Try in playground

PINT AE data dictionary: UAE fields

The PINT AE data dictionary as GETS fields: every field a UAE document can carry, the mandatory fields, the values each accepts, and the PINT AE business term it fills.

UAE e-invoices follow PINT AE 1.0.4, the UAE specification on the Peppol network. You send GETS, and Complyance produces the PINT AE document.

  • Field is the name the Integration engine shows. Business term is the PINT AE term the field fills; a field without one has no PINT AE term of its own.
  • Requirement covers tax invoices, credit notes and every modifier. Mandatory fields are always required and optional ones never are. Conditional fields are required only when the condition in their description is met.
  • Enums are the values the field accepts. Hover over a value to see what it means.

Payload fields

382 fields · conditional fields are required only when the condition in their description is met

DescriptionEnums
Document NumberInvoice numberMandatorystringUnique document number
Issue DateInvoice issue dateMandatorydateDocument issue date
Invoice CurrencyInvoice currency codeMandatorystringDocument currency
Currency: 177 codes
Tax Accounting CurrencyTax accounting currencyConditionalstringTax currency (often same as document currency) Required when currency ≠ AED
Currency: 177 codes
Due DatePayment due dateConditionaldatePayment due date Mandatory for tax invoices; optional for credit notes. With the deemed_supply modifier: optional for tax invoices. UAE PINT-AE IBT-009UAE PINT-AE IBR-127-AE exempts credit notes from the payment due date requirementUAE PINT-AE IBR-127-AE exempts deemed supply from payment due date
Additional NotesInvoice noteOptionalstringA textual note that gives unstructured information that is relevant to the Invoice as a whole.
Reference IDPreceding Invoice referenceConditionalstringOriginal invoice reference ID Mandatory for credit notes; optional for tax invoices. Credit note requires original invoice reference
Invoice Period StartInvoicing period start dateConditionaldateStart date of the invoiced period Conditional with the summary modifier. UAE PINT-AE IBR-138-AE requires an invoicing period for summary invoices
Invoice Period EndInvoicing period end dateConditionaldateEnd date of the invoiced period Conditional with the summary modifier. UAE PINT-AE IBR-138-AE requires an invoicing period for summary invoices
Document BaseMandatorystringThe base document type, such as tax_invoice or credit_note. Each country’s values are listed under Enums on its fields page.
tax_invoiceTax invoicecredit_noteCredit note
Exchange RateConditionalnumberExchange rate when currency differs from tax currency Required when currency ≠ AED
Invoice Period FrequencyConditionalstringFrequency of the billing period (monthly, weekly, etc.) Conditional with the summary modifier. UAE PINT-AE IBR-138-AE requires an invoicing period for summary invoices
DAILYDailyWEEKLYWeeklyONCE_IN_15_DAYSOnce in 15 daysMONTHLYMonthlyONCE_IN_45_DAYSOnce in 45 daysONCE_IN_60_DAYSOnce in 60 days
Document IDOptionalstringInternal system document identifier (UUID or database ID)
Document ModifiersOptionalarrayModifiers that apply to the document, such as export. Send [] when none apply. Each country’s values are listed under Enums on its fields page.
free_trade_zoneFree trade zonedisclosed_agentDisclosed agente_commerceE-commerceexportExportreverse_chargeReverse chargecontinuous_supplyContinuous supplydeemed_supplyDeemed supplysummarySummarymargin_schemeMargin schemeself_billedSelf billedout_of_scopeOut of scope
Document VariantOptionalstringLeave it out: the UAE has no document variants.
Exchange Rate DateOptionaldateExchange rate date
Issue TimeOptionalstringTime the document was issued, as hh:mm:ss.
Note Issuance ReasonOptionalstringReason for credit/debit note
Reference NumbersOptionalarrayReference to original invoice (notes)
Seller Registration TypeSeller legal registration identifier typeMandatorystringSeller registration type
Seller NameSeller nameSeller trading nameMandatorystringSeller company name
Seller Party IDSeller identifierOptionalstringSeller internal party ID
Seller Registration ValueSeller legal registration identifierMandatorystringAn identifier issued by an official registrar that identifies the Seller as a legal entity or person.
Seller Tax ID ValueSeller VAT identifierSeller tax registration identifierConditionalstringSeller tax ID value Optional with the out_of_scope modifier. UAE PINT-AE IBR-134-AE does not require Seller VAT identifier for out-of-scope invoices
Seller Tax ID TypeTax scheme codeMandatorystringThe scheme of the TAX identifier.
Seller Peppol IDSeller electronic addressMandatorystringSeller's Peppol network identifier for Peppol delivery
Seller Address Line 1Seller address line 1MandatorystringThe main address line in an address. UAE address requirement
Seller Address Line 2Seller address line 2OptionalstringAn additional address line in an address that can be used to give further details supplementing the main line.
Seller CitySeller cityMandatorystringThe common name of the city, town or village, where the Seller address is located.
Seller Postal CodeSeller post codeOptionalstringThe identifier for an addressable group of properties according to the relevant postal service.
Seller State/ProvinceSeller country subdivisionMandatorystringThe subdivision of a country. Such as a region, a county, a state, a province etc.. UAE emirate required
Only when the country is AE. AUHAbu DhabiDXBDubaiSHJSharjahUAQUmm Al QuwainFUJFujairahAJMAjmanRAKRas Al Khaimah
Seller CountrySeller country codeMandatorystringSeller country code
Country: 251 codes
Seller Contact NameSeller contact pointOptionalstringA contact point for a legal entity or person.
Seller Contact PhoneSeller contact telephone numberOptionalstringA phone number for the contact point.
Seller Contact EmailSeller contact email addressOptionalstringAn e-mail address for the contact point.
Seller Access Code BuildingOptionalstringseller access code building
Seller Access Code GateOptionalstringseller access code gate
Seller Access Code IntercomOptionalstringseller access code intercom
Seller Address TypeOptionalstringseller address type
Seller Address UsageOptionalstringseller address usage
Seller ApartmentOptionalstringseller apartment
Seller Attention ToOptionalstringseller attention to
Seller Building NameOptionalstringseller building name
Seller Building NumberOptionalstringSeller building number
Seller Business Hours CloseOptionalstringseller business hours close
Seller Business Hours DaysOptionalarrayseller business hours days
Seller Business Hours OpenOptionalstringseller business hours open
Seller Care OfOptionalstringseller care of
Seller Delivery InstructionsOptionalstringseller delivery instructions
Seller Delivery PointOptionalstringseller delivery point
Seller DistrictOptionalstringSeller district
Seller FloorOptionalstringseller floor
Seller Geo Location LatitudeOptionalnumberseller geo location latitude
Seller Geo Location LongitudeOptionalnumberseller geo location longitude
Seller LandmarkOptionalstringseller landmark
Seller Plus CodeOptionalstringseller plus code
Seller PO BoxOptionalstringseller po box
Seller Post OfficeOptionalstringseller post office
Seller Room NumberOptionalstringseller room number
Seller Street NameOptionalstringseller street name
Seller Street NumberOptionalstringseller street number
Seller Sub DistrictOptionalstringseller sub district
Seller Time ZoneOptionalstringseller time zone
Seller Valid FromOptionaldateseller valid from
Seller Valid ToOptionaldateseller valid to
Seller Verification DateOptionaldateseller verification date
Seller Verification SourceOptionalstringseller verification source
Seller VerifiedOptionalstringseller verified
Seller WardOptionalstringseller ward
Seller What Three WordsOptionalstringseller what three words
Seller ZoneOptionalstringseller zone
Seller Address Line 3OptionalstringSeller address line 3
Seller Business ActivityOptionalstringSeller business activity
Seller Industry Classification CodeOptionalstringIndustry classification code
Seller Industry Classification DescriptionOptionalstringIndustry classification description
Seller Industry Classification SchemeOptionalstringIndustry classification scheme
Seller Trade NameOptionalstringSeller trade name
Buyer Registration TypeBuyer legal registration identifier typeMandatorystringBuyer registration type
Buyer NameBuyer nameBuyer trading nameMandatorystringBuyer company/name
Buyer Party IDBuyer identifierOptionalstringBuyer internal party ID
Buyer Registration ValueBuyer legal registration identifierMandatorystringAn identifier issued by an official registrar that identifies the Buyer as a legal entity or person.
Buyer Tax ID ValueBuyer VAT identifierConditionalstringThe buyer’s tax identifier. A buyer in the UAE that is registered for VAT gives its Tax Registration Number (TRN). Optional with the export modifier. Mandatory with the reverse_charge modifier. UAE TRN for B2B buyersUAE TRN optional for export buyersRCM requires buyer TRN
Buyer Tax ID TypeTax scheme codeOptionalstringThe scheme of the TAX identifier.
Buyer Peppol IDBuyer electronic addressMandatorystringBuyer's Peppol network identifier for Peppol delivery
Buyer Address Line 1Buyer address line 1MandatorystringThe main address line in an address. UAE address requirement
Buyer Address Line 2Buyer address line 2OptionalstringAn additional address line in an address that can be used to give further details supplementing the main line.
Buyer CityBuyer cityMandatorystringThe common name of the city, town or village, where the Buyer’s address is located. UAE address requirement
Buyer Postal CodeBuyer post codeOptionalstringThe identifier for an addressable group of properties according to the relevant postal service.
Buyer State/ProvinceBuyer country subdivisionMandatorystringThe subdivision of a country. Such as a region, a county, a state, a province etc.. UAE emirate required
Only when the country is AE. AUHAbu DhabiDXBDubaiSHJSharjahUAQUmm Al QuwainFUJFujairahAJMAjmanRAKRas Al Khaimah
Buyer CountryBuyer country codeMandatorystringBuyer country code
Country: 251 codes
Buyer Contact NameBuyer contact pointOptionalstringA contact point for a legal entity or person.
Buyer Contact PhoneBuyer contact telephone numberOptionalstringA phone number for the contact point.
Buyer Contact EmailBuyer contact email addressOptionalstringAn e-mail address for the contact point.
Buyer Access Code BuildingOptionalstringbuyer access code building
Buyer Access Code GateOptionalstringbuyer access code gate
Buyer Access Code IntercomOptionalstringbuyer access code intercom
Buyer Address TypeOptionalstringbuyer address type
Buyer Address UsageOptionalstringbuyer address usage
Buyer ApartmentOptionalstringbuyer apartment
Buyer Attention ToOptionalstringbuyer attention to
Buyer Building NameOptionalstringbuyer building name
Buyer Building NumberOptionalstringBuyer building number
Buyer Business Hours CloseOptionalstringbuyer business hours close
Buyer Business Hours DaysOptionalarraybuyer business hours days
Buyer Business Hours OpenOptionalstringbuyer business hours open
Buyer Care OfOptionalstringbuyer care of
Buyer Delivery InstructionsOptionalstringbuyer delivery instructions
Buyer Delivery PointOptionalstringbuyer delivery point
Buyer DistrictOptionalstringBuyer district
Buyer FloorOptionalstringbuyer floor
Buyer Geo Location LatitudeOptionalnumberbuyer geo location latitude
Buyer Geo Location LongitudeOptionalnumberbuyer geo location longitude
Buyer LandmarkOptionalstringbuyer landmark
Buyer Plus CodeOptionalstringbuyer plus code
Buyer PO BoxOptionalstringbuyer po box
Buyer Post OfficeOptionalstringbuyer post office
Buyer Room NumberOptionalstringbuyer room number
Buyer Street NameOptionalstringbuyer street name
Buyer Street NumberOptionalstringbuyer street number
Buyer Sub DistrictOptionalstringbuyer sub district
Buyer Time ZoneOptionalstringbuyer time zone
Buyer Valid FromOptionaldatebuyer valid from
Buyer Valid ToOptionaldatebuyer valid to
Buyer Verification DateOptionaldatebuyer verification date
Buyer Verification SourceOptionalstringbuyer verification source
Buyer VerifiedOptionalstringbuyer verified
Buyer WardOptionalstringbuyer ward
Buyer What Three WordsOptionalstringbuyer what three words
Buyer ZoneOptionalstringbuyer zone
Buyer Address Line 3OptionalstringBuyer address line 3
Buyer Business ActivityOptionalstringBuyer business activity
Buyer Industry Classification CodeOptionalstringBuyer industry code
Buyer Industry Classification DescriptionOptionalstringBuyer industry description
Buyer Industry Classification SchemeOptionalstringBuyer industry scheme
Buyer Trade NameOptionalstringBuyer trade name
IncotermsIncotermsOptionalstringDelivery terms (Incoterms)
Delivery Address Line 1Deliver to address line 1ConditionalstringThe main address line in an address. Mandatory with the e_commerce or export modifier. E-commerce deliveryExport delivery
Delivery CityDeliver to cityConditionalstringThe common name of the city, town or village, where the deliver to address is located. Mandatory with the e_commerce or export modifier. E-commerce deliveryExport delivery
Delivery Post CodeDeliver to post codeOptionalstringPostal code for delivery address
Delivery Country SubdivisionDeliver to country subdivisionConditionalstringState, emirate or province for delivery address Mandatory with the e_commerce or export modifier. E-commerce deliveryExport delivery
Only when the country is AE. AUHAbu DhabiDXBDubaiSHJSharjahUAQUmm Al QuwainFUJFujairahAJMAjmanRAKRas Al Khaimah
Delivery CountryDeliver to country codeConditionalstringA code that identifies the country. Mandatory with the e_commerce or export modifier. E-commerce deliveryExport delivery
Country: 251 codes
Delivery Access Code BuildingOptionalstringdelivery access code building
Delivery Access Code GateOptionalstringdelivery access code gate
Delivery Access Code IntercomOptionalstringdelivery access code intercom
Delivery Address TypeOptionalstringdelivery address type
Delivery Address UsageOptionalstringdelivery address usage
Delivery ApartmentOptionalstringdelivery apartment
Delivery Attention ToOptionalstringdelivery attention to
Delivery Building NameOptionalstringdelivery building name
Delivery Building NumberOptionalstringdelivery building number
Delivery Business Hours CloseOptionalstringdelivery business hours close
Delivery Business Hours DaysOptionalarraydelivery business hours days
Delivery Business Hours OpenOptionalstringdelivery business hours open
Delivery Care OfOptionalstringdelivery care of
Delivery Delivery InstructionsOptionalstringdelivery delivery instructions
Delivery Delivery PointOptionalstringdelivery delivery point
Delivery DistrictOptionalstringdelivery district
Delivery FloorOptionalstringdelivery floor
Delivery Geo Location LatitudeOptionalnumberdelivery geo location latitude
Delivery Geo Location LongitudeOptionalnumberdelivery geo location longitude
Delivery LandmarkOptionalstringdelivery landmark
Delivery Plus CodeOptionalstringdelivery plus code
Delivery PO BoxOptionalstringdelivery po box
Delivery Post OfficeOptionalstringdelivery post office
Delivery Room NumberOptionalstringdelivery room number
Delivery Street NameOptionalstringdelivery street name
Delivery Street NumberOptionalstringdelivery street number
Delivery Sub DistrictOptionalstringdelivery sub district
Delivery Time ZoneOptionalstringdelivery time zone
Delivery Valid FromOptionaldatedelivery valid from
Delivery Valid ToOptionaldatedelivery valid to
Delivery Verification DateOptionaldatedelivery verification date
Delivery Verification SourceOptionalstringdelivery verification source
Delivery VerifiedOptionalstringdelivery verified
Delivery WardOptionalstringdelivery ward
Delivery What Three WordsOptionalstringdelivery what three words
Delivery ZoneOptionalstringdelivery zone
Delivery Address Line 2OptionalstringAdditional delivery address line
Delivery Address Line 3OptionalstringThird delivery address line
Delivery Business ActivityOptionalstringDelivery business activity
Delivery Contact EmailOptionalstringDelivery contact email
Delivery Contact NameOptionalstringDelivery contact name
Delivery Contact PhoneOptionalstringDelivery contact phone
Actual Delivery DateOptionaldateActual delivery date
Actual Delivery TimeOptionalstringActual delivery time
Customs Declaration NumberOptionalstringcustoms declaration number
Destination PortOptionalstringDestination port
Export DateOptionaldateexport date
FreightOptionalstringfreight
Freight DocumentOptionalstringfreight document
Origin PortOptionalstringOrigin port
Special TermsOptionalstringspecial terms
Transport ModeOptionalstringtransport mode
Delivery Industry Classification CodeOptionalstringDelivery industry classification code
Delivery Industry Classification DescriptionOptionalstringDelivery industry classification description
Delivery Industry Classification SchemeOptionalstringDelivery industry classification scheme
Delivery Party NameOptionalstringDelivery party name
Delivery Party IDOptionalstringIdentifier for delivery party
Delivery Peppol IDOptionalstringDelivery party's Peppol network identifier
Deliver to Legal Registration TypeOptionalstringType of registration for delivery party
Deliver to Legal RegistrationOptionalstringRegistration number for delivery party
Delivery Tax ID TypeOptionalstringDelivery tax ID type
Delivery Tax ID ValueOptionalstringDelivery tax ID value
Delivery Trade NameOptionalstringDelivery party trade name
Line Item IDInvoice line identifierMandatorystringLine item identifier
Line Item QuantityInvoiced quantityMandatorynumberThe quantity of items (goods or services) that is charged in the Invoice line.
Line Item Unit CodeInvoiced quantity unit of measure codeItem price base quantity unit of measure codeMandatorystringUnit code (PCE, KGM, etc.)
Line Total Without TaxInvoice line net amountMandatorynumberNet line amount excluding VAT. Emitted as the UAE invoice line extension amount. UAE IBR-147-AE requires the IBT-131 invoice line net amount
Line Discount/Charge AmountInvoice line allowance amountInvoice line charge amountOptionalnumberDiscount/Charge amount
Line Discount/Charge Base AmountInvoice line allowance base amountInvoice line charge base amountOptionalnumberDiscount/Charge base amount
Line Discount/Charge PercentageInvoice line allowance percentageInvoice line charge percentageOptionalnumberDiscount/Charge percentage
Line Discount/Charge ReasonInvoice line allowance reasonInvoice line charge reasonOptionalstringDiscount/Charge reason
Line Discount/Charge Reason CodeInvoice line allowance reason codeInvoice line charge reason codeOptionalstringDiscount/Charge reason code
For allowances bonus_for_works_ahead_of_scheduleBonus for works ahead of scheduleother_bonusOther bonusmanufacturers_consumer_discountManufacturer's consumer discountdue_to_military_statusDue to military statusdue_to_work_accidentDue to work accidentspecial_agreementSpecial agreement
For charges
Item Net PriceItem net priceMandatorynumberNet unit price excluding VAT.
Item Gross PriceItem gross priceMandatorynumberUnit price before a price-level discount, excluding VAT. UAE PINT-AE IBR-126-AE requires Item Gross Price
Base QuantityItem price base quantityOptionalnumberThe number of item units to which the price applies.
Line Tax CategoryInvoiced item VAT category codeMandatorystringThe VAT category code for the invoiced item. UAE VAT category required per line
SStandard rateEExempt from taxOServices outside scope of tax / Not subject to taxAEVAT Reverse ChargeZZero ratedNStandard rate additional VAT
Line Tax RateInvoiced item VAT rateConditionalnumberThe VAT rate, represented as percentage that applies to the invoiced item. Conditional with the out_of_scope modifier. UAE VAT rate required per lineOut-of-scope invoices permit E/O lines without a VAT rate and Z lines with a zero rate (ALIGNED-IBRP-E-05, ALIGNED-IBRP-O-05, ALIGNED-IBRP-Z-05)
Line Item NameItem nameMandatorystringLine item name/description
Line Item DescriptionItem descriptionOptionalstringA description for an item.
Standard Item Code IDItem standard identifierConditionalstringAn item identifier based on a registered scheme. Mandatory with the reverse_charge modifier. RCM requires item classification
Standard Item Code SchemeScheme identifierConditionalstringThe identification scheme identifier of the Item standard identifier. Mandatory with the reverse_charge modifier. RCM requires item classification scheme
Identifier scheme: 243 codes
Commodity Classification SchemeScheme identifierConditionalstringThe identification scheme shall be chosen from the entries in UNTDID 7143 [6]. UAE PINT-AE IBR-188-AE requires the HS scheme when item classification is provided
Item classification scheme: 185 codes
Country Of OriginItem country of originOptionalstringThe code identifying the country from which the item originates.
Country: 251 codes
Tax Exemption ReasonVAT exemption reason textConditionalstringA textual statement of the reason why the line amount is exempted from VAT or why no VAT is being charged. Required for exempt/zero-rated lines
Tax Exemption Reason CodeVAT exemption reason codeConditionalstringA coded statement of the reason for why the line amount is exempted from VAT. Required for exempt/zero-rated lines
CERTAIN_FINANCIAL_SERVICESCertain financial servicesRESIDENTIAL_UNITSSupply of residential units (lease or sale)BARE_LANDBare landLOCAL_PASSENGER_TRANSPORTLocal passenger transport
Line Item Tax AmountMandatorynumberTax amount for the line item, excluding the net line amount.
Commodity Classification CodeConditionalstringCommodity classification code UAE PINT-AE IBR-184-AE and IBR-186-AE require item classification for goods and mixed items
Buyer Item CodeOptionalstringBuyer item code
Commodity Classification DescriptionOptionalstringCommodity classification description
Commodity CodeOptionalstringTariff/commodity code
Line Discount/Charge IDOptionalstringDiscount/Charge ID
Line Discount/Charge is ChargeOptionalbooleanIs charge or discount
Line Discount/Charge Tax AmountOptionalnumberDiscount/Charge tax amount
Line Discount/Charge Tax CategoryOptionalstringDiscount/Charge tax category
Line Discount/Charge Tax RateOptionalnumberDiscount/Charge tax rate
Line Total With TaxOptionalnumberTax-inclusive line amount. Calculated from the line total without tax and line tax amount when omitted. UAE BTAE-10 invoice line amount payable can be enriched from net amount plus VAT
Line TypeOptionalstringLine type
Base Quantity Unit CodeOptionalstringBase quantity unit code
Line Related Document TypeOptionalstringRelated document type
Line Related Document IDOptionalstringRelated document ID
Seller Item CodeOptionalstringSeller item code
VAT Line Amount in AEDVAT Line amount in AEDOptionalnumberVAT amount calculated in AED currency.
Line Amount in AEDInvoice line amount in AEDOptionalnumberInvoice line amount payable calculated in AED currency.
Item TypeItem typeConditionalstringGoods, Services, or Both; emitted as item CommodityCode G, S, or B.
GoodsServicesBoth
Service Accounting CodeService Accounting codeConditionalstringService accounting code, emitted as AdditionalItemIdentification/ID. Required for Services and Both items.
Service Accounting Code SchemeService Accounting code Scheme identifierConditionalstringMust be "SAC" when a service accounting code is provided.
Line NoteInvoice line noteOptionalstringFree text note for the line item.
Line Object IdentifierInvoice line object identifierOptionalstringObject identifier for the line item.
Line Object Identifier SchemeScheme identifierOptionalstringScheme for the line item object identifier.
Reference type: 818 codes
Order Line ReferenceReferenced purchase order line referenceOptionalstringReference to the corresponding order line.
Line Accounting ReferenceInvoice line Buyer accounting referenceOptionalstringAccounting reference for the line item.
Line Invoice Period StartInvoice line period start dateOptionaldateStart date of the invoiced period for this line.
Line Invoice Period EndInvoice line period end dateOptionaldateEnd date of the invoiced period for this line.
Item Price Allowance AmountItem price discountOptionalnumberItem-level allowance calculated from the gross and net prices.
Attribute NameItem attribute nameOptionalstringName of the line item attribute.
Attribute ValueItem attribute valueOptionalstringValue of the line item attribute.
Reverse Charge Mechanism TypeConditionalstringReverse charge mechanism type for goods/services. Required when the reverse_charge modifier is active or when taxCategory is AE. Mandatory with the reverse_charge modifier. RCM type required
ELECTRONIC_DEVICESGOLD_AND_DIAMONDSCRUDE_OR_REFINED_OILUNPROCESSED_OR_PROCESSED_NATURAL_GASPURE_HYDROCARBONS
Batch NumberOptionalstringUAE-specific batch ID. Used for inventory tracking and batch management.
Service Accounting Code Scheme VersionOptionalstringSAC scheme version. Version of the service accounting code scheme.
Line Buyer Accounting ReferenceOptionalstringBuyer accounting reference for the line item.
Commodity Classification VersionOptionalstringVersion of the commodity classification scheme.
Line Tax SchemeOptionalstringTax scheme for the line item (IBT-167). Typically VAT for Peppol/EN 16931 invoices.
Total Line Taxable AmountSum of Invoice line net amountMandatorynumberSum of line taxable values
Total AllowancesSum of allowances on document levelOptionalnumberSum of all allowances on document level in the Invoice.
Total ChargesSum of charges on document levelOptionalnumberSum of all charges on document level in the Invoice.
Total Amount Excluding TaxInvoice total amount without TAXMandatorynumberTotal excluding tax
Total Amount Including TaxInvoice total amount with TAXMandatorynumberTotal including tax
Prepaid AmountPaid amountOptionalnumberThe sum of amounts which have been paid in advance.
Rounding AmountRounding amountOptionalnumberRounding adjustment
Amount DueAmount due for paymentMandatorynumberThe outstanding amount that is requested to be paid.
Total Tax AmountMandatorynumberTotal tax amount
Tax Total AmountConditionalnumberTotal tax amount of the document. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Tax Subtotal PercentageConditionalnumberTax rate of this category, as a percentage. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Tax Subtotal Taxable AmountConditionalnumberSum of the taxable amounts in this tax category and rate. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Tax Subtotal AmountConditionalnumberTax amount for this tax category and rate. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Tax Subtotal CategoryConditionalstringTax category code of this part of the breakdown, such as S for the standard rate. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Tax Subtotal Exemption ReasonConditionalstringWhy this category is exempt from tax, as text. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Tax Subtotal Exemption Reason CodeConditionalstringWhy this category is exempt from tax, as a code. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
CERTAIN_FINANCIAL_SERVICESCertain financial servicesRESIDENTIAL_UNITSSupply of residential units (lease or sale)BARE_LANDBare landLOCAL_PASSENGER_TRANSPORTLocal passenger transport
Tax Subtotal SchemeOptionalstringTax scheme of this part of the breakdown, normally VAT. Optional as a group: if you leave taxTotals out, the VAT breakdown is calculated from the line items. A tax total you send needs its tax amount and, for each VAT category, the taxable amount, tax amount and category.
Invoice Discount/Charge AmountDocument level allowance amountDocument level charge amountOptionalnumberAllowance/charge amount
Invoice Discount/Charge Base AmountDocument level allowance base amountDocument level charge base amountOptionalnumberBase amount
Invoice Discount/Charge PercentageDocument level allowance percentageDocument level charge percentageOptionalnumberPercent applied
Invoice Discount/Charge Tax CategoryDocument level allowance VAT category codeDocument level charge VAT category codeOptionalstringTax category
SStandard rateEExempt from taxOServices outside scope of tax / Not subject to taxAEVAT Reverse ChargeZZero ratedNStandard rate additional VAT
Invoice Discount/Charge Tax RateDocument level allowance VAT rateDocument level charge VAT rateOptionalnumberTax rate
Invoice Discount/Charge ReasonDocument level allowance reasonDocument level charge reasonOptionalstringReason for allowance/charge
Invoice Discount/Charge Reason CodeDocument level allowance reason codeDocument level charge reason codeOptionalstringReason code
For allowances bonus_for_works_ahead_of_scheduleBonus for works ahead of scheduleother_bonusOther bonusmanufacturers_consumer_discountManufacturer's consumer discountdue_to_military_statusDue to military statusdue_to_work_accidentDue to work accidentspecial_agreementSpecial agreement
For charges
Invoice Discount/Charge Line IDOptionalstringAllowance/Charge ID
Invoice-level Is ChargeOptionalbooleanCharge (true) or allowance (false)
Invoice Discount/Charge Tax AmountOptionalnumberTax amount
Payment Terms NotePayment termsOptionalstringA textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties).
Payment Means CodePayment means type codeConditionalstringHow the payment is made, as one of the values under Enums. The e-invoice carries the matching UNTDID 4461 code. Mandatory for tax invoices; optional for credit notes. With the deemed_supply modifier: optional for tax invoices. UAE PINT-AE payment means mandatoryUAE PINT-AE IBR-191-AE prohibits payment means code for credit notesUAE PINT-AE IBR-191-AE prohibits payment means code for deemed supply
INSTRUMENT_NOT_DEFINEDInstrument not definedIN_CASHCashCHEQUEChequeBANKERS_DRAFTBanker's draftCREDIT_TRANSFERCredit transferDIRECT_DEBITDirect debit
Payment IDRemittance informationOptionalstringPayment identifier
Payee Account IDPayment account identifierConditionalstringA unique identifier of the financial payment account, at a payment service provider, to which payment should be made.
Payee Account NamePayment account nameOptionalstringThe name of the payment account, at a payment service provider, to which payment should be made.
Payee Institution BranchPayment service provider identifierOptionalstringAn identifier for the payment service provider where a payment account is located.
Discount AmountTerms amountOptionalnumberThe payment amount that these terms apply to. When relevant, the amount includes tax.
Card Holder NameOptionalstringCard holder name
Card NetworkOptionalstringCard network ID
Card PANOptionalstringCard primary account number
Direct Debit Mandate Ref IDOptionalstringDirect debit mandate reference
Payer Financial AccountOptionalstringPayer financial account
Payment Means TextOptionalstringPayment method description
Discount Due DateOptionaldateDiscount due date
Penalty AmountOptionalnumberPenalty amount
Penalty PercentageOptionalnumberPenalty percent
Settlement Discount PercentageOptionalnumberSettlement discount percent
Supporting Document IDProject referenceInvoiced object identifierSupporting document referenceOptionalstringSupporting document identifier
Supporting Document DescriptionSupporting document descriptionOptionalstringDescription of supporting document
Supporting Document URLExternal document locationOptionalstringReference URL
Attachment ContentAttached documentOptionalstringAttachment base64 content
Attachment Mime CodeAttached document Mime codeOptionalstringA code identifying the file type.
Attachment FilenameAttached document FilenameOptionalstringAttachment file name
Attachment ChecksumOptionalstringAttachment checksum
Attachment Content URLOptionalstringAttachment content URL
Attachment DescriptionOptionalstringAttachment description
Attachment SizeOptionalnumberAttachment size
Supporting Document TypeOptionalstringType of supporting document
Supporting Document Issue DateOptionaldateSupporting document issue date
Tax Point DateVAT point dateOptionaldateDate when VAT becomes accountable (BT-7). Critical for VAT compliance and tax period determination.
Buyer Accounting ReferenceBuyer referenceOptionalstringAccounting reference provided by the buyer.
Accounting CostBuyer accounting referenceOptionalstringBuyers accounting cost centre (BT-19).
Seller Identifier SchemeScheme identifierOptionalstringISO/IEC 6523 scheme ID for seller identifier (BT-29-1). Defines the format and authority of the seller identifier.
Seller Registration Number Scheme (BT-30-1)Scheme identifierOptionalstringScheme for seller legal registration identifier (BT-30-1). E.g. CBE, Handelsregister.
Identifier scheme: 243 codes
Seller Additional Legal InformationSeller additional legal informationOptionalstringAdditional legal information about the seller (BT-33). E.g. legal form (SPRL, SA, BV, NV, ASBL).
Seller Electronic Address SchemeSeller electronic address identification scheme identifierMandatorystringScheme of the seller’s Peppol participant identifier (BT-34-1), for example 0235 for a UAE TRN.
Electronic address scheme: 90 codes
Buyer Identifier SchemeScheme identifierOptionalstringISO/IEC 6523 scheme ID for buyer identifier (BT-46-1). Defines the format and authority of the buyer identifier.
Identifier scheme: 243 codes
Buyer Registration Number Scheme (BT-47-1)Scheme identifierOptionalstringScheme for buyer legal registration identifier (BT-47-1). E.g. CBE, Handelsregister.
Identifier scheme: 243 codes
Buyer Electronic Address SchemeScheme identifierMandatorystringPeppol participant scheme identifier for buyer
Electronic address scheme: 90 codes
Delivery Location IdentifierDeliver to location identifierOptionalstringIdentifier for the actual delivery location (BT-71). Used for logistics and tracking when delivery party differs from buyer.
Delivery Location Identifier SchemeScheme identifierOptionalstringScheme for delivery location identifier (BT-71-1). E.g. 0088 for GLN-based location IDs.
Payment Account Identifier SchemeScheme identifierOptionalstringScheme for payment account identifier (BT-84-1). Typically IBAN for SEPA credit transfers.
Invoice Total VAT Amount in Tax Accounting CurrencyInvoice total VAT amount in tax accounting currencyConditionalnumberTotal VAT amount expressed in tax accounting currency (BT-111). Required when taxCurrency differs from document currency.
Preceding Invoice Issue DateConditionaldateIssue date of the original preceding invoice (BT-26). Required for credit/debit notes and continuous supply.
Bank Assigned Creditor IdentifierOptionalstringSEPA creditor identifier (BT-90). Required for direct debit mandates. Conditional for payment means 59 (SEPA direct debit).
Delivery Party Identifier SchemeOptionalstringISO/IEC 6523 scheme ID for delivery party identifier.
Invoiced Object IdentifierOptionalstringObject identification by seller (BT-18). For specific object tracking and reference, e.g. meter point or project ID.
Invoiced Object Identifier SchemeOptionalstringScheme for invoiced object identifier (BT-18-1). Defines the format and authority of the object identifier.
Note Subject CodeOptionalstringSubject code for document-level notes.
Payee Identifier SchemeOptionalstringISO/IEC 6523 scheme ID for payee identifier (BT-61-1). Defines the format and authority of the payee identifier.
Payment Terms AmountOptionalnumberPayment terms monetary amount (BT-176). E.g. minimum payment amount or installment amount.
Payment Terms Due DateOptionaldatePayment terms due date (BT-177). The date by which payment must be made according to agreed terms.
Payment Terms Instructions IDOptionalstringIdentifier for payment terms instructions (BT-187). Used to reference agreed payment terms.
Remittance InformationOptionalstringPayment remittance information text (BT-83). Free text or structured reference for payment reconciliation.
Remittance Information SchemeOptionalstringScheme for remittance information (BT-83-1). Identifies the type of payment reference used.
Tax Point Date CodeOptionalstringCode indicating the tax point date type.
Credit Note Reason CodeCredit note reason codeConditionalstringInternal reason code for credit note. Accepted public enums are mapped into DL8.61.1.A, DL8.61.1.B, DL8.61.1.C, DL8.61.1.D, DL8.61.1.E, or VD. Mandatory for credit notes; optional for tax invoices. Credit note reason code required
SUPPLY_CANCELLEDIf the supply was cancelled.TAX_TREATMENT_CHANGEDIf the tax treatment of the supply has changed due to a change in the nature of the supply.CONSIDERATION_ALTEREDIf the previously agreed consideration for the supply was altered for any reason (i.e. bad debt relief).GOODS_OR_SERVICES_RETURNEDIf the recipient of goods or recipient of services returned them to the registrant in full or in part and the Consideration was returned in full or in part.TAX_APPLIED_IN_ERRORIf the tax was charged or tax treatment was applied in error.VOLUME_DISCOUNTVolume Discount.
Buyer Authority NameAuthority NameConditionalstringIssuing authority name for buyer registration. Required when the buyer legal registration type is Commercial/Trade license (TL).
Seller Authority NameAuthority NameConditionalstringIssuing authority name for seller registration. Required for certain registration types (e.g., passport-based).
Seller Passport Issuing Country CodePassport issuing Country codeConditionalstringCountry code for passport-based registration (seller). ISO 3166-1 alpha-2 format.
Country: 251 codes
Buyer Passport Issuing Country CodePassport issuing Country codeConditionalstringCountry code for passport-based registration (buyer).
Country: 251 codes
Beneficiary IDConditionalstringFree trade zone beneficiary ID. Required when the free_trade_zone modifier is selected. Mandatory with the free_trade_zone modifier. FTZ transaction
Principal TRNConditionalstringPrincipal TRN for disclosed agent billing scenarios. Required when isDisclosedAgent=true. Mandatory with the disclosed_agent modifier. UAE PINT-AE IBR-137-AE requires Principal ID for disclosed agent billing
Total Amount Including Tax in AEDConditionalnumberTotal invoice amount including tax in AED currency. Required when invoice currency is not AED.
Contract ValueOptionalnumberOptional contract value for contract-based invoicing scenarios.
Delivery Party TRNOptionalstringTax Registration Number of the delivery party.
Bank Address Line 1OptionalstringFirst line of the bank address.
Bank Address Line 2OptionalstringSecond line of the bank address.
Bank Address Line 3OptionalstringThird line of the bank address.
Bank Address CityOptionalstringCity of the bank address.
Bank Address CountryOptionalstringCountry of the bank address. ISO 3166-1 alpha-2 format.
Bank Address Postal CodeOptionalstringPostal code of the bank address.
Bank Address State or ProvinceOptionalstringState or province of the bank address.
Direct Debit Creditor ID SchemeOptionalstringScheme identifier for direct debit creditor ID.
Destination AuthorityOptionalstringDestination authority
Destination BodyOptionalstringEmail body
Destination CountryOptionalstringDestination country
Destination Document TypeOptionalstringDestination document type
Destination Participant IDOptionalstringPeppol participant ID
Destination RecipientsOptionalarrayEmail recipients
Destination SubjectOptionalstringEmail subject
Destination TypeOptionalstringDestination type for submission
Is B2BOptionalbooleanBusiness to Business flag
Is TestbedOptionalbooleanTestbed document flag
PurposeOptionalstringDocument purpose (e.g., testbed, e-invoicing, mapping)
ModeOptionalstringDocument processing mode
OperationOptionalstringDocument operation type
Source IDOptionalstringSource identifier
Source NameOptionalstringSource name
Source TypeOptionalstringSource type
Source VersionOptionalstringSource version
VersionOptionalstringDocument version

