E-invoice validation rules, explained
Your validator printed « [BR-CO-15]-Invoice total amount with VAT … » or « [BR-DE-15] Das Element "Buyer reference" … muss übermittelt werden »? Find the rule here: each page gives the message, what the rule checks, why invoices fail it, how to fix it, and a failing invoice with its fix, both checked by our validator. 1623 rules from the official files of CEN and KoSIT.
- 257 rules with their own explanation and a checked example, 1623 rules in all from the CEN artefacts 1.3.16 and the XRechnung schematron 2.6.0.
- Every page is built from the rule file our validator runs: the text, the severity and the test cannot drift from what the validator reports.
- Every example is an invoice our own software wrote, failing and fixed, both run through the validator on the same day; the tests repeat that on every change.
- Peppol rules (PEPPOL-EN16931-*, DE-R, NL-R …) are checked by the validator, but their texts are not republished here: OpenPeppol has not licensed them for it (168 rules).
The rule sets
In the overviews, rules in bold have their own explanation and a checked example.
| Specification | Publisher | Rules | With a checked example |
|---|---|---|---|
| EN 16931 business rules | CEN/TC 434 | 223 | 219 |
| XRechnung 3.0 rules | KoSIT | 61 | 38 |
| CII syntax rules (CII-SR, CII-DT) | CEN/TC 434 | 583 | 0 |
| UBL syntax rules (UBL-CR, UBL-SR, UBL-DT) | CEN/TC 434 | 756 | 0 |
How a rule page is made
The text, severity, context and test come unmodified from the schematron files our validator runs, in the same release (the CEN artefacts, KoSIT’s XRechnung configuration). The explanation is written per rule, in English and German: what the rule checks, the usual cause, the fix. The example is an invoice from our own generator, changed in one place; both versions run through the validator, and the page shows its real report.
A page is indexed only when it has both: an explanation written for that rule alone, and a checked example. The 1,300 or so syntax rules (UBL-CR, CII-SR …) say the same thing about different elements; they have one explanation per family on their overview, and their own pages are not indexed.
Licences and credits
The BR-*, UBL-* and CII-* rules come from the EN 16931 validation artefacts of CEN/TC 434, published under the European Union Public Licence 1.2; the BR-DE-*, BR-TMP-* and BR-DEX-* rules from KoSIT’s XRechnung schematron, Apache License 2.0. Both are quoted unmodified and credited on every page. The Peppol BIS rules are OpenPeppol’s copyright with no licence to redistribute; their pages will follow if OpenPeppol consents.
Check your own invoice
Drop your XRechnung, ZUGFeRD or Peppol file into a free validator (Peppol BIS, XRechnung, Factur-X): each runs the same rule files and links every finding to its rule page. From your own code, POST /einvoice/validate (reference) returns the same check as JSON, each finding with an explanation field pointing here (5 calls a check, anonymous within the daily allowance).
Sources
- EN 16931 validation artefacts 1.3.16 (UBL and CII schematron, the business rules BR-*) — CEN/TC 434, published with the European Commission (Connecting Europe), consulted 2026-10-28
- EN 16931 validation artefacts: licence, European Union Public Licence (EUPL) v1.2 (LICENSE.txt, the README « License » section and the release notes of validation-1.3.16) — European Commission (Connecting Europe), for CEN/TC 434, consulted 2026-11-17. The EUPL permits reproduction and communication to the public, with the licence, the copyright notices and the disclaimer kept; a modified copy must say so. The rule library quotes the rule ids and messages of the BR-*, UBL-* and CII-* rules unmodified, credits the artefacts and links the licence.
- Validator configuration XRechnung v2026-08-31 (XRechnung 3.0.2, CEN schematron 1.3.16, xrechnung-schematron 2.6.0) — KoSIT, consulted 2026-10-28
- XRechnung schematron (xrechnung-schematron) and the XRechnung validator configuration: licence, Apache License 2.0 (LICENSE files; NOTICE of the configuration: « Copyright 2020 Koordinierungsstelle für IT-Standards ») — KoSIT (Koordinierungsstelle für IT-Standards), Bremen, consulted 2026-11-17. Apache 2.0 permits redistribution with the licence and the notices kept. KoSIT’s LICENSE adds that the copyright in the EN 16931 standard lies with CEN. The rule library quotes the BR-DE-*, BR-DEX-* and BR-TMP-* messages unmodified, in KoSIT’s German.
- Peppol BIS Billing 3.0, « Statement of copyright »: OpenPeppol AISBL holds the copyright; the BIS may not be modified, redistributed, sold or repackaged without its prior consent; no licence is stated for the schematron rules — OpenPeppol AISBL, consulted 2026-11-17. Why the rule library does not republish the PEPPOL-* and national (DE-R, DK-R, NL-R…) rule texts: the validator runs them and reports them, but their pages wait for OpenPeppol’s consent.