Business Rules Errors
EN 16931 semantic validation errors (BR-xx codes) that enforce invoice content requirements like mandatory fields, VAT calculations, and document totals.
100 errors documented
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-08EN 16931INPUTSeller must have postal address
An Invoice shall contain the Seller postal address (BG-5). At minimum, the country code is required.
BR-12EN 16931BLOCKEDInvoice total with VAT required
The invoice must contain the total amount including VAT (TaxInclusiveAmount).
BR-13EN 16931BLOCKEDInvoice total without VAT required
The invoice must state the amount due for payment (PayableAmount).
BR-15EN 16931BLOCKEDInvoice line quantity required
The Amount due for payment (BT-115) is required.. Check the `cbc:PayableAmount` element in your invoice XML.
BR-17EN 16931INPUTInvoice line item name required
Each invoice line must have an item name describing what is being invoiced.
BR-18EN 16931INPUTInvoice line price required
Each invoice line must have a price amount (item net price).
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.
BR-16EN 16931BLOCKEDInvoice line must have an identifier
Each invoice line must have a unique line identifier (ID).
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-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-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-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.
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-CO-15EN 16931AUTO-FIXTax 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.
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-47EN 16931AUTO-FIXLine allowance amount required
Line-level AllowanceCharge must include the Amount element.
BR-48EN 16931BLOCKEDDocument allowance tax category required
Document-level allowances/charges must specify the VAT category.
BR-49EN 16931INPUTA Payment instruction (BG-16) shall specify the Payment means type code (BT-81)
A Payment instruction (BG-16) shall specify the Payment means type code (BT-81). This applies to the `cac:PaymentMeans` element in the invoice XML.
BR-52EN 16931INPUTEach Additional supporting document (BG-24) shall contain a Supporting...
InvoiceTypeCode must be a valid UNTDID 1001 document type code.
BR-57EN 16931INPUTEach Deliver to address (BG-15) shall contain a Deliver to country code (BT-80)
Each Deliver to address (BG-15) shall contain a Deliver to country code (BT-80). This applies to the `cac:Address` element in the invoice XML.
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-DEC-08en16931BLOCKEDAllowance total: max 2 decimals
AllowanceTotalAmount allows max 2 decimal places.
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-02EN 16931INPUTInvoice must have an invoice number
Every invoice must contain a unique invoice number (ID) to identify the document.
BR-AE-02EN 16931INPUTReverse charge requires both VAT IDs
Reverse charge requires seller and buyer VAT identifiers.
BR-AE-03EN 16931INPUTWhen document level allowances use the reverse charge VAT category, both...
When document level allowances use the reverse charge VAT category, both seller and buyer must have proper tax identifiers for tax compliance.
BR-AE-04EN 16931INPUTWhen document level charges use the reverse charge VAT category, both seller...
When document level charges use the reverse charge VAT category, both seller and buyer must have proper tax identifiers for tax compliance.
BR-AE-06EN 16931AUTO-FIXDocument 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.
BR-AF-02EN 16931INPUTWhen invoice lines use the IGIC VAT category, the seller must have a proper...
When invoice lines use the IGIC VAT category, the seller must have a proper tax identifier (VAT ID, tax registration, or tax representative VAT ID).
BR-AF-03EN 16931INPUTWhen document level allowances use the IGIC VAT category, the seller must...
When document level allowances use the IGIC VAT category, the seller must have a proper tax identifier.
BR-AF-04EN 16931INPUTWhen document level charges use the IGIC VAT category, the seller must have...
When document level charges use the IGIC VAT category, the seller must have a proper tax identifier.
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-AG-06EN 16931AUTO-FIXIPSI 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.
BR-AG-07EN 16931AUTO-FIXIPSI 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.
BR-AG-09EN 16931AUTO-FIXIPSI 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.
BR-AG-10EN 16931AUTO-FIXIPSI 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.
BR-CO-02en16931INPUTPayment means code must be valid
Payment means type code must be from UNCL4461.
BR-AG-01EN 16931BLOCKEDIPSI 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.
BR-AG-02EN 16931INPUTWhen 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.
BR-AG-03EN 16931INPUTWhen 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-AG-03).
BR-AG-04EN 16931INPUTWhen 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-AG-04).
BR-AG-08EN 16931AUTO-FIXIPSI 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.
BR-B-01EN 16931BLOCKEDSplit 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.
BR-S-02EN 16931INPUTStandard rated invoice requires seller VAT number
This invoice charges standard-rate VAT but does not include the seller's VAT identification number. When an invoice includes items at a standard VAT rate, the seller must provide their VAT ID, tax registration number, or a tax representative's VAT ID.
BR-S-04EN 16931INPUTSeller VAT number missing (required for standard-rated charges)
Your invoice includes a document-level charge (surcharge) with standard VAT rate, but the seller does not have a VAT registration number on the invoice. Standard-rated VAT charges require the seller to be VAT-registered.
BR-S-06EN 16931INPUTStandard rate VAT calculation error
In a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is "Standard rated" the Document level allowance VAT rate (BT-96) shall be greater than zero.. This applies to the `cac:AllowanceCharge` element in the invoice XML.
BR-S-07EN 16931INPUTWhen 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.
BR-S-08EN 16931AUTO-FIXStandard 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.
BR-S-10EN 16931AUTO-FIXStandard rate must not have exemption reason
VAT category S must not have exemption reason.
BR-E-03EN 16931INPUTWhen 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-E-03).
BR-E-04EN 16931INPUTWhen 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-E-04).
BR-E-01EN 16931BLOCKEDAn Invoice that contains an Invoice line (BG-25), a Document level allowance...
When using VAT category E (exempt), an exemption reason must be provided.
BR-E-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-E-05).
BR-E-08EN 16931AUTO-FIXVAT-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.
BR-E-09EN 16931AUTO-FIXExempt percentage must be zero
VAT category E must have rate of 0%.
BR-Z-01EN 16931BLOCKEDAn 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.
BR-Z-02EN 16931INPUTWhen 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-Z-02).
BR-Z-03EN 16931INPUTWhen 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-Z-03).
BR-Z-04EN 16931INPUTWhen 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-Z-04).
BR-34peppol-bis-3INPUTInvoice line VAT category required
Each invoice line must specify which VAT category applies to that line.
BR-Z-05EN 16931AUTO-FIXIn an Invoice line (BG-25) where the Invoiced item VAT category code...
VAT category Z taxable amount must match sum of Z amounts.
BR-Z-06EN 16931AUTO-FIXIn a Document level allowance (BG-20) where the Document level allowance VAT...
VAT amount for category Z must be zero.
BR-Z-07EN 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:AllowanceCharge`, rule BR-Z-07).
BR-Z-08EN 16931AUTO-FIXZero-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.
BR-Z-09EN 16931AUTO-FIXThe VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT...
VAT category Z must have rate of 0%.
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.
BR-Z-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-Z-10).
BR-K-01en16931BLOCKEDIntra-community supply VAT treatment
VAT category K (intra-community) requires zero VAT and both party VAT numbers.
BR-G-01EN 16931BLOCKEDExport VAT category requirements
VAT category G (export) requires exemption reason and must have zero VAT.
BR-CO-01en16931INPUTVAT category code must be valid
VAT category code must be from allowed code list (S, Z, E, AE, K, G, O, L, M).
BR-G-02EN 16931INPUTWhen 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-G-02).
BR-G-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-G-05).
BR-E-02EN 16931INPUTWhen 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).
BR-G-06EN 16931AUTO-FIXExport VAT must be zero
VAT amount for category G must be zero.
BR-G-07EN 16931AUTO-FIXExport requires reason
VAT category G must have exemption reason.
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-E-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.
BR-IC-01EN 16931BLOCKEDIntra-community must be in breakdown
If any line uses VAT category K, breakdown must include K.
BR-S-05EN 16931INPUTStandard rate taxable amount calculation
VAT category S taxable amount must equal sum of S-rated amounts.
BR-IC-02EN 16931INPUTIntra-community requires both VAT IDs
Intra-community supply requires seller and buyer VAT IDs.
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-06EN 16931AUTO-FIXIntra-community VAT must be zero
VAT amount for category K must be zero.
BR-IC-03EN 16931INPUTWhen 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).
BR-IC-07EN 16931AUTO-FIXIntra-community requires reason
VAT category K must have exemption reason.
BR-IC-04EN 16931INPUTWhen 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).
BR-IC-08EN 16931BLOCKEDThe 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-IC-08).
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).
Handle Business Rules Errors in Your Pipeline
The compliance engine auto-remediates business rules errors with controlled safety policies.
Get API Access