Skip to content

Error

FX-SCH-A-000490: Use an allowed invoice note subject code (Basic)

In short

Error: fails the selected checks.

FX-SCH-A-000490 means the subject code (BT-21) for an invoice note (BG-1) is not allowed by the Basic profile. Replace it with a permitted code describing the note, or omit the optional subject code while keeping the note text.

On this page

What it means

In the Basic profiles of Factur-X and ZUGFeRD, this rule checks rsm:ExchangedDocument/ram:IncludedNote/ram:SubjectCode against the profile's note subject code list. An empty checked value passes. The rule does not check the note text.

Why it matters

The subject code labels the type of information in the note. Whether that label is allowed is separate from what the note says.

How to fix it

Check the affected invoice note's subject code. Use a permitted code matching its content, such as AAI for general information, or remove the optional ram:SubjectCode element. Keep the note text, then export and recheck your 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

Value of 'ram:SubjectCode' is not allowed.

Where this rule applies

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

Check your file

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

Updated 6 November 2026