XRechnung (UBL)
- Format id:
xrechnung-ubl - Countries: Germany (DE)
- Status: in active use
- Parser:
ublfamily, converts to canonical JSON
German CIUS. B2G mandatory; B2B receiving obligation since 1 Jan 2025. BT-10 carries the Leitweg-ID.
Where you will receive it
Section titled “Where you will receive it”- DE:
xrechnung-ubl,xrechnung-cii,facturx, legacyzugferd-1. Receiving obligation since Jan 2025, sending from Jan 2027. MINIMUM/BASIC WL are not valid e-invoices.
Mapping notes for the ubl parser family
Section titled “Mapping notes for the ubl parser family”- Phase 1. Covers: Peppol BIS 3 + self-billing, XRechnung UBL, NLCIUS, CIUS-RO, CIUS-PT, HR-CIUS, OIOUBL 3, UBL.BE, PINT, BIS 2 (best-effort), OIOUBL 2. One parser, profile-specific rules on top. Invoice vs CreditNote element names differ (
InvoicedQuantity/CreditedQuantity). UBL 2.1 CreditNote has no rootcbc:DueDate: readcac:PaymentMeans/cbc:PaymentDueDate, and accept a rootcbc:DueDateonly as a fallback with a warning (it appears in some XRechnung test files).
The same parser family handles the formats listed in Build order and mapping notes.
Check it
Section titled “Check it”- Drop a XRechnung (UBL) file into the browser converter to get canonical JSON; nothing is uploaded.
- Conformance checklist: fixtures, real samples, mapping source and validation for this format.
- Output shape: canonical-invoice.v1.schema.json.