UAE field requirements
Use this page to map the UAE information your source system supplies to Complyance. It covers the customer-facing fields and choices that affect UAE document generation. General information such as parties, line items, totals, payment details, and supporting documents remains part of the common integration contract and is not repeated here.
Select the UAE Document Type
| Field label | Format | Requirement | Available choices | Purpose |
|---|---|---|---|---|
| Document Type | Composed selection | Required | Tax Invoice + Ordinary; Tax Credit Note + Ordinary; Tax Invoice + Out of Scope; Tax Credit Note + Out of Scope; Tax Invoice + Self-Billed; Tax Credit Note + Self-Billed | Defines the complete UAE document outcome, official document type code, and validation profile. See UAE document type composition. |
For UAE, Document Type combines the base with a variant when applicable and any applicable modifiers. The UAE does not use a separate document variant. Ordinary, Out of Scope, and Self-Billed are part of the complete Document Type selection, so clients make one composed selection.
A Tax Point Date may be supplied where applicable, but a Tax Point Date Code is not available because PINT AE term IBT-008 has cardinality 0..0 for ordinary invoices and credit notes and for self-billed invoices and credit notes.
UAE fields clients may need to supply
| Field label | Format | Applies to | Requirement or condition | Client guidance |
|---|---|---|---|---|
| Document Number | Text | All UAE documents | Required | Supply your unique document identifier. It corresponds to PINT AE term IBT-001. |
| Issue Date | Date | All UAE documents | Required | Supply the document issue date. |
| Issue Time | Time | All UAE documents | Optional | Supply it when your integration records the issue time. |
| Document Currency | ISO 4217 currency | All UAE documents | Required | Choose a currency accepted by the applicable PINT AE transaction. |
| Preceding Invoice Reference | Text | Ordinary credit notes, codes 381 and 81 | Required unless the Credit Note Reason is Volume Discount | Reference the preceding invoice. See IBR-055-AE. The current self-billing rule does not make the same requirement for code 261. |
| Credit Note Reason | Selection | Ordinary and self-billed credit notes, codes 381, 81, and 261 | Required exactly once | Choose a reason from UAE allowed values and code lists. See ordinary BTAE-03 and self-billing BTAE-03. |
| Billing Frequency | Selection | Invoice or credit note | Conditional | When Other is selected, also provide an invoice note. See ordinary IBR-160-AE for invoices and credit notes, plus self-billed invoice and credit-note billing-frequency lists. |
| Item Type | Selection | Each applicable line | Conditional | Choose Goods, Services, or Both. The related classification or activity information depends on the selected value. See self-billed invoice and credit-note item-type lists where applicable. |
| Reverse Charge Goods Type | Selection | Each reverse-charge line | Required when reverse charge applies | Choose the type that describes the goods on the line. |
| Net Unit Price | Decimal | Each line | Required | Unit price after any item-price discount and before tax. |
| Gross Unit Price | Decimal | Each line | Required | Unit price before any item-price discount and before tax. See ordinary invoice IBT-148 and credit-note IBT-148. |
| Tax Point Date | Date | Invoice or credit note | Optional where applicable | Supply the date on which VAT becomes chargeable when it differs from the issue date and the selected transaction permits it. |
Official field meaning and cardinality come from the transaction-specific PINT AE semantic model. Your Complyance mapping experience presents these fields using the labels above.
Route-specific checks
Ordinary invoice and credit note
Choose Tax Invoice + Ordinary or Tax Credit Note + Ordinary. For an ordinary credit note, supply the Credit Note Reason and the Preceding Invoice Reference unless the reason is Volume Discount.
Out-of-scope invoice and credit note
Choose Tax Invoice + Out of Scope or Tax Credit Note + Out of Scope. VAT categories at both document and line level must be Exempt, Outside Scope, or Zero Rated. Do not combine an out-of-scope selection with Self-Billed, Deemed Supply, Margin Scheme, Summary Invoice, Reverse Charge, or Export.
Self-billed invoice and credit note
Choose Tax Invoice + Self-Billed or Tax Credit Note + Self-Billed. These selections use the separate PINT AE Self-Billing profile and cannot also be out of scope.
Related official references
- PINT AE invoice semantic model
- PINT AE credit-note semantic model
- PINT AE Self-Billing invoice semantic model
- PINT AE Self-Billing credit-note semantic model
- MoF Mandatory Fields V1.0
For available choices and composition compatibility, continue with UAE allowed values and code lists and UAE document type composition. For rejected documents, see UAE validation and troubleshooting.
Internal schema paths and input-to-output transformation mappings are intentionally excluded from this public reference.