Business Terms

EN 16931 describes an invoice by its business terms (BT) and business groups (BG), such as the invoice number (BT-1) or the seller (BG-4). The tables below list each of them with what invoice-pro does with it:

• input: an input of invoice-pro states it, and Details names the input: a parameter of invoice, a key of a party, a component or one of its arguments.
• derived: invoice-pro derives it, and Details says from what.
• not supported: invoice-pro does not state it, and Details says why.

The profile decides which of them the XML states (see What Each Profile States); an input the profile cannot state is reported as a warning (IP-PROFILE-01). The scheme identifiers of identifiers (BT-29-1, BT-30-1, BT-34-1, ...) share the entry of their business term. The tables are generated from tools/zugferd/bt-disposition.toml of the repository, which the tests keep complete: every term has a decision.

Of the 196 business terms and groups of EN 16931, invoice-pro states 129 from an input, derives 30 and does not support 37.

Not Supported

Term	Name	Reason
BT-6	VAT accounting currency code	the VAT is stated in the invoice currency; a separate VAT accounting currency is not supported
BT-7	Value added tax point date	the tax point is stated by the actual delivery date (BT-72) or the invoicing period (BG-14)
BT-8	Value added tax point date code	the tax point is stated by the actual delivery date (BT-72) or the invoicing period (BG-14)
BT-14	Sales order reference	no input for the seller's own order number
BT-15	Receiving advice reference	no input; receiving advices are documents of the buyer
BT-17	Tender or lot reference	no input for public procurement references
BT-18	Invoiced object identifier	no input for invoiced objects (e.g. subscriptions, meters)
BT-19	Buyer accounting reference	no input for the buyer's booking account
BT-82	Payment means text	the payment means code (BT-81) says it; no input for a text
BT-93	Document level allowance base amount	a percentage discount is stated by its amount (BT-92); its base is not stated yet
BT-94	Document level allowance percentage	a percentage discount is stated by its amount (BT-92); its percentage is not stated yet
BT-98	Document level allowance reason code	no input for UNTDID 5189 reason codes
BT-100	Document level charge base amount	a percentage surcharge is stated by its amount (BT-99); its base is not stated yet
BT-101	Document level charge percentage	a percentage surcharge is stated by its amount (BT-99); its percentage is not stated yet
BT-105	Document level charge reason code	no input for UNTDID 7161 reason codes
BT-111	Invoice total VAT amount in accounting currency	no VAT accounting currency (BT-6)
BT-114	Rounding amount	amounts are not rounded to a payable amount
BG-24	ADDITIONAL SUPPORTING DOCUMENTS	no input for supporting documents or attachments
BT-122	Supporting document reference	no input for supporting documents or attachments
BT-123	Supporting document description	no input for supporting documents or attachments
BT-124	External document location	no input for supporting documents or attachments
BT-125	Attached document	no input for supporting documents or attachments
BT-128	Invoice line object identifier	no input for invoiced objects of the lines
BT-132	Referenced purchase order line reference	no input for order line references
BT-133	Invoice line Buyer accounting reference	no input for the buyer's booking accounts
BT-137	Invoice line allowance base amount	a percentage discount is stated by its amount (BT-136); its base is not stated yet
BT-138	Invoice line allowance percentage	a percentage discount is stated by its amount (BT-136); its percentage is not stated yet
BT-140	Invoice line allowance reason code	no input for UNTDID 5189 reason codes
BT-142	Invoice line charge base amount	a percentage surcharge is stated by its amount (BT-141); its base is not stated yet
BT-143	Invoice line charge percentage	a percentage surcharge is stated by its amount (BT-141); its percentage is not stated yet
BT-145	Invoice line charge reason code	no input for UNTDID 7161 reason codes
BT-147	Item price discount	prices are stated as net prices (BT-146); discounts of an item are line allowances (BG-27)
BT-148	Item gross price	prices are stated as net prices (BT-146); discounts of an item are line allowances (BG-27)
BT-158	Item classification identifier	no input for item classifications
BG-32	ITEM ATTRIBUTES	no input for item attributes
BT-160	Item attribute name	no input for item attributes
BT-161	Item attribute value	no input for item attributes

All Business Terms

Invoice

