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.
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 "$BASE/v1/generate/ubl?profile=xrechnung" \ -H "X-API-Key: $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.