• Contact us: office@woods.consulting
Book a meeting

E-invoice error explained

BR-DE-17: Invoice type code is not one XRechnung expects

BT-3 states what kind of document it is.

What the rule checks

BT-3 states what kind of document it is. XRechnung expects one of eight codes: 380 commercial invoice, 381 credit note, 384 corrected invoice, 389 self-billed invoice, 326 partial invoice, 875 partial construction invoice, 876 partial final construction invoice, 877 final construction invoice. The rule is a warning. The file still counts as valid, but some receiving platforms reject other codes.

Official rule text

The element "Invoice type code" (BT-3) should only contain the following codes from the UNTDID 1001 code list: 326 (Partial invoice), 380 (Commercial invoice), 384 (Corrected invoice), 389 (Self-billed invoice) and 381 (Credit note), 875 (Partial construction invoice), 876 (Partial final construction invoice), 877 (Final construction invoice).

Source: KoSIT configuration XRechnung 3.0.2 (31 Jan 2026).

Typical causes

  • A down payment invoice uses 386 (prepayment invoice).
  • A debit note uses 383.
  • The ERP writes its own document type key instead of a UNTDID 1001 code.

How to fix it

Set ram:ExchangedDocument/ram:TypeCode to one of the eight codes. For down payment invoices many issuers use 380 and describe the down payment in the invoice note. If in doubt, agree the code with the buyer.

Example

Wrong (CII)

<rsm:ExchangedDocument>
  <ram:ID>RG-26-0051</ram:ID>
  <ram:TypeCode>386</ram:TypeCode>
  <ram:IssueDateTime>...</ram:IssueDateTime>
</rsm:ExchangedDocument>

Right (CII)

<rsm:ExchangedDocument>
  <ram:ID>RG-26-0051</ram:ID>
  <ram:TypeCode>380</ram:TypeCode>
  <ram:IssueDateTime>...</ram:IssueDateTime>
</rsm:ExchangedDocument>

In Dynamics 365, Business Central and Finance

Sales / Project Operations: Sales and Project Operations have no e-invoice output out of the box. In the WBS Invoice Accelerator for Dynamics 365 the code follows the Invoice type: Credit note and Cancellation invoice become 381, all other types 380, including down payment, progress and final invoices.

Related error codes

All error codes

Check your invoice for free. The validator shows every finding with an explanation and its location in the XML.

Check a file