Skip to content

Warning

UBL-CR-502: Leave the tax tier range out of the VAT breakdown

In short

Warning: worth checking.

UBL-CR-502 means a document-level tax subtotal contains cbc:TierRange, which EN 16931 does not use there. It is a warning. Remove the element and recheck your file.

On this page

What it means

This rule checks that no document-level cac:TaxTotal/cac:TaxSubtotal in a UBL invoice or credit note contains cbc:TierRange. In the VAT breakdown (BG-23), the taxable amount (BT-116) and any applicable VAT rate (BT-119) are separate fields, not a tier range.

Why it matters

EN 16931 does not use tier ranges in document-level tax subtotals.

How to fix it

Delete cbc:TierRange from each document-level cac:TaxTotal/cac:TaxSubtotal. Ask the supplier of your invoicing software to stop writing the element if you cannot change it yourself. Recheck the file.

Once the file is corrected, check it again for free: Validate an invoice against EN 16931

Or fix the invoice in a form and download the corrected file, for 1 credit: Fix a rejected e-invoice

The rule as published

A UBL invoice should not include the TaxTotal TaxSubtotal TierRange

Where this rule applies

Rule set Version
EN 16931 (UBL) 1.3.17
EN 16931 (UBL credit note) 1.3.17
XRechnung 3.0 (UBL) 3.0.2
XRechnung 3.0 (UBL credit note) 3.0.2
Peppol BIS Billing 3.0 (invoice) 2026.5
Peppol BIS Billing 3.0 (credit note) 2026.5
SI-UBL 2.0 / NLCIUS (invoice) 2.0.3.13
SI-UBL 2.0 / NLCIUS (credit note) 2.0.3.13
France CTC (UBL invoice) 1.4.0-04
France CTC (UBL credit note) 1.4.0-04
CIUS-RO UBL Invoice 1.0.9 1.0.9
CIUS-RO UBL Credit Note 1.0.9 1.0.9
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether UBL-CR-502 still fails, and which other rules do.

Updated 6 November 2026