Skip to content

Error

FX-SCH-A-000563: A supporting document needs exactly one reference

In short

Error: fails the selected checks.

FX-SCH-A-000563 means a supporting document reference (BG-24) contains no ram:IssuerAssignedID or more than one. Put its reference (BT-122) in one ram:IssuerAssignedID, or remove the whole reference if it does not apply.

On this page

What it means

This rule counts ram:IssuerAssignedID elements in each ram:AdditionalReferencedDocument under ram:ApplicableHeaderTradeAgreement whose ram:TypeCode is 916. There must be one identifier element for the supporting document reference (BT-122). The test does not check its text, so an empty identifier element still counts. It applies to the EN 16931 and Extended profiles of Factur-X and ZUGFeRD.

Why it matters

The reference identifies the supporting document. Giving it one identifier element keeps the reference in the structure defined for BG-24.

How to fix it

Check the reference for each supporting document included with your invoice. In each affected ram:AdditionalReferencedDocument with ram:TypeCode 916, put the document's identifying reference, such as its number or file name, in one ram:IssuerAssignedID. Remove duplicate identifier elements. Remove the whole supporting document reference only if it does not apply. Export and recheck your invoice.

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:IssuerAssignedID' must occur exactly 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 EN 16931 1.0.9-2
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 EN 16931 2.5.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-000563 still fails, and which other rules do.

Updated 6 November 2026