Compliance

EN 16931 field coverage

Each business term of the EN 16931-1:2017+A1:2019 core invoice model, and whether Beliq's invoice object has a field for it. 139 of 164 have one; 19 do not.

EN 16931 defines 164 business terms in 32 groups. Beliq’s invoice object has a field for 139 of them. This page lists all 164, so you can check a term before you build against it rather than after.

A term marked No field is one the API does not accept today. It is not a term Beliq rejects or strips: it never reaches the request, because there is nowhere to put it, so the document Beliq builds does not carry it and a rule that requires it fails verification.

Another 6 are marked Set by Beliq. There is nothing to send for those: the value follows from the rest of the request, so Beliq writes it wherever the syntax carries it.

Nothing here is a statement about validation. /v1/validate checks a document you supply against the authority’s full ruleset, every term included, whether or not /v1/generate can produce it.

At a glance

	Have a field	Set by Beliq	Neither	Total in EN 16931
Business terms (`BT`)	139	6	19	164
Groups (`BG`)	21	0	11	32

A group counts here when the invoice object has a field standing for the group itself, such as taxSummary for BG-23. That says nothing about how much of the group is reachable: BG-22 has a field for 10 of its 10 terms and BG-5 for 6 of its 7 terms, and both count once here. Read the business-term table for depth.

Business terms

Fields are named by the object that declares them, as the generate reference documents them: Party is both seller and buyer, Address is the address of either, InvoiceLine is an entry in lines. Follow a field to its table for the JSON path, the type and the constraints.

