← Back to error library

UBL-TAX-002 · UBL · EN16931 · Peppol

UBL: TaxTotal does not match TaxSubtotal amounts

The overall tax amount differs from the tax subtotal amounts.

UBL 2.1, EN16931Last professional review: 2026-07-05

Meaning

The overall tax amount differs from the tax subtotal amounts.

Typical cause

A tax rate was counted twice, omitted or rounded differently.

Affected fields / XML paths

/ubl:Invoice/cac:TaxTotal/cbc:TaxAmount/ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount

Invalid example

<cac:TaxTotal><cbc:TaxAmount>23.00</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxAmount>22.99</cbc:TaxAmount></cac:TaxSubtotal></cac:TaxTotal>

Corrected example

<cac:TaxTotal><cbc:TaxAmount>23.00</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxAmount>23.00</cbc:TaxAmount></cac:TaxSubtotal></cac:TaxTotal>

Remediation steps

  1. Re-sum tax subtotals.
  2. Check currency and rounding.
  3. Derive TaxTotal from subtotals.