Skip to content

Error

FX-SCH-A-000160: Each invoice note needs one text element

In short

Error: fails the selected checks.

FX-SCH-A-000160 means an invoice note (BG-1) has no ram:Content element for its text (BT-22), or has more than one. Put the intended note text in one ram:Content per note, or remove a note you do not need, then export and recheck the file.

On this page

What it means

Each ram:IncludedNote inside ram:ExchangedDocument must contain exactly one ram:Content element (BT-22). A subject code (BT-21, ram:SubjectCode) does not replace it. This test counts text elements; it does not check whether their text is empty. It applies to the Basic WL, Basic and EN 16931 profiles of Factur-X 1.09 and ZUGFeRD 2.5.

Why it matters

Keeping each note's text in one element gives the note one defined text field, separate from its subject code.

How to fix it

Check each invoice note. If its ram:Content is missing, add it with the intended text. If several text elements belong to one note, combine their text in one ram:Content; if they are separate notes, use separate ram:IncludedNote elements. Remove any note you do not need, 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

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

Where this rule applies

Rule set Version
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
ZUGFeRD 2.5 BASIC WL 2.5.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-000160 still fails, and which other rules do.

Updated 6 November 2026