E-invoice error code reference

BR-1: Specification identifier missing (BT-24 / CustomizationID)

Every EN 16931-compliant invoice must include the specification identifier (BT-24). This field tells the receiving system which invoice profile is in use: Factur-X, Peppol BIS 3.0, XRechnung, ZUGFeRD, etc. Missing this field triggers BR-1.

BR-2: invoice number missing

The invoice does not contain an invoice number (BT-1). This is one of the fundamental mandatory fields of EN 16931 — without it the file is rejected by every compliant validator, including Chorus Pro and Peppol access points.

BR-3: invoice issue date missing

The invoice does not contain an issue date (BT-2), or the date is present but in a format the validator does not accept. The issue date is mandatory in every EN 16931-compliant format.

BR-4: invoice type code missing

The invoice does not state a document type code (BT-3). This code signals whether the document is an invoice, a credit note, or a corrected invoice — without it the recipient's system cannot determine how to process the document.

BR-5: invoice currency code missing or invalid

The invoice does not state a currency code (BT-5), or the supplied code is not a valid ISO 4217 code. The currency is mandatory: every amount on the invoice is interpreted in this currency.

BR-6: seller name missing

The invoice does not state the seller name (BT-27). The issuing party's legal name is a mandatory EN 16931 field in every format.

BR-7: buyer name missing

The invoice does not state the buyer name (BT-44). This is the counterpart to the seller name (BT-27, BR-6): the standard requires both parties to be identified by name on every invoice.

BR-8: seller postal address missing

The invoice has no seller postal address (BG-5) at all — the address group itself is missing, not just one of its fields. This address group is distinct from the seller VAT identifier (BR-CO-9) and country code (BR-9), which are sub-fields inside this same group.

BR-9: seller country code missing

The seller postal address (BG-5) does not contain a country code (BT-40). This field is separate from the VAT number check (BR-CO-9): it's the country of the physical address, required even if the seller has no VAT number.

BR-10: buyer postal address missing

The invoice has no buyer postal address (BG-8) at all — the buyer-side counterpart of BR-8. The address group itself is missing, distinct from the country code (BT-55, checked by BR-11) which is a sub-field inside that group.

BR-11: buyer country code missing

The buyer postal address does not contain a country code (BT-55). This is the buyer-side counterpart of BR-9: both parties need a complete address with a country on every invoice, domestic or cross-border.

BR-12: sum of invoice line net amounts missing

The invoice does not state the sum of invoice line net amounts (BT-106) at document level. This field is distinct from each line's own net amount (BT-131, checked by BR-24) — it is their total, calculated once for the whole document.

BR-13: invoice total amount without VAT missing

The invoice does not state the total amount without VAT (BT-109). This field folds in the line total (BT-106) plus document-level allowances and charges (BG-20/BG-21); it then feeds the calculation of BT-112, checked by BR-CO-15.

BR-14: invoice total amount with VAT missing

The invoice does not state the total amount with VAT (BT-112). This is the final amount before deducting any prepaid amount (BT-113) — the amount actually due (BT-115) is calculated separately and checked by BR-CO-16.

BR-24: invoice line net amount missing

One or more invoice lines have no net amount (BT-131). This is the line amount excluding VAT — it feeds directly into the document's net total (BT-106), and its consistency is checked by BR-CO-16.

BR-25: invoice line description missing

One or more invoice lines have no item name (BT-153). Unlike document-level errors, this rule fires per line — the message states which line is affected.

BR-45: VAT breakdown taxable amount missing

One or more VAT breakdown groups (BG-23) have no taxable amount (BT-116) — the amount the category's VAT rate is applied to. This field feeds the VAT amount calculation (BT-117), checked by BR-CO-17.

BR-46: VAT breakdown tax amount missing

One or more VAT breakdown groups (BG-23) have no VAT amount (BT-117) — the calculated tax for that category. This is the counterpart of BR-45 (taxable amount): the two fields together are what BR-CO-17 checks for consistency.

BR-47: VAT category code missing from breakdown

One or more VAT breakdown groups (BG-23) have no category code (BT-118) — the code that defines the applied regime (standard, exempt, reverse charge, zero-rated, etc.). Without this code, the breakdown's taxable amount and VAT amount cannot be interpreted.

BR-CL-01: invalid invoice type code

The document type code (BT-3) is not in the UNTDID 1001 code list accepted by EN 16931. Common values are 380 (commercial invoice), 381 (credit note), 384 (corrected invoice) and 386 (prepayment invoice).

BR-CO-9: VAT number missing country code prefix

VAT identifiers (BT-31 seller, BT-63 tax representative, BT-48 buyer) must begin with the ISO 3166-1 alpha-2 country code. A number without prefix — e.g. '12345678901' instead of 'FR12345678901' — triggers BR-CO-9.

BR-CO-15: Invoice total amount with VAT is incorrect

The invoice total amount with VAT (BT-112) does not equal the sum of the total amount without VAT (BT-109) and the total VAT amount (BT-110). This arithmetic rule is enforced across all EN 16931-compliant formats: Factur-X, ZUGFeRD, XRechnung, and Peppol BIS.

BR-CO-16: Amount due for payment is incorrect

The amount due for payment (BT-115) does not match the formula: Invoice total with VAT (BT-112) − Paid amount (BT-113) + Rounding (BT-114). This rule applies to all EN 16931-compliant formats: Factur-X, ZUGFeRD, XRechnung, and Peppol BIS.

BR-CO-17: VAT category tax amount is incorrect

