UAE e-invoice mandatory fields

What a PINT AE invoice must carry, field by field: the IBT or BTAE id, the UBL element, when it is required and the rule that checks it. Read from the rules OpenPeppol publishes for PINT AE 1.0.4, as they test

Reading the table

An ordinary tax invoice in AED needs the 40 fields marked Always, the ones OpenPeppol's own mandatory fields example carries. The others become required in a case the column names: a credit note, an invoice in another currency, an exempt or reverse charge line, or a transaction type flagged in BTAE-02.

Element paths are an invoice's, under the element named at the start of each table. A credit note has cbc:CreditNoteTypeCode, cac:CreditNoteLine and cbc:CreditedQuantity in their place. Each rule id links to its page, with its message and the XPath test it runs.

BTAE-02, the invoice transaction type code in cbc:ProfileExecutionID, is eight flags of 0 or 1, in this order: free trade zone, deemed supply, margin scheme, summary invoice, continuous supplies, disclosed agent billing, e-commerce, exports. An ordinary invoice is 00000000, an export 00000001.

Document

Field Element Required Rules
IBT-024
Specification identifier
cbc:CustomizationID
urn:peppol:pint:billing-1@ae-1
Always ibr-001
aligned-ibrp-001-ae
IBT-023
Business process
cbc:ProfileID
urn:peppol:bis:billing
Always ibr-076
aligned-ibrp-002-ae
BTAE-02
Invoice transaction type code
cbc:ProfileExecutionID
Eight flags of 0 or 1, 00000000 for an ordinary invoice
Always ibr-154-ae
IBT-001
Invoice number
cbc:ID Always ibr-002
BTAE-07
Unique identifier
cbc:UUID Always ibr-193-ae
IBT-002
Invoice issue date
cbc:IssueDate Always ibr-003
IBT-003
Invoice type code
cbc:InvoiceTypeCode
380 tax invoice, 480 out of scope of VAT, 381 credit note
Always ibr-004
IBT-005
Invoice currency code
cbc:DocumentCurrencyCode Always ibr-005
IBT-009
Payment due date
cbc:DueDate When the amount due (IBT-115) is above zero, except in a credit note (381, 81, 261) and a deemed supply ibr-127-ae
BTAE-04
Currency exchange rate
cac:TaxExchangeRate/cbc:CalculationRate
Up to 6 decimals
When the invoice currency is not AED ibr-159-ae
ibr-002-ae
IBT-111
Invoice total VAT amount in AED
cac:TaxTotal/cbc:TaxAmount[@currencyID='AED'] When the invoice currency is not AED and the tax accounting currency (IBT-006) is AED ibr-175-ae
ibr-053
BTAE-20
Invoice total amount with VAT in AED
cac:AdditionalDocumentReference[cbc:DocumentTypeCode='aedtotal-incl-vat']/cbc:DocumentDescription When the invoice currency is not AED and the tax accounting currency (IBT-006) is AED ibr-175-ae
IBT-025
Preceding invoice reference
cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID In a credit note (381 or 81), unless its reason code (BTAE-03) is VD ibr-055-ae
ibr-055
BTAE-03
Credit note reason code
cac:DiscrepancyResponse/cbc:ResponseCode In a credit note (381) ibr-158-ae
ibr-001-ae
IBT-022
Invoice note
cbc:Note When the frequency of billing (BTAE-06) is OTH ibr-160-ae

Seller

Under cac:AccountingSupplierParty/cac:Party

