Skip to content
Change language: English

Error

FX-SCH-A-001021: A line attachment needs a file-name attribute

In short

Error: fails the selected checks.

FX-SCH-A-001021 means an embedded attachment in your line's document reference is missing the filename attribute. Add it to ram:AttachmentBinaryObject with the attachment's file name.

On this page

What it means

This rule checks whether filename exists on ram:AttachmentBinaryObject inside a line's ram:SpecifiedLineTradeAgreement/ram:AdditionalReferencedDocument. An empty attribute satisfies the test. The rule does not check the name's contents, extension or pattern.

Why it matters

The filename attribute gives the embedded attachment a recognisable name without changing its contents.

How to fix it

Set filename on the affected ram:AttachmentBinaryObject to the actual file name, including its extension if it has one. Keep the name consistent with the attached file. If your software omits the attribute, have its export corrected, then export 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

Attribute '@filename' is required in this context.

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

Updated 6 November 2026