Field mapping management for e-invoice file templates for United Arab Emirates
Manage field mapping for e-invoice file templates in UAE's e-invoicing clearance process, ensuring compliance with business requirements.
E-invoicing business regions configuration for United Arab Emirates
For a domestic seller in the UAE, document the following business region configurations:
| Business Number Schema Id | TL | Use this value as the default for testing purposes. It represents the seller legal registration identifier type (schemeAgencyID). |
| Trade Name | Test Authority | Use this value as the default for testing purposes. It represents the issuing authority name (schemeAgencyName). |
The UAE out-of-the-box templates support only buyers within the UAE region. If you need to support cross-border or non-UAE buyers, customize the template as described in the following sections.
Customizations for cross-border scenarios
For transactions involving non-UAE buyers, document the following required customizations:
- Update buyer country identification
Change the hard-coded country identification code in the Customer Party definition from
AEto a dynamic 2-digit country code by defining and using a custom field on the Contact object. - Add tax currency in AED
Uncomment and implement the tax currency logic in the template so that the tax currency is represented in AED. This includes adding:
-
TaxCurrencyCode=AED -
TaxAmountin tax currency (AED)
-
- Implement tax exchange rate:
Implement the Tax Exchange Rate section at the document level in the template path
Invoice/cac:TaxExchangeRateto support conversion from the invoice currency to AED. - Update item price extension amounts:
Update the Item Price Extension section so that the amount reflects the converted tax currency value instead of assuming the buyer is always in the UAE region.