Term	Name	invoice-pro	Details
BT-1	Invoice number	input	invoice-nr
BT-2	Invoice issue date	input	date
BT-3	Invoice type code	input	document-type (a named type such as "credit-note", or a UNTDID 1001 code); 380 (commercial invoice) without document-type
BT-5	Invoice currency code	input	currency, else the currency code of the locale (locale, region currency)
BT-6	VAT accounting currency code	not supported	the VAT is stated in the invoice currency; a separate VAT accounting currency is not supported
BT-7	Value added tax point date	not supported	the tax point is stated by the actual delivery date (BT-72) or the invoicing period (BG-14)
BT-8	Value added tax point date code	not supported	the tax point is stated by the actual delivery date (BT-72) or the invoicing period (BG-14)
BT-9	Payment due date	input	due-date (a date), payment-goal(date:) or payment-goal(days:)
BT-10	Buyer reference	input	recipient.buyer-reference or recipient.leitweg-id (text or id.leitweg(..))
BT-11	Project reference	input	project; EN 16931 and XRechnung only
BT-12	Contract reference	input	contract-nr (or recipient.contract-nr)
BT-13	Purchase order reference	input	order-nr (or recipient.order-nr, po-nr)
BT-14	Sales order reference	not supported	no input for the seller's own order number
BT-15	Receiving advice reference	not supported	no input; receiving advices are documents of the buyer
BT-16	Despatch advice reference	input	delivery-note-nr (or recipient.delivery-note-nr)
BT-17	Tender or lot reference	not supported	no input for public procurement references
BT-18	Invoiced object identifier	not supported	no input for invoiced objects (e.g. subscriptions, meters)
BT-19	Buyer accounting reference	not supported	no input for the buyer's booking account
BT-20	Payment terms	input	payment-goal (its text), due-date (a text) or paid (the printed sentence)
BG-1	INVOICE NOTE	input	notes
BT-21	Invoice note subject code	input	notes (subject-code of a note)
BT-22	Invoice note	input	notes (the text of a note)
BG-2	PROCESS CONTROL	derived	the profile (zugferd)
BT-23	Business process type	derived	the Peppol billing process for the EN 16931 and XRechnung profiles
BT-24	Specification identifier	derived	the guideline of the profile (zugferd)
BG-3	PRECEDING INVOICE REFERENCE	input	preceding-invoice-nr
BT-25	Preceding Invoice reference	input	preceding-invoice-nr
BT-26	Preceding Invoice issue date	input	preceding-invoice-date

Seller

Term	Name	invoice-pro	Details
BG-4	SELLER	input	sender
BT-27	Seller name	input	sender.name
BT-28	Seller trading name	input	sender.trading-name
BT-29	Seller identifier	input	sender.id, sender.global-id (text or an identifier of the id module); without an identifier, legal registration or VAT identifier, the tax number (sender.tax-nr) identifies the seller (BR-CO-26)
BT-30	Seller legal registration identifier	input	sender.legal-id (text or an identifier of the id module)
BT-31	Seller VAT identifier	input	sender.vat-id; left out when the invoice is not subject to VAT (BR-O-02)
BT-32	Seller tax registration identifier	input	sender.tax-nr
BT-33	Seller additional legal information	input	sender.legal-info
BT-34	Seller electronic address	input	sender.electronic-address; without one, derived from sender.vat-id or the email address
BG-5	SELLER POSTAL ADDRESS	input	sender.address, sender.city, sender.country
BT-35	Seller address line 1	input	sender.address (first line)
BT-36	Seller address line 2	input	sender.address (second line)
BT-162	Seller address line 3	input	sender.address (further lines)
BT-37	Seller city	input	sender.city (the city name)
BT-38	Seller post code	input	sender.city (the post code)
BT-39	Seller country subdivision	input	sender.city (the state of a city dictionary or of a US city line)
BT-40	Seller country code	input	sender.country; without one, the country of the locale region
BG-6	SELLER CONTACT	input	sender.contact
BT-41	Seller contact point	input	sender.contact.name (or sender.contact-name)
BT-42	Seller contact telephone number	input	sender.contact.phone (or sender.phone)
BT-43	Seller contact email address	input	sender.contact.email (or sender.email)

Buyer

