Skip to content

Error

FX-SCH-A-000161: An invoice note can have at most one subject code

In short

Error: fails the selected checks.

FX-SCH-A-000161 means an invoice note (BG-1) contains more than one subject code (BT-21). Keep at most one ram:SubjectCode per note, or split genuinely separate subjects into separate notes, then export and recheck the file.

On this page

What it means

Each ram:IncludedNote inside ram:ExchangedDocument may contain at most one ram:SubjectCode (BT-21). This rule permits a note without a subject code and does not check the code's value. It applies to the Basic WL, Basic, EN 16931 and Extended profiles of Factur-X 1.09 and ZUGFeRD 2.5.

Why it matters

The subject code classifies the note. This structure provides one optional subject value per note rather than a list of subjects.

How to fix it

Check any note with repeated ram:SubjectCode elements. Keep the code that matches its content, or omit the code if you do not need it. If the content belongs in separate notes, give each note its own text and no more than one subject code. Export again 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:SubjectCode' may occur at maximum 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
Factur-X 1.09 EXTENDED 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
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-000161 still fails, and which other rules do.

Updated 6 November 2026