Skip to content
Change language: English

Error

FX-SCH-A-000407: The specification must have exactly one identifier

In short

Error: fails the selected checks.

FX-SCH-A-000407 means a specification block contains either no ram:ID element or more than one. Put the correct specification identifier (BT-24) in exactly one ram:ID within ram:GuidelineSpecifiedDocumentContextParameter, then export and recheck the file.

On this page

What it means

This rule checks each ram:GuidelineSpecifiedDocumentContextParameter under rsm:ExchangedDocumentContext and requires exactly one ram:ID element. It applies in the Minimum, BASIC WL, Basic, EN 16931 and Extended profiles of Factur-X and ZUGFeRD. This is an element-count check, not a check of the identifier's text.

Why it matters

The specification identifier records which specification and profile the file claims to follow. One element avoids a missing or repeated declaration within the block.

How to fix it

Check which specification and profile your file is meant to follow. Ensure your export writes the corresponding BT-24 exactly once inside ram:GuidelineSpecifiedDocumentContextParameter under rsm:ExchangedDocumentContext. If the details are correct but the export contains missing or duplicate ID elements, ask your software supplier to correct it. 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:ID' must occur exactly 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 MINIMUM 1.0.9-2
Factur-X 1.09 BASIC WL 1.0.9-2
Factur-X 1.09 BASIC 1.0.9-2
Factur-X 1.09 EN 16931 1.0.9-2
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 MINIMUM 2.5.2
ZUGFeRD 2.5 BASIC WL 2.5.2
ZUGFeRD 2.5 BASIC 2.5.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-000407 still fails, and which other rules do.

Updated 6 November 2026