Skip to content

Error

FX-SCH-A-001126: Reference type of a document referred to on a line must be valid

In short

Error: fails the selected checks.

FX-SCH-A-001126 means a non-empty reference type code in an invoice line's additional document reference is not allowed. Correct ram:ReferenceTypeCode using the Extended profile's permitted reference qualifiers.

On this page

What it means

Each non-empty ram:ReferenceTypeCode under the line's ram:SpecifiedLineTradeSettlement/ram:AdditionalReferencedDocument must match code list 20. An empty value passes. This checks the reference qualifier, not the document type in ram:TypeCode.

Why it matters

The reference qualifier tells software what the referenced identifier represents.

How to fix it

Check what the identifier in the line's ram:AdditionalReferencedDocument refers to. Replace the incorrect ram:ReferenceTypeCode with the permitted qualifier for that reference. Do not put a description such as order in the code field or substitute a document type code. Export again 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

Value of 'ram:ReferenceTypeCode' is not allowed.

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

Updated 6 November 2026