E-Invoice Error Reference
1369+ documented errors for Peppol, UBL, CII, and EN16931 validation errors.
346 errors found · Page 1 of 7 in Business Rules
BR-03EN 16931AUTO-FIXInvoice must have an issue date
Every invoice must contain an issue date indicating when the invoice was created.
BR-04EN 16931AUTO-FIXMissing invoice type code
An Invoice shall have an Invoice type code (BT-3). The most common value is 380 for a standard commercial invoice.
BR-53EN 16931BLOCKEDVAT amount in accounting currency is missing
Your invoice declares a tax accounting currency (different from the invoice currency), but the total VAT amount in that accounting currency is not provided. When using a separate tax currency, you must include the VAT total in both currencies.
BR-17EN 16931INPUTInvoice line item name required
Each invoice line must have an item name describing what is being invoiced.
BR-19EN 16931INPUTThe Seller tax representative postal address (BG-12) shall be provided in...
The Seller tax representative postal address (BG-12) shall be provided in the Invoice, if the Seller (BG-4) has a Seller tax representative party (BG-11). This applies to the `cac:PostalAddress` element in the invoice XML.
BR-20EN 16931INPUTThe Seller tax representative postal address (BG-12) shall contain a Tax...
The Seller tax representative postal address (BG-12) shall contain a Tax representative country code (BT-69), if the Seller (BG-4) has a Seller tax representative party (BG-11). This applies to the `cac:PostalAddress` element in the invoice XML.
KSEF-440PLksefBLOCKEDKSeF Duplicate Invoice Rejection (HTTP 440)
The KSeF system rejected your invoice because it detected a duplicate submission. KSeF checks the combination of seller NIP, invoice number, and invoice date against all invoices submitted in the last 10 years. If a match is found, the API returns HTTP status 440 and the invoice is not accepted.
BR-22EN 16931INPUTInvoice currency code required
The invoice must specify the document currency using ISO 4217 alpha-3 code.
BR-25EN 16931INPUTInvoice line item name required
Each Invoice line shall contain the Item name (BT-153). This describes the goods or services being invoiced.
BR-24EN 16931BLOCKEDAmount currency must match document currency
Each Invoice line (BG-25) shall have an Invoice line net amount (BT-131).. Check the `cbc:LineExtensionAmount` element in your invoice XML.
BR-45EN 16931BLOCKEDEach VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116).
Each VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116).. Check the `cac:TaxSubtotal` element in your invoice XML.
BR-18EN 16931INPUTInvoice line price required
Each invoice line must have a price amount (item net price).
PEPPOL-EN16931-R040EN 16931AUTO-FIXDiscount or surcharge amount doesn't match the calculation
A discount or surcharge amount does not match its base amount multiplied by the percentage. When all three values are provided (amount, base amount, and percentage), they must be consistent: amount = base amount × percentage ÷ 100.
PEPPOL-EN16931-R061Peppol BIS 3.0INPUTMissing direct debit mandate reference
When payment is by direct debit (SEPA or other), the invoice must include the mandate reference number. This is the unique identifier of the agreement that authorizes the seller to collect payment from the buyer's bank account.
BR-CO-18EN 16931INPUTAn 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.
BR-21EN 16931AUTO-FIXMissing invoice line identifier
Each Invoice line shall have an Invoice line identifier (BT-126). This is a unique sequential number identifying each line item on the invoice.
BR-13EN 16931BLOCKEDInvoice total without VAT required
The invoice must state the amount due for payment (PayableAmount).
BR-G-08EN 16931AUTO-FIXThe taxable amount for this VAT category must equal the sum of line amounts...
The taxable amount for this VAT category must equal the sum of line amounts minus allowances plus charges for this category.
BR-G-09EN 16931AUTO-FIXThe tax amount for this VAT category must be 0 (zero). This category does...
The tax amount for this VAT category must be 0 (zero). This category does not generate tax.
BR-G-10EN 16931AUTO-FIXThis VAT category requires an exemption reason code or text explaining why...
This VAT category requires an exemption reason code or text explaining why no tax is charged (applies to `cac:TaxSubtotal`, rule BR-G-10).
BR-IC-05EN 16931AUTO-FIXWhen using this VAT category, the VAT rate must be 0 (zero). This category...
When using this VAT category, the VAT rate must be 0 (zero). This category does not have a positive tax rate (applies to `cac:InvoiceLine`, rule BR-IC-05).
BR-IC-09EN 16931AUTO-FIXThe tax amount for this VAT category must be 0 (zero). This category does...
The tax amount for this VAT category must be 0 (zero). This category does not generate tax (applies to `cbc:TaxAmount`, rule BR-IC-09).
BR-29EN 16931AUTO-FIXInvoice period end date before start date
The Invoicing Period End Date (BT-74) is before the Start Date (BT-73). The end date must be on or after the start date.
BR-32EN 16931AUTO-FIXEach Document level allowance (BG-20) shall have a Document level allowance...
Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95). Check the `cac:AllowanceCharge` element in your invoice XML.
BR-33EN 16931AUTO-FIXDocument level allowance reason required
A document level allowance (discount) is missing both a reason text (BT-97) and reason code (BT-98). At least one must be provided to explain why this discount exists.
BR-O-08EN 16931AUTO-FIXThe taxable amount for this VAT category must equal the sum of line amounts...
The taxable amount for this VAT category must equal the sum of line amounts minus allowances plus charges for this category (applies to `cac:TaxSubtotal`, rule BR-O-08).
BR-38EN 16931AUTO-FIXDocument level charge reason required
A document level charge is missing both a reason text (BT-104) and reason code (BT-105). At least one must be provided to explain what this charge is for.
DE-R-008DEUEN 16931AUTO-FIXThe element "Buyer city" (BT-52) shall be provided.
Buyer city is missing. German invoices must include the buyer's city in the address (BT-52).
BR-44EN 16931AUTO-FIXInvoice line charge reason required
An invoice line charge (BG-28) is missing both a reason text and reason code. At least one must be provided to explain this line surcharge.
BR-47EN 16931AUTO-FIXLine allowance amount required
Line-level AllowanceCharge must include the Amount element.
BR-CL-16EN 16931AUTO-FIXInvalid payment means code
The payment means code must be a valid code from the UNTDID 4461 code list. Common codes: 10 (Cash), 30 (Credit transfer), 48 (Bank card), 49 (Direct debit), 58 (SEPA credit transfer), 59 (SEPA direct debit).
BR-CL-17EN 16931AUTO-FIXInvoice tax categories MUST be coded using UNCL5305 code list
A VAT Category Code is not a valid UNCL5305 code. Valid codes: S=standard, Z=zero, E=exempt, AE=reverse charge, K=intra-community.
BR-CL-26EN 16931AUTO-FIXDelivery location identifier scheme identifier MUST belong to the ISO 6523...
A Delivery Location Identifier scheme is not a valid ISO 6523 ICD code. Location identifiers need proper scheme codes.
BR-CL-23EN 16931AUTO-FIXUnit code MUST be coded according to the UN/ECE Recommendation 20 with Rec...
A Unit of Measure Code is not a valid UN/ECE Rec 20/21 code. Common codes: C62=unit, HUR=hour, KGM=kilogram, MTR=meter.
BR-AF-01EN 16931BLOCKEDWhen an invoice contains items, allowances, or charges with VAT category...
When an invoice contains items, allowances, or charges with VAT category "IGIC" (Canary Islands indirect tax), the VAT breakdown must include at least one entry with the IGIC VAT category code.
CII-SR-462cii-d16bINPUTOnly one DueDateTypeCode may be present across all tax breakdown entries
CII-SR-462 is a fatal EN 16931 syntax rule on the CII binding. It asserts that across every ram:ApplicableTradeTax block in the document, either no ram:DueDateTypeCode is present, or every DueDateTypeCode carries the same value. The XPath test is count(//ram:ApplicableTradeTax/ram:DueDateTypeCode)=0 or count(distinct-values(//ram:ApplicableTradeTax/ram:DueDateTypeCode))=1.
BR-55EN 16931INPUTPrepayment should reference prepayment invoice
When PrepaidAmount is used, reference the prepayment invoice.
BR-62EN 16931AUTO-FIXThe Seller electronic address (BT-34) shall have a Scheme identifier.
The Seller Electronic Address (BT-34) is missing its Scheme Identifier. What type of address is this (PEPPOL ID, GLN, email)?
BR-64EN 16931AUTO-FIXItem standard identifier needs scheme
If item has standard identifier, scheme must be specified.
BR-65EN 16931AUTO-FIXBuyer item identifier should be unique
The Item classification identifier (BT-158) shall have a Scheme identifier.
BR-DEC-03en16931BLOCKEDDocument charge: max 2 decimals
Document level charge amount allows max 2 decimal places.
BR-66EN 16931AUTO-FIXAn Invoice shall contain maximum one Payment Card account (BG-18).
The invoice contains multiple Payment Card accounts (BG-18). Only one card payment method is allowed per invoice.
BR-O-11EN 16931BLOCKEDMixed VAT categories with "Not subject to VAT". When using VAT category O...
Mixed VAT categories with "Not subject to VAT". When using VAT category O (Not subject to VAT), no other VAT categories are allowed on the invoice.
BR-O-13EN 16931BLOCKEDInconsistent allowance VAT with "Not subject to VAT". Document allowances...
Inconsistent allowance VAT with "Not subject to VAT". Document allowances must use VAT category O when the invoice uses "Not subject to VAT".
BR-67EN 16931AUTO-FIXAn Invoice shall contain maximum one Payment Mandate (BG-19).
The invoice contains multiple Payment Mandates (BG-19). Only one direct debit mandate is allowed per invoice.
BR-DEC-11EN 16931AUTO-FIXThe allowed maximum number of decimals for the Sum of charges on document...
The sum of document level charges has too many decimal places. This total must have a maximum of 2 decimal places.
BR-DEC-13EN 16931AUTO-FIXThe allowed maximum number of decimals for the Invoice total VAT amount...
The invoice total VAT amount has too many decimal places. The total tax amount must have a maximum of 2 decimal places.
BR-DEC-14EN 16931AUTO-FIXThe allowed maximum number of decimals for the Invoice total amount with VAT...
The invoice total amount with VAT (tax inclusive amount) has too many decimal places. This grand total must have a maximum of 2 decimal places.
BR-DEC-24EN 16931AUTO-FIXThe allowed maximum number of decimals for the Invoice line allowance amount...
The invoice line allowance amount has too many decimal places. Line-level allowance amounts must have a maximum of 2 decimal places.
BR-DEC-25EN 16931AUTO-FIXThe allowed maximum number of decimals for the Invoice line allowance base...
The invoice line allowance base amount has too many decimal places. The base amount for calculating line allowances must have a maximum of 2 decimal places.
Handle These Errors Automatically in Your Pipeline
The compliance engine auto-remediates validation errors with controlled safety policies and evidence pack generation.
Get API Access→