Skip to content

Warning

UBL-CR-477: Do not name the VAT category of an invoice-level discount or charge

In short

Warning: worth checking.

UBL-CR-477 means the VAT category of a discount or charge on the whole invoice has a name (Name), which EN 16931 does not use. Remove the name and use the VAT category code and, where required, the VAT rate.

On this page

What it means

The rule looks at the discounts (BG-20) and charges (BG-21) placed on the whole invoice, directly under the invoice or credit note. It warns when the cac:TaxCategory inside one of them has a cbc:Name. EN 16931 identifies the VAT of a discount by its category code (BT-95) and applicable VAT rate (BT-96), and that of a charge by its category code (BT-102) and applicable VAT rate (BT-103).

Why it matters

EN 16931 does not use cbc:Name in the VAT category of document-level discounts (BG-20) or charges (BG-21).

How to fix it

Delete cbc:Name from the cac:TaxCategory inside each cac:AllowanceCharge directly under the Invoice or CreditNote element. Check that the category code and any applicable VAT rate on the discount or charge match the VAT breakdown. Check the corrected file again.

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 AllowanceCharge TaxCategory Name

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-477 still fails, and which other rules do.

Updated 6 November 2026