Free zone invoice errors (BTAE-01, BTAE-02 bit 1)
Fix errors specific to UAE free zone invoices: missing beneficiary ID, wrong transaction type flag, and PEPPOL ID format.
Free zone invoices require an additional field (Beneficiary ID, BTAE-01) and must set bit 1 of the transaction type code (BTAE-02) to 1.
Rule failures specific to free zones
| Rule | Meaning | Fix |
|---|---|---|
| IBR-007-AE | Free zone flag (bit 1) set but no Beneficiary ID | Enter the Beneficiary ID in Step 1 → Free zone details |
| IBR-008-AE | Beneficiary ID present but free zone flag not set | Set bit 1 of BTAE-02 to 1 |
| IBR-009-AE | Beneficiary ID format invalid | Must match the format issued by the relevant free zone authority |
What is the Beneficiary ID (BTAE-01)?
The Beneficiary ID is a unique identifier assigned to your free zone entity by the free zone authority (e.g. JAFZA, DMCC, DIFC, ADGM). It is separate from your TRN and trade licence number.
How to configure free zone invoices
- In Settings → Company profile, enable the Free zone entity toggle.
- Enter your Beneficiary ID as issued by your free zone authority.
- When creating an invoice, the portal automatically sets BTAE-02 bit 1 to
1and populates BTAE-01. - If you are issuing invoices to a free zone buyer, enter their Beneficiary ID in the customer record.
Designated zones
Designated zones (warehousing areas outside UAE VAT territory) are treated differently from free zones. For designated zone supplies, also set the appropriate VAT exemption reason code. Consult your tax advisor if supplies cross between designated and non-designated zones.
See also: Transaction type builder · Scenario finder.