Skip to content

Error

FX-SCH-A-000617: Use a valid scheme code for the line reference

In short

Error: fails the selected checks.

FX-SCH-A-000617 means the identifier scheme code (BT-128-1) on a line reference is not allowed. Correct ram:ReferenceTypeCode to the appropriate listed UNTDID 1153 code, or omit this optional scheme element if it is not needed.

On this page

What it means

This rule checks ram:ReferenceTypeCode inside a line-level ram:AdditionalReferencedDocument. For the invoiced object identifier (BT-128), it identifies the identifier scheme (BT-128-1). A non-empty value must belong to the profile's UNTDID 1153 code list. Empty values pass. This rule applies to the EN 16931 profile.

Why it matters

The scheme code explains what kind of identifier the reference contains. It is distinct from ram:TypeCode, which identifies the document or reference type.

How to fix it

Check the scheme assigned to your line's object identifier. If you generate XML, correct ram:ReferenceTypeCode in ram:AdditionalReferencedDocument under ram:SpecifiedLineTradeSettlement, or remove the optional scheme element when it is not needed. Do not replace it with the document type code. Generate the file again and recheck it.

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 EN 16931 1.0.9-2
ZUGFeRD 2.5 EN 16931 2.5.2
Rule text from phive-rules 4.6.4.

Check your file

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

Updated 6 November 2026