Required fields by document type

The table’s requirements as lists of GETS paths. A conditional field is required only when the condition in its description is met. Fields a modifier or variant makes mandatory are listed under it.

Every document type

Mandatory: header.documentType.base, header.documentNumber, header.issueDate, header.currency, parties.seller.name, parties.seller.address.country, parties.seller.address.city, parties.seller.taxIds[].type, parties.seller.taxIds[].value, parties.seller.registrationNumbers[].type, parties.seller.registrationNumbers[].value, parties.seller.address.addressLine1, parties.seller.address.stateOrProvince, parties.buyer.name, parties.buyer.address.country, parties.buyer.registrationNumbers[].type, parties.buyer.registrationNumbers[].value, parties.buyer.address.addressLine1, parties.buyer.address.city, parties.buyer.address.stateOrProvince, lineItems[].id, lineItems[].name, lineItems[].quantity, lineItems[].unitCode, lineItems[].taxAmount, lineItems[].lineTaxableValue, lineItems[].taxCategory, lineItems[].taxRate, lineItems[].price.amount, lineItems[].price.grossPrice, totals.totalAmountExcludingTax, totals.totalAmountIncludingTax, totals.amountDue, totals.totalLineTaxableAmount, totals.totalTaxAmount, parties.seller.peppolId, parties.buyer.peppolId, extensions.peppol_seller_peppolIdScheme, extensions.peppol_buyer_peppolIdScheme

