Skip to content

Error

FX-SCH-A-000284: A supporting document can hold only one attached file (EN 16931 and Extended)

In short

Error: fails the selected checks.

FX-SCH-A-000284 means a supporting document reference contains more than one embedded file element (ram:AttachmentBinaryObject). Put each embedded file in its own supporting document reference, then export and recheck.

On this page

What it means

Each supporting document reference (BG-24), represented by a header ram:AdditionalReferencedDocument with ram:TypeCode 916, may contain at most one ram:AttachmentBinaryObject for an attached document (BT-125). Having no embedded file also passes this count check. The rule applies to the EN 16931 and Extended profiles of Factur-X and ZUGFeRD.

Why it matters

Each supporting document reference has one optional field for an embedded file. Repeating that field exceeds the permitted limit.

How to fix it

Attach each file as a separate supporting document reference in your invoicing software. If you create the XML yourself, use a separate ram:AdditionalReferencedDocument with ram:TypeCode 916 for each embedded file, with no more than one ram:AttachmentBinaryObject in each. Keep the corresponding description and file details with the correct file. 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:AttachmentBinaryObject' 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-000284 still fails, and which other rules do.

Updated 6 November 2026