Skip to content

Validate an XRechnung

Validate your XRechnung against EN 16931 and the XRechnung rules. Review returned findings in plain English. Free within the daily limit.

No file to hand? Try a sample invoice

In short

Check an invoice against its applicable EN 16931 and national rule set. Read each finding and guidance on what to correct. Free, 10 a day without an account.

What the check covers

Klarbon checks the XML against the official schema and the business rules of the rule set for its format and version, listed below, and checks a PDF for PDF/A-3 conformance and the invoice metadata Factur-X and ZUGFeRD require. It does not verify digital signatures, and a pass does not show that the tax treatment is right or that the recipient or a platform will accept the file.

Rule sets and versions

Klarbon chooses the rule set from what the file declares.

Specification Version Covers
XRechnung 3.0.2 UBL, CII

Klarbon's XRechnung validator checks an XRechnung file, in UBL or CII, against the European standard EN 16931 and the German XRechnung rules published by KoSIT. Returned findings include rule codes and guidance where available. It is free for ten checks a day, fifty with a free account, and the file is deleted after the check.

How do I validate an XRechnung?

  1. Upload the XML file. Klarbon detects UBL or CII and the XRechnung version the file declares.
  2. Read the report. Returned findings show the rule code and severity, with a business term, source location and correction guidance where available.
  3. Correct and check again. Fix the invoice in your software and recheck, or fix the rejected e-invoice in a form and download a validated file for one credit.

The report names the ruleset and version it used, so you can compare it with what a portal reported.

Which rules does it apply?

Ruleset Prefix Source
EN 16931 core rules BR-, BR-CO-, BR-CL- and others CEN/TC 434 artefacts
XRechnung national rules BR-DE- KoSIT

Klarbon runs both rule sets on every XRechnung and shows their results side by side. It checks supported XRechnung 3.0 UBL invoices and CII files using the 3.0.2 rule sets. UBL credit-note checking is not supported yet. Checking XRechnung is live: KoSIT's official examples pass both rule sets, and the same examples with a wrong total are caught as BR-CO-16. If your recipient applies a different version, the two results can differ; the report names the version of each rule set Klarbon used.

Why do validators disagree?

Often because one of them runs only EN 16931. XRechnung adds German rules on top: it requires a buyer reference (BT-10, rule BR-DE-15), payment instructions (BR-DE-1) and an electronic address for the seller and the buyer, none of which EN 16931 requires. A file can therefore pass an EN 16931 validator and fail at a German portal. Where Klarbon's two rule sets disagree, the report says in one sentence why. After the check you can save a validation record, made on your device, with the file's SHA-256, the date and time in UTC, each rule set and version and every finding. It records what these rules found on that date, and nothing more.

Which errors are common?

A synthetic example:

Rule Field What it means Fix
BR-DE-15 BT-10 Buyer reference the buyer reference is missing enter the Leitweg-ID, or your customer's reference
BR-DE-1 BG-16 Payment instructions no payment instructions given add the payment means and IBAN
BR-CO-15 BT-112 Total with VAT total with VAT is not total without VAT plus VAT (OpenPeppol) correct the rounding

Find catalogue guidance in e-invoice error codes; not every schema diagnostic has a dedicated page.

Does a pass mean the invoice will be accepted?

A pass means the file passed the selected technical checks, not every possible requirement. It does not confirm the VAT treatment, the amounts or the bank details, and a portal can still reject an unknown Leitweg-ID or a supplier who is not registered. Technical validation is not tax advice.

What happens to the XML, and how many checks are free?

It goes to Klarbon's servers, is validated in memory and is deleted after the request; no copy is kept and no invoice content is logged (what happens to my files). To only read an XRechnung without uploading it, open the XRechnung in the viewer instead. Ten checks a day are free without an account and fifty with one; Pro and Bookkeeper allow up to 2,000 a day (prices).

Frequently asked questions

How do I validate an XRechnung?

Upload the XML to Klarbon's XRechnung validator. It applies EN 16931 and the XRechnung rules using the supported XRechnung 3.0.2 rule sets for UBL invoices and CII. It reports findings with guidance where available. UBL credit-note checking is not supported yet.

Does the validator check XRechnung in UBL and in CII?

Yes, for supported XRechnung 3.0 UBL invoices and CII files. Checking uses the 3.0.2 rule sets; UBL credit-note checking is not supported yet.

What does BR-DE-15 mean?

It is an XRechnung rule that requires the buyer reference (BT-10). Use a Leitweg-ID when the recipient requires one, or the buyer reference your customer supplies.

Does a valid XRechnung mean the portal will accept it?

No. A pass means the selected technical checks passed, not that every requirement was checked. Portals can also reject an unknown Leitweg-ID or a missing registration, which no file check can see.

How many XRechnung files can I check for free?

Ten a day without an account and fifty with a free account. Pro and Bookkeeper have a 2000-check daily fair-use limit.

Sources

Updated 16 November 2026

Also as an API: XRechnung API