Conditional: header.taxCurrency, header.exchangeRate.rate, parties.buyer.taxIds[].value, lineItems[].commodityClassification.code, lineItems[].commodityClassification.scheme, lineItems[].taxExemptionReason, lineItems[].taxExemptionReasonCode, payment.paymentMeans[].creditTransferInfo.payeeFinancialAccountId, extensions.peppol_precedingInvoiceIssueDate, extensions.peppol_totalTaxAmountInTaxCurrency, extensions.ae_buyer_authorityName, extensions.ae_beneficiaryId, extensions.ae_principalTRN, extensions.ae_totalAmountIncludingTaxInAED, extensions.ae_seller_authorityName, extensions.ae_seller_passportIssuingCountry, extensions.ae_buyer_passportCountry, lineItems[].extensions.ae_itemType, lineItems[].extensions.ae_rcmType, lineItems[].extensions.ae_serviceAccountingCode, lineItems[].extensions.ae_sacScheme, taxTotals[].taxAmount, taxTotals[].taxSubtotals[].taxableAmount, taxTotals[].taxSubtotals[].taxAmount, taxTotals[].taxSubtotals[].taxCategory, taxTotals[].taxSubtotals[].percent, taxTotals[].taxSubtotals[].taxExemptionReason, taxTotals[].taxSubtotals[].taxExemptionReasonCode

