XRechnung 3.0
Germania · B2G live, B2B 2027–2028XRechnung este CIUS-ul german pe EN 16931 — o factură UBL sau CII cu reguli stricte pentru sectorul public german, in special un identificator de rutare obligatoriu (Leitweg-ID). E deja obligatorie pentru facturarea administrațiilor publice germane, emiterea B2B devenind obligatorie treptat din 2027.
Parte din acoperirea de formate CrateAPI — vezi toate formatele.
Acest format este generat și validat de API-ul de e-facturare CrateAPI.
Ce este
XRechnung 3.0.2 definește câmpurile exacte, listele de coduri și regulile de business pe care trebuie să le respecte o factură germană, în sintaxă UBL sau CII. E întreținută de KoSIT, iar CrateAPI validează pe artefactele oficiale de validare KoSIT — aceleași folosite de sistemul destinatarului tău.
Unde e obligatoriu
Germania: facturarea sectorului public (B2G) e deja live. Emiterea B2B devine obligatorie din 2027 pentru firmele cu cifră de afaceri peste 800.000 €, iar din 2028 pentru toate — vezi tracker-ul nostru de obligații pentru detalii.
Ce nu facem. Leitweg-ID — codul de rutare de care are nevoie un cumpărător public german — se mapează direct pe câmpul buyer_reference (BT-10) din modelul canonic. E un câmp standard EN 16931 pe care XRechnung îl face doar obligatoriu, nu un câmp suplimentar specific XRechnung.
Încearcă
curl -X POST "https://api.crateapi.com/v1/generate/ubl?profile=xrechnung" \ -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \ -d @invoice.json -o invoice.xml
Endpoint-uri relevante
| Endpoint | Note |
|---|---|
POST /v1/generate/ubl?profile=xrechnung | Sintaxă UBL, reguli XRechnung 3.0.2. |
POST /v1/generate/cii?profile=xrechnung | Sintaxă CII — aceleași reguli, formă XML diferită. |
POST /v1/validate/{ubl,cii}?profile=xrechnunggratuit | Artefactele proprii de validare ale KoSIT, aceleași verificate de destinatarul tău. |
POST /v1/render/{html,pdf}?lang=de | Pentru facturile pe care le primești și nu le poți citi ca XML brut. |
Exemple și documentație
Descarcă un exemplu XRechnung validat din biblioteca noastră de exemple, sau citește referința API completă.
Întrebări frecvente
UBL sau CII pentru XRechnung?
Oricare — XRechnung e definit pe ambele sintaxe, iar CrateAPI le generează și validează pe amândouă. Folosește ce așteaptă partenerul tău comercial sau portalul.
E același lucru cu ZUGFeRD?
Nu, dar e înrudit: ZUGFeRD 2.x e formatul hibrid PDF+XML al Germaniei și împarte nucleul XML (CII) cu Factur-X. Pentru varianta PDF hibridă în loc de XML simplu, vezi pagina noastră Factur-X.
Am nevoie de un câmp special pentru Leitweg-ID?
Nu — e câmpul standard buyer_reference (BT-10) din modelul canonic, pe care XRechnung îl face obligatoriu, iar alte profiluri îl lasă opțional.