E-Invoice Error Reference

1375+ 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

1375 errors found · Page 13 of 28

errorCII-FIX-TOTALScii-d16bCONFIRM

CII invoice totals recalculation

The invoice header totals must be internally consistent: LineTotalAmount must equal the sum of line totals, TaxBasisTotalAmount must equal LineTotalAmount + charges - allowances, GrandTotalAmount must equal TaxBasisTotalAmount + TaxTotalAmount, and DuePayableAmount must equal GrandTotalAmount - prepaid amounts. This recalculates the entire cascade and requires your confirmation because it modifies financial values.

errorBR-06EN 16931INPUT

Invoice must have seller name

An Invoice shall contain the Seller name (BT-27). This is the trading name or legal name of the seller/supplier.

errorUBL-SR-15EN16931CONFIRM

Buyer name shall occur maximum once

Your invoice contains multiple Buyer name elements (AccountingCustomerParty/Party/PartyName/Name). EN16931 allows only one buyer name.

errorUBL-SR-51EN16931CONFIRM

An address can only have one third line.

Duplicate address line 3. An address can have at most one additional address line (third line).

errorUBL-SR-52EN16931CONFIRM

Document reference shall occur maximum once

Duplicate document reference. Document reference can only appear once in the specified context.

errorDE-R-018DEUPEPPOL_BISCONFIRM

Invalid Skonto format. Cash discount terms in German invoices must follow the format: #SKONTO#TAGE=N#PROZENT=N.NN# with

Invalid Skonto format. Cash discount terms in German invoices must follow the format: #SKONTO#TAGE=N#PROZENT=N.NN# with optional #BASISBETRAG=N#. Must be uppercase with no extra whitespace.

errorUBL-SR-18EN16931CONFIRM

Buyer VAT identifier shall occur maximum once

Your invoice contains multiple Buyer VAT identifiers (PartyTaxScheme with VAT scheme). EN16931 allows only one VAT identifier per buyer.

errorUBL-SR-37EN16931CONFIRM

Item price discount shall occur maximum once

Your invoice line contains multiple Item price discount elements (Price/AllowanceCharge). EN16931 allows only one discount per price.

warningIT-01ITACIUS-IT (Italy)BLOCKED

Italian sellers should include Codice Fiscale or Partita IVA

Italian sellers should include Codice Fiscale or Partita IVA. This validation rule ensures Invoice compliance with CIUS-IT (Italy).

errorBR-16EN 16931BLOCKED

Invoice line must have an identifier

Each invoice line must have a unique line identifier (ID).

errorUBL-CR-029UBL 2.1AUTO-FIX

A UBL invoice should not include the BillingReference LanguageID

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

errorUBL-SR-47EN 16931AUTO-FIX

Multiple different payment methods on one invoice

Your invoice has multiple payment means sections with different payment method codes. The UBL standard requires that all payment means on a single invoice use the same payment method code.

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.

errorUBL-CR-031UBL 2.1AUTO-FIX

A UBL invoice should not include the BillingReference VersionID

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

errorPEPPOL-COMMON-R046Peppol BIS 3.0AUTO-FIX

Tax Code (Codice Fiscale) must be stated in the correct format

Italian Tax Code (Codice Fiscale) must follow the correct format. This validation applies to a different location in the invoice where tax codes appear.

errorPEPPOL-COMMON-R044Peppol BIS 3.0AUTO-FIX

Italian office code (IPA) has wrong format

The Italian IPA code (Codice Univoco Unità Organizzativa) on your invoice is not in the correct format. It must be exactly 6 uppercase letters and/or digits.

errorBR-23EN 16931AUTO-FIX

Missing unit of measure code

Each Invoice line shall have an Invoiced quantity unit of measure code (BT-130). This identifies the unit of measure for the invoiced quantity using UN/ECE Recommendation 20 codes.

warningUBL-CR-665EN16931AUTO-FIX

A UBL invoice should not include the AdditionalDocumentReference ID schemeID unless the DocumentTypeCode equals '130'

This UBL element should not be present in an EN16931 invoice. It is allowed in full UBL 2.1 but not in the EN16931 subset.

errorPEPPOL-EN16931-R008Peppol BIS 3.0AUTO-FIX

Document MUST not contain empty elements.

The document must not contain empty XML elements. All elements that are present must have content - empty tags are not allowed in PEPPOL invoices.

errorBR-30EN 16931AUTO-FIX

