Skip to content

Error

BR-FXEXT-01: Invoice notes with a subject code need some text

In short

Error: fails the selected checks.

BR-FXEXT-01 means an invoice note has a subject code but no text, neither plain nor coded. Fix it by adding the note text, or by removing the subject code if you do not need the note.

On this page

What it means

An invoice note that has a subject code (BT-21) must also have the note text (BT-22), a coded version of the note text (BT-X-5), or both. In the Extended profile of Factur-X and ZUGFeRD the note is ram:IncludedNote, and the check looks for ram:Content or ram:ContentCode next to ram:SubjectCode. If you give both, they must mean the same thing. The check itself only tests that at least one of them is there.

Why it matters

A subject code only labels what kind of note it is. With no content under it the note is empty, the recipient has nothing to read or process, and the file fails the check.

How to fix it

Find the invoice notes in your invoicing software, where they may be called remarks, comments or free text. Add the text of the note to every note that has a subject, or delete the subject if the note is not needed. If you fill in both a text and a coded text, make sure they say the same thing.

The rule as published

If the Invoice Free Text subject Code (BT-21) is specified, either the coded message free text (BT-X-5) or the message free text (BT-22) must be specified, or both. If both BT-X-5 and BT-22 are specified, both must have the same meaning.

Business terms: BT-21, BT-22

Where this rule applies

Rule set Version
Factur-X 1.09 EXTENDED 1.0.9-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 BR-FXEXT-01 still fails, and which other rules do.

Updated 6 November 2026