E-invoice coverage

Generated page

Generated from the list of business terms in packages/engine and the pinned versions in apps/conformance/versions.json by apps/docs/scripts/gen-einvoice.ts; do not edit by hand.

The _invoice block of an e-invoice carries 129 of the 164 business terms of EN 16931 into the XML. This page lists every one of them with the field it comes from, says what the block does not carry, and names the validator and the rules each e-invoice is held to before it is delivered.

Validator and rules

Every e-invoice passes the conformance service before it is delivered: the XML against the rules of its profile, the file against PDF/A-3b. A file that fails is not delivered. In use:

Part	Version
Mustang, which writes the PDF/A-3b and runs the rules of the XML	2.26.0
veraPDF, which checks the file against PDF/A-3b	1.30.2
PDFBox, which reads and writes the PDF	3.0.8
The rules of the XML	Factur-X 1.09.2 (Mustang 2.26.0)
The release of the specification	Factur-X 1.09, ZUGFeRD 2.5
France's rules (AFNOR XP Z12-012), for an invoice between two French businesses	BR-FR Flux 2 1.3.0 (16 February 2026)

Every render names the versions that judged its file in einvoice.validation.versions, beside the SHA-256 of the XML and of the PDF that were judged; see What comes back. France's rules report what they find as warnings; French domestic invoices says which of them the check asks for before rendering.

What the block does not carry

These 35 terms have no field in the block, so an e-invoice from Formfeed never contains them. EN 16931 asks for none of them in every invoice, but some in a situation the block cannot describe: a payee who is not the seller has to be named (BR-17), and so has a seller's tax representative (BR-18). Such an invoice cannot be made with Formfeed yet.

Whole groups among them: the payee (BG-10), the seller's tax representative (BG-11, BG-12), payment cards (BG-18), supporting documents and attachments (BG-24) and item attributes (BG-32).

Term	Name
BT-7	Value added tax point date
BT-11	Project reference
BT-14	Sales order reference
BT-15	Receiving advice reference
BT-16	Despatch advice reference
BT-17	Tender or lot reference
BT-18	Invoiced object identifier
BT-19	Buyer accounting reference
BT-59	Payee name
BT-60	Payee identifier
BT-61	Payee legal registration identifier
BT-62	Seller tax representative name
BT-63	Seller tax representative VAT identifier
BT-64	Tax representative address line 1
BT-65	Tax representative address line 2
BT-66	Tax representative city
BT-67	Tax representative post code
BT-68	Tax representative country subdivision
BT-69	Tax representative country code
BT-71	Deliver to location identifier
BT-82	Payment means text
BT-87	Payment card primary account number
BT-88	Payment card holder name
BT-122	Supporting document reference
BT-123	Supporting document description
BT-124	External document location
BT-125	Attached document
BT-128	Invoice line object identifier
BT-147	Item price discount
BT-148	Item gross price
BT-158	Item classification identifier
BT-159	Item country of origin
BT-160	Item attribute name
BT-161	Item attribute value
BT-164	Tax representative address line 3

Left out in the profile basic

The profile basic has no place for these terms. An e-invoice in basic leaves them out of the XML, and a totals.rounding other than 0 is refused in it.

Term	Name	Field
BT-33	Seller additional legal information	seller.legal_info
BT-41	Seller contact point	seller.contact.name
BT-42	Seller contact telephone number	seller.contact.phone
BT-43	Seller contact email address	seller.contact.email
BT-56	Buyer contact point	buyer.contact.name
BT-57	Buyer contact telephone number	buyer.contact.phone
BT-58	Buyer contact email address	buyer.contact.email
BT-85	Payment account name	payment.account_name
BT-86	Payment service provider identifier	payment.bic
BT-114	Rounding amount	totals.rounding
BT-132	Referenced purchase order line reference	lines[].order_line_reference
BT-133	Invoice line Buyer accounting reference	lines[].buyer_accounting_reference
BT-154	Item description	lines[].description
BT-155	Item Sellers identifier	lines[].seller_item_id
BT-156	Item Buyers identifier	lines[].buyer_item_id

Every business term

The terms with their names in the English edition of EN 16931 and the field of the block each one is written from. Fields are written as in the field reference: [] stands for every item of a list.

