Counterfoil field map

Invoice field map

Which boxes on the invoice form match a business term in Peppol BIS Billing 3.0, May 2026 release, UBL Invoice syntax. Retrieved 2026-10-17. Not a validator. Not tax, legal, or accounting advice. Names and definitions are copied from the cited pages. Whitespace inside a copied definition is collapsed to one space. A missing space that is in the official text is kept.

JSON · OpenAPI · Invoice page · Rule notes · Privacy

Boxes that match one term

Form boxTermOfficial nameOfficial definition
Number
number		 BT-1
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cbc-ID/		 Invoice number A unique identification of the Invoice.
Issue date
issueDate		 BT-2
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cbc-IssueDate/		 Invoice issue date The date when the Invoice was issued.
Currency
currency		 BT-5
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cbc-DocumentCurrencyCode/		 Invoice currency code The currency in which all Invoice amounts are given, except for the Total VAT amount in accounting currency.
Due date
dueDate		 BT-9
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cbc-DueDate/		 Payment due date The date when the payment is due.Format "YYYY-MM-DD". In case the Amount due for payment (BT-115) is positive, either the Payment due date (BT-9) or the Payment terms (BT-20) shall be present.
Date of supply (optional)
supplyDate		 BT-72
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-Delivery/cbc-ActualDeliveryDate/		 Actual delivery date The date on which the supply of goods or services was made or completed.
The form calls this box Date of supply. The syntax name is Actual delivery date. The form does not collect the value added tax point date.
Terms printed on the invoice
terms		 BT-20
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-PaymentTerms/cbc-Note/		 Payment terms A textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties).
Legal name
bizName		 BT-27
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AccountingSupplierParty/cac-Party/cac-PartyLegalEntity/cbc-RegistrationName/		 Seller name 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.
VAT ID
bizVat		 BT-31
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AccountingSupplierParty/cac-Party/cac-PartyTaxScheme/cbc-CompanyID/		 Seller VAT identifier The Seller's VAT identifier (also known as Seller VAT identification number) or 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.
The syntax page gives this one description to BT-31 and BT-32 together. This box is labelled VAT ID, so it is stored only as BT-31. It is not stored as BT-32.
Email (optional)
bizEmail		 BT-43
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AccountingSupplierParty/cac-Party/cac-Contact/cbc-ElectronicMail/		 Seller contact email address An e-mail address for the contact point.
IBAN
bizIban		 BT-84
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-PaymentMeans/cac-PayeeFinancialAccount/cbc-ID/		 Payment account identifier A unique identifier of the financial payment account, at a payment service provider, to which payment should be made. Such as IBAN or BBAN.
The box is an IBAN. The term is the payment account identifier. The form does not ask for a payment means type code.
BIC (optional)
bizBic		 BT-86
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-PaymentMeans/cac-PayeeFinancialAccount/cac-FinancialInstitutionBranch/cbc-ID/		 Payment service provider identifier An identifier for the payment service provider where a payment account is located. Such as a BIC or a national clearing code where required. No identification scheme Identifier to be used.
Legal name
clientName		 BT-44
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AccountingCustomerParty/cac-Party/cac-PartyLegalEntity/cbc-RegistrationName/		 Buyer name The full name of the Buyer.
VAT ID (if they have one)
clientVat		 BT-48
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-AccountingCustomerParty/cac-Party/cac-PartyTaxScheme/cbc-CompanyID/		 Buyer VAT identifier The Buyer's VAT identifier (also known as Buyer VAT identification number).

Line boxes

Form boxTermOfficial nameOfficial definition
Qty
lines[].qty		 BT-129
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cbc-InvoicedQuantity/		 Invoiced quantity The quantity of items (goods or services) that is charged in the Invoice line.
Price
lines[].price		 BT-146
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cac-Price/cbc-PriceAmount/		 Item net price The price of an item, exclusive of VAT, after subtracting item price discount.
The form says prices are net of VAT. It has no item price discount.

VAT rate

The form says one rate applies to the whole invoice. Domestic VAT uses the rate box. Reverse charge, outside the EU, and exemption print 0 and do not use the rate box. The rate is not a VAT category code.

