Skip to content

Error

FX-SCH-A-000564: A supporting document needs exactly one type code

In short

Error: fails the selected checks.

FX-SCH-A-000564 means your supporting document reference (BG-24) contains more than one ram:TypeCode. Keep one ram:TypeCode with the value 916 in the affected ram:AdditionalReferencedDocument, then export and recheck your invoice.

On this page

What it means

This rule counts ram:TypeCode elements in each ram:AdditionalReferencedDocument under ram:ApplicableHeaderTradeAgreement that contains a type code of 916. Because that code is already present, a failure means there are multiple type-code elements, even if they all contain 916. It applies to the EN 16931 and Extended profiles of Factur-X and ZUGFeRD.

Why it matters

One type-code element identifies the reference as a supporting document reference. Repeating that element does not follow the required structure, even when the values agree.

How to fix it

In the affected supporting document reference, retain one ram:TypeCode containing 916 and remove the extra type-code elements. If another code belongs to a separate reference, give that reference its own ram:AdditionalReferencedDocument. If your invoicing software creates the duplicates, ask its supplier to correct the export. Export 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

Element 'ram:TypeCode' 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-000564 still fails, and which other rules do.

Updated 6 November 2026