Invoice line period end date before start date

If both Invoice line period start date (BT-134) and Invoice line period end date (BT-135) are given then the end date shall be later or equal to the start date.

warningUBL-CR-680EN16931AUTO-FIX

A UBL invoice should not include the PaymentMeans/PayerFinancialAccount

This UBL element should not be present in an EN16931 invoice. It is allowed in full UBL 2.1 but not in the EN16931 subset.

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.

warningUBL-CR-681EN16931AUTO-FIX

A UBL invoice should not include the PaymentMeans InstructionNote

This UBL element should not be present in an EN16931 invoice. It is allowed in full UBL 2.1 but not in the EN16931 subset.

warningUBL-CR-682EN16931AUTO-FIX

A UBL invoice should not include the Delivery DeliveryAddress

This UBL element should not be present in an EN16931 invoice. It is allowed in full UBL 2.1 but not in the EN16931 subset.

errorBR-51EN 16931AUTO-FIX

Payment card primary account number not masked

The invoice contains a full credit card number (BT-87), which violates PCI security standards. Only the first 6 and last 4 digits should be shown.

warningUBL-DT-13EN16931BLOCKED

Unit code list identifier attribute should not be present

Your invoice contains the unitCodeListID attribute on a quantity element. This attribute is not allowed in EN16931 and must be removed.

errorUBL-SR-12EN 16931AUTO-FIX

Seller VAT identifier shall occur maximum once

Your invoice contains multiple Seller VAT identifiers (PartyTaxScheme with VAT scheme). EN16931 allows only one VAT identifier per seller.

errorPEPPOL-COMMON-R049Peppol BIS 3.0AUTO-FIX

Invalid Swedish organization number

A Swedish organization number (organisationsnummer) in this invoice is not correctly formatted. Swedish org numbers must be exactly 10 digits and include a valid check digit calculated using the Luhn algorithm. This applies to any identifier using scheme 0007, including seller and buyer endpoint addresses, company registration numbers, and party identifiers.

errorBR-CO-18EN 16931INPUT

An Invoice shall at least have one VAT breakdown group (BG-23)

An Invoice shall at least have one VAT breakdown group (BG-23). This applies to the `cac:TaxSubtotal` element in the invoice XML.

errorBR-05EN 16931AUTO-FIX

Missing document currency code

An Invoice shall have an Invoice currency code (BT-5). This specifies the currency used for all monetary amounts in the invoice using ISO 4217 three-letter codes.

warningUBL-DT-26EN16931BLOCKED

EncodingCode attribute should not be present

Your invoice contains the encodingCode attribute on a binary object element. This attribute is not allowed in EN16931 and must be removed.

errorBR-42EN 16931AUTO-FIX

Invoice line allowance reason required

An invoice line allowance (BG-27) is missing both a reason text (BT-139) and reason code (BT-140). At least one must be provided to explain this line discount.

errorKSEF-001POLKSeFINPUT

KSeF NIP validation failed — bad format or wrong identifier field

KSEF-001 fires when a Polish tax identification number (NIP) on a KSeF e-invoice is malformed or placed in the wrong identifier element. A NIP must be exactly 10 digits and pass the official weighted check-digit test; the KSeF schema field that carries it (Podmiot1/Podmiot2 → DaneIdentyfikacyjne → NIP) accepts digits only — no PL prefix, no spaces, no dashes. A second, very common variant is putting a domestic NIP in the EU VAT field (NrVatUE) or a generic identifier (NrID) instead of the NIP element, which both fails validation and breaks routing of the invoice to the correct party inside KSeF.

errorKSEF-005POLKSeFINPUT

KSeF VAT rate invalid — StawkaPodatku not in the Ministry of Finance dictionary

KSEF-005 is raised when a VAT rate or tax category on an FA(2)/FA(3) invoice does not match the values the KSeF schema and the Ministry of Finance dictionary allow. KSeF does not accept arbitrary percentages or free-text descriptions: each line's rate must map to an allowed value (currently 23%, 8%, 5%, 0%) or to one of the markers — zw (exempt), np (out of scope), and the reverse-charge handling — declared through P_12 and consistent with the document totals (P_13_x / P_14_x). A non-dictionary percentage, or a marker inconsistent with the amounts reported for that group, is rejected.

errorKSEF-21115PLksefINPUT

KSeF error 21115 — invalid authentication certificate