Form boxTermOfficial nameOfficial definition
VAT rate, percent
vatRate · invoice		 BT-119
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-TaxTotal/cac-TaxSubtotal/cac-TaxCategory/cbc-Percent/		 VAT category rate The VAT rate, represented as percentage that applies for the relevant VAT category.
VAT rate, percent
vatRate · line		 BT-152
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cac-Item/cac-ClassifiedTaxCategory/cbc-Percent/		 Invoiced item VAT rate The VAT rate, represented as percentage that applies to the invoiced item.

Wording under the totals

On reverse charge, outside the EU, and exemption, the wording is the exemption reason text. On domestic VAT, a sentence the user types is an invoice note. A domestic sentence is not stored as an exemption reason.

Form boxTermOfficial nameOfficial definition
Wording under the totals
vatNote · reverse, export, exempt		 BT-120
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-TaxTotal/cac-TaxSubtotal/cac-TaxCategory/cbc-TaxExemptionReason/		 VAT exemption reason text A textual statement of the reason why the amount is exempted from VAT or why no VAT is being charged.
Wording under the totals
vatNote · domestic		 BT-22
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cbc-Note/		 Invoice note A textual note that gives unstructured information that is relevant to the Invoice as a whole.Such as the reason for any correction or assignment note in case the invoice has been factored.

Amounts the page calculates

These are not boxes. They are filled only when every started line parses. A half-typed price leaves the invoice totals blank.

FromTermOfficial nameOfficial definition
line-net BT-131
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cbc-LineExtensionAmount/		 Invoice line net amount The total amount of the Invoice line. The amount is “net” without VAT, i.e. inclusive of line level allowances and charges as well as other relevant taxes.
Quantity times net price, from the lines that parse. A started line that does not parse has no line net amount.
subtotal BT-106
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-LegalMonetaryTotal/cbc-LineExtensionAmount/		 Sum of Invoice line net amount Sum of all Invoice line net amounts in the Invoice.
Present only when every started line parses.
subtotal BT-109
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-LegalMonetaryTotal/cbc-TaxExclusiveAmount/		 Invoice total amount without VAT The total amount of the Invoice without VAT.
The form has no document-level allowance or charge. The stored BR-CO-13 statement says this total equals the line net sum minus document allowances plus document charges.
subtotal BT-116
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-TaxTotal/cac-TaxSubtotal/cbc-TaxableAmount/		 VAT category taxable amount Sum of all taxable amounts subject to a specific VAT category code and VAT category rate (if the VAT category rate is applicable).
The form has one rate and no document-level allowance or charge, so the taxable amount is the line net sum. The category code is not chosen here.
vat BT-110
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-TaxTotal/cbc-TaxAmount/		 Invoice total VAT amount The total VAT amount for the Invoice or the VAT total amount expressed in the accounting currency accepted or required in the country of the Seller.
The page total for VAT, in the invoice currency. The syntax page also lists BT-111 on this element. Blank until every started line parses.
vat BT-117
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-TaxTotal/cac-TaxSubtotal/cbc-TaxAmount/		 VAT category tax amount The total VAT amount for a given VAT category.
One rate means one VAT breakdown. The stored BR-CO-14 statement says the invoice VAT total equals the sum of the category tax amounts.
total BT-112
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-LegalMonetaryTotal/cbc-TaxInclusiveAmount/		 Invoice total amount with VAT The total amount of the Invoice with VAT.
Line net sum plus the VAT total. This is not the amount due for payment.

Boxes that are not one term

Description

lines.desc

One text box. The syntax has an item name, which is required, and an item description, which is optional and is for more detail than the name. The form does not collect them separately, so the box is not stored as either term.

Address

bizAddress

One textarea. The syntax splits the seller address into separate terms. The typed text is not stored as any one of them.

Address

clientAddress

One textarea. The syntax splits the buyer address into separate terms. The typed text is not stored as any one of them.

Country

bizCountry

The box is a country name. Seller country code is a code. The example on the syntax page is GB. The typed name is not that code.

Country

clientCountry

The box is a country name. Buyer country code is a code. The example on the syntax page is SE. The typed name is not that code.

Extra line (optional)

bizExtra

The placeholder says register or tax number. Those are different terms. The box does not say which, so it is not stored as either.

What should this invoice say?

vatMode

The form asks for a treatment, not a VAT category code. None of the four labels is stored as the VAT category code or the invoiced item VAT category code.

Terms the form does not ask for

