E-Invoice Error Reference

1374+ documented errors for Peppol, UBL, CII, and EN16931 validation errors.

Business Rules Country-Specific Syntax Errors Format Rules

CountryFrance Germany Italy Netherlands Belgium Spain Poland

1374 errors found · Page 6 of 28

warningIN-PRICE-POSITIVEpeppol-bis-3BLOCKED

Item price should be positive

Item price (PriceAmount) should typically be a positive value.

warningIN-QUANTITY-POSITIVEpeppol-bis-3BLOCKED

Line quantity should be positive

Invoice line quantity (InvoicedQuantity) should typically be a positive value.

errorBR-CL-01EN 16931AUTO-FIX

Invalid invoice type code

The invoice type code is not a valid value from the UN/EDIFACT code list 1001. Valid codes include 380 for a standard invoice, 381 for a credit note, 383 for a debit note, 384 for a corrected invoice, 386 for a prepayment invoice, and 389 for a self-billed invoice.

errorBR-CL-03EN 16931AUTO-FIX

currencyID MUST be coded using ISO code list 4217 alpha-3

A currency attribute (currencyID) contains an invalid ISO 4217 code. Currency codes must be 3-letter codes like EUR, USD, GBP.

errorBR-AG-01EN 16931BLOCKED

IPSI VAT breakdown required when IPSI used on lines

When using the IPSI VAT category (M) on invoice lines, allowances, or charges, you must have exactly one matching VAT breakdown section for IPSI.

errorBR-CL-05EN 16931AUTO-FIX

Tax currency code MUST be coded using ISO code list 4217 alpha-3

The Tax Currency Code (BT-6) is not a valid ISO 4217 code. If using a different currency for tax accounting, it must be a valid 3-letter code.

errorUBL-CR-411UBL 2.1AUTO-FIX

A UBL invoice should not include the PaymentMeans ID

Your invoice contains a PaymentMeans ID element which is not allowed in EN16931 invoices. This element must be removed.

errorBR-FR-02FRApeppol-bis-3INPUT

SIREN vs SIRET confusion

SIREN (9 digits) identifies the company, SIRET (14 digits) identifies the specific establishment. French e-invoices require the full 14-digit SIRET.

errorBR-E-02EN 16931INPUT

When using this VAT category, the seller must have a VAT identifier, tax...

When using this VAT category, the seller must have a VAT identifier, tax registration, or tax representative (applies to `cac:InvoiceLine`, rule BR-E-02).

errorBR-DE-25DEUxrechnungBLOCKED

XRechnung invoice type restriction

XRechnung restricts allowed invoice type codes.

warningBR-CL-04EN 16931AUTO-FIX

Invalid currency code

Currency code must be a valid ISO 4217 alpha-3 code (e.g., EUR, USD, GBP). Ensure you are using the three-letter currency code, not a currency symbol or name.

errorBR-IC-03EN 16931INPUT

When using this VAT category, the seller must have a VAT identifier, tax...

When using this VAT category, the seller must have a VAT identifier, tax registration, or tax representative (applies to `cac:AllowanceCharge`, rule BR-IC-03).

errorBR-CL-06EN 16931AUTO-FIX

Value added tax point date code MUST be coded using a restriction of UNTDID...

The VAT Point Date Code (BT-8) is not a valid UNTDID 2005 code. Valid codes indicate when VAT becomes due (e.g., 35=delivery date, 432=payment date).

errorBR-CL-20EN 16931AUTO-FIX

Coded charge reasons MUST belong to the UNCL 7161 code list

A Charge Reason Code is not a valid UNCL 7161 code. Common codes: FC=freight, AAA=advertising, ABL=handling, DL=delivery.

errorBR-IC-04EN 16931INPUT

When using this VAT category, the seller must have a VAT identifier, tax...

When using this VAT category, the seller must have a VAT identifier, tax registration, or tax representative (applies to `cac:AllowanceCharge`, rule BR-IC-04).

errorBR-CL-07EN 16931AUTO-FIX

Object identifier scheme MUST be from UNTDID 1153

An Object Identifier scheme is not a valid UNTDID 1153 code. This identifies what type of reference the object ID represents.

errorBR-DE-20DEUXRechnung (Germany)BLOCKED

The Debited Account (BT-91) should contain a valid IBAN for SEPA direct...

The Debited Account (BT-91) should contain a valid IBAN for SEPA direct debit. The current value doesn't match IBAN format.

errorKSEF-007POLKSeFBLOCKED

Date format invalid

All dates in KSeF invoices must be in YYYY-MM-DD (ISO 8601) format. Other formats are rejected.

errorBR-CL-15EN 16931AUTO-FIX

Country codes in an invoice MUST be coded using ISO code list 3166-1

A country code in the invoice is not a valid ISO 3166-1 alpha-2 code. All country fields must use 2-letter codes.

errorBR-O-03EN 16931INPUT

When using this VAT category, the seller must have a VAT identifier, tax...

When using this VAT category, the seller must have a VAT identifier, tax registration, or tax representative (applies to `cac:AllowanceCharge`, rule BR-O-03).

errorBR-S-09EN 16931AUTO-FIX

VAT amount is calculated incorrectly

The VAT amount in the standard-rated breakdown does not match the taxable amount multiplied by the tax rate. For example, if the taxable amount is 1,000.00 and the rate is 21%, the VAT amount should be 210.00.

errorBR-B-01EN 16931BLOCKED

Split payment requires domestic Italian invoice

Split payment (scissione pagamenti, VAT category B) is only valid for domestic Italian invoices. Both seller and buyer must be in Italy.

warningCZ-R-003CZEisdocBLOCKED

ISDOC format for Czech domestic

Czech domestic invoices may use ISDOC format.

errorcvc-pattern-validxsdINPUT

Value does not match the regex pattern declared in the schema

cvc-pattern-valid is an XSD facet-validation error raised when an element or attribute value fails the xsd:pattern regular expression declared on its simple type. The canonical message reads: "Value 'X' is not facet-valid with respect to pattern 'P' for type 'T'." In EN 16931 invoice payloads it usually fires on identifier fields (BT-30 Seller legal registration ID, BT-46 Buyer identifier, BT-90 Bank assigned creditor identifier), date fields with a stricter UN/CEFACT format pattern, and country-CIUS extensions like the Italian fattura tax-ID pattern.

errorES-R-002ESPfacturaeBLOCKED

Invalid FacturaE format

Spanish B2G invoices must use FacturaE 3.2.x format.

errorDE-R-004DEUEN 16931INPUT

The element "Seller post code" (BT-38) shall be provided.

Seller postal code is missing. German invoices must include the seller's postal code (BT-38).

errorcvc-minLength-validxsdINPUT

Value is shorter than the minimum length declared in the schema

cvc-minLength-valid is an XSD facet-validation error raised when a string is shorter than the xsd:minLength facet on its simple type. The canonical message reads: "Value 'X' with length = N is not facet-valid with respect to minLength '1' for type 'T'." In EN 16931 invoices the overwhelming majority of cases are minLength=1 violations — i.e. an empty element. The XSD treats the empty string as a structural failure, even though the surrounding element is technically present.

errorUBL-CR-055UBL 2.1AUTO-FIX

A UBL invoice should not include the DespatchDocumentReference...

Your invoice contains DespatchDocumentReference/DocumentStatusCode which is not allowed in EN16931 invoices.

errorBR-DE-04DEUxrechnungBLOCKED

Invalid XRechnung CustomizationID

XRechnung invoices must use the correct specification identifier for the version.

errorBR-CL-18EN 16931AUTO-FIX

Invoice line item tax categories MUST be coded using UNCL5305 code list.

PartyTaxScheme/TaxScheme/ID must be "VAT".

errorES-R-004ESPfacturaeBLOCKED

Digital signature required

Spanish FacturaE invoices require XAdES digital signature.

errorCII-SR-001cii-d16bBLOCKED

Invalid CII namespace

CII (Cross Industry Invoice) documents must use the correct namespace declaration.

errorPEPPOL-EN16931-R045EN 16931INPUT

Each document level allowance must have a reason or reason code

PEPPOL-EN16931-R045 is a Schematron rule on the Peppol BIS Billing 3.0 invoice. It asserts that every cac:AllowanceCharge element where ChargeIndicator = false (i.e. an allowance/discount, not a charge) at document level must carry either a free-text AllowanceReason (BT-97) or a coded AllowanceReasonCode (BT-98), or both. The rule prevents anonymous discounts that the buyer cannot reconcile against a contract or promotion.

errorBR-CL-25EN 16931AUTO-FIX

Unit of measure codes MUST be coded according to UN/ECE Recommendation 20.

The scheme identifier for a seller or buyer electronic address (endpoint) is not from the valid Electronic Address Scheme (EAS) code list. Every endpoint ID must specify which numbering system it uses, such as 0088 for GLN, 0007 for Swedish org number, or 0198 for Danish CVR.

