XRechnung 3.0
Germania · B2G attivo, B2B 2027–2028XRechnung è la CIUS tedesca su EN 16931 — una fattura UBL o CII con regole rigorose per il settore pubblico tedesco, in particolare un identificativo di instradamento obbligatorio (Leitweg-ID). È già richiesta per fatturare alle pubbliche amministrazioni tedesche, con l'emissione B2B che diventa obbligatoria per fasi dal 2027.
Cos'è
XRechnung 3.0.2 definisce i campi esatti, le liste di codici e le regole di business che una fattura tedesca deve rispettare, in sintassi UBL o CII. È mantenuta da KoSIT, e CrateAPI valida secondo gli artefatti di validazione ufficiali di KoSIT — gli stessi usati dal sistema del vostro destinatario.
Dove è obbligatorio
Germania: la fatturazione verso il settore pubblico (B2G) è già attiva. L'emissione B2B diventa obbligatoria dal 2027 per le aziende con fatturato oltre 800.000 €, e dal 2028 per tutte — vedi il nostro tracker degli obblighi per i dettagli.
Cosa non facciamo. Il Leitweg-ID — il codice di instradamento richiesto da un acquirente pubblico tedesco — corrisponde direttamente al campo buyer_reference (BT-10) del modello canonico. È un campo standard EN 16931 che XRechnung rende semplicemente obbligatorio, non un extra specifico di XRechnung.
Provalo
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 rilevanti
| Endpoint | Note |
|---|---|
POST /v1/generate/ubl?profile=xrechnung | Sintassi UBL, regole XRechnung 3.0.2. |
POST /v1/generate/cii?profile=xrechnung | Sintassi CII — stesse regole, forma XML diversa. |
POST /v1/validate/{ubl,cii}?profile=xrechnunggratuito | Gli artefatti di validazione propri di KoSIT, gli stessi usati dal vostro destinatario. |
POST /v1/render/{html,pdf}?lang=de | Per le fatture che ricevete e non potete leggere come XML puro. |
Esempi e documentazione
Scarica un esempio XRechnung validato dalla nostra libreria di esempi, oppure leggi il riferimento API completo.
Domande frequenti
UBL o CII per XRechnung?
Entrambi — XRechnung è definito su entrambe le sintassi e CrateAPI genera e valida entrambe. Usa quella attesa dal tuo partner commerciale o portale.
È la stessa cosa di ZUGFeRD?
No, ma è correlato: ZUGFeRD 2.x è il formato ibrido PDF+XML tedesco e condivide il nucleo XML (CII) con Factur-X. Per la versione PDF ibrida invece dell'XML puro, vedi la nostra pagina Factur-X.
Serve un campo speciale per il Leitweg-ID?
No — è il campo standard buyer_reference (BT-10) del modello canonico, che XRechnung rende obbligatorio e che altri profili lasciano opzionale.