United Arab Emirates (AE) Field Mapping
Country: AE
Compliance: PINT AE
Last Updated: 2026
Requirement Legend
M: MandatoryCM: Conditional Mandatory (required only when condition applies)O: Optional
Field Mapping Reference
1) Core Invoice Information
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Invoice number | header.documentNumber | M | Unique per seller |
| Unique Identifier Number (UUID) | header.documentId | M | UUID |
| Invoice issue date | header.issueDate | M | ISO date |
| Invoice issue time | header.issueTime | O | ISO time |
| Invoice type code | header.documentType | M | UAE document type mapping |
| Invoice currency code | header.currency | M | ISO 4217 |
| Tax accounting currency | header.taxCurrency | CM | M if not same as document currency |
| Currency exchange rate | header.exchangeRate.rate | CM | M when tax currency provided |
| Payment due date | header.dueDate | M | Mandatory per PINT-AE |
| Credit note reason | header.noteIssuanceReason | CM | Mandatory for credit note |
| Preceding invoice reference | header.referenceId | CM | Mandatory for credit notes |
2) Process Control
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Business process type | extensions.peppol_businessProcessType | M | urn:peppol:bis:billing |
| Specification identifier | extensions.peppol_specificationIdentifier | M | urn:peppol:pint:billing-1@ae-1 |
3) Seller Information
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Seller name | parties.seller.name | M | Legal name |
| Seller trading name | parties.seller.tradeName | O | Commercial name |
| Seller identifier | parties.seller.partyId | O | Internal/GLN |
| Seller legal registration ID | parties.seller.registrationNumbers[].value | M | Trade license/EID/etc |
| Seller legal reg ID type | parties.seller.registrationNumbers[].type | M | TL/EID/PAS/CD |
| Seller VAT identifier (TRN) | parties.seller.taxIds[type="VAT"].value | M (CM O for commercial invoice) | 15-digit TRN |
| Seller TIN (non-VAT case) | parties.seller.taxIds[type="TIN"].value | O (CM M for commercial invoice) | Required when not VAT-registered |
| Seller electronic address | parties.seller.peppolId | M | Peppol ID |
| Seller contact name | parties.seller.contact.name | O | Contact point |
| Seller contact phone | parties.seller.contact.phone | O | Phone |
| Seller contact email | parties.seller.contact.email | O | Email |
| Address line 1 | parties.seller.address.addressLine1 | M | Main address |
| Address line 2 | parties.seller.address.addressLine2 | O | Secondary |
| Address line 3 | parties.seller.address.addressLine3 | O | Additional |
| City | parties.seller.address.city | M | City |
| Post code | parties.seller.address.postalCode | O | Postal code |
| Country subdivision | parties.seller.address.stateOrProvince | M | Emirate/state |
| Country code | parties.seller.address.country | M | ISO alpha-2 |
4) Buyer Information
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Buyer name | parties.buyer.name | M | Legal name |
| Buyer trading name | parties.buyer.tradeName | O | Commercial name |
| Buyer identifier | parties.buyer.partyId | O | Internal/GLN |
| Buyer legal registration ID | parties.buyer.registrationNumbers[].value | O | Trade license/EID/etc |
| Buyer legal reg ID type | parties.buyer.registrationNumbers[].type | CM | TL/EID/PAS/CD |
| Buyer VAT identifier (TRN) | parties.buyer.taxIds[type="VAT"].value | M | VAT-registered buyer |
| Buyer electronic address | parties.buyer.peppolId | M | Peppol ID |
| Buyer contact name | parties.buyer.contact.name | O | Contact point |
| Buyer contact phone | parties.buyer.contact.phone | O | Phone |
| Buyer contact email | parties.buyer.contact.email | O | Email |
| Address line 1 | parties.buyer.address.addressLine1 | M | Main address |
| Address line 2 | parties.buyer.address.addressLine2 | O | Secondary |
| Address line 3 | parties.buyer.address.addressLine3 | O | Additional |
| City | parties.buyer.address.city | M | City |
| Post code | parties.buyer.address.postalCode | O | Postal code |
| Country subdivision | parties.buyer.address.stateOrProvince | M | Emirate/state |
| Country code | parties.buyer.address.country | M | ISO alpha-2 |
5) Line Items
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Line ID | lineItems[].id | M | Unique line ID |
| Description | lineItems[].description | M | Description |
| Unit price | lineItems[].price.amount | M | Per unit |
| Unit code | lineItems[].unitCode | O | UN/ECE Rec 20 |
| Quantity | lineItems[].quantity | O | Quantity |
| Total excluding tax | lineItems[].lineTaxableValue | M | Net amount |
| Tax type | lineItems[].taxCategory | M | S,Z,E,O |
| Tax rate | lineItems[].taxRate | M | Percentage |
| Tax amount | lineItems[].taxAmount | M | Tax amount |
| Tax exemption reason | lineItems[].taxExemptionReason | O | For exempt/zero-rated |
| Line total | lineItems[].lineTotal | O | Including tax |
6) Totals
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Total excluding tax | totals.totalAmountExcludingTax | M | Before VAT |
| Total tax amount | totals.totalTaxAmount | M | VAT total |
| Total including tax | totals.totalAmountIncludingTax | M | Grand total |
| Prepayment amount | totals.prepaidAmount | O | Prepaid |
| Total payable amount | totals.amountDue | M | Final due |
| Rounding amount | totals.roundingAmount | O | Rounding |
7) Payment Details
| Business Term | GETS Path | Mandatory | Notes |
|---|
| Payment instruction ID | payment.paymentMeans[].paymentId | O | Payment reference |
| Payment means type | payment.paymentMeans[].paymentMeansCode | M | UNCL 4461 |
| Payment means text | payment.paymentMeans[].paymentMeansText | O | Description |
| Payee account ID | payment.paymentMeans[].creditTransferInfo.payeeFinancialAccountId | O | IBAN/account |
| Payee account name | payment.paymentMeans[].creditTransferInfo.payeeFinancialAccountName | O | Account holder |
| Financial institution branch | payment.paymentMeans[].creditTransferInfo.payeeFinancialInstitutionBranch | O | BIC/SWIFT |
| Payment terms | payment.paymentTerms[].note | O | Terms text |
Code Lists Reference
UAE Document Types
| UAE Code | UAE Document Type | GETS documentType |
|---|
| 380 | Tax Invoice | { "base": "tax_invoice" } |
| 381 | Credit Note | { "base": "credit_note" } |
| 389 | Self-Billed Invoice | { "base": "tax_invoice", "modifiers": ["self_billed"] } |
| 261 | Self-Billed Credit Note | { "base": "credit_note", "modifiers": ["self_billed"] } |
| 480 | Invoice Out of Scope of Tax | { "base": "tax_invoice", "modifiers": ["out_of_scope"] } |
UAE Transaction Modifiers
| Modifier | Meaning |
|---|
free_trade_zone | Free trade zone supplies |
deemed_supply | Deemed supply |
margin_scheme | Profit margin scheme |
summary | Summary invoice |
continuous_supply | Continuous supply |
disclosed_agent | Disclosed agent billing |
e_commerce | E-commerce platform sales |
export | Export transactions |
Tax Category Codes (UNCL 5305)
| Code | Description |
|---|
| S | Standard rate |
| Z | Zero-rated |
| E | Exempt |
| O | Out of scope |
Payment Means Codes (UNCL 4461)
| Code | Description |
|---|
| 10 | Cash |
| 20 | Cheque |
| 30 | Credit transfer |
| 48 | Credit card |
| 54 | Credit card (brand specific) |
| 55 | Debit card |
| 58 | SEPA credit transfer |
| 59 | SEPA direct debit |
| 97 | Local cheque |
See Also
