InvoiceNETSIMPLIFYING DIGITAL BUSINESS Help Center
Open portal

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

  1. In Settings → Company profile, enable the Free zone entity toggle.
  2. Enter your Beneficiary ID as issued by your free zone authority.
  3. When creating an invoice, the portal automatically sets BTAE-02 bit 1 to 1 and populates BTAE-01.
  4. 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.