Term	Name	invoice-pro	Details
BG-7	BUYER	input	recipient
BT-44	Buyer name	input	recipient.name
BT-45	Buyer trading name	input	recipient.trading-name
BT-46	Buyer identifier	input	recipient.id or recipient.global-id (text or an identifier of the id module)
BT-47	Buyer legal registration identifier	input	recipient.legal-id (text or an identifier of the id module)
BT-48	Buyer VAT identifier	input	recipient.vat-id; left out when the invoice is not subject to VAT (BR-O-02)
BT-49	Buyer electronic address	input	recipient.electronic-address (e.g. id.leitweg(..)); without one, derived from recipient.vat-id or the email address
BG-8	BUYER POSTAL ADDRESS	input	recipient.address, recipient.city, recipient.country
BT-50	Buyer address line 1	input	recipient.address (first line)
BT-51	Buyer address line 2	input	recipient.address (second line)
BT-163	Buyer address line 3	input	recipient.address (further lines)
BT-52	Buyer city	input	recipient.city (the city name)
BT-53	Buyer post code	input	recipient.city (the post code)
BT-54	Buyer country subdivision	input	recipient.city (the state of a city dictionary or of a US city line)
BT-55	Buyer country code	input	recipient.country; without one, the country of the locale region
BG-9	BUYER CONTACT	input	recipient.contact (or recipient.contact-name, recipient.phone); an email address alone is no contact point: it can be the electronic address (BT-49)
BT-56	Buyer contact point	input	recipient.contact.name (or recipient.contact-name)
BT-57	Buyer contact telephone number	input	recipient.contact.phone (or recipient.phone)
BT-58	Buyer contact email address	input	recipient.contact.email (or recipient.email)

Payee

Term	Name	invoice-pro	Details
BG-10	PAYEE	input	payee
BT-59	Payee name	input	payee.name
BT-60	Payee identifier	input	payee.id or payee.global-id (text or an identifier of the id module)
BT-61	Payee legal registration identifier	input	payee.legal-id (text or an identifier of the id module)

Seller Tax Representative

Term	Name	invoice-pro	Details
BG-11	SELLER TAX REPRESENTATIVE PARTY	input	sender.tax-representative
BT-62	Seller tax representative name	input	sender.tax-representative.name
BT-63	Seller tax representative VAT identifier	input	sender.tax-representative.vat-id
BG-12	SELLER TAX REPRESENTATIVE POSTAL ADDRESS	input	sender.tax-representative.address, .city, .country
BT-64	Tax representative address line 1	input	sender.tax-representative.address (first line)
BT-65	Tax representative address line 2	input	sender.tax-representative.address (second line)
BT-164	Tax representative address line 3	input	sender.tax-representative.address (further lines)
BT-66	Tax representative city	input	sender.tax-representative.city (the city name)
BT-67	Tax representative post code	input	sender.tax-representative.city (the post code)
BT-68	Tax representative country subdivision	input	sender.tax-representative.city (the state of a city dictionary or of a US city line)
BT-69	Tax representative country code	input	sender.tax-representative.country; without one, the country of the locale region

Delivery and Invoicing Period

Term	Name	invoice-pro	Details
BG-13	DELIVERY INFORMATION	input	delivery-address (or recipient.delivery-address); an intra-community supply without delivery address states the buyer's address (BR-IC-12)
BT-70	Deliver to party name	input	delivery-address.name
BT-71	Deliver to location identifier	input	delivery-address.id, .location-id or .global-id
BT-72	Actual delivery date	derived	service-period (a date), else the date of the items (date of item, bundle, group) when they share one, else the invoice date; a credit note or a prepayment invoice without service-period and dates states none: its own date is not the date of the supply
BG-14	DELIVERY OR INVOICE PERIOD	derived	service-period (a period), else the dates of the items (date of item, bundle, group) when they span a period
BT-73	Invoicing period start date	derived	the earliest date of the items
BT-74	Invoicing period end date	derived	the latest date of the items
BG-15	DELIVER TO ADDRESS	input	delivery-address.address, .city, .country
BT-75	Deliver to address line 1	input	delivery-address.address (first line)
BT-76	Deliver to address line 2	input	delivery-address.address (second line)
BT-165	Deliver to address line 3	input	delivery-address.address (further lines)
BT-77	Deliver to city	input	delivery-address.city (the city name)
BT-78	Deliver to post code	input	delivery-address.city (the post code)
BT-79	Deliver to country subdivision	input	delivery-address.city (the state of a city dictionary or of a US city line)
BT-80	Deliver to country code	input	delivery-address.country; without one, the country of the recipient

Payment Instructions