Tax invoice (tax_invoice)

Also mandatory: header.dueDate, payment.paymentMeans[].paymentMeansCode

Credit note (credit_note)

Also mandatory: header.referenceId, extensions.ae_creditNoteReasonCode

Modifiers and variants

  • free_trade_zone (modifier): mandatory: extensions.ae_beneficiaryId.
  • disclosed_agent (modifier): mandatory: extensions.ae_principalTRN.
  • e_commerce (modifier): mandatory: parties.delivery.address.addressLine1, parties.delivery.address.city, parties.delivery.address.stateOrProvince, parties.delivery.address.country.
  • export (modifier): mandatory: parties.delivery.address.addressLine1, parties.delivery.address.city, parties.delivery.address.stateOrProvince, parties.delivery.address.country.
  • reverse_charge (modifier): mandatory: parties.buyer.taxIds[].value, lineItems[].standardItemCode.id, lineItems[].standardItemCode.schemeId, lineItems[].extensions.ae_rcmType.
  • continuous_supply (modifier): no further mandatory fields.
  • deemed_supply (modifier): no further mandatory fields.
  • summary (modifier): no further mandatory fields.
  • margin_scheme (modifier): no further mandatory fields.
  • self_billed (modifier): no further mandatory fields.
  • out_of_scope (modifier): no further mandatory fields.