Skip to content

Error

FX-SCH-A-001024: The reference type code on a line document is not allowed

In short

Error: fails the selected checks.

FX-SCH-A-001024 means the reference type code on your line's document reference is outside the Extended profile's permitted list. Correct ram:ReferenceTypeCode using an allowed code that describes the reference.

On this page

What it means

A non-empty ram:ReferenceTypeCode inside a line's ram:AdditionalReferencedDocument must belong to the Extended profile's permitted reference type codes from UNTDID 1153. An empty value passes this check. This is the reference type code, not the separate document type code in ram:TypeCode.

Why it matters

The reference type code identifies the kind of reference you have supplied. Using the permitted list gives that value a defined meaning within the Extended profile.

How to fix it

Check the reference type assigned to the affected line's document reference. In the XML, correct ram:ReferenceTypeCode inside ram:AdditionalReferencedDocument under ram:SpecifiedLineTradeAgreement. Choose a permitted code that matches the reference, then export again and recheck the file.

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

Updated 6 November 2026