XRechnung 3.0
Allemagne · B2G actif, B2B 2027–2028XRechnung est la CIUS allemande sur EN 16931 — une facture UBL ou CII avec des règles strictes du secteur public allemand, notamment un identifiant de routage obligatoire (Leitweg-ID). Elle est déjà exigée pour facturer les administrations publiques allemandes, l'émission B2B devenant obligatoire par étapes à partir de 2027.
Ce que c'est
XRechnung 3.0.2 définit les champs exacts, les listes de codes et les règles métier qu'une facture allemande doit respecter, en syntaxe UBL ou CII. Elle est maintenue par KoSIT, et CrateAPI valide selon les artefacts de validation officiels de KoSIT — les mêmes que ceux utilisés par le système de votre destinataire.
Où c'est obligatoire
Allemagne : la facturation électronique du secteur public (B2G) est déjà en place. L'émission B2B devient obligatoire à partir de 2027 pour les entreprises de plus de 800k € de chiffre d'affaires, et pour toutes à partir de 2028 — voir notre suivi des obligations pour le détail.
Ce que nous ne faisons pas. Le Leitweg-ID — le code de routage requis par un acheteur public allemand — correspond directement au champ buyer_reference (BT-10) du modèle canonique. C'est un champ standard EN 16931 que XRechnung rend simplement obligatoire, pas un champ additionnel spécifique à XRechnung.
Essayer
curl -X POST "$BASE/v1/generate/ubl?profile=xrechnung" \ -H "X-API-Key: $KEY" -H "Content-Type: application/json" \ -d @invoice.json -o invoice.xml
Endpoints pertinents
| Endpoint | Notes |
|---|---|
POST /v1/generate/ubl?profile=xrechnung | Syntaxe UBL, règles XRechnung 3.0.2. |
POST /v1/generate/cii?profile=xrechnung | Syntaxe CII — mêmes règles, structure XML différente. |
POST /v1/validate/{ubl,cii}?profile=xrechnunggratuit | Les artefacts de validation propres à KoSIT, les mêmes que vérifie votre destinataire. |
POST /v1/render/{html,pdf}?lang=de | Pour les factures que vous recevez et ne pouvez pas lire en XML brut. |
Exemples et documentation
Téléchargez un exemple XRechnung validé depuis notre bibliothèque d'exemples, ou consultez la référence API complète.
FAQ
UBL ou CII pour XRechnung ?
Les deux — XRechnung est défini sur les deux syntaxes et CrateAPI génère et valide les deux. Utilisez celle attendue par votre partenaire commercial ou votre portail.
Est-ce la même chose que ZUGFeRD ?
Non, mais lié : ZUGFeRD 2.x est le format hybride PDF+XML allemand et partage son socle XML (CII) avec Factur-X. Pour la version PDF hybride plutôt que du XML pur, voir notre page Factur-X.
Ai-je besoin d'un champ spécial pour le Leitweg-ID ?
Non — c'est le champ standard buyer_reference (BT-10) du modèle canonique, que XRechnung rend obligatoire et que d'autres profils laissent optionnel.