All explained rules

BR-DE-17: The document type code is not allowed in XRechnung. How to fix it

XRechnung permits only eight values for the document type code (BT-3), and yours is not one of them. This is a warning, not an error.

Warning: the invoice is acceptedFrom the German additional rules (XRechnung)

The rule, in its own words

Mit dem Element "Invoice type code" (BT-3) sollen ausschließlich folgende Codes aus der Codeliste UNTDID 1001 übermittelt werden: 326 (Partial invoice), 380 (Commercial invoice), 384 (Corrected invoice), 389 (Self-billed invoice) und 381 (Credit note),875 (Partial construction invoice), 876 (Partial final construction invoice), 877 (Final construction invoice).

Fields involved: BT-3

What the rule checks

The rule checks the code against a short list: 326 partial invoice, 380 commercial invoice, 381 credit note, 384 corrected invoice, 389 self-billed invoice, plus 875, 876 and 877 for interim and final construction invoices. The European norm allows more; XRechnung narrows it.

Why files fail it

  • The software sets a code that is valid in the European norm but not foreseen in XRechnung.
  • A code was chosen for a document that is not an invoice, such as a request for prepayment.
  • The code is empty, in which case BR-04 applies as well.

How to fix it

  1. Choose the code that actually describes your document: 380 for an ordinary invoice, 381 for a credit note, 326 for a partial invoice, 384 for a correction.
  2. In construction, 875, 876 and 877 additionally apply to interim and final invoices.
  3. This is a warning. The official report accepts the invoice, but the receiving software may post it incorrectly if the code does not fit.

Check your file

Upload your invoice. It runs through the same official validator that applies this rule, and you see immediately whether it passes now.

Check an invoice

or drop it here

XRechnung XML, or a ZUGFeRD / Factur-X PDF. Up to 10 MB.

  • Run against the official EN 16931 and XRechnung rules
  • Your file is deleted the moment the result appears
  • No sign-up, and a result in seconds

What to do next

An invoice with errors will be rejected. Build a compliant one from the PDF you already have, or enter the details yourself. Either way you get a file that passes.