Skip to content
Change language: English

Warning

UBL-CR-504: The VAT category should not have a name

In short

Warning: worth checking.

UBL-CR-504 means a tax category in a document-level tax subtotal has a name (cbc:Name), which EN 16931 does not use there. It is a warning. Remove the name and keep the VAT category code.

On this page

What it means

The rule checks cac:TaxCategory in each document-level cac:TaxTotal/cac:TaxSubtotal for cbc:Name, a free text label such as Standard rate. It applies to UBL invoices and credit notes. The VAT category code is BT-118, for example S, Z or E. The VAT rate (BT-119), where applicable, and exemption reason text (BT-120), where needed, are separate fields.

Why it matters

EN 16931 uses a VAT category code rather than a name in this part of the VAT breakdown.

How to fix it

Delete cbc:Name from cac:TaxCategory under each document-level cac:TaxTotal/cac:TaxSubtotal. Keep the VAT category code (BT-118). If the wording is an exemption reason, use the exemption reason text (BT-120), not the category name. Recheck your 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 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-504 still fails, and which other rules do.

Updated 6 November 2026