Guide for FTA e-invoice Fields
How to read this guide:
Every field on the DocFlow e-invoice platform is listed below with its API key, PINT-AE business term, requirement level, definition and accepted values. Fields are grouped by form tab and numbered continuously across the guide.
ADDITIONAL INFORMATION
Exports :
For exports, if the buyer does not have a Peppol ID, the predefined endpoint (0235: 9900000099) should be mandatorily included by the supplier on the Electronic Invoice.
Buyer not Registered in E-Invoicing :
When issuing Tax Invoices to buyers that have not yet implemented Electronic Invoicing (e.g. due to not having yet implemented on a voluntary basis and not having a mandatory implementation requirement as per the roll-out plan), regular Tax Invoices (e.g. in pdf) are required in addition to electronic Tax Invoices. In such scenarios where the buyer has not yet implemented Electronic Invoicing and does not have a Participant Identifier, the predefined endpoint (0235: 9900000098) should be mandatorily included by the supplier on the Electronic Invoice.
Deemed Supply :
In the case of a deemed supply, the buyer electronic address should always be 0235: 9900000097. This value does not change based on the identity of the supplier.
Document tab
Header fields identify the document, its dates, type and currency, the FTA transaction-type flags, references, the preceding invoice for credit notes, delivery details and notes. All keys sit at the root of the payload.
Identification
#
field name
API key
business term
Required
description
accepted values
1
invoice number
invoiceNo
iBT-001
FTA mandatory
A unique identification of the Invoice.
Free text, unique per seller; e.g. INV-2026-000001
2
document ID
documentId
BTAE-07
required
Globally unique identifier for the invoice.
UUID
3
issue date
issueDate
IBT-002
FTA mandatory
The date when the Invoice was issued.
Date, YYYY-MM-DD
4
issue time
issueTime
IBT-168
optional
The time of day when an invoice was issued.
Time, HH:MM
5
invoice type code
invoiceTypeCode
IBT-003
FTA mandatory
A code specifying the functional type of the Invoice.
380 Commercial invoice; 381 Credit note; 480 Out of scope of VAT; 81 Credit note related to goods or services. Use 480 or 81 when the seller is not VAT-registered
6
currency code
currencyCode
IBT-005
FTA mandatory
The currency in which all Invoice amounts are given, except for the Total tax amount in accounting currency.
ISO 4217 code from the form list; default AED
7
payment due date
dueDate
IBT-009
FTA mandatory
The date when the payment is due.
Date, YYYY-MM-DD
8
Business process type
businessProcessType
IBT-023
FTA mandatory
Identifies the business process context in which the transaction appears, to enable the Buyer to process the Invoice in an appropriate way.
Fixed value urn:peppol:bis:billing, injected by the XML generator
9
Specification identifier
specificationIdentifier
IBT-024
FTA mandatory
An identification of the specification containing the total set of rules regarding semantic content, cardinalities and business rules to which the data contained in the instance document conforms.
Fixed value urn:peppol:pint:billing-1@ae-1, injected by the XML generator
transation type
#
field name
API key
business term
Required
description
accepted values
10
transaction type code
invoiceTransactionTypeCode
BTAE-02
FTA mandatory
A sequence of flags that identify the invoice transaction types. Each position is 1 (applicable) or 0 (not applicable): Free trade zone, Deemed supply, Margin scheme, Summary invoice, Continuous supply, Disclosed agent billing, Supply through e-commerce, Exports.
8-character binary string built from the eight form checkboxes, in that order; e.g. 10001000 = Free trade zone + Continuous supply; 00000000 when none apply
11
Principal ID
principalId
BTAE-14
Conditional — required when flag 6 (Disclosed agent billing) is set
In case of Disclosed Agent billing, provide the tax registration number (TRN) of the principal.
TRN of the principal (15 digits)
Dates and billing period
#
field name
API key
business term
Required
description
accepted values
12
supply date
supplyDate
IBT-072
optional
The date on which the supply of goods or services was made or completed.
Date, YYYY-MM-DD
13
VAT point date
taxPointDate
IBT-007
Conditional — when it differs from the issue date
The date when the tax becomes accountable for the Seller and for the Buyer in so far as that date can be determined and differs from the date of issue of the invoice, according to the tax directive.
Date, YYYY-MM-DD
14
Invoice period start
invoicePeriod.start
IBT-073
Conditional — for period or continuous-supply billing
The date when the Invoice period starts.
Date, YYYY-MM-DD
15
Invoice period end
invoicePeriod.end
IBT-074
Conditional — for period or continuous-supply billing
The date when the Invoice period ends.
Date, YYYY-MM-DD; on or after the period start
16
Billing frequency
invoicePeriod.billingFrequency
btae-06
Conditional — for continuous supply
The frequency at which the billing is done (Daily, Weekly etc.).
DLY Daily; WKY Weekly; Q15 Every 15 days; MTH Monthly; Q45 Every 45 days; Q60 Every 60 days; QTR Quarterly; YRL Yearly; HYR Half-yearly; OTH Other
References
#
field name
API key
business term
Required
description
accepted values
17
Purchase order reference
references.purchaseOrder
ibt-013
optional
An identifier of a referenced purchase order, issued by the Buyer.
Free text; e.g. PO-2026-0457
18
Sales order reference
references.salesOrder
ibt-014
optional
An identifier of a referenced sales order issued by the Seller.
Free text; used on self-billed invoices
19
Contract reference
references.contract
IBT-012
Conditional — when a contract exists
The identification of a contract.
Free text; e.g. CTR-2026-0042
20
Contract value
references.contractValue
btae-05
Conditional — when a contract reference is given
The value of the contract.
Decimal amount, 2 decimals
21
Project reference
references.project
IBT-011
optional
The identification of the project the invoice refers to.
Free text
22
Receiving advice reference
references.receipt
IBT-015
optional
An identifier of a referenced receiving advice.
Free text
23
Despatch advice reference
references.despatchAdvice
ibt-016
optional
An identifier of a referenced despatch advice.
Free text
Preceding invoice and credit note
#
field name
API key
business term
Required
description
accepted values
24
Original invoice reference
precedingInvoice.invoiceNo
ibt-025
Conditional — required for credit notes (381, 81)
The identification of an Invoice that was previously sent by the Seller.
Invoice number of the document being corrected or credited
25
Original invoice issue date
precedingInvoice.issueDate
ibt-026
optional
The date when the Preceding Invoice was issued.
Date, YYYY-MM-DD
26
Credit note reason code
creditNoteReasonCode
btae-03
Conditional — required for credit notes (381)
A code specifying the reason for the credit note as a whole.
DL8.61.1.A Supply was cancelled; DL8.61.1.B Tax treatment changed; DL8.61.1.C Consideration was altered; DL8.61.1.D Goods or services returned; DL8.61.1.E Tax charged in error; VD Volume discount
27
Credit note reason
creditNoteReasonText
--
optional
Free-text explanation of the credit note reason, alongside the code (form).
Free text
Delivery details
#
field name
API key
business term
Required
description
accepted values
28
Delivery date
delivery.date
ibt-072
optional
The date on which the supply of goods or services was made or completed. The form maps both Supply date and Delivery date to IBT-072; only one should be sent.
Date, YYYY-MM-DD
29
deliver to
delivery.locationName
ibt-070
Conditional — when delivery details are given
The name of the party to which the goods and services are delivered.
Free text
30
Delivery address line 1
delivery.address.line1
IBT-075
Conditional — when a delivery address is given
The main address line in an address.
Free text
31
Delivery address line 2
delivery.address.line2
ibt-076
optional
An additional address line in an address that can be used to give further details supplementing the main line.
Free text
32
Delivery city
delivery.address.city
IBT-077
Conditional — when a delivery address is given
The common name of the city, town or village, where the deliver-to address is located.
Free text
33
Delivery Emirate / subdivision
delivery.address.countrySubdivision
IBT-079
Conditional — when a delivery address is given
The subdivision of a country, such as a region, a county, a state, a province etc.
Emirate code from the form list; e.g. AE-DU
34
Delivery postal code
delivery.address.postalCode
ibt-078
optional
The identifier for an addressable group of properties according to the relevant postal service.
Free text
35
Delivery country
delivery.address.countryCode
ibt-080
Conditional — when a delivery address is given
A code that identifies the country.
ISO 3166-1 alpha-2 code from the form list; e.g. AE
notes
#
field name
API key
business term
Required
description
accepted values
36
Notes / remarks
note
ibt-022
optional
A textual note that gives unstructured information that is relevant to the Invoice as a whole.
Free text
Parties — Seller
The seller block mixes root-level keys (sellerRegisteredName, sellerTaxIdentifier, address and contact) with a nested seller object for the electronic address, TIN, registration authority, passport country and address line 3.
identity
#
field name
API key
business term
Required
description
accepted values
37
Seller name
seller.registeredName
iBT-027
FTA mandatory
The full formal name by which the Seller is registered in the national registry of legal entities or as a taxable person or otherwise trades as a person or persons.
Free text
38
Seller trading name
seller.tradingName
ibt-028
Conditional — when it differs from the registered name
A name by which the Seller is known, other than Seller name (also known as Business name).
Free text
39
Electronic address
seller.electronicAddress.id
IBT-034
FTA mandatory
Identifies the Seller's electronic address to which the application level response to the invoice may be delivered.
Peppol participant ID; filled from the seller TIN when left blank
40
Address scheme
seller.electronicAddress.schemeId
IBT-034-1
FTA mandatory
The scheme identifier shall be chosen from a list to be maintained by the Connecting Europe Facility.
ISO/IEC 6523 ICD; 0235 (UAE TIN) is the default for UAE participants
registration & tax
#
field name
API key
business term
Required
description
accepted values
41
Seller VAT / TRN
seller.taxIdentifier.id
ibt-031
FTA mandatory— leave blank only for invoice types 480 and 81
The Seller's VAT identifier (also known as Seller tax identification number). Suppliers in the UAE registered under VAT should provide the Tax Registration Number (TRN).
15 digits, starting with 1 and ending with 03 (pattern ^1\d{12}03$)
42
VAT scheme
seller.taxIdentifier.schemeCode
ibt-031-1
FTA mandatory
The scheme of the tax identifier. Default value of VAT to be used.
VAT
43
Tax registration scheme
seller.taxRegistration.schemeId
--
optional
Scheme identifier for the seller TIN (form).
TAX
44
Seller TIN
seller.taxRegistration.id
IBT-032
FTA mandatory
The local identification (defined by the Seller's address) of the Seller for tax purposes or a reference that enables the Seller to state his registered tax status. Suppliers who do not have a TRN should give their Tax Identification Number (TIN).
10 digits (pattern ^\d{10}$); sellers without a TRN enter their corporate tax number
45
Legal registration ID
seller.legalRegistration.id
IBT-030
FTA mandatory— required when the electronic address scheme is 0235
An identifier issued by an official registrar that identifies the Seller as a legal entity or person.
Trade licence, Emirates ID, passport or Cabinet Decision number
46
Legal registration type
seller.legalRegistration.typeCode
btae-15
FTA mandatory — required when the electronic address scheme is 0235
To identify the nature of commercial registration number issued in UAE. It should be one of TL, EID, PAS or CD.
TL Commercial / Trade license; EID Emirates ID; PAS Passport; CD Cabinet Decision
47
registration authority
seller.legalRegistration.authorityName
btae-12
Conditional — required when the registration type is TL
To identify the authority which has issued the commercial/trade license.
Free text; e.g. Dubai Department of Economy and Tourism
48
Passport issuing country
seller.legalRegistration.passportIssuingCountryCode
btae-18
Conditional — required when the registration type is PAS
To identify the country which has issued the passport.
ISO 3166-1 alpha-2 code from the form list; disabled unless type is PAS
address
#
field name
API key
business term
Required
description
accepted values
49
Address line 1
seller.address.line1
ibt-035
FTA mandatory
The main address line in an address.
Free text
50
Address line 2
seller.address.line2
ibt-036
optional
An additional address line in an address that can be used to give further details supplementing the main line.
Free text
51
Address line 3
seller.address.line3
IBT-162
optional
An additional address line in an address that can be used to give further details supplementing the main line.
Free text
52
City
seller.address.city
ibt-037
FTA mandatory
The common name of the city, town or village, where the Seller address is located.
Free text
53
Emirate / subdivision
seller.address.countrySubdivision
IBT-039
FTA mandatory
The subdivision of a country, such as a region, a county, a state, a province etc.
Emirate code from the form list; e.g. AE-DU
54
Postal code
seller.address.postalCode
IBT-038
optional
The identifier for an addressable group of properties according to the relevant postal service.
Free text
55
Country code
seller.address.countryCode
ibt-040
FTA mandatory
A code that identifies the country.
ISO 3166-1 alpha-2 code from the form list; default AE
contact
#
field name
API key
business term
Required
description
accepted values
56
Contact person
seller.contact.name
ibt-041
optional
A contact point for a legal entity or person.
free text
57
Telephone
seller.contact.phone
ibt-042
optional
A phone number for the contact point.
Phone number; e.g. +971 4 555 0198
58
seller.contact.email
ibt-043
optional
An e-mail address for the contact point.
Valid e-mail address
Parties tab — Buyer
The buyer block follows the same split as the seller: root-level keys for name, TRN, address and contact, and a nested buyer object for the electronic address, buyer identifier, legal registration, passport country, address lines 2–3 and the free-trade-zone beneficiary.
identity
#
field name
API key
business term
Required
description
accepted values
59
Buyer name
buyer.registeredName
iBT-044
FTA mandatory
The full name of the Buyer.
Free text
60
Buyer trading name
buyer.tradingName
ibt-045
Conditional — when it differs from the registered name
A name by which the Buyer is known, other than Buyer name (also known as Business name).
Free text
61
Electronic address
buyer.electronicAddress.id
IBT-049
FTA mandatory
Identifies the Buyer's electronic address to which the application level response to the invoice may be delivered.
Peppol participant ID
62
Address scheme
buyer.electronicAddress.schemeId
IBT-049-1
FTA mandatory
The scheme identifier shall be chosen from a list to be maintained by the Connecting Europe Facility.
ISO/IEC 6523 ICD; 0235 (UAE TIN) is the default for UAE participants
63
Buyer reference
references.buyerReference
IBT-010
optional
An identifier assigned by the Buyer used for internal routing purposes.
Free text
registration & tax
#
field name
API key
business term
Required
description
accepted values
64
Buyer VAT / TRN
buyer.taxIdentifier.id
ibt-048
FTA mandatory — enter the TRN or the buyer identifier unless this is an export
The Buyer's VAT identifier (also known as Buyer tax identification number). Buyers in the UAE registered under VAT should provide the Tax Registration Number (TRN).
15 digits TRN
65
VAT scheme
buyer.taxIdentifier.schemeCode
ibt-048-1
FTA mandatory
The scheme of the tax identifier. Default value of VAT to be used.
VAT
66
Buyer identifier
buyer.identifier.id
ibt-046
Conditional — alternative to the TRN when the buyer is not VAT-registered
An identifier of the Buyer.
Free text identifier
67
Buyer identifier scheme
buyer.identifier.schemeId
IBT-046-1
Optional — with the buyer identifier
If used, the identification scheme shall be chosen from the entries of the list published by the ISO/IEC 6523 maintenance agency.
ISO/IEC 6523 ICD code
68
Legal registration ID
buyer.legalRegistration.id
IBT-047
FTA mandatory
An identifier issued by an official registrar that identifies the Buyer as a legal entity or person.
Trade licence, Emirates ID, passport or Cabinet Decision number
69
Legal registration type
buyer.legalRegistration.typeCode
btae-16
FTA mandatory
To identify the nature of commercial registration number issued in UAE. It should be one of TL, EID, PAS or CD.
TL Commercial / Trade license; EID Emirates ID; PAS Passport; CD Cabinet Decision
70
registration authority
buyer.legalRegistration.authorityName
btae-11
Conditional — required when the registration type is TL
To identify the authority which has issued the commercial/trade license.
Free text; e.g. Dubai Department of Economy and Tourism
71
Passport issuing country
buyer.legalRegistration.passportIssuingCountryCode
btae-19
Conditional — required when the registration type is PAS
To identify the country which has issued the passport.
ISO 3166-1 alpha-2 code from the form list; disabled unless type is PAS
address
#
field name
API key
business term
Required
description
accepted values
72
Address line 1
buyer.address.line1
ibt-050
FTA mandatory
The main address line in an address.
Free text
73
Address line 2
buyer.address.line2
ibt-051
optional
An additional address line in an address that can be used to give further details supplementing the main line.
Free text
74
Address line 3
buyer.address.line3
IBT-163
optional
An additional address line in an address that can be used to give further details supplementing the main line.
Free text
75
City
buyer.address.city
ibt-052
FTA mandatory
The common name of the city, town or village, where the Seller address is located.
Free text
76
Emirate / subdivision
buyer.address.countrySubdivision
IBT-054
FTA mandatory
The subdivision of a country, such as a region, a county, a state, a province etc.
Emirate code from the form list; e.g. AE-DU, AE-AZ
77
Postal code
buyer.address.postalCode
IBT-053
optional
The identifier for an addressable group of properties according to the relevant postal service.
Free text
78
Country code
buyer.address.countryCode
ibt-055
FTA mandatory
A code that identifies the country.
ISO 3166-1 alpha-2 code from the form list; default AE
contact
#
field name
API key
business term
Required
description
accepted values
79
Contact person
buyer.contact.name
ibt-056
optional
A contact point for a legal entity or person.
free text
80
Telephone
buyer.contact.phone
ibt-057
optional
A phone number for the contact point.
Phone number; e.g. +971 4 555 0198
81
buyer.contact.email
ibt-058
optional
An e-mail address for the contact point.
Valid e-mail address
Beneficiary (free trade zone supplies)
#
field name
API key
business term
Required
description
accepted values
82
Beneficiary ID
beneficialRecipient.id
btae-01
Conditional — required when flag 1 (Free trade zone) is set
In case of free trade zone supply, the declaration regarding the beneficiary of such supplies. The TRN or TIN of the beneficiary is required to be provided.
15-digit TRN or 10-digit TIN
83
Beneficial recipient name
beneficialRecipient.name
--
optional
Name of the beneficial recipient of a free-trade-zone supply (form).
Free text
84
Beneficial recipient address
Beneficial recipient address
--
optional
Address of the beneficial recipient of a free-trade-zone supply (form).
Free text, single line
Where Anyone Can Be an Accountant. We Make E-Invoicing Easy.
© 2026 DocFlow. All rights reserved.