Why it is absentTermOfficial nameOfficial definition
The form does not ask for a buyer reference. BT-10
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cbc-BuyerReference/		 Buyer reference An identifier assigned by the Buyer used for internal routing purposes.
The form does not ask for a buyer reference.
The form does not ask how the invoice is paid. An IBAN does not select this code. BT-81
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-PaymentMeans/cbc-PaymentMeansCode/		 Payment means type code The means, expressed as code, for how a payment is expected to be or has been settled.
The form does not ask how the invoice is paid. An IBAN does not select this code.
The syntax page lists BT-110 and BT-111 on one element. The form has one currency box and does not ask for a VAT accounting currency, so the VAT total is not stored as BT-111. BT-111
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-TaxTotal/cbc-TaxAmount/		 Invoice total VAT amount in accounting currency The total VAT amount for the Invoice or the VAT total amount expressed in the accounting currency accepted or required in the country of the Seller.
The syntax page lists BT-110 and BT-111 on one element. The form has one currency box and does not ask for a VAT accounting currency, so the VAT total is not stored as BT-111.
The form does not ask for an amount already paid. BT-113
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-LegalMonetaryTotal/cbc-PrepaidAmount/		 Paid amount The sum of amounts which have been paid in advance.
The form does not ask for an amount already paid.
The printed total is the invoice total with VAT. Amount due for payment is a different term, and the form does not collect the paid amount, so the total is not stored as the amount due. BT-115
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-LegalMonetaryTotal/cbc-PayableAmount/		 Amount due for payment The outstanding amount that is requested to be paid.
The printed total is the invoice total with VAT. Amount due for payment is a different term, and the form does not collect the paid amount, so the total is not stored as the amount due.
The form does not ask for a line identifier. BT-126
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cbc-ID/		 Invoice line identifier A unique identifier for the individual line within the Invoice.
The form does not ask for a line identifier.
The form asks for a quantity and does not ask for a unit. BT-130
https://docs.peppol.eu/poacc/billing/3.0/syntax/ubl-invoice/cac-InvoiceLine/cbc-InvoicedQuantity/unitCode/		 Invoiced quantity unit of measure code The unit of measure that applies to the invoiced quantity.
The form asks for a quantity and does not ask for a unit.

VAT category codes

Duty or tax or fee category code (Subset of UNCL5305). Quoted so the form labels can be compared with the code names. The form does not store one of these codes.

Source: https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/

CodeOfficial nameOfficial definition
AEVat Reverse ChargeCode specifying that the standard VAT rate is levied from the invoicee.
BTransferred (VAT), In ItalyVAT not to be paid to the issuer of the invoice but directly to relevant tax authority. This code is allowed in the EN 16931 for Italy only based on the Italian A-deviation.
EExempt from TaxCode specifying that taxes are not applicable.
GFree export item, VAT not chargedCode specifying that the item is free export and taxes are not charged.
KVAT exempt for EEA intra-community supply of goods and servicesA tax category code indicating the item is VAT exempt due to an intra-community supply in the European Economic Area.
LCanary Islands general indirect taxImpuesto General Indirecto Canario (IGIC) is an indirect tax levied on goods and services supplied in the Canary Islands (Spain) by traders and professionals, as well as on import of goods.
MTax for production, services and importation in Ceuta and MelillaImpuesto sobre la Producción, los Servicios y la Importación (IPSI) is an indirect municipal tax, levied on the production, processing and import of all kinds of movable tangible property, the supply of services and the transfer of immovable property located in the cities of Ceuta and Melilla.
OServices outside scope of taxCode specifying that taxes are not applicable to the services.
SStandard rateCode specifying the standard rate.
ZZero rated goodsCode specifying that the goods are at a zero rate.

Form labels

ValueLabelWhy it is not a code
domesticDomestic VAT — a rate you enterThe label is not the code name Standard rate, and it is not the code name Zero rated goods.
reverseReverse charge — 0%, with a note you can editThe label is not the code name Vat Reverse Charge.
exportOutside the EU — 0%, with a note you can editThe code list separates Free export item, VAT not charged, VAT exempt for EEA intra-community supply of goods and services, and Services outside scope of tax.
exemptExemption or small-business scheme — 0%, you write the noteThe label is wider than the code name Exempt from Tax. It also says small-business scheme.

JSON · OpenAPI · Invoice page · Rule notes · Privacy