Skip to content
Change language: English

Warning

UBL-CR-002: The UBL version should be 2.1 if given

In short

Warning: worth checking.

UBL-CR-002 means the file states a UBL version (cbc:UBLVersionID) that is not 2.1. Remove that element or set it to 2.1.

On this page

What it means

The rule checks the UBL version number at document level in the invoice or credit note. The element cbc:UBLVersionID may be left out. If it is there, the rule expects its value to be exactly 2.1.

Why it matters

EN 16931's UBL rules expect 2.1 when you include this version field. Leaving the element out also passes this check.

How to fix it

The simplest fix is to delete cbc:UBLVersionID, since it is optional. Otherwise change its value to 2.1. Apply the same change to your XML export template if needed, then export again and 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 UBLVersionID or it should be 2.1

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

Updated 6 November 2026