Skip to content

Error

FX-SCH-A-000162: Use an allowed note subject code in Basic WL

In short

Error: fails the selected checks.

FX-SCH-A-000162 means an invoice note's subject code (BT-21) is not allowed by the Basic WL profile. Replace ram:SubjectCode with a code from that profile's subject code list, or omit the optional element, then export and recheck the file.

On this page

What it means

For each ram:SubjectCode inside an invoice note, this test allows an empty code or a value found in the subject code list supplied with Basic WL. It does not require a subject code. It applies to the Basic WL profiles of Factur-X 1.09 and ZUGFeRD 2.5.

Why it matters

A subject code gives the note a standard classification. The profile's list defines the values you can use for that field.

How to fix it

Check what the note is about and use the matching code from the Basic WL subject code list. Write the code exactly as listed, not as a translated description. If you do not need a subject code, omit ram:SubjectCode from ram:IncludedNote. 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

Value of 'ram:SubjectCode' is not allowed.

Where this rule applies

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

Check your file

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

Updated 6 November 2026