Skip to content

Error

FX-SCH-A-000283: A supporting document can have only one description (EN 16931 and Extended)

In short

Error: fails the selected checks.

FX-SCH-A-000283 means a supporting document reference has more than one description element (ram:Name). Keep at most one description in each affected reference, then export and recheck.

On this page

What it means

A supporting document reference (BG-24) is represented by a header ram:AdditionalReferencedDocument with ram:TypeCode 916. Each such reference may contain at most one ram:Name for the supporting document description (BT-123). The rule applies to the EN 16931 and Extended profiles of Factur-X and ZUGFeRD.

Why it matters

These profiles provide one optional description element for each supporting document reference. Repeating that element exceeds the permitted limit.

How to fix it

Check the description for the affected supporting document reference. Combine relevant wording into one description or remove unintended duplicates. If you create the XML yourself, keep at most one ram:Name inside each header ram:AdditionalReferencedDocument with ram:TypeCode 916. Use separate references for genuinely separate supporting documents. 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

Element 'ram:Name' may occur at maximum 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-000283 still fails, and which other rules do.

Updated 6 November 2026