Term	Name	invoice-pro	Details
BG-16	PAYMENT INSTRUCTIONS	input	bank-details, direct-debit, card-payment or paid
BT-81	Payment means type code	derived	the payment means component: bank-details 58 (SEPA credit transfer) in euro, 30 otherwise; direct-debit 59 or 49; card-payment 54, 55 or 48; paid(method:) the code of its method, e.g. 10 for cash
BT-82	Payment means text	not supported	the payment means code (BT-81) says it; no input for a text
BT-83	Remittance information	input	bank-details(reference:, text:), payment-reference or invoice-nr
BG-17	CREDIT TRANSFER	input	bank-details
BT-84	Payment account identifier	input	bank-details(iban:)
BT-85	Payment account name	input	bank-details(name:); only an explicit name: the default account holder, the payee or the seller, is named by BT-59 or BT-27
BT-86	Payment service provider identifier	input	bank-details(bic:)
BG-18	PAYMENT CARD INFORMATION	input	card-payment
BT-87	Payment card primary account number	input	card-payment(last4:)
BT-88	Payment card holder name	input	card-payment(holder:)
BG-19	DIRECT DEBIT	input	direct-debit
BT-89	Mandate reference identifier	input	direct-debit(mandate:)
BT-90	Bank assigned creditor identifier	input	direct-debit(creditor-id:)
BT-91	Debited account identifier	input	direct-debit(debtor-iban:)

Document Level Allowances and Charges

Term	Name	invoice-pro	Details
BG-20	DOCUMENT LEVEL ALLOWANCES	input	discount (a document level modifier); one allowance per VAT category the discount applies to (BR-53)
BT-92	Document level allowance amount	derived	the amount of a document level discount in each VAT category
BT-93	Document level allowance base amount	not supported	a percentage discount is stated by its amount (BT-92); its base is not stated yet
BT-94	Document level allowance percentage	not supported	a percentage discount is stated by its amount (BT-92); its percentage is not stated yet
BT-95	Document level allowance VAT category code	derived	the VAT category the discount applies to (or its tax)
BT-96	Document level allowance VAT rate	derived	the VAT rate the discount applies to (or its tax)
BT-97	Document level allowance reason	input	the name of the discount ("Discount" without one)
BT-98	Document level allowance reason code	not supported	no input for UNTDID 5189 reason codes
BG-21	DOCUMENT LEVEL CHARGES	input	surcharge (a document level modifier); one charge per VAT category the surcharge applies to (BR-53)
BT-99	Document level charge amount	derived	the amount of a document level surcharge in each VAT category
BT-100	Document level charge base amount	not supported	a percentage surcharge is stated by its amount (BT-99); its base is not stated yet
BT-101	Document level charge percentage	not supported	a percentage surcharge is stated by its amount (BT-99); its percentage is not stated yet
BT-102	Document level charge VAT category code	derived	the VAT category the surcharge applies to (or its tax)
BT-103	Document level charge VAT rate	derived	the VAT rate the surcharge applies to (or its tax)
BT-104	Document level charge reason	input	the name of the surcharge ("Surcharge" without one)
BT-105	Document level charge reason code	not supported	no input for UNTDID 7161 reason codes

Totals and VAT Breakdown

Term	Name	invoice-pro	Details
BG-22	DOCUMENT TOTALS	derived	the totals of the line items, as printed
BT-106	Sum of Invoice line net amount	derived	the net amounts of the lines
BT-107	Sum of allowances on document level	derived	the document level allowances (BG-20)
BT-108	Sum of charges on document level	derived	the document level charges (BG-21)
BT-109	Invoice total amount without VAT	derived	the printed net total
BT-110	Invoice total VAT amount	derived	the VAT amounts of the VAT breakdown (BG-23)
BT-111	Invoice total VAT amount in accounting currency	not supported	no VAT accounting currency (BT-6)
BT-112	Invoice total amount with VAT	derived	the printed gross total
BT-113	Paid amount	input	prepayment, or paid (the total)
BT-114	Rounding amount	not supported	amounts are not rounded to a payable amount
BT-115	Amount due for payment	derived	the gross total less the prepayments
BG-23	VAT BREAKDOWN	derived	the VAT groups of the line items (one per category and rate)
BT-116	VAT category taxable amount	derived	the net amounts of the VAT group
BT-117	VAT category tax amount	derived	the VAT of the VAT group, as printed
BT-118	VAT category code	input	tax (constructors of the tax module) of the invoice, the items or the modifiers
BT-119	VAT category rate	input	tax (constructors of the tax module)
BT-120	VAT exemption reason text	input	the grounds of the tax (e.g. tax.exempt(grounds:)); without grounds, the note of the invoice language for AE, K, G and O, as printed
BT-121	VAT exemption reason code	input	tax.exempt(code:) and the other constructors of the tax module without VAT; without code, VATEX-EU-AE, -IC, -G and -O for AE, K, G and O, and VATEX-FR-FRANCHISE for the small business scheme of France

