E-Invoice Error Reference

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

345 errors found · Page 1 of 7 in Business Rules

errorBR-03EN 16931AUTO-FIX

Invoice must have an issue date

Every invoice must contain an issue date indicating when the invoice was created.

errorBR-04EN 16931AUTO-FIX

Missing invoice type code

An Invoice shall have an Invoice type code (BT-3). The most common value is 380 for a standard commercial invoice.

errorKSEF-440PLksefBLOCKED

KSeF 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.

errorBR-18EN 16931INPUT

Invoice line price required

Each invoice line must have a price amount (item net price).

errorPEPPOL-EN16931-R040EN 16931AUTO-FIX

Discount 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.

errorPEPPOL-EN16931-R061Peppol BIS 3.0INPUT

Missing 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.

errorBR-21EN 16931AUTO-FIX

Missing 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.

errorBR-25EN 16931INPUT

Invoice line item name required

Each Invoice line shall contain the Item name (BT-153). This describes the goods or services being invoiced.

errorBR-29EN 16931AUTO-FIX

Invoice 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.

errorBR-32EN 16931AUTO-FIX

Each 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.

errorBR-33EN 16931AUTO-FIX

Document 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.

errorBR-38EN 16931AUTO-FIX

Document 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.

errorBR-44EN 16931AUTO-FIX

Invoice 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.

errorBR-CO-15EN 16931AUTO-FIX

Tax exclusive amount calculation error

Invoice total amount with VAT (BT-112) = Invoice total amount without VAT (BT-109) + Invoice total VAT amount (BT-110).. This applies to the `cbc:TaxInclusiveAmount` element in the invoice XML.

errorBR-47EN 16931AUTO-FIX

Line allowance amount required

Line-level AllowanceCharge must include the Amount element.

warningBR-55EN 16931INPUT

Prepayment should reference prepayment invoice

When PrepaidAmount is used, reference the prepayment invoice.

errorBR-62EN 16931AUTO-FIX

The 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)?

errorBR-64EN 16931AUTO-FIX

Item standard identifier needs scheme

If item has standard identifier, scheme must be specified.

errorBR-65EN 16931AUTO-FIX

Buyer item identifier should be unique

The Item classification identifier (BT-158) shall have a Scheme identifier.

errorBR-DEC-03en16931BLOCKED

Document charge: max 2 decimals

Document level charge amount allows max 2 decimal places.

errorBR-66EN 16931AUTO-FIX

An 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.

errorBR-67EN 16931AUTO-FIX

An 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.

errorBR-AE-06EN 16931AUTO-FIX

Document level allowance with reverse charge must have 0% VAT rate

When a document level allowance uses the reverse charge VAT category, the VAT rate must be 0%. Allowances in reverse charge scenarios follow the same zero-rate rule.

errorBR-AG-06EN 16931AUTO-FIX

IPSI document level allowance VAT rate must be 0% or positive

When a document level allowance uses the IPSI VAT category (M for Ceuta/Melilla indirect tax), the VAT rate must be 0 or greater than zero.

errorBR-AG-07EN 16931AUTO-FIX

IPSI document level charge VAT rate must be 0% or positive

When a document level charge uses the IPSI VAT category (M for Ceuta/Melilla indirect tax), the VAT rate must be 0 or greater than zero.

errorBR-AG-09EN 16931AUTO-FIX

IPSI VAT breakdown tax amount must be calculated correctly

The tax amount for the IPSI VAT category in the VAT breakdown must be calculated based on the taxable amount and rate.

errorBR-AG-10EN 16931AUTO-FIX

IPSI VAT breakdown must NOT have exemption reason

An IPSI VAT breakdown must NOT have a VAT exemption reason code or text. IPSI is a positive tax (like standard VAT), so exemption reasons are not applicable.

errorBR-AG-08EN 16931AUTO-FIX

IPSI taxable amount calculation error

The IPSI taxable amount in the VAT breakdown does not match the calculated sum of line amounts plus charges minus allowances for the IPSI category.

warningBR-S-08EN 16931AUTO-FIX

Standard rated VAT amount doesn't add up

The taxable amount in the VAT breakdown for standard-rated items does not match the sum of the corresponding line items, charges, and allowances. For each VAT rate (e.g. 25%, 21%, 19%), the taxable base in the VAT summary must equal: sum of line amounts at that rate, plus charges at that rate, minus allowances at that rate.

errorBR-S-10EN 16931AUTO-FIX

Standard rate must not have exemption reason

VAT category S must not have exemption reason.

errorBR-E-05EN 16931AUTO-FIX

When 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-E-05).

errorBR-E-08EN 16931AUTO-FIX

VAT-exempt taxable amount doesn't add up

The taxable amount in the VAT-exempt breakdown does not match the sum of exempt line items, charges, and allowances. The taxable base must equal: sum of line amounts with category E, plus charges with category E, minus allowances with category E.

errorBR-E-09EN 16931AUTO-FIX

Exempt percentage must be zero

VAT category E must have rate of 0%.

errorBR-Z-05EN 16931AUTO-FIX

In an Invoice line (BG-25) where the Invoiced item VAT category code...

VAT category Z taxable amount must match sum of Z amounts.

errorBR-Z-06EN 16931AUTO-FIX

In a Document level allowance (BG-20) where the Document level allowance VAT...

VAT amount for category Z must be zero.

errorBR-Z-07EN 16931AUTO-FIX

When 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:AllowanceCharge`, rule BR-Z-07).

errorBR-Z-08EN 16931AUTO-FIX

Zero-rated taxable amount doesn't add up

The taxable amount in the zero-rated VAT breakdown does not match the sum of zero-rated line items, charges, and allowances. The taxable base must equal: sum of line amounts with category Z, plus charges with category Z, minus allowances with category Z.

errorBR-Z-09EN 16931AUTO-FIX

The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT...

VAT category Z must have rate of 0%.

errorBR-Z-10EN 16931AUTO-FIX

This 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-Z-10).

errorBR-G-05EN 16931AUTO-FIX

When 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-G-05).

errorBR-G-06EN 16931AUTO-FIX

Export VAT must be zero

VAT amount for category G must be zero.

errorBR-12EN 16931BLOCKED

Invoice total with VAT required

The invoice must contain the total amount including VAT (TaxInclusiveAmount).

errorBR-13EN 16931BLOCKED

Invoice total without VAT required

The invoice must state the amount due for payment (PayableAmount).

errorBR-G-07EN 16931AUTO-FIX

Export requires reason

VAT category G must have exemption reason.

errorBR-G-08EN 16931AUTO-FIX

The 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.

errorBR-G-09EN 16931AUTO-FIX

The 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.

errorBR-G-10EN 16931AUTO-FIX

This 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).

errorBR-E-10EN 16931AUTO-FIX

This 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.

errorBR-IC-01EN 16931BLOCKED

Intra-community must be in breakdown

If any line uses VAT category K, breakdown must include K.

errorBR-IC-05EN 16931AUTO-FIX

When 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).

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