Term	Name	Inside	Beliq field
`BT-1`	Invoice number	Document level	`Invoice.number`
`BT-2`	Invoice issue date	Document level	`Invoice.issueDate`
`BT-3`	Invoice type code	Document level	`Invoice.documentType`, `Invoice.typeCode`
`BT-5`	Invoice currency code	Document level	`Invoice.currencyCode`
`BT-6`	VAT accounting currency code	Document level	`Invoice.taxCurrencyCode`
`BT-7`	Value added tax point date	Document level	`Invoice.vatPointDate`
`BT-8`	Value added tax point date code	Document level	`Invoice.vatPointDateCode`
`BT-9`	Payment due date	Document level	`Invoice.dueDate`
`BT-10`	Buyer reference	Document level	`Invoice.buyerReference`
`BT-11`	Project reference	Document level	`Invoice.projectReference`
`BT-12`	Contract reference	Document level	`Invoice.contractReference`
`BT-13`	Purchase order reference	Document level	`Invoice.orderReference`
`BT-14`	Sales order reference	Document level	`Invoice.salesOrderReference`
`BT-15`	Receiving advice reference	Document level	`Invoice.receivingAdviceReference`
`BT-16`	Despatch advice reference	Document level	`Invoice.despatchAdviceReference`
`BT-17`	Tender or lot reference	Document level	`Invoice.tenderReference`
`BT-18`	Invoiced object identifier	Document level	`Invoice.invoicedObjectIdentifier`
`BT-19`	Buyer accounting reference	Document level	`Invoice.buyerAccountingReference`
`BT-20`	Payment terms	Document level	`Invoice.paymentTerms`
`BT-21`	Invoice note subject code	BG-1 Invoice note	No field
`BT-22`	Invoice note	BG-1 Invoice note	`Invoice.note`
`BT-23`	Business process type	BG-2 Process control	`Invoice.businessProcessId`
`BT-24`	Specification identifier	BG-2 Process control	Set by Beliq. The specification identifier follows from `standard` and `profile`: `beliq-engine/app/formats/ubl.py:332` writes `cbc:CustomizationID` and `app/formats/cii.py:480` the CII `GuidelineSpecifiedDocumentContextParameter`.
`BT-25`	Preceding Invoice reference	BG-3 Preceding invoice reference	`Invoice.precedingInvoiceReference`
`BT-26`	Preceding Invoice issue date	BG-3 Preceding invoice reference	`Invoice.precedingInvoiceReference`
`BT-27`	Seller name	BG-4 Seller	`Party.name`
`BT-28`	Seller trading name	BG-4 Seller	No field
`BT-29`	Seller identifier	BG-4 Seller	No field
`BT-30`	Seller legal registration identifier	BG-4 Seller	`Party.registrationId`
`BT-31`	Seller VAT identifier	BG-4 Seller	`Party.vatId`
`BT-32`	Seller tax registration identifier	BG-4 Seller	`Party.taxId`
`BT-33`	Seller additional legal information	BG-4 Seller	No field
`BT-34`	Seller electronic address	BG-4 Seller	`Party.peppol`, `PeppolEndpoint.schemeId`, `PeppolEndpoint.id`
`BT-35`	Seller address line 1	BG-5 Seller postal address	`Address.street`
`BT-36`	Seller address line 2	BG-5 Seller postal address	`Address.additionalStreet`
`BT-37`	Seller city	BG-5 Seller postal address	`Address.city`
`BT-38`	Seller post code	BG-5 Seller postal address	`Address.postalCode`
`BT-39`	Seller country subdivision	BG-5 Seller postal address	`Address.countrySubentity`
`BT-40`	Seller country code	BG-5 Seller postal address	`Address.countryCode`
`BT-41`	Seller contact point	BG-6 Seller contact	`Party.contactName`
`BT-42`	Seller contact telephone number	BG-6 Seller contact	`Party.phone`
`BT-43`	Seller contact email address	BG-6 Seller contact	`Party.email`
`BT-44`	Buyer name	BG-7 Buyer	`Party.name`
`BT-45`	Buyer trading name	BG-7 Buyer	No field
`BT-46`	Buyer identifier	BG-7 Buyer	No field
`BT-47`	Buyer legal registration identifier	BG-7 Buyer	`Party.registrationId`
`BT-48`	Buyer VAT identifier	BG-7 Buyer	`Party.vatId`
`BT-49`	Buyer electronic address	BG-7 Buyer	`Party.peppol`, `PeppolEndpoint.schemeId`, `PeppolEndpoint.id`
`BT-50`	Buyer address line 1	BG-8 Buyer postal address	`Address.street`
`BT-51`	Buyer address line 2	BG-8 Buyer postal address	`Address.additionalStreet`
`BT-52`	Buyer city	BG-8 Buyer postal address	`Address.city`
`BT-53`	Buyer post code	BG-8 Buyer postal address	`Address.postalCode`
`BT-54`	Buyer country subdivision	BG-8 Buyer postal address	`Address.countrySubentity`
`BT-55`	Buyer country code	BG-8 Buyer postal address	`Address.countryCode`
`BT-56`	Buyer contact point	BG-9 Buyer contact	`Party.contactName`
`BT-57`	Buyer contact telephone number	BG-9 Buyer contact	`Party.phone`
`BT-58`	Buyer contact email address	BG-9 Buyer contact	`Party.email`
`BT-59`	Payee name	BG-10 Payee	`Payee.name`
`BT-60`	Payee identifier	BG-10 Payee	`Payee.identifier`
`BT-61`	Payee legal registration identifier	BG-10 Payee	`Payee.registrationId`
`BT-62`	Seller tax representative name	BG-11 Seller tax representative party	`TaxRepresentative.name`
`BT-63`	Seller tax representative VAT identifier	BG-11 Seller tax representative party	`TaxRepresentative.vatId`
`BT-64`	Tax representative address line 1	BG-12 Seller tax representative postal address	`TaxRepresentative.address`
`BT-65`	Tax representative address line 2	BG-12 Seller tax representative postal address	`TaxRepresentative.address`
`BT-66`	Tax representative city	BG-12 Seller tax representative postal address	`TaxRepresentative.address`
`BT-67`	Tax representative post code	BG-12 Seller tax representative postal address	`TaxRepresentative.address`
`BT-68`	Tax representative country subdivision	BG-12 Seller tax representative postal address	`TaxRepresentative.address`
`BT-69`	Tax representative country code	BG-12 Seller tax representative postal address	`TaxRepresentative.address`
`BT-70`	Deliver to party name	BG-13 Delivery information	`Delivery.name`
`BT-71`	Deliver to location identifier	BG-13 Delivery information	`Delivery.locationId`
`BT-72`	Actual delivery date	BG-13 Delivery information	`Delivery.date`
`BT-73`	Invoicing period start date	BG-14 Invoicing period	`Invoice.invoicingPeriod`
`BT-74`	Invoicing period end date	BG-14 Invoicing period	`Invoice.invoicingPeriod`
`BT-75`	Deliver to address line 1	BG-15 Deliver to address	`DeliveryAddress.street`
`BT-76`	Deliver to address line 2	BG-15 Deliver to address	`DeliveryAddress.additionalStreet`
`BT-77`	Deliver to city	BG-15 Deliver to address	`DeliveryAddress.city`
`BT-78`	Deliver to post code	BG-15 Deliver to address	`DeliveryAddress.postalCode`
`BT-79`	Deliver to country subdivision	BG-15 Deliver to address	`DeliveryAddress.countrySubentity`
`BT-80`	Deliver to country code	BG-15 Deliver to address	`DeliveryAddress.countryCode`
`BT-81`	Payment means type code	BG-16 Payment instructions	`PaymentMeans.typeCode`
`BT-82`	Payment means text	BG-16 Payment instructions	`PaymentMeans.information`
`BT-83`	Remittance information	BG-16 Payment instructions	`PaymentMeans.paymentReference`
`BT-84`	Payment account identifier	BG-17 Credit transfer	`PaymentMeans.iban`
`BT-85`	Payment account name	BG-17 Credit transfer	No field
`BT-86`	Payment service provider identifier	BG-17 Credit transfer	`PaymentMeans.bic`
`BT-87`	Payment card primary account number	BG-18 Payment card information	No field
`BT-88`	Payment card holder name	BG-18 Payment card information	No field
`BT-89`	Mandate reference identifier	BG-19 Direct debit	`PaymentMeans.mandateReference`
`BT-90`	Bank assigned creditor identifier	BG-19 Direct debit	`PaymentMeans.creditorId`
`BT-91`	Debited account identifier	BG-19 Direct debit	`PaymentMeans.debitedAccountId`
`BT-92`	Document level allowance amount	BG-20 Document level allowances	`DocumentAllowanceCharge.amount`
`BT-93`	Document level allowance base amount	BG-20 Document level allowances	`DocumentAllowanceCharge.baseAmount`
`BT-94`	Document level allowance percentage	BG-20 Document level allowances	`DocumentAllowanceCharge.percentage`
`BT-95`	Document level allowance VAT category code	BG-20 Document level allowances	`DocumentAllowanceCharge.vatCategoryCode`
`BT-96`	Document level allowance VAT rate	BG-20 Document level allowances	`DocumentAllowanceCharge.vatRate`
`BT-97`	Document level allowance reason	BG-20 Document level allowances	`DocumentAllowanceCharge.reason`
`BT-98`	Document level allowance reason code	BG-20 Document level allowances	`DocumentAllowanceCharge.reasonCode`
`BT-99`	Document level charge amount	BG-21 Document level charges	`DocumentAllowanceCharge.amount`
`BT-100`	Document level charge base amount	BG-21 Document level charges	`DocumentAllowanceCharge.baseAmount`
`BT-101`	Document level charge percentage	BG-21 Document level charges	`DocumentAllowanceCharge.percentage`
`BT-102`	Document level charge VAT category code	BG-21 Document level charges	`DocumentAllowanceCharge.vatCategoryCode`
`BT-103`	Document level charge VAT rate	BG-21 Document level charges	`DocumentAllowanceCharge.vatRate`
`BT-104`	Document level charge reason	BG-21 Document level charges	`DocumentAllowanceCharge.reason`
`BT-105`	Document level charge reason code	BG-21 Document level charges	`DocumentAllowanceCharge.reasonCode`
`BT-106`	Sum of Invoice line net amount	BG-22 Document totals	`Invoice.totalNetAmount`
`BT-107`	Sum of allowances on document level	BG-22 Document totals	Set by Beliq. The sum of the `allowances` list, which the builders compute rather than accept, so the two syntaxes cannot disagree: `beliq-engine/app/formats/allowance_charge.py::totals`, written at `app/formats/ubl.py:558` and `app/formats/cii.py:732`. Written only when the list is non-empty, as the syntaxes allow.
`BT-108`	Sum of charges on document level	BG-22 Document totals	Set by Beliq. The sum of the `charges` list, from the same function, written at `beliq-engine/app/formats/ubl.py:560` and `app/formats/cii.py:730`.
`BT-109`	Invoice total amount without VAT	BG-22 Document totals	Set by Beliq. Derived as `totalNetAmount` minus BT-107 plus BT-108 (`BR-CO-13`) by `beliq-engine/app/formats/allowance_charge.py::tax_exclusive_total`, written to `cbc:TaxExclusiveAmount` (`app/formats/ubl.py:549`) and `ram:TaxBasisTotalAmount` (`app/formats/cii.py:735`). A caller-sent copy could only ever disagree with the arithmetic, so there is no field.
`BT-110`	Invoice total VAT amount	BG-22 Document totals	`Invoice.totalTaxAmount`
`BT-111`	Invoice total VAT amount in accounting currency	BG-22 Document totals	`Invoice.taxTotalInAccountingCurrency`
`BT-112`	Invoice total amount with VAT	BG-22 Document totals	`Invoice.totalGrossAmount`
`BT-113`	Paid amount	BG-22 Document totals	`Invoice.paidAmount`
`BT-114`	Rounding amount	BG-22 Document totals	`Invoice.roundingAmount`
`BT-115`	Amount due for payment	BG-22 Document totals	Set by Beliq. Derived as `totalGrossAmount` minus `paidAmount` plus `roundingAmount` (`BR-CO-16`) by `beliq-engine/app/formats/amount_due.py::amount_due`, written to `cbc:PayableAmount` (`app/formats/ubl.py:637`) and `ram:DuePayableAmount` (`app/formats/cii.py:825`). With neither field sent it equals `totalGrossAmount`.
`BT-116`	VAT category taxable amount	BG-23 VAT breakdown	`TaxSummary.taxableAmount`
`BT-117`	VAT category tax amount	BG-23 VAT breakdown	`TaxSummary.taxAmount`
`BT-118`	VAT category code	BG-23 VAT breakdown	`TaxSummary.vatCategoryCode`
`BT-119`	VAT category rate	BG-23 VAT breakdown	`TaxSummary.vatRate`
`BT-120`	VAT exemption reason text	BG-23 VAT breakdown	`TaxSummary.exemptionReasonText`
`BT-121`	VAT exemption reason code	BG-23 VAT breakdown	`TaxSummary.exemptionReasonCode`
`BT-122`	Supporting document reference	BG-24 Additional supporting documents	`SupportingDocument.id`
`BT-123`	Supporting document description	BG-24 Additional supporting documents	`SupportingDocument.description`
`BT-124`	External document location	BG-24 Additional supporting documents	`SupportingDocument.externalLocation`
`BT-125`	Attached document	BG-24 Additional supporting documents	`SupportingDocument.attachment`
`BT-126`	Invoice line identifier	BG-25 Invoice line	Set by Beliq. Line identifiers are numbered from 1 in request order, `beliq-engine/app/formats/ubl.py:499` and `app/formats/cii.py:539`.
`BT-127`	Invoice line note	BG-25 Invoice line	No field
`BT-128`	Invoice line object identifier	BG-25 Invoice line	No field
`BT-129`	Invoiced quantity	BG-25 Invoice line	`InvoiceLine.quantity`
`BT-130`	Invoiced quantity unit of measure code	BG-25 Invoice line	`InvoiceLine.unitCode`
`BT-131`	Invoice line net amount	BG-25 Invoice line	`InvoiceLine.lineTotal`
`BT-132`	Referenced purchase order line reference	BG-25 Invoice line	No field
`BT-133`	Invoice line Buyer accounting reference	BG-25 Invoice line	No field
`BT-134`	Invoice line period start date	BG-26 Invoice line period	`InvoiceLine.invoicingPeriod`
`BT-135`	Invoice line period end date	BG-26 Invoice line period	`InvoiceLine.invoicingPeriod`
`BT-136`	Invoice line allowance amount	BG-27 Invoice line allowances	`LineAllowanceCharge.amount`
`BT-137`	Invoice line allowance base amount	BG-27 Invoice line allowances	`LineAllowanceCharge.baseAmount`
`BT-138`	Invoice line allowance percentage	BG-27 Invoice line allowances	`LineAllowanceCharge.percentage`
`BT-139`	Invoice line allowance reason	BG-27 Invoice line allowances	`LineAllowanceCharge.reason`
`BT-140`	Invoice line allowance reason code	BG-27 Invoice line allowances	`LineAllowanceCharge.reasonCode`
`BT-141`	Invoice line charge amount	BG-28 Invoice line charges	`LineAllowanceCharge.amount`
`BT-142`	Invoice line charge base amount	BG-28 Invoice line charges	`LineAllowanceCharge.baseAmount`
`BT-143`	Invoice line charge percentage	BG-28 Invoice line charges	`LineAllowanceCharge.percentage`
`BT-144`	Invoice line charge reason	BG-28 Invoice line charges	`LineAllowanceCharge.reason`
`BT-145`	Invoice line charge reason code	BG-28 Invoice line charges	`LineAllowanceCharge.reasonCode`
`BT-146`	Item net price	BG-29 Price details	`InvoiceLine.unitPrice`
`BT-147`	Item price discount	BG-29 Price details	`InvoiceLine.priceDiscount`
`BT-148`	Item gross price	BG-29 Price details	`InvoiceLine.grossPrice`
`BT-149`	Item price base quantity	BG-29 Price details	`InvoiceLine.priceBaseQuantity`
`BT-150`	Item price base quantity unit of measure	BG-29 Price details	No field
`BT-151`	Invoiced item VAT category code	BG-30 Line VAT information	`InvoiceLine.vatCategoryCode`
`BT-152`	Invoiced item VAT rate	BG-30 Line VAT information	`InvoiceLine.vatRate`
`BT-153`	Item name	BG-31 Item information	`InvoiceLine.description`
`BT-154`	Item description	BG-31 Item information	No field
`BT-155`	Item Sellers identifier	BG-31 Item information	`InvoiceLine.itemId`
`BT-156`	Item Buyers identifier	BG-31 Item information	`InvoiceLine.buyerItemId`
`BT-157`	Item standard identifier	BG-31 Item information	`InvoiceLine.standardItemId`
`BT-158`	Item classification identifier	BG-31 Item information	`InvoiceLine.classifications`
`BT-159`	Item country of origin	BG-31 Item information	`InvoiceLine.originCountryCode`
`BT-160`	Item attribute name	BG-32 Item attributes	`InvoiceLine.attributes`
`BT-161`	Item attribute value	BG-32 Item attributes	`InvoiceLine.attributes`
`BT-162`	Seller address line 3	BG-5 Seller postal address	No field
`BT-163`	Buyer address line 3	BG-8 Buyer postal address	No field
`BT-164`	Tax representative address line 3	BG-12 Seller tax representative postal address	No field
`BT-165`	Deliver to address line 3	BG-15 Deliver to address	No field