In the VAT breakdown (BG-23), the category tax amount (BT-117) does not equal the taxable amount (BT-116) multiplied by the rate (BT-119) divided by 100, rounded to two decimals. Together with BR-CO-15 this is the most common VAT rounding error.

BR-CO-26: no seller identifier present

The invoice carries none of the three seller identifiers: seller identifier (BT-29), legal registration identifier (BT-30, e.g. company register number) or VAT identifier (BT-31). At least one of the three is required so the buyer can automatically identify the supplier.

BR-S-2: Seller VAT identifier missing for standard-rated VAT

When an invoice contains at least one standard-rated VAT breakdown (category code S, e.g. 20% France, 19% Germany), the seller VAT identifier (BT-31) or seller tax representative VAT identifier (BT-63) must be present. Missing this field triggers BR-S-2.

XRechnung error BR-DE-1: payment means missing

BR-DE-1 requires that an XRechnung contains at least one payment means. This includes payment instructions such as IBAN/BIC for bank transfer, direct debit data, or other payment methods. The PaymentMeans element (cac:PaymentMeans) must be present.

XRechnung error BR-DE-2: seller contact group missing

BR-DE-2 requires that every XRechnung contains the SELLER CONTACT group (BG-6) — the seller's contact details. This group holds the contact point (BT-41), telephone number (BT-42) and email address (BT-43).

XRechnung error BR-DE-3: seller city missing

BR-DE-3 requires the seller postal address (BG-5) to contain the city (BT-37). EN 16931 requires only the country code — XRechnung additionally makes the city and post code mandatory.

XRechnung error BR-DE-4: seller post code missing

BR-DE-4 requires the seller postal address (BG-5) to contain the post code (BT-38). XRechnung makes the post code and city mandatory, unlike the EN 16931 core.

XRechnung error BR-DE-5: seller contact point missing

BR-DE-5 requires the name of the seller contact point (BT-41). It is part of the seller contact group (BG-6), which XRechnung makes mandatory (see BR-DE-2).

XRechnung error BR-DE-6: seller contact telephone missing

BR-DE-6 requires the seller contact telephone number (BT-42). It is part of the seller contact group (BG-6), which XRechnung makes mandatory (see BR-DE-2).

XRechnung error BR-DE-7: seller contact email missing

BR-DE-7 requires the seller contact email address (BT-43). It is part of the seller contact group (BG-6), which XRechnung makes mandatory (see BR-DE-2).

XRechnung error BR-DE-8: buyer city missing

BR-DE-8 requires the buyer postal address (BG-8) to contain the city (BT-52). EN 16931 requires only the country code — XRechnung additionally makes the city and post code mandatory.

XRechnung error BR-DE-9: buyer post code missing

BR-DE-9 requires the buyer postal address (BG-8) to contain the post code (BT-53). Together with BR-DE-8 (city), XRechnung makes the full buyer address mandatory.

XRechnung error BR-DE-10: deliver-to city missing

BR-DE-10 requires that a supplied deliver-to address (BG-15, 'DELIVER TO ADDRESS') contains the city of the delivery location (BT-77). The rule applies only when a deliver-to address is present.

XRechnung error BR-DE-11: deliver-to post code missing

BR-DE-11 requires that a supplied deliver-to address (BG-15, 'DELIVER TO ADDRESS') contains the post code of the delivery location (BT-78). The rule applies only when a deliver-to address is present.

XRechnung BR-DE-13 (legacy): delivery date or invoice period

Note: BR-DE-13 is no longer part of the current XRechnung 3.x rule set — modern validators do not emit this code. Historically it covered the recommendation to provide either the actual delivery date (BT-72) or an invoice period (BG-14). That information is still good practice but is now checked through the EN 16931 core rather than a dedicated BR-DE rule.

XRechnung error BR-DE-15: Leitweg-ID missing

BR-DE-15 is the most common rejection reason for XRechnung invoices. The Buyer reference (Leitweg-ID) is missing or has an invalid format. The field cbc:BuyerReference in UBL format or ram:BuyerReference in CII format must be present and non-empty.

XRechnung error BR-DE-16: tax identification missing

BR-DE-16 requires that the invoice issuer (seller) provides either a German tax number (SchemeID 'FC') or a VAT identification number (SchemeID 'VA') in the SellerTaxRegistration field. At least one of these two fields must be populated.

XRechnung BR-DE-17: disallowed invoice type code

BR-DE-17 is a warning: the invoice type code (BT-3) should only use the following UNTDID 1001 codes: 326 (partial invoice), 380 (commercial invoice), 381 (credit note), 384 (corrected invoice), 389 (self-billed invoice), 875/876/877 (construction invoices).

XRechnung BR-DE-19: IBAN missing for SEPA credit transfer

BR-DE-19 is a warning (not a hard error): when the payment means type code (BT-81) is 58 (SEPA credit transfer), the payment account identifier (BT-84) should contain a correct IBAN.

XRechnung BR-DE-20: debited IBAN for SEPA direct debit

BR-DE-20 is a warning: when the payment means type code (BT-81) is 59 (SEPA direct debit), the debited account identifier (BT-91) should contain a correct IBAN.

XRechnung BR-DE-21: specification identifier is not XRechnung

BR-DE-21 is a warning: the specification identifier (BT-24, CustomizationID) should syntactically correspond to the official identifier of the XRechnung standard (e.g. 'urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0').

XRechnung BR-DE-26: preceding invoice reference missing

BR-DE-26 is a warning: when the invoice type code (BT-3) is 384 (corrected invoice), the PRECEDING INVOICE REFERENCE group (BG-3) should be present at least once and point to the original invoice.