errorubl-2.1

UBL-CR-008:TaxTotal missing TaxSubtotal

TaxTotal element must contain at least one TaxSubtotal.

We can fix this automatically

AUTO-FIX

Auto-fix: Remove the disallowed element from the invoice XML. No data loss occurs because EN16931 explicitly prohibits this element.

No manual changes needed
Upload and Fix Now

Why This Error Matters

Invoice will be rejected by PEPPOL/EN16931 validators. Safe to remove - this element is explicitly prohibited and contains no required business data.

How to Fix It

1

Add TaxSubtotal

At least one required

2

Include required elements

TaxableAmount, TaxAmount, TaxCategory

3

Group by category

One subtotal per VAT category/rate

Code Example

<cac:TaxTotal>
  <cbc:TaxAmount currencyID="EUR">210.00</cbc:TaxAmount>
  <cac:TaxSubtotal>
    <cbc:TaxableAmount currencyID="EUR">1000.00</cbc:TaxableAmount>
    <cbc:TaxAmount currencyID="EUR">210.00</cbc:TaxAmount>
    <cac:TaxCategory>
      <cbc:ID>S</cbc:ID>
      <cbc:Percent>21</cbc:Percent>
    </cac:TaxCategory>
  </cac:TaxSubtotal>
</cac:TaxTotal>

Technical Details

XPath: /Invoice/cac:TaxTotal/cac:TaxSubtotal

Common Causes

  • Source ERP exports full UBL 2.1 instead of EN16931 subset
  • Generic UBL template includes optional elements not needed for e-invoicing
  • Conversion from another format added unsupported elements
  • Manual XML editing introduced non-standard elements
  • Invoice software not configured for EN16931 compliance

Commonly Seen In

All invoicing software

Frequently Asked Questions

TaxTotal element must contain at least one TaxSubtotal.
Add TaxSubtotal to TaxTotal. You can also use Invoice Navigator's automatic Fixer tool to correct this instantly.
Yes, UBL-CR-008 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 UBL-CR-008 can be automatically corrected using Invoice Navigator's Fixer tool. Upload your invoice and the tool will identify and fix common issues, including taxtotal missing taxsubtotal.
UBL-CR-008 is commonly seen in exports from All invoicing software. These software packages sometimes generate invoices that need adjustment to meet full compliance standards.

Related Errors

BR-19

Tax category code required

BR-CO-10

Sum of VAT category amounts incorrect

Last updated: 16 January 2026

Share this guide: