Why does EN 16931 forbid most TypeCode elements in CII?

EN 16931 is an interoperability profile that removes optional children from the wider UN/CEFACT CII dictionary to prevent ambiguity between senders and receivers.

Which values are allowed on ram:AdditionalReferencedDocument/ram:TypeCode?

Only UNTDID 1001 codes 50 (price or sales catalogue), 130 (invoicing data sheet), and 916 (related document). Any other value fails CII-DT-018.

Is this error safe to auto-fix?

Yes in most cases. Deleting a forbidden TypeCode is deterministic because EN 16931 ignores it anyway. Invoice Navigator applies the deletion automatically.

Will removing TypeCode change how my buyer processes the invoice?

No. EN 16931 receivers ignore TypeCode children that are not on AdditionalReferencedDocument, so removing them preserves all business meaning.

Does this error also apply to ZUGFeRD MINIMUM and BASIC WL?

No. MINIMUM and BASIC WL do not run EN 16931 Schematron. CII-DT-018 fires for every ZUGFeRD profile from BASIC upwards and for all Factur-X profiles.

Error codes · cii-d16b

CII-DT-018Fixable here

TypeCode should not be present on this element

This is the rejection, word for word: „[CII-DT-018] CII-DT-018 is an EN 16931 datatype assertion on the CII binding. It forbids a ram:TypeCode child on any element except ram:AdditionalReferencedDocument, and even there restricts the value to UNTDID 1001 codes 50 (price/sales catalogue), 130 (invoicing data sheet), or 916 (related document).“

What to have readyThe missing value from your purchase order, contract or bookkeeping.

What we doDelete every ram:TypeCode that is not on ram:AdditionalReferencedDocument; where allowed, keep only the values 50, 130, or 916.

Choose the rejected invoiceor drop it here

XRechnung XML or ZUGFeRD PDF. Checking is free · corrected file €1.90 · the first every 30 days is free · no sign-up.

If you enter it yourself in your invoicing software

Before

<ram:AdditionalReferencedDocument><ram:IssuerAssignedID>PO-2026-0041</ram:IssuerAssignedID><ram:TypeCode>999</ram:TypeCode><ram:ReferenceTypeCode>PO</ram:ReferenceTypeCode></ram:AdditionalReferencedDocument>

After

<ram:AdditionalReferencedDocument><ram:IssuerAssignedID>PO-2026-0041</ram:IssuerAssignedID><ram:ReferenceTypeCode>PO</ram:ReferenceTypeCode></ram:AdditionalReferencedDocument>

What the finding looks likeExample

FindingValue missing · CII-DT-018

From youThe missing value

ThenPassed

ProofSHA-256 and /verify link after the check