Groups

Group	Name	Inside	Beliq field
`BG-1`	Invoice note	Document level	No field
`BG-2`	Process control	Document level	No field
`BG-3`	Preceding invoice reference	Document level	`Invoice.precedingInvoiceReference`
`BG-4`	Seller	Document level	`Invoice.seller`
`BG-5`	Seller postal address	BG-4 Seller	`Party.address`
`BG-6`	Seller contact	BG-4 Seller	No field
`BG-7`	Buyer	Document level	`Invoice.buyer`
`BG-8`	Buyer postal address	BG-7 Buyer	`Party.address`
`BG-9`	Buyer contact	BG-7 Buyer	No field
`BG-10`	Payee	Document level	`Invoice.payee`
`BG-11`	Seller tax representative party	Document level	`Invoice.taxRepresentative`
`BG-12`	Seller tax representative postal address	BG-11 Seller tax representative party	`TaxRepresentative.address`
`BG-13`	Delivery information	Document level	`Invoice.delivery`
`BG-14`	Invoicing period	Document level	`Invoice.invoicingPeriod`
`BG-15`	Deliver to address	BG-13 Delivery information	`Delivery.address`
`BG-16`	Payment instructions	Document level	`Invoice.paymentMeans`
`BG-17`	Credit transfer	BG-16 Payment instructions	No field
`BG-18`	Payment card information	BG-16 Payment instructions	No field
`BG-19`	Direct debit	BG-16 Payment instructions	No field
`BG-20`	Document level allowances	Document level	`Invoice.allowances`
`BG-21`	Document level charges	Document level	`Invoice.charges`
`BG-22`	Document totals	Document level	No field
`BG-23`	VAT breakdown	Document level	`Invoice.taxSummary`
`BG-24`	Additional supporting documents	Document level	`Invoice.supportingDocuments`
`BG-25`	Invoice line	Document level	`Invoice.lines`
`BG-26`	Invoice line period	BG-25 Invoice line	`InvoiceLine.invoicingPeriod`
`BG-27`	Invoice line allowances	BG-25 Invoice line	`InvoiceLine.allowances`
`BG-28`	Invoice line charges	BG-25 Invoice line	`InvoiceLine.charges`
`BG-29`	Price details	BG-25 Invoice line	No field
`BG-30`	Line VAT information	BG-25 Invoice line	No field
`BG-31`	Item information	BG-25 Invoice line	No field
`BG-32`	Item attributes	BG-31 Item information	`InvoiceLine.attributes`

