Invoice (document level)Top-level fields of the invoice document.
Unique invoice identifier from the seller.
Date the invoice was issued.
UNCL1001 code; 380 = commercial invoice.
ISO 4217 currency of all invoice amounts.
Currency for VAT bookkeeping when it differs from BT-5.
Date when the VAT becomes chargeable.
Code for the VAT date when BT-7 is not used (UNCL2005).
Date by which payment is due.
Buyer-supplied reference (e.g. routing or Leitweg-ID); Peppol requires BT-10 or BT-13.
Project the invoice refers to.
Contract the invoice refers to.
Buyer's purchase order number.
Seller's sales order number.
Reference to the receiving advice.
Reference to the despatch advice.
Tender or lot the invoice relates to.
Identifier of an object the invoice is based on (e.g. meter).
Buyer's cost centre or booking reference.
Payment terms as text.
Invoice noteFree-text notes.
Qualifier for the note (UNCL4451).
Free-text note on the invoice.
Process controlWhich rule set and process the invoice follows.
Business process context; fixed value in Peppol.
Identifies the rule set the invoice follows.
Preceding invoice referenceLinks corrections to the earlier invoice.
Number of the invoice being corrected.
Issue date of the preceding invoice.
SellerWho issues the invoice.
Full legal name of the seller.
Trade name if it differs from the legal name.
Seller identifier such as GLN or national number.
Company register number (e.g. KvK, Handelsregister).
Seller's VAT number; required for reverse charge.
Local tax registration of the seller.
Legal form or share capital notes.
Seller's Peppol address; mandatory in Peppol.
Seller postal addressPostal address of the seller.
Street and number of the seller.
Additional address line.
Third address line.
City of the seller address.
Postal code of the seller address.
Region or province.
ISO 3166-1 country of the seller.
Seller contactContact details of the seller.
Contact person or department; XRechnung requires it.
Phone number of the contact.
Email address of the contact.
BuyerWho receives the invoice.
Full legal name of the buyer.
Trade name of the buyer.
Buyer identifier such as GLN.
Company register number of the buyer.
Buyer's VAT number.
Buyer's Peppol address; delivery target on the network.
Buyer postal addressPostal address of the buyer.
Street and number of the buyer.
Additional address line.
Third address line.
City of the buyer address.
Postal code of the buyer address.
Region or province.
ISO 3166-1 country of the buyer.
Buyer contactContact details of the buyer.
Contact person at the buyer.
Phone number at the buyer.
Email address at the buyer.
PayeeWho gets paid, if not the seller.
Name of the payee when it differs from the seller.
Identifier of the payee.
Register number of the payee.
Seller tax representativeTax representative of the seller.
Name of the seller's tax representative.
VAT number of the tax representative.
Tax representative addressAddress of the tax representative.
Street of the tax representative.
Additional address line.
Third address line.
City of the tax representative.
Postal code.
Region or province.
Country of the tax representative.
Delivery informationWhere and when delivery happened.
Name of the party goods are delivered to.
Identifier of the delivery location (e.g. GLN).
Date the goods or services were delivered.
Invoicing periodPeriod the invoice covers.
Start of the period the invoice covers.
End of the period the invoice covers.
Deliver-to addressDelivery address.
Street of the delivery address.
Additional address line.
Third address line.
City of delivery.
Postal code of delivery.
Region or province.
Country of delivery.
Payment instructionsHow the invoice is to be paid.
How payment is expected (UNCL4461); 30 = credit transfer, 58 = SEPA.
Payment means in free text.
Reference the buyer states with the payment.
Credit transferBank account to pay into.
IBAN or account number to pay into.
Name of the account holder.
BIC of the bank.
Payment card informationCard used for payment.
Masked card number used to pay.
Name of the card holder.
Direct debitSEPA direct debit details.
SEPA direct debit mandate reference.
SEPA creditor identifier of the seller.
IBAN to be debited.
Document level allowancesDiscounts on the whole invoice.
Discount amount without VAT.
Base the discount percentage applies to.
Discount percentage.
VAT category of the discount.
VAT rate of the discount.
Reason for the discount as text.
Reason code (UNCL5189).
Document level chargesCharges on the whole invoice.
Charge amount without VAT.
Base the charge percentage applies to.
Charge percentage.
VAT category of the charge.
VAT rate of the charge.
Reason for the charge as text.
Reason code (UNCL7161).
Document totalsAll invoice totals.
Total of all line net amounts.
Total of document level discounts.
Total of document level charges.
Invoice total excluding VAT.
Total VAT of the invoice.
VAT total in the accounting currency.
Invoice total including VAT.
Amount already paid.
Rounding applied to the total.
Outstanding amount to pay.
VAT breakdownVAT per category and rate.
Taxable base per VAT category.
VAT amount per category.
UNCL5305 category: S, Z, E, AE, K, G, O, L, M.
VAT rate of the category.
Why no VAT is charged.
Coded exemption reason (VATEX).
Additional supporting documentsAttachments and references.
Identifier of a supporting document.
Description of the attachment.
URL where the document can be found.
Base64 embedded attachment (@mimeCode, @filename).
Invoice lineOne invoiced item or service.
Unique line number.
Free text on the line.
Object the line refers to.
Quantity of the invoiced item.
UN/ECE Rec 20 unit; C62 = piece, HUR = hour.
Line total without VAT.
Order line the invoice line refers to.
Buyer cost centre for this line.
Invoice line periodPeriod of a single line.
Start of the line's period.
End of the line's period.
Invoice line allowancesDiscounts on a line.
Line discount without VAT.
Base for the line discount percentage.
Line discount percentage.
Reason for the line discount.
Reason code (UNCL5189).
Invoice line chargesCharges on a line.
Line charge without VAT.
Base for the line charge percentage.
Line charge percentage.
Reason for the line charge.
Reason code (UNCL7161).
Price detailsUnit price composition.
Unit price without VAT, after price discount.
Discount included in the unit price.
Unit price before the price discount.
Quantity the price applies to.
Unit of the base quantity.
Line VAT informationVAT of the line item.
VAT category of the line item.
VAT rate of the line item.
Item informationWhat is being invoiced.
Name of the invoiced item.
Longer description of the item.
Seller's article number.
Buyer's article number.
Standard identifier such as GTIN.
Classification code such as UNSPSC or CPV.
Country the item originates from.
Item attributesExtra item properties.
Name of an item attribute.
Value of the item attribute.
Model: EN 16931 core invoice; mapping: Peppol BIS Billing 3.0 (UBL invoice). Official term names are shown in English.
About this tool
The EN 16931 explorer walks through the European e-invoicing semantic model field by field: business terms, cardinalities and how each term maps to UBL elements.
It is a reference for developers and consultants implementing EN 16931, XRechnung or Peppol BIS: look up a business term such as BT-31 and see exactly where it lives in the XML.
The explorer is free. If you would rather not learn the model at all, the NordInvoice generate API builds compliant UBL from plain JSON.