United Arab Emirates (AE) Field Mapping
Country: AE Compliance: PINT AE Last Updated: 2026
This page includes the full UAE field mapping with actual JSON field paths and UAE extension fields in one place.
Complete Sample Payload
{
"invoice_data": {
"document_number": "UAE-DBT-20260218123000123",
"document_type": "tax_invoice",
"invoice_date": "2026-02-18",
"invoice_time": "14:30:00Z",
"currency_code": "AED",
"tax_currency_code": "AED",
"due_date": "2026-03-20",
"period_start_date": "2026-01-19",
"period_end_date": "2026-02-18",
"period_frequency": "MONTHLY",
"exchange_rate": 1.0,
"line_extension_amount": 10000.0,
"tax_exclusive_amount": 10000.0,
"total_tax_amount": 500.0,
"total_amount": 10500.0,
"total_allowances": 0.0,
"total_charges": 0.0,
"prepaid_amount": 0.0,
"amount_due": 10500.0,
"rounding_amount": 0.0,
"original_reference_id": "UAE-INV-ORIG-001",
"credit_note_reason": "Goods returned"
},
"seller_info": {
"seller_name": "ABC Trading LLC",
"seller_trade_name": "ABC Trading",
"seller_party_id": "SELLER-UAE-001",
"vat_number_type": "TRN",
"vat_number": "100819867100003",
"tax_scheme": "VAT",
"registration_number": "CN-1234567",
"registration_type": "TL",
"registration_scheme": "AE:TL",
"authority_name": "Dubai Department of Economic Development",
"peppol_id": "0235:1914931209",
"seller_email": "contact@abctrading.ae",
"seller_phone": "+971-4-1234567",
"seller_contact_name": "Ahmed Al Maktoum",
"street_name": "Sheikh Zayed Road",
"additional_address": "Building 123",
"building_number": "123",
"city_name": "Dubai",
"state_province": "DUBAI",
"postal_code": "00000",
"country_code": "AE"
},
"buyer_info": {
"buyer_name": "XYZ Corporation LLC",
"buyer_trade_name": "XYZ Corp",
"buyer_party_id": "BUYER-UAE-001",
"buyer_vat_type": "TRN",
"buyer_vat_number": "100889867100003",
"buyer_tax_scheme": "VAT",
"buyer_registration_number": "CN-9876543",
"buyer_registration_type": "TL",
"buyer_registration_scheme": "TL",
"buyer_authority_name": "Abu Dhabi Department of Economic Development",
"buyer_peppol_id": "0235:1008213264",
"buyer_email": "purchasing@xyzcorp.ae",
"buyer_phone": "+971-2-9876543",
"buyer_contact_name": "Fatima Al Mansouri",
"buyer_street_name": "Al Wasl Road",
"buyer_additional_address": "Tower 2",
"buyer_building_number": "456",
"buyer_city": "Dubai",
"buyer_state_province": "DUBAI",
"buyer_postal_code": "00000",
"buyer_country": "AE"
},
"line_items": [
{
"line_id": "1",
"item_name": "Office Equipment",
"item_description": "Professional office equipment package",
"quantity": 10.0,
"unit_code": "EA",
"unit_price": 500.0,
"net_price": 500.0,
"gross_price": 500.0,
"line_taxable_value": 5000.0,
"tax_category": "S",
"tax_rate": 5.0,
"tax_amount": 250.0,
"line_total": 5250.0,
"item_type": "GOODS",
"country_of_origin": "AE",
"classification_code": "8471",
"classification_scheme": "HS",
"seller_item_code": "SKU-001",
"buyer_item_code": "BUYER-SKU-001",
"batch_number": "BATCH-2024-001"
}
],
"uae_extensions": {
"unique_identifier": "550e8400-e29b-41d4-a716-446655440000",
"invoiced_object_id": "OBJECT-2024-001",
"taxpoint_date": "2026-02-18",
"total_amount_including_tax_in_aed": 10500.0,
"authority_name": "Dubai Department of Economic Development",
"buyer_authority_name": "Abu Dhabi Department of Economic Development",
"business_process_type": "urn:peppol:bis:billing",
"specification_identifier": "urn:peppol:pint:ae:invoice:v1"
},
"payment_info": {
"payment_id": "PAY-001",
"payment_means_code": "IN_CASH",
"payment_means_text": "Bank Transfer",
"remittance_info": "Payment for Invoice UAE-DBT-20260218123000123",
"account_id": "AE123456789012345678901",
"account_name": "ABC Trading LLC",
"bank_id": "AEBN0001"
},
"payment_terms": [
{
"instructions_id": "TERMS-001",
"note": "Net 30 days",
"amount": 10500.0,
"due_date": "2026-03-20"
}
],
"supporting_documents": [
{
"type": "purchaseOrderReference",
"id": "PO-2024-001234"
}
]
}Field Mapping Reference
Use the tables below to map your data to the correct JSON field paths. All paths use dot notation (e.g., invoice_data.document_number).
Document Header Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
invoice_data.document_type | string | Yes | Document type (tax_invoice, credit_note, debit_note). | tax_invoice |
invoice_data.document_number | string | Yes | Unique invoice number. | UAE-DBT-20260218123000123 |
invoice_data.invoice_date | string | Yes | Invoice issue date (YYYY-MM-DD). | 2026-02-18 |
invoice_data.invoice_time | string | Yes | Invoice issue time (HH:MM:SSZ). | 14:30:00Z |
invoice_data.currency_code | string | Yes | Currency code (ISO 4217). Defaults to AED. | AED |
invoice_data.tax_currency_code | string | No | Tax currency code. Defaults to document currency. | AED |
invoice_data.due_date | string | No | Payment due date (YYYY-MM-DD). | 2026-03-20 |
invoice_data.period_start_date | string | No | Billing period start date. | 2026-01-19 |
invoice_data.period_end_date | string | No | Billing period end date. | 2026-02-18 |
invoice_data.period_frequency | string | No | Billing frequency (MONTHLY, QUARTERLY, etc.). | MONTHLY |
invoice_data.exchange_rate | number | No | Exchange rate when currency differs from AED. | 1.0 |
invoice_data.line_extension_amount | number | No | Sum of line extension amounts. | 10000.0 |
invoice_data.tax_exclusive_amount | number | No | Total excluding VAT. | 10000.0 |
invoice_data.total_tax_amount | number | No | Total VAT amount. | 500.0 |
invoice_data.total_amount | number | No | Total including VAT. | 10500.0 |
invoice_data.total_allowances | number | No | Total document-level allowances. | 0.0 |
invoice_data.total_charges | number | No | Total document-level charges. | 0.0 |
invoice_data.prepaid_amount | number | No | Prepaid amount. | 0.0 |
invoice_data.amount_due | number | No | Amount due for payment. | 10500.0 |
invoice_data.rounding_amount | number | No | Rounding adjustment amount. | 0.0 |
invoice_data.original_reference_id | string | No | Reference to original invoice for credit/debit notes. | UAE-INV-ORIG-001 |
invoice_data.credit_note_reason | string | No | Reason for credit/debit note. | Goods returned |
Seller Information Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
seller_info.seller_name | string | Yes | Legal registered name. | ABC Trading LLC |
seller_info.seller_trade_name | string | No | Trading/commercial name. | ABC Trading |
seller_info.seller_party_id | string | No | Internal seller identifier. | SELLER-UAE-001 |
seller_info.vat_number_type | string | Yes | VAT identification scheme (TRN). | TRN |
seller_info.vat_number | string | Yes | UAE VAT number (15 digits starting with 1, ending with 03). | 100819867100003 |
seller_info.tax_scheme | string | No | Tax scheme identifier. | VAT |
seller_info.registration_number | string | Yes | Business registration number. | CN-1234567 |
seller_info.registration_type | string | Yes | Registration type (TL for Trade License). | TL |
seller_info.registration_scheme | string | No | Registration scheme (format: AE:TL). | AE:TL |
seller_info.authority_name | string | No | Issuing authority name (for ID/passport contexts). | Dubai Department of Economic Development |
seller_info.peppol_id | string | No | Peppol network identifier (format: 0235:XXXXXXXXX). | 0235:1914931209 |
seller_info.seller_email | string | No | Contact email address. | contact@abctrading.ae |
seller_info.seller_phone | string | No | Contact phone number. | +971-4-1234567 |
seller_info.seller_contact_name | string | No | Contact person name. | Ahmed Al Maktoum |
seller_info.street_name | string | Yes | Street address. | Sheikh Zayed Road |
seller_info.additional_address | string | No | Additional address line. | Building 123 |
seller_info.building_number | string | No | Building number. | 123 |
seller_info.city_name | string | Yes | City name. | Dubai |
seller_info.state_province | string | No | State or province. | DUBAI |
seller_info.postal_code | string | Yes | Postal code. | 00000 |
seller_info.country_code | string | Yes | Country code (ISO 3166-1 alpha-2). | AE |
Buyer Information Fields (B2B)
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
buyer_info.buyer_name | string | Conditional | Legal buyer name. Required for B2B. | XYZ Corporation LLC |
buyer_info.buyer_trade_name | string | No | Trading/commercial name. | XYZ Corp |
buyer_info.buyer_party_id | string | No | Internal buyer identifier. | BUYER-UAE-001 |
buyer_info.buyer_vat_type | string | Conditional | VAT identification scheme. Required for B2B. | TRN |
buyer_info.buyer_vat_number | string | Conditional | Buyer VAT number. Required for B2B. | 100889867100003 |
buyer_info.buyer_tax_scheme | string | No | Tax scheme identifier. | VAT |
buyer_info.buyer_registration_number | string | Conditional | Business registration number. | CN-9876543 |
buyer_info.buyer_registration_type | string | Conditional | Registration type. | TL |
buyer_info.buyer_registration_scheme | string | No | Registration scheme. | TL |
buyer_info.buyer_authority_name | string | No | Buyer issuing authority name. | Abu Dhabi Department of Economic Development |
buyer_info.buyer_peppol_id | string | No | Buyer Peppol identifier. | 0235:1008213264 |
buyer_info.buyer_email | string | No | Buyer contact email. | purchasing@xyzcorp.ae |
buyer_info.buyer_phone | string | No | Buyer contact phone. | +971-2-9876543 |
buyer_info.buyer_contact_name | string | No | Buyer contact person name. | Fatima Al Mansouri |
buyer_info.buyer_street_name | string | Conditional | Street address. Required for B2B. | Al Wasl Road |
buyer_info.buyer_additional_address | string | No | Additional address line. | Tower 2 |
buyer_info.buyer_building_number | string | No | Building number. | 456 |
buyer_info.buyer_city | string | Conditional | City name. Required for B2B. | Dubai |
buyer_info.buyer_state_province | string | No | State or province. | DUBAI |
buyer_info.buyer_postal_code | string | Conditional | Postal code. Required for B2B. | 00000 |
buyer_info.buyer_country | string | Conditional | Country code. Required for B2B. | AE |
Line Items Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
line_items[].line_id | string | Yes | Unique line identifier. | 1 |
line_items[].item_name | string | Yes | Item/product name. | Office Equipment |
line_items[].item_description | string | No | Detailed item description. | Professional office equipment package |
line_items[].quantity | number | Yes | Invoiced quantity. | 10.0 |
line_items[].unit_code | string | Yes | Unit of measurement (UN/ECE Rec 20). | EA |
line_items[].unit_price | number | Yes | Price per unit. | 500.0 |
line_items[].net_price | number | No | Net price per unit. | 500.0 |
line_items[].gross_price | number | No | Gross price per unit. | 500.0 |
line_items[].line_taxable_value | number | Yes | Taxable amount for this line. | 5000.0 |
line_items[].tax_category | string | Yes | VAT category code (S=Standard, Z=Zero, E=Exempt). | S |
line_items[].tax_rate | number | Yes | VAT rate percentage. | 5.0 |
line_items[].tax_amount | number | Yes | VAT amount for this line. | 250.0 |
line_items[].line_total | number | Yes | Line total including VAT. | 5250.0 |
line_items[].item_type | string | No | Item type (GOODS, SERVICES). | GOODS |
line_items[].country_of_origin | string | No | Country of origin (ISO 3166-1 alpha-2). | AE |
line_items[].classification_code | string | No | HS classification code. | 8471 |
line_items[].classification_scheme | string | No | Classification scheme (HS). | HS |
line_items[].seller_item_code | string | No | Seller's item code/SKU. | SKU-001 |
line_items[].buyer_item_code | string | No | Buyer's item code. | BUYER-SKU-001 |
line_items[].batch_number | string | No | Batch/lot number. | BATCH-2024-001 |
Totals and Amounts Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
invoice_data.line_extension_amount | number | No | Sum of all line extension amounts. | 10000.0 |
invoice_data.tax_exclusive_amount | number | No | Total amount excluding VAT. | 10000.0 |
invoice_data.total_tax_amount | number | No | Total VAT amount. | 500.0 |
invoice_data.total_amount | number | No | Total amount including VAT. | 10500.0 |
invoice_data.amount_due | number | No | Final amount due for payment. | 10500.0 |
Payment Information Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
payment_info.payment_id | string | No | Payment reference/ID. | PAY-001 |
payment_info.payment_means_code | string | Yes | Payment method code (IN_CASH, CREDIT, BANK_TRANSFER). | IN_CASH |
payment_info.payment_means_text | string | No | Payment method description. | Bank Transfer |
payment_info.remittance_info | string | No | Remittance information/reference. | Payment for Invoice UAE-DBT-20260218123000123 |
payment_info.account_id | string | No | Payee account ID (IBAN). | AE123456789012345678901 |
payment_info.account_name | string | No | Payee account holder name. | ABC Trading LLC |
payment_info.bank_id | string | No | Bank identifier code. | AEBN0001 |
Payment Terms Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
payment_terms[].instructions_id | string | No | Payment instructions identifier. | TERMS-001 |
payment_terms[].note | string | No | Payment terms description. | Net 30 days |
payment_terms[].amount | number | No | Amount subject to payment terms. | 10500.0 |
payment_terms[].due_date | string | No | Payment due date. | 2026-03-20 |
Supporting Documents Fields
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
supporting_documents[].type | string | No | Document type (purchaseOrderReference, etc.). | purchaseOrderReference |
supporting_documents[].id | string | No | Document reference ID. | PO-2024-001234 |
Country Extension Fields
UAE-specific extension fields are provided in the uae_extensions object.
| JSON Field Path | Type | Required | Description | Example |
|---|---|---|---|---|
uae_extensions.unique_identifier | string | No | Unique transaction identifier (UUID). | 550e8400-e29b-41d4-a716-446655440000 |
uae_extensions.invoiced_object_id | string | No | Seller object ID for tracking. | OBJECT-2024-001 |
uae_extensions.taxpoint_date | string | No | VAT tax point date (tax period). | 2026-02-18 |
uae_extensions.total_amount_including_tax_in_aed | number | No | Invoice total including VAT in AED. | 10500.0 |
uae_extensions.authority_name | string | No | Issuing authority name. | Dubai Department of Economic Development |
uae_extensions.buyer_authority_name | string | No | Buyer issuing authority name. | Abu Dhabi Department of Economic Development |
uae_extensions.business_process_type | string | No | Business process identifier. | urn:peppol:bis:billing |
uae_extensions.specification_identifier | string | No | PINT AE technical specification identifier. | urn:peppol:pint:ae:invoice:v1 |
See Also
- Back to Field Mapping Overview
- Unify API Integration Guide — Complete API integration documentation
- Examples — Code examples and cURL requests