eliDocs
/
Format Reference

XRechnung

Germany's CIUS of EN 16931 for public-sector and increasingly B2B e-invoicing — what Beliq emits, validates, and where the submission boundary lies.

XRechnung is the German Core Invoice Usage Specification (CIUS) of EN 16931, maintained by KoSIT (Coordination Office for IT Standards) under mandate from the IT Planning Council on behalf of the Federal Ministry of the Interior and Bremen. It implements EU Directive 2014/55/EU for invoicing to German public-sector buyers (B2G) and is also widely required by large B2B buyers in Germany.

The current normative release is XRechnung 3.0 (effective 2024-02-01). KoSIT publishes a fixed release cadence — see the XRechnung release cycle note on the validation-artifacts page for upgrade timing.

What Beliq emits

When you call POST /v1/generate with standard: "xrechnung", Beliq writes a compliant XML document using the syntax you choose. XRechnung permits both EN 16931–defined syntaxes (per EN 16931-2): UBL 2.1 and UN/CEFACT CII D16B.

Element Beliq behaviour
cbc:CustomizationID / ram:GuidelineSpecifiedDocumentContextParameter XRechnung URN for the appropriate UBL or CII document type.
Syntax CII by default (matches existing integrations in DE); pass profile to switch where applicable.
cbc:BuyerReference (BT-10) Required — supply via invoice.buyerReference. For B2G this is the Leitweg-ID identifying the receiving authority.
Seller email (BT-43) Required — supply via invoice.seller.email.
Payment means At least one paymentMeans entry must be present.
VAT identifier Either seller.vatId (BT-31) or seller.taxId must be set.

The full request schema (parties, lines, totals, etc.) is on POST /v1/generate, and a worked German curl example is in the Germany guide.

German-specific rules

XRechnung adds DE-prefixed business rules on top of EN 16931 core rules (BR-*). The most common to watch for are documented in the Germany guide — Common validation errors section. Rule IDs follow the BR-DE-* convention; the full Schematron is published at itplr-kosit/xrechnung-schematron.

Validation pipeline

Every invoice generated with standard: "xrechnung" is validated before the response is returned, and uploaded XML can be re-validated via POST /v1/validate. The pipeline is:

  1. XSD — UBL 2.1 or CII D16B structural correctness.
  2. EN 16931 Schematron — the cross-syntax core rules.
  3. XRechnung Schematron (KoSIT) — DE-specific overlay; matched by CustomizationID.

The pinned versions Beliq runs are published on the validation artifacts page (single source of truth — this page does not duplicate them).

Submission channels (out of scope for Beliq)

Beliq generates compliant XRechnung XML; it does not transmit invoices to the German government portals. Submission goes through your ERP / AP system to:

  • ZRE (Zentraler Rechnungseingang) — federal agencies.
  • OZG-RE — state and municipal authorities, via the Online Access Act gateway.

This split keeps Beliq focused on producing structurally and semantically correct XRechnung documents on the first try; channel operation belongs to your transmission partner.