What the field is for
The specification's description (above, in German) translates as: "A code specifying the functional type of the invoice." BT-3 says what kind of document the file is: an invoice, a correction, a credit note. Every invoice needs this code (BR-04). The codes come from the code list UNTDID 1001.
Which codes XRechnung allows
| Code | Meaning |
|---|---|
380 |
commercial invoice — the normal case |
381 |
credit note: reduces an invoice |
384 |
corrected invoice |
389 |
self-billed invoice: the buyer issues the invoice |
326 |
partial invoice |
875 / 876 / 877 |
partial, partial final and final construction invoice |
Other codes, even if they are in UNTDID 1001 (e.g. 393 factored invoice), trigger the warning
BR-DE-17 in XRechnung.
"Gutschrift" — two meanings in German
In the German VAT Act a Gutschrift is an invoice issued by the recipient of the supply
(§ 14 (2) sentence 5 UStG); it must carry the word „Gutschrift“ (§ 14 (4) sentence 1 no. 10
UStG). In XRechnung that is code 389.
In everyday German business, Gutschrift usually means the reduction of an invoice, for example
after a return. That is code 381 (credit note) with a reference to the original invoice
(BT-25).
Which rules check the field
| Rule | What it requires | Level in XRechnung |
|---|---|---|
| BR-04 | BT-3 is there | error |
| BR-DE-17 | BT-3 is one of the codes above | warning |
| BR-DE-26 | with 384 the preceding invoice (BG-3, BT-25) is given |
warning |
Where the field is in the file
| Syntax | Element |
|---|---|
| CII | rsm:ExchangedDocument/ram:TypeCode |
| UBL | cbc:InvoiceTypeCode under Invoice; for a credit note cbc:CreditNoteTypeCode under CreditNote |
Common mistakes
- A correction 384 without a reference to the original invoice → BR-DE-26, warning.
- „Gutschrift“ as 389 when a reduction is meant — or the other way round.
Example
<!-- CII -->
<rsm:ExchangedDocument>
<ram:ID>RE-2026-0001</ram:ID>
<ram:TypeCode>380</ram:TypeCode> <!-- BT-3 -->
...
</rsm:ExchangedDocument>
<!-- UBL -->
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
Sources: KoSIT, XRechnung specification 3.0.2 (BT-3, BR-04, BR-DE-17, BR-DE-26); code lists for EN 16931 v17b in the Factur-X 1.09.2 / ZUGFeRD 2.5.2 package (UNTDID 1001); German VAT Act (UStG), § 14 (2) sentence 5 and (4) sentence 1 no. 10.