Field Element Required Rules
IBT-027
Seller name
cac:PartyLegalEntity/cbc:RegistrationName Always ibr-006
IBT-034
Seller electronic address
cbc:EndpointID Always ibr-081
IBT-034-1
Its scheme identifier
cbc:EndpointID/@schemeID
0235 for a UAE TIN
Always ibr-062
IBT-035
Seller address line 1
cac:PostalAddress/cbc:StreetName Always ibr-143-ae
IBT-037
Seller city
cac:PostalAddress/cbc:CityName Always ibr-143-ae
IBT-039
Seller country subdivision
cac:PostalAddress/cbc:CountrySubentity
In the UAE the emirate: AUH, DXB, SHJ, UAQ, FUJ, AJM or RAK
Always ibr-143-ae
ibr-128-ae
IBT-040
Seller country code
cac:PostalAddress/cac:Country/cbc:IdentificationCode Always ibr-009
IBT-031
Seller VAT identifier (TRN)
cac:PartyTaxScheme/cbc:CompanyID
15 digits, starting with 1 and ending with 03
Except when the invoice type code is 480 (out of scope of VAT) or 81 ibr-134-ae
ibr-132-ae
IBT-030
Seller legal registration identifier
cac:PartyLegalEntity/cbc:CompanyID When the electronic address scheme (IBT-034-1) is 0235 ibr-150-ae
BTAE-15
Its identifier type
cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyID
TL trade licence, EID Emirates ID, PAS passport, CD cabinet decision
With IBT-030, when IBT-034-1 is 0235 ibr-181-ae
ibr-173-ae
BTAE-12
Authority name
cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyName When BTAE-15 is TL ibr-172-ae
BTAE-18
Passport issuing country
cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyName
ISO 3166-1 country code
When BTAE-15 is PAS ibr-012-ae
ibr-013-ae

Buyer

Under cac:AccountingCustomerParty/cac:Party

Field Element Required Rules
IBT-044
Buyer name
cac:PartyLegalEntity/cbc:RegistrationName Always ibr-007
IBT-049
Buyer electronic address
cbc:EndpointID Always ibr-080
IBT-049-1
Its scheme identifier
cbc:EndpointID/@schemeID Always ibr-063
IBT-050
Buyer address line 1
cac:PostalAddress/cbc:StreetName Always ibr-144-ae
IBT-052
Buyer city
cac:PostalAddress/cbc:CityName Always ibr-144-ae
IBT-054
Buyer country subdivision
cac:PostalAddress/cbc:CountrySubentity
The emirate when the country is AE
Always ibr-144-ae
ibr-128-ae
IBT-055
Buyer country code
cac:PostalAddress/cac:Country/cbc:IdentificationCode Always ibr-011
IBT-048
Buyer VAT identifier (TRN)
cac:PartyTaxScheme/cbc:CompanyID
15 digits, starting with 1 and ending with 03
When IBT-049-1 is 0235 and the electronic address does not start with 1 or 9; and when a line is reverse charge (AE) ibr-149-ae
ibr-135-ae
ibr-103-ae
IBT-047
Buyer legal registration identifier
cac:PartyLegalEntity/cbc:CompanyID When the invoice type code is 480 or the credit note type code 81 ibr-136-ae
BTAE-16
Its identifier type
cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyID
TL, CL, EID, PAS or CD
With IBT-047, when IBT-049-1 is 0235 ibr-180-ae
ibr-183-ae
BTAE-11
Authority name
cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyName When BTAE-16 is TL ibr-101-ae
BTAE-19
Passport issuing country
cac:PartyLegalEntity/cbc:CompanyID/@schemeAgencyName
ISO 3166-1 country code
When BTAE-16 is PAS ibr-010-ae
ibr-011-ae

Payment

Under cac:PaymentMeans

Field Element Required Rules
IBT-081
Payment means type code
cbc:PaymentMeansCode
30 credit transfer, 10 cash, 48 card, 55 debit card…
Except in a credit note (381, 81, 261) and a deemed supply ibr-191-ae
IBT-084
Payment account identifier
cac:PayeeFinancialAccount/cbc:ID
The IBAN
When the payment means code is 30 (credit transfer) ibr-192-ae

Totals

Under cac:LegalMonetaryTotal

