Skip to content

Fatal

CII-DT-021: Descriptions belong on supporting document references

In short

Fatal: fails the selected checks.

CII-DT-021 means a CII document reference contains ram:Name where it is not allowed. Remove that element unless the reference is genuinely a supporting document represented by ram:AdditionalReferencedDocument with ram:TypeCode 916.

On this page

What it means

The check applies to all CII reference elements whose names end in ReferencedDocument. They may contain ram:Name only when the reference is ram:AdditionalReferencedDocument with a ram:TypeCode value of 916. For a supporting document (BG-24), this name is the document description (BT-123).

Why it matters

The CII mapping provides this description field for supporting documents, not for other document reference types.

How to fix it

Remove ram:Name from the affected reference. If the text describes a supporting document, put it in ram:Name on the appropriate ram:AdditionalReferencedDocument with ram:TypeCode 916. Do not change a contract or order reference into a supporting document just to retain its name. Export the corrected file and recheck it.

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

Name should not be present

Where this rule applies

Rule set Version
EN 16931 (CII) 1.3.17
XRechnung 3.0 (CII) 3.0.2
NLCIUS (CII) 1.0.3.13
France CTC (CII) 1.4.0-04
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether CII-DT-021 still fails, and which other rules do.

Updated 6 November 2026