Additional Supporting Documents

Term	Name	invoice-pro	Details
BG-24	ADDITIONAL SUPPORTING DOCUMENTS	not supported	no input for supporting documents or attachments
BT-122	Supporting document reference	not supported	no input for supporting documents or attachments
BT-123	Supporting document description	not supported	no input for supporting documents or attachments
BT-124	External document location	not supported	no input for supporting documents or attachments
BT-125	Attached document	not supported	no input for supporting documents or attachments

Invoice Lines

Term	Name	invoice-pro	Details
BG-25	INVOICE LINE	input	item and bundle (in line-items); a bundle with several VAT groups is stated as one line per group
BT-126	Invoice line identifier	derived	the printed position of the item (pos), otherwise its number
BT-127	Invoice line note	input	item(note:)
BT-128	Invoice line object identifier	not supported	no input for invoiced objects of the lines
BT-129	Invoiced quantity	input	item(quantity:)
BT-130	Invoiced quantity unit of measure code	input	item(unit:) (the unit module, a code or a known unit text)
BT-131	Invoice line net amount	derived	the net total of the item, as printed
BT-132	Referenced purchase order line reference	not supported	no input for order line references
BT-133	Invoice line Buyer accounting reference	not supported	no input for the buyer's booking accounts
BG-26	INVOICE LINE PERIOD	input	item(date:), or the date of its bundle or group
BT-134	Invoice line period start date	input	item(date:), the date or the start of the period
BT-135	Invoice line period end date	input	item(date:), the date or the end of the period
BG-27	INVOICE LINE ALLOWANCES	input	item(modifier: discount(..))
BT-136	Invoice line allowance amount	derived	the amount of the item discount
BT-137	Invoice line allowance base amount	not supported	a percentage discount is stated by its amount (BT-136); its base is not stated yet
BT-138	Invoice line allowance percentage	not supported	a percentage discount is stated by its amount (BT-136); its percentage is not stated yet
BT-139	Invoice line allowance reason	input	the name of the item discount ("Discount" without one)
BT-140	Invoice line allowance reason code	not supported	no input for UNTDID 5189 reason codes
BG-28	INVOICE LINE CHARGES	input	item(modifier: surcharge(..))
BT-141	Invoice line charge amount	derived	the amount of the item surcharge
BT-142	Invoice line charge base amount	not supported	a percentage surcharge is stated by its amount (BT-141); its base is not stated yet
BT-143	Invoice line charge percentage	not supported	a percentage surcharge is stated by its amount (BT-141); its percentage is not stated yet
BT-144	Invoice line charge reason	input	the name of the item surcharge ("Surcharge" without one)
BT-145	Invoice line charge reason code	not supported	no input for UNTDID 7161 reason codes
BG-29	PRICE DETAILS	input	item(price:, base-quantity:)
BT-146	Item net price	input	item(price:); with gross prices (tax-mode: "inclusive"), the net price rounded like every unit price
BT-147	Item price discount	not supported	prices are stated as net prices (BT-146); discounts of an item are line allowances (BG-27)
BT-148	Item gross price	not supported	prices are stated as net prices (BT-146); discounts of an item are line allowances (BG-27)
BT-149	Item price base quantity	input	item(base-quantity:)
BT-150	Item price base quantity unit of measure code	derived	the unit of the item (BT-130)
BG-30	LINE VAT INFORMATION	input	item(tax:) (or the tax of the invoice)
BT-151	Invoiced item VAT category code	input	item(tax:) (constructors of the tax module)
BT-152	Invoiced item VAT rate	input	item(tax:) (constructors of the tax module)
BG-31	ITEM INFORMATION	input	item
BT-153	Item name	input	the name of the item (its first argument)
BT-154	Item description	input	item(description:)
BT-155	Item Seller's identifier	input	item(item-id:) (text or seller)
BT-156	Item Buyer's identifier	input	item(item-id: (buyer: ..))
BT-157	Item standard identifier	input	item(item-id: (standard: ..)) (a GTIN, scheme 0160)
BT-158	Item classification identifier	not supported	no input for item classifications
BT-159	Item country of origin	input	item(origin:); EN 16931 and XRechnung only
BG-32	ITEM ATTRIBUTES	not supported	no input for item attributes
BT-160	Item attribute name	not supported	no input for item attributes
BT-161	Item attribute value	not supported	no input for item attributes