Field Element Required Rules
IBT-106
Sum of invoice line net amounts
cbc:LineExtensionAmount Always ibr-012
IBT-109
Invoice total amount without VAT
cbc:TaxExclusiveAmount Always ibr-013
IBT-112
Invoice total amount with VAT
cbc:TaxInclusiveAmount Always ibr-014
IBT-115
Amount due for payment
cbc:PayableAmount Always ibr-015

VAT breakdown, one per category and rate

Under cac:TaxTotal/cac:TaxSubtotal

Field Element Required Rules
IBT-116
VAT category taxable amount
cbc:TaxableAmount Always aligned-ibrp-045
IBT-117
VAT category tax amount
cbc:TaxAmount Always aligned-ibrp-046
IBT-118
VAT category code
cac:TaxCategory/cbc:ID
S, Z, E, O, AE or N
Always aligned-ibrp-047
IBT-119
VAT category rate
cac:TaxCategory/cbc:Percent Except for E (exempt) and O (out of scope) aligned-ibrp-048
ibr-119-ae

Each invoice line

Under cac:InvoiceLine

Field Element Required Rules
IBT-126
Invoice line identifier
cbc:ID Always ibr-021
IBT-129
Invoiced quantity
cbc:InvoicedQuantity Always ibr-022
IBT-130
Unit of measure code
cbc:InvoicedQuantity/@unitCode Always ibr-023
IBT-131
Invoice line net amount
cbc:LineExtensionAmount Always ibr-024
ibr-147-ae
IBT-153
Item name
cac:Item/cbc:Name Always ibr-025
IBT-154
Item description
cac:Item/cbc:Description Always ibr-125-ae
IBT-151
Invoiced item VAT category code
cac:Item/cac:ClassifiedTaxCategory/cbc:ID Always ibr-sr-58
ibr-145-ae
IBT-152
Invoiced item VAT rate
cac:Item/cac:ClassifiedTaxCategory/cbc:Percent Except for E (exempt) and O (out of scope) aligned-ibrp-s-05
aligned-ibrp-z-05
aligned-ibrp-ae-05-ae
IBT-146
Item net price
cac:Price/cbc:PriceAmount Always ibr-026
IBT-149
Item price base quantity
cac:Price/cbc:BaseQuantity Always ibr-126-ae
IBT-148
Item gross price
cac:Price/cac:AllowanceCharge/cbc:BaseAmount Always ibr-126-ae
aligned-ibrp-004
BTAE-10
Invoice line amount payable in AED
cac:ItemPriceExtension/cbc:Amount
The line amount with VAT
Always ibr-194-ae
ibr-104-ae
BTAE-08
VAT line amount in AED
cac:ItemPriceExtension/cac:TaxTotal/cbc:TaxAmount
Zero for Z and AE
Unless the line is exempt (E), where it must be left out ibr-104-ae
ibr-163-ae
IBT-186
VAT exemption reason code
cac:Item/cac:ClassifiedTaxCategory/cbc:TaxExemptionReasonCode When the line is exempt (E) ibr-167-ae
IBT-158
Item classification identifier
cac:Item/cac:CommodityClassification/cbc:ItemClassificationCode
An HS code, listID="HS"
When the item type (BTAE-13, cbc:CommodityCode) is G (goods) or B (both) ibr-184-ae
ibr-186-ae
ibr-188-ae
BTAE-17
Service accounting code
cac:Item/cac:AdditionalItemIdentification/cbc:ID
schemeID="SAC"
When the item type (BTAE-13) is S (services) or B (both) ibr-185-ae
ibr-186-ae
ibr-189-ae
BTAE-09
Type of goods or services
cac:Item/cac:CommodityClassification/cbc:NatureCode
A code of the reverse charge list, such as DL8.48.3.1
When the line is reverse charge (AE) ibr-166-ae
ibr-006-ae
IBT-157
Item standard identifier
cac:Item/cac:StandardItemIdentification/cbc:ID
schemeID="0160" (GTIN)
When the line is reverse charge (AE) ibr-174-ae

