Skip to content

Error

FX-SCH-A-001016: A line document reference needs one type-code element

In short

Error: fails the selected checks.

FX-SCH-A-001016 means an additional document reference on your invoice line contains no ram:TypeCode element or more than one. Keep exactly one type-code element and use the appropriate allowed code for that reference.

On this page

What it means

This rule counts ram:TypeCode children of each ram:AdditionalReferencedDocument under a line's ram:SpecifiedLineTradeAgreement. Exactly one element must exist. The test does not check whether its value is empty or belongs to a code list.

Why it matters

The type code identifies what kind of reference you are providing, separately from the reference identifier.

How to fix it

Find the affected document reference. Add one ram:TypeCode if it is missing, or remove extra occurrences while retaining the appropriate type. Fill it with the allowed code for the intended reference. If the reference is unnecessary, remove it as a whole. Export and recheck.

Once the file is corrected, check it again for free: Validate a ZUGFeRD invoice

Or fix the invoice in a form and download the corrected file, for 1 credit: Fix a rejected e-invoice Beta

The rule as published

Element 'ram:TypeCode' must occur exactly 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 EXTENDED 2.5.2
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether FX-SCH-A-001016 still fails, and which other rules do.

Updated 6 November 2026