Skip to content

Error

FX-SCH-A-000286: An attached document must have a file name

In short

Error: fails the selected checks.

FX-SCH-A-000286 means an embedded supporting document has no filename attribute on ram:AttachmentBinaryObject. Make sure the export includes this attribute with the attached file's name, then recheck the invoice.

On this page

What it means

For a supporting document reference with ram:TypeCode 916, ram:AttachmentBinaryObject (BT-125) must have a filename attribute (BT-125-2). This rule checks that the attribute exists, not whether its value is empty or otherwise suitable. It applies to the EN 16931 and Extended profiles of Factur-X and ZUGFeRD.

Why it matters

The attribute provides a file name for the embedded document. Its absence does not match the required attachment structure.

How to fix it

Check the attached file's name and export the invoice again. If the filename attribute is still missing, ask your software supplier to correct the attachment export; renaming the original file alone does not ensure the attribute is written. If you create XML yourself, add filename to ram:AttachmentBinaryObject, for example filename="order-confirmation.pdf" when that is the file's name. Recheck the exported 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

Attribute '@filename' is required in this context.

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

Updated 6 November 2026