Each document level allowance or charge

In each allowance or charge the invoice has, under cac:AllowanceCharge

Field Element Required Rules
IBT-092
Allowance or charge amount (IBT-099)
cbc:Amount Always ibr-031
ibr-036
IBT-097
Reason or reason code (IBT-098, IBT-104, IBT-105)
cbc:AllowanceChargeReason
Either the text or cbc:AllowanceChargeReasonCode
Always ibr-033
ibr-038
IBT-095
VAT category code (IBT-102)
cac:TaxCategory/cbc:ID
Not N
Always aligned-ibrp-032
aligned-ibrp-037
ibr-114-ae
ibr-115-ae
IBT-098
Reason code (IBT-105)
cbc:AllowanceChargeReasonCode When the VAT category is E (exempt) ibr-168-ae
ibr-169-ae

By transaction type (BTAE-02)

Field Element Required Rules
BTAE-01
Beneficiary ID
cac:BuyerCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID Free trade zone: 1XXXXXXX ibr-007-ae
IBG-14
Invoicing period
cac:InvoicePeriod Summary invoice: XXX1XXXX ibr-138-ae
BTAE-14
Principal ID
cac:SellerSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID Disclosed agent billing: XXXXX1XX ibr-137-ae
ibr-176-ae
IBT-075
Deliver to address line 1, city and subdivision (IBT-077, IBT-079)
cac:Delivery/cac:DeliveryLocation/cac:Address/cbc:StreetName
With cbc:CityName and cbc:CountrySubentity
E-commerce: XXXXXX1X; exports outside the UAE: XXXXXXX1 ibr-142-ae
ibr-152-ae

Where a rule says more than it checks

A few PINT AE 1.0.4 rules test less than their message says, and this page lists what they test, which is what a validator running them reports:

  • ibr-149-ae speaks of the buyer legal registration identifier (IBT-047), but tests for the buyer VAT identifier (IBT-048, cac:PartyTaxScheme/cbc:CompanyID).
  • ibr-177-ae, "either the seller tax registration identifier or the seller VAT identifier", is tested only for disclosed agent billing; ibr-134-ae asks for the seller VAT identifier on every other invoice.
  • ibr-123-ae, "line VAT information must be there", checks only that a line of an out of scope invoice (480) or an 81 credit note has one VAT category; ibr-145-ae requires the category on every line.
  • A VAT breakdown without its taxable amount (IBT-116) is never reported by aligned-ibrp-045: for a standard rated breakdown, aligned-ibrp-s-08 reads the missing amount first and the rules stop with an XPath error, which validators show as the rules failing to run.
  • ibr-168-ae and ibr-169-ae name a VAT exemption reason code for an exempt allowance or charge, and test for its reason code, cbc:AllowanceChargeReasonCode.

Your Accredited Service Provider may check more than the rules do, such as what the Federal Tax Authority holds about the parties. The validator runs these rules and the UBL schema on a file in your browser.

Questions

How many mandatory fields does a UAE e-invoice have?

By the PINT AE rules, an ordinary tax invoice in AED needs 40 fields on every invoice, counting each address line and attribute, and every line and VAT breakdown repeats its own. Credit notes, other currencies, exempt or reverse charge lines and the special transaction types add the conditional ones.

Where does this list come from?

From the rules OpenPeppol publishes for PINT AE 1.0.4, read for what each one tests: the PINT Billing rules in the form the PINT AE package ships them, and the UAE rules. Where a rule's message and its test differ, this page follows the test, as a validator does.

Does a file with all these fields pass?

Not by itself: the values have to be right too. TRNs must have 15 digits starting with 1 and ending with 03, amounts must add up, and codes must come from the code lists. Check the file in the validator for all of that.

Is this the same for self-billing?

Nearly: a self-billed invoice uses urn:peppol:pint:selfbilling-1@ae-1 and urn:peppol:bis:selfbilling, type codes 389 and 261, and the same UAE rules.