Lesson 1 — Why a catalog and not more fields
Every UAE authority you deal with hands you a number, and the numbers land in different places. One sits on the company record, one on a tax setting, one on an employee's form, one in an email from your customs broker and nowhere else. Nothing in the database tells you which is which, who issued it, or whether the value you are looking at is the current one. The obvious fix is to add fields until every number has a box. That is also the fix that quietly creates two versions of the same number.
The mental model: a catalog, and a small registry behind it. Odoone UAE Identifiers (odoone_uae_identifiers) is the designated home for every identifier a UAE authority assigns — the Tax Registration Number, GIBAN, Establishment ID, Customs Registration Number, Emirates ID-adjacent document numbers, and more. It moves none of that data. It adds a documented catalog of what identifiers exist, and a small value registry for the handful that have no field of their own yet: the Corporate Tax registration number, the per-tax-type GIBANs, and the Customs Code.
The click path. Go to Apps, search for Odoone UAE Identifiers and press Install — the technical name is odoone_uae_identifiers. Or tick UAE Identifiers on Settings › UAE, which does the same thing from the page course 1.1 spends its time on. Installing pulls in odoone_l10n_ae and mail automatically, so there is nothing to install first.
Installing changes nothing you have already typed. Installing does not change any value already stored on an existing field. The catalog only documents where those values already live. That sentence is the reason this module is safe to put on a database that has been running for years: it is a reference layer over data you already have, not a migration of it.
The HR bridge installs itself. Odoone UAE Identifiers — HR Bridge (odoone_uae_identifiers_hr) installs automatically the moment both odoone_uae_identifiers and hr are present, and forces neither module onto a database that does not otherwise need them. Install the base module where there is no HR and the bridge stays uninstalled; install hr later and the bridge arrives on its own. Lesson 5 is entirely about what it adds, and it adds less than most people expect — deliberately.
Worked example. Marina Ridge Trading LLC installs the module on a Tuesday morning, and the finance manager watches for something to move. Nothing does. The tax registration number is exactly where it was, on the field that always held it. What is new is a catalog menu under Accounting configuration and, on the company form, a UAE Registrations & Identifiers group with an empty inline list — empty because no registry value has been entered yet, not because the install failed.
The failure mode. "The UAE Registrations & Identifiers group is missing from the company form." The company's fiscal country is not the UAE, so the whole UAE Company Setting tab is hidden and this group with it. That is the check course 1.1 opens with, and it is worth making before you conclude that anything about this module is broken.