Term	Name	Field	Remark
BT-1	Invoice number	number
BT-2	Invoice issue date	issue_date
BT-3	Invoice type code	type_code
BT-5	Invoice currency code	currency
BT-6	VAT accounting currency code	accounting_currency
BT-7	Value added tax point date	–	not carried
BT-8	Value added tax point date code	seller.vat_on_debits	only the code for the invoice date, when seller.vat_on_debits is true
BT-9	Payment due date	payment.due_date
BT-10	Buyer reference	buyer_reference
BT-11	Project reference	–	not carried
BT-12	Contract reference	contract_reference
BT-13	Purchase order reference	order_reference
BT-14	Sales order reference	–	not carried
BT-15	Receiving advice reference	–	not carried
BT-16	Despatch advice reference	–	not carried
BT-17	Tender or lot reference	–	not carried
BT-18	Invoiced object identifier	–	not carried
BT-19	Buyer accounting reference	–	not carried
BT-20	Payment terms	payment.terms
BT-21	Invoice note subject code	notes[].subject_code
BT-22	Invoice note	note, notes[].text
BT-23	Business process type	operation, operation_code
BT-24	Specification identifier	–	from the option profile
BT-25	Preceding Invoice reference	preceding_invoices[].number
BT-26	Preceding Invoice issue date	preceding_invoices[].issue_date
BT-27	Seller name	seller.name
BT-28	Seller trading name	seller.trading_name
BT-29	Seller identifier	seller.id
BT-30	Seller legal registration identifier	seller.legal_registration
BT-31	Seller VAT identifier	seller.vat_id
BT-32	Seller tax registration identifier	seller.tax_number
BT-33	Seller additional legal information	seller.legal_info	in en16931 only
BT-34	Seller electronic address	seller.electronic_address
BT-35	Seller address line 1	seller.address.street
BT-36	Seller address line 2	seller.address.street2
BT-37	Seller city	seller.address.city
BT-38	Seller post code	seller.address.postcode
BT-39	Seller country subdivision	seller.address.subdivision
BT-40	Seller country code	seller.address.country
BT-41	Seller contact point	seller.contact.name	in en16931 only
BT-42	Seller contact telephone number	seller.contact.phone	in en16931 only
BT-43	Seller contact email address	seller.contact.email	in en16931 only
BT-44	Buyer name	buyer.name
BT-45	Buyer trading name	buyer.trading_name
BT-46	Buyer identifier	buyer.id
BT-47	Buyer legal registration identifier	buyer.legal_registration, buyer.siren
BT-48	Buyer VAT identifier	buyer.vat_id
BT-49	Buyer electronic address	buyer.electronic_address
BT-50	Buyer address line 1	buyer.address.street
BT-51	Buyer address line 2	buyer.address.street2
BT-52	Buyer city	buyer.address.city
BT-53	Buyer post code	buyer.address.postcode
BT-54	Buyer country subdivision	buyer.address.subdivision
BT-55	Buyer country code	buyer.address.country
BT-56	Buyer contact point	buyer.contact.name	in en16931 only
BT-57	Buyer contact telephone number	buyer.contact.phone	in en16931 only
BT-58	Buyer contact email address	buyer.contact.email	in en16931 only
BT-59	Payee name	–	not carried
BT-60	Payee identifier	–	not carried
BT-61	Payee legal registration identifier	–	not carried
BT-62	Seller tax representative name	–	not carried
BT-63	Seller tax representative VAT identifier	–	not carried
BT-64	Tax representative address line 1	–	not carried
BT-65	Tax representative address line 2	–	not carried
BT-66	Tax representative city	–	not carried
BT-67	Tax representative post code	–	not carried
BT-68	Tax representative country subdivision	–	not carried
BT-69	Tax representative country code	–	not carried
BT-70	Deliver to party name	delivery.name
BT-71	Deliver to location identifier	–	not carried
BT-72	Actual delivery date	delivery.date
BT-73	Invoicing period start date	period.start
BT-74	Invoicing period end date	period.end
BT-75	Deliver to address line 1	delivery.address.street
BT-76	Deliver to address line 2	delivery.address.street2
BT-77	Deliver to city	delivery.address.city
BT-78	Deliver to post code	delivery.address.postcode
BT-79	Deliver to country subdivision	delivery.address.subdivision
BT-80	Deliver to country code	delivery.address.country
BT-81	Payment means type code	payment.means_code
BT-82	Payment means text	–	not carried
BT-83	Remittance information	payment.reference
BT-84	Payment account identifier	payment.iban
BT-85	Payment account name	payment.account_name	in en16931 only
BT-86	Payment service provider identifier	payment.bic	in en16931 only
BT-87	Payment card primary account number	–	not carried
BT-88	Payment card holder name	–	not carried
BT-89	Mandate reference identifier	payment.mandate_id
BT-90	Bank assigned creditor identifier	payment.creditor_id
BT-91	Debited account identifier	payment.debited_iban
BT-92	Document level allowance amount	allowances[].amount
BT-93	Document level allowance base amount	allowances[].base_amount
BT-94	Document level allowance percentage	allowances[].percent
BT-95	Document level allowance VAT category code	allowances[].tax.category
BT-96	Document level allowance VAT rate	allowances[].tax.rate
BT-97	Document level allowance reason	allowances[].reason
BT-98	Document level allowance reason code	allowances[].reason_code
BT-99	Document level charge amount	charges[].amount
BT-100	Document level charge base amount	charges[].base_amount
BT-101	Document level charge percentage	charges[].percent
BT-102	Document level charge VAT category code	charges[].tax.category
BT-103	Document level charge VAT rate	charges[].tax.rate
BT-104	Document level charge reason	charges[].reason
BT-105	Document level charge reason code	charges[].reason_code
BT-106	Sum of Invoice line net amount	totals.line_net
BT-107	Sum of allowances on document level	totals.allowances
BT-108	Sum of charges on document level	totals.charges
BT-109	Invoice total amount without VAT	totals.tax_basis
BT-110	Invoice total VAT amount	totals.tax_total
BT-111	Invoice total VAT amount in accounting currency	totals.tax_total_accounting
BT-112	Invoice total amount with VAT	totals.grand
BT-113	Paid amount	totals.prepaid
BT-114	Rounding amount	totals.rounding	in en16931 only
BT-115	Amount due for payment	totals.due
BT-116	VAT category taxable amount	tax.breakdown[].basis
BT-117	VAT category tax amount	tax.breakdown[].amount
BT-118	VAT category code	tax.breakdown[].category
BT-119	VAT category rate	tax.breakdown[].rate
BT-120	VAT exemption reason text	tax.breakdown[].exemption_reason
BT-121	VAT exemption reason code	tax.breakdown[].exemption_reason_code
BT-122	Supporting document reference	–	not carried
BT-123	Supporting document description	–	not carried
BT-124	External document location	–	not carried
BT-125	Attached document	–	not carried
BT-126	Invoice line identifier	lines[].id
BT-127	Invoice line note	lines[].note
BT-128	Invoice line object identifier	–	not carried
BT-129	Invoiced quantity	lines[].quantity
BT-130	Invoiced quantity unit of measure code	lines[].unit_code
BT-131	Invoice line net amount	lines[].net_amount
BT-132	Referenced purchase order line reference	lines[].order_line_reference	in en16931 only
BT-133	Invoice line Buyer accounting reference	lines[].buyer_accounting_reference	in en16931 only
BT-134	Invoice line period start date	lines[].period.start
BT-135	Invoice line period end date	lines[].period.end
BT-136	Invoice line allowance amount	lines[].allowances[].amount
BT-137	Invoice line allowance base amount	lines[].allowances[].base_amount
BT-138	Invoice line allowance percentage	lines[].allowances[].percent
BT-139	Invoice line allowance reason	lines[].allowances[].reason
BT-140	Invoice line allowance reason code	lines[].allowances[].reason_code
BT-141	Invoice line charge amount	lines[].charges[].amount
BT-142	Invoice line charge base amount	lines[].charges[].base_amount
BT-143	Invoice line charge percentage	lines[].charges[].percent
BT-144	Invoice line charge reason	lines[].charges[].reason
BT-145	Invoice line charge reason code	lines[].charges[].reason_code
BT-146	Item net price	lines[].net_price
BT-147	Item price discount	–	not carried
BT-148	Item gross price	–	not carried
BT-149	Item price base quantity	lines[].price_base_quantity
BT-150	Item price base quantity unit of measure	lines[].unit_code	the unit of the quantity
BT-151	Invoiced item VAT category code	lines[].tax.category
BT-152	Invoiced item VAT rate	lines[].tax.rate
BT-153	Item name	lines[].name
BT-154	Item description	lines[].description	in en16931 only
BT-155	Item Sellers identifier	lines[].seller_item_id	in en16931 only
BT-156	Item Buyers identifier	lines[].buyer_item_id	in en16931 only
BT-157	Item standard identifier	lines[].standard_item_id
BT-158	Item classification identifier	–	not carried
BT-159	Item country of origin	–	not carried
BT-160	Item attribute name	–	not carried
BT-161	Item attribute value	–	not carried
BT-162	Seller address line 3	seller.address.street3
BT-163	Buyer address line 3	buyer.address.street3
BT-164	Tax representative address line 3	–	not carried
BT-165	Deliver to address line 3	delivery.address.street3