BR-12:Invoice total with VAT required
The invoice must contain the total amount including VAT (TaxInclusiveAmount).
Engine Classification
Financial or legal field · Modification blocked by policy
Reason: Invoice totals require manual verification. Automatic changes could cause calculation cascades affecting tax amounts, line totals, and compliance. Please verify all amounts in your source system.
What is BR-12?
BR-12 is a fatal validation rule defined in the EN 16931 specification. It validates the TaxInclusiveAmount element under Invoice > LegalMonetaryTotal in the UBL invoice XML.
When this rule fires, the invoice is non-compliant and will be rejected by Peppol access points and national validation services. The sending system receives a rejection response and the invoice does not reach the buyer.
Target path: XPath: /Invoice/cac:LegalMonetaryTotal/cbc:TaxInclusiveAmount
Why This Error Matters
Invoice rejected. This sum is required for VAT calculation and must match the individual line amounts.
BR-12 is a hard failure. Invoices that trigger this rule are rejected at the access point and never reach the recipient. In Peppol networks, this means your sending system receives an MLR (Message Level Response) with a rejection status. The invoice must be corrected and re-sent, adding delay to your payment cycle.
Validator Behavior
- ·Causes invoice rejection
- ·Error returned: BR-12
- ·Specification: EN 16931
How to Fix It
Get tax exclusive
Use TaxExclusiveAmount value
Add VAT total
Add TaxTotal/TaxAmount
Set element
Result goes in TaxInclusiveAmount
Before / After
<cac:LegalMonetaryTotal> <!-- cbc:LineExtensionAmount is missing --> </cac:LegalMonetaryTotal>
<cac:LegalMonetaryTotal> <cbc:LineExtensionAmount>valid-value</cbc:LineExtensionAmount> </cac:LegalMonetaryTotal>
Technical Reference
XPath: /Invoice/cac:LegalMonetaryTotal/cbc:TaxInclusiveAmountCode Example
<cbc:TaxInclusiveAmount currencyID="EUR">1210.00</cbc:TaxInclusiveAmount>Common Causes
- ·Line extension amount total not calculated by ERP
- ·Export template missing LegalMonetaryTotal section
- ·Line items exported but LineExtensionAmount sum not computed
- ·Monetary totals section not mapped in template
- ·Manual invoice without recalculating totals
Seeing this in production? The API handles BR-12 automatically. See the fix response →
Commonly Seen In
Frequently Asked Questions
The invoice must contain the total amount including VAT (TaxInclusiveAmount).
Add TaxInclusiveAmount = TaxExclusiveAmount + TaxTotal. You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.
Yes, BR-12 is a critical error that will cause invoice rejection. It must be fixed before submission to ensure your invoice is accepted by the recipient's system.
Many instances of BR-12 can be automatically corrected using Invoice Navigator's Fixer tool. Upload your invoice and the tool will identify and fix common issues, including invoice total with vat required.
BR-12 is commonly seen in exports from All invoicing software. These software packages sometimes generate invoices that need adjustment to meet full compliance standards.
See Also
Related Errors
Last updated: 27 February 2026
Handle BR-12 Automatically in Your Pipeline
The compliance engine auto-remediates this error with controlled safety policies and evidence pack generation.