Terms with no field, by group

BG-1 Invoice note. BT-21 Invoice note subject code
BG-4 Seller. BT-28 Seller trading name; BT-29 Seller identifier; BT-33 Seller additional legal information
BG-5 Seller postal address. BT-162 Seller address line 3
BG-7 Buyer. BT-45 Buyer trading name; BT-46 Buyer identifier
BG-8 Buyer postal address. BT-163 Buyer address line 3
BG-12 Seller tax representative postal address. BT-164 Tax representative address line 3
BG-15 Deliver to address. BT-165 Deliver to address line 3
BG-17 Credit transfer. BT-85 Payment account name
BG-18 Payment card information. BT-87 Payment card primary account number; BT-88 Payment card holder name
BG-25 Invoice line. BT-127 Invoice line note; BT-128 Invoice line object identifier; BT-132 Referenced purchase order line reference; BT-133 Invoice line Buyer accounting reference
BG-29 Price details. BT-150 Item price base quantity unit of measure
BG-31 Item information. BT-154 Item description

How this page is kept true

Both halves are read, not written.

The 164 terms and 32 groups come from src/data/en16931-terms.json, extracted by beliq-engine/tools/en16931_terms from Mustang-CLI-2.26.0.jar’s stylesheets/cii-xr.xsl, a KoSIT transform that maps a document onto the semantic model one term at a time. A rule pack would have been the wrong source: it names only the terms a business rule constrains, which is about half of them, and half a denominator doubles the coverage.

The fields come from the generate.mdx tables, where every row already opens with the term it carries. test/field-coverage.test.mjs regenerates this page and fails on any difference, and fails again when a field reaches the invoice schema without reaching those tables.