Skip to content

Error

FX-SCH-A-000529: A line note needs exactly one text element

In short

Error: fails the selected checks.

FX-SCH-A-000529 means an invoice line note (BT-127) contains no ram:Content element or more than one. Give each ram:IncludedNote exactly one ram:Content, remove duplicate content elements, or remove the note if you do not need it. Export and recheck your file.

On this page

What it means

An invoice line (BG-25) can have a note (BT-127). This rule counts ram:Content elements within each ram:IncludedNote under ram:AssociatedDocumentLineDocument. The count must be exactly one. It does not check whether the content element contains text, so an empty ram:Content does not fail this count test. The rule applies to the Basic and EN 16931 profiles of Factur-X and ZUGFeRD.

Why it matters

The required structure gives each note one element for its text. Missing or repeated content elements do not meet that structure.

How to fix it

Check the note on the affected invoice line. In XML, keep exactly one ram:Content within each ram:IncludedNote. If duplicate content elements belong to the same note, combine their text into one element without losing information. Remove the whole note if it is unnecessary. 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

Element 'ram:Content' must occur exactly 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 BASIC 1.0.9-2
Factur-X 1.09 EN 16931 1.0.9-2
ZUGFeRD 2.5 BASIC 2.5.2
ZUGFeRD 2.5 EN 16931 2.5.2
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether FX-SCH-A-000529 still fails, and which other rules do.

Updated 6 November 2026