errorBR-E-01EN 16931BLOCKED

An Invoice that contains an Invoice line (BG-25), a Document level allowance...

When using VAT category E (exempt), an exemption reason must be provided.

errorBR-CL-10EN 16931AUTO-FIX

Invalid party identifier scheme

The scheme identifier for a seller or buyer party identification number is not a valid code from the ISO 6523 ICD list. Every party identifier must specify which numbering system it belongs to, using a standard code like 0088 for GLN, 0007 for Swedish org number, 0106 for Dutch KvK number, etc.

errorPEPPOL-EN16931-R048EN 16931AUTO-FIX

Invoice line net amount must equal price * quantity ± allowances/charges

PEPPOL-EN16931-R048 is a Schematron calculation rule on the Peppol BIS Billing 3.0 invoice. For each cac:InvoiceLine the rule requires: BT-131 (Invoice line net amount) = (BT-129 Invoiced quantity * BT-146 Item net price / BT-149 Item price base quantity) + sum of BT-141 line-level charges − sum of BT-136 line-level allowances. When the calculated value differs from the value the seller emitted by more than the rounding tolerance, the line is rejected.

errorKSEF-21177PLksefINPUT

Invoice issue date is outside the allowed KSeF window

KSEF-21177 is a server-side validation error returned by the Polish Krajowy System e-Faktur (KSeF) when the FA(2) schema element P_1 (data wystawienia / invoice issue date) is outside the window the platform accepts. KSeF rejects invoices whose issue date is in the future, more than the allowed look-back from the submission timestamp, or in a different reporting period than the one the schema header (DataWytworzeniaFa) declares. The mandate-live behaviour since the February 2026 go-live is strict: the platform returns 400 with this code and the invoice is not stored.

errorUBL-CR-002ubl-2.1AUTO-FIX

Invalid or Missing Namespace

The UBL invoice must use the correct XML namespaces for UBL 2.1.

errorFR-R-006FRAfactur-xBLOCKED

Invalid Factur-X profile identifier

Factur-X invoices must have valid profile in CustomizationID.

errorUBL-CR-024UBL 2.1AUTO-FIX

A UBL invoice should not include the BillingReference UUID

Your invoice contains BillingReference/UUID which is not allowed in EN16931 invoices.

errorBR-CL-11EN 16931AUTO-FIX

Invalid registration identifier scheme

Any registration identifier identification scheme identifier MUST be coded using one of the ISO 6523 ICD list. This applies to the PartyLegalEntity/CompanyID@schemeID attribute.

errorBR-Z-01EN 16931BLOCKED

An Invoice that contains an Invoice line (BG-25), a Document level allowance...

When using VAT category Z (zero rate), an exemption reason code or text must be provided.

errorBR-AE-05EN 16931AUTO-FIX

Reverse charge invoice line must have 0% VAT rate

When an invoice line uses the reverse charge VAT category, the VAT rate must be 0%. Reverse charge means the buyer accounts for VAT, so seller charges zero VAT.

errorUBL-CR-009UBL 2.1AUTO-FIX

Disallowed element: cbc:PaymentAlternativeCurrencyCode

UBL 2.1 Invoice schema does not include `cbc:PaymentAlternativeCurrencyCode`. This element must be removed for EN 16931 compliance.

errorBR-CL-19EN 16931AUTO-FIX

Invalid allowance reason code

Coded allowance reasons MUST belong to the UNCL 5189 code list. This applies to AllowanceChargeReasonCode for allowances (ChargeIndicator=false).

errorBR-CL-21EN 16931AUTO-FIX

Invalid product identifier scheme

A line item's standard product identifier uses an invalid scheme code. The most common standard identifier is a GTIN (barcode number), which should use scheme code 0160. Other valid schemes include ISO 6523 ICD codes for industry-specific numbering systems.

errorBR-ES-02ESPverifactuBLOCKED

Missing VeriFACTU hash chain

Spanish VeriFACTU invoices must include the hash chain for audit trail.

errorGR-R-002GRCubl-2.1BLOCKED

myDATA reporting required

Greek invoices must be reported to myDATA (AADE).

errorBR-CO-17EN 16931BLOCKED

A VAT Category Tax Amount (BT-117) doesn't equal the Taxable Amount (BT-116)...

A VAT Category Tax Amount (BT-117) doesn't equal the Taxable Amount (BT-116) multiplied by the Rate (BT-119). The tax calculation is mathematically wrong.