Clean four things before go-live: customer records (legal name, address with Emirate, tax identifier, network identifier), the product and service catalogue (description, one VAT category, classification code), invoice numbering (one unbroken sequence per legal entity), and one rounding policy. Start with customers, because it depends on them replying.
Key facts at a glance
- Most rejections come from data, not software.
- Customer records need legal name, address, Emirate code and tax identifier.
- Every item needs a description, one VAT category and a classification code (HS for goods, SAC for services).
- Emirate subdivision codes must come from the AE code list (
IBR-128-AE), for exampleAE-DU. - Use one unbroken numbering sequence per legal entity and one rounding policy.
1. Customer records
For every business customer you will invoice after go-live:
| Field | Why |
|---|---|
| Legal name as registered | Must match the tax registration |
| Address including Emirate | Postal address fields are required (IBR-143-AE, IBR-144-AE); Emirate must be a code from the AE list (IBR-128-AE) |
| TRN or TIN | Must be valid and correctly formatted (IBR-132-AE) |
| Network identifier | Needed to deliver the invoice (0235: + TIN) |
| Customer type | Business, government or consumer, so the system knows what is in scope |
Send your customers a short form asking for their legal name, address, TRN or TIN and confirmation of their e-invoicing go-live date. Chase the non-responders; this is the longest task.
2. Product and service catalogue
| Field | Why |
|---|---|
| Clear description | Item description is mandatory (IBR-125-AE) |
| One VAT category | Standard, zero-rated, exempt or out of scope, fixed per item |
| Classification code | HS for goods, SAC for services (IBR-188-AE, IBR-189-AE) |
| Unit and base quantity | Base quantity and gross price are required (IBR-126-AE) |
Remove duplicates. If "consulting", "consultancy fee" and "advisory" exist with different settings, merge them.
3. Numbering
One unbroken sequence per legal entity, no manual overrides, and credit notes that reference the original invoice.
4. Rounding
Pick one method (usually round each line, then add the rounded lines) and use it in every system that produces invoices. Mixed rounding is a top cause of one-fils rejections. See common rejection errors.
A realistic order
Frequently asked questions
What data do I need about customers for e-invoicing?
Legal name, full address including the Emirate code, valid TRN or TIN, and the customer's network identifier, plus whether they are a business, government or consumer.
Do products need a classification code?
Yes. Goods use HS codes and services use SAC codes, with the scheme identified on each line. Have your tax adviser confirm the codes.
What is an Emirate code?
A subdivision code from the official AE list, such as AE-DU for Dubai or AE-AJ for Ajman. Free text like Dubai is rejected.
Why does rounding matter?
Validation checks that totals reconcile to the fils. Mixing line-level and total-level rounding produces one-fils differences that cause rejections.