KSEF-21115 ("Nieprawidłowy certyfikat" / invalid certificate) is a gateway error returned during authentication, before any invoice is processed. The KSeF 2.0 API rejected the certificate presented to establish the session, so the connection is never authorised and no document reaches schema or business validation. It is an integration/credential problem, not a fault in the invoice XML — the same certificate fails for every document until it is corrected.

warningUBL-DT-27EN16931BLOCKED

Scheme Agency ID attribute should not be present

Your invoice contains the schemeAgencyID attribute on an identifier element. This attribute is not allowed in EN16931 and must be removed.

errorUBL-SR-16EN16931CONFIRM

Buyer identifier shall occur maximum once

Your invoice contains multiple Buyer identifier elements (AccountingCustomerParty/Party/PartyIdentification/ID). EN16931 allows only one buyer identifier.

errorBR-AG-05EN 16931AUTO-FIX

IPSI invoice line VAT rate must be 0% or positive

When an invoice line uses the IPSI VAT category (M for Ceuta/Melilla indirect tax), the VAT rate must be 0 or greater than zero.

errorPEPPOL-EN16931-R101Peppol BIS 3.0AUTO-FIX

Invoice line document reference has wrong type code

A document reference on one of your invoice lines uses the wrong type code. Line-level document references in Peppol invoices must use code "130", which means "invoice line object identifier".

errorUBL-SR-23EN16931CONFIRM

Seller tax representative VAT identifier shall occur maximum once, if the Seller has a tax representative

Your invoice contains multiple Tax representative VAT identifiers (TaxRepresentativeParty/PartyTaxScheme). EN16931 allows only one.

errorUBL-SR-25EN16931CONFIRM

Deliver to party name shall occur maximum once

Your invoice contains multiple Deliver to party name elements (Delivery/DeliveryParty/PartyName/Name). EN16931 allows only one.

errorBR-CL-13EN 16931AUTO-FIX

Invalid product classification scheme

A line item's classification code uses an invalid scheme identifier. The classification listID must be from the UNTDID 7143 code list. Common valid schemes include STI for UNSPSC, EN for eCl@ss, and CPV for EU public procurement.

errorUBL-SR-30EN16931CONFIRM

Document level allowance reason shall occur maximum once

Your invoice contains multiple Document level allowance reason texts (AllowanceCharge/AllowanceChargeReason). EN16931 allows only one reason per allowance.

errorPEPPOL-COMMON-R041Peppol BIS 3.0AUTO-FIX

Norwegian organization number MUST be stated in the correct format.

Norwegian organization numbers must follow the correct format. The organization number is a 9-digit identifier assigned by Brønnøysund Register Centre.

errorPEPPOL-COMMON-R042Peppol BIS 3.0AUTO-FIX

Danish organization number (CVR) MUST be stated in the correct format.

Danish organization numbers (CVR) must follow the correct format. CVR is an 8-digit identifier assigned by the Danish Business Authority.

errorPEPPOL-COMMON-R043Peppol BIS 3.0AUTO-FIX

Belgian enterprise number MUST be stated in the correct format.

Belgian enterprise numbers must follow the correct format. The enterprise number is a 10-digit identifier (0XXX.XXX.XXX format) assigned by the Crossroads Bank for Enterprises.

errorPEPPOL-COMMON-R045Peppol BIS 3.0AUTO-FIX

Tax Code (Codice Fiscale) must be stated in the correct format

Italian Tax Code (Codice Fiscale) must follow the correct format. For individuals, this is a 16-character alphanumeric code; for companies, it may be an 11-digit VAT number.

errorUBL-SR-46EN16931CONFIRM

Payment means text shall occur maximum once

Your invoice contains multiple Payment means instruction text elements. EN16931 allows only one instruction note per payment means.

errorPEPPOL-EN16931-R053Peppol BIS 3.0AUTO-FIX

Only one tax total with tax subtotals must be provided

PEPPOL-EN16931-R053 fires when an invoice contains more than one cac:TaxTotal element that has cac:TaxSubtotal children. Peppol BIS Billing 3.0 allows multiple TaxTotal blocks only in narrow multi-currency scenarios (one in the document currency with subtotals, one in the tax accounting currency without subtotals). The schematron test `count(cac:TaxTotal[cac:TaxSubtotal]) = 1` enforces this: there must be exactly one TaxTotal carrying the category breakdown.

errorSE-R-001Peppol BIS 3.0AUTO-FIX