UBL 2.1 / Peppol BIS 3.0
UE · transfrontaliero e settore pubblicoUBL (Universal Business Language) 2.1 è la sintassi XML dietro Peppol BIS Billing 3.0 — quanto di più simile a uno standard unico di fatturazione elettronica esista nell'UE: una sola rete, un solo insieme di regole, usato per il commercio transfrontaliero e la fatturazione verso la pubblica amministrazione nella maggior parte degli stati membri. CrateAPI genera, valida e converte fatture UBL secondo le regole ufficiali Peppol/EN 16931 — gli stessi artefatti verificati dal vostro Access Point.
Cos'è
Peppol BIS Billing 3.0 è una CIUS (Core Invoice Usage Specification) costruita sulla sintassi UBL EN 16931, mantenuta da OpenPeppol. Definisce lo schema di indirizzamento elettronico, i campi obbligatori e le regole di business che permettono a una fattura di transitare attraverso qualsiasi Access Point Peppol senza un accordo bilaterale tra mittente e destinatario.
Dove è obbligatorio
La fatturazione elettronica verso la pubblica amministrazione (B2G) su Peppol è già attiva nella maggior parte degli stati membri UE — molti governi accettano solo Peppol BIS o un profilo equivalente. L'adozione nel settore privato è oggi volontaria ma in rapida crescita, diventando l'opzione predefinita per il commercio transfrontaliero man mano che ogni paese introduce i propri obblighi nazionali fino al 2030 (ViDA).
Cosa non facciamo. CrateAPI non è un Access Point Peppol — non operiamo sulla rete né trasmettiamo fatture attraverso di essa. Generiamo e validiamo il documento; farlo transitare sulla rete resta compito del vostro Access Point (vostro, o di un fornitore).
Provalo
curl -X POST "$BASE/v1/generate/ubl?profile=peppol" \ -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=peppol | Pre-validata secondo le regole Peppol BIS 3.0 prima di essere restituita — una fattura non valida non esce mai con un 200. |
POST /v1/validate/ubl?profile=peppolgratuito | Regole ufficiali Peppol BIS 3.0 + EN 16931, ogni rilievo con il suo ID regola. |
POST /v1/convert/cii-to-ubl?profile=peppol | Da CII, senza perdite o rifiutata — un 422 elenca esattamente cosa non è sopravvissuto. |
POST /v1/render/{html,pdf}?lang=en|de | HTML o PDF leggibile della fattura, fogli di stile KoSIT ufficiali. |
Esempi e documentazione
Scarica una fattura di esempio UBL/Peppol validata dalla nostra libreria di esempi, oppure leggi il riferimento API completo.
Domande frequenti
UBL è la stessa cosa di Peppol?
No — UBL è la sintassi XML; Peppol BIS Billing 3.0 è un insieme specifico di regole (CIUS) costruito su di essa. Il profilo peppol di CrateAPI genera UBL già conforme a Peppol BIS.
Trasmettete la mia fattura attraverso la rete Peppol?
No. Produciamo un documento conforme a Peppol; farlo transitare sulla rete è compito del vostro Access Point.
Posso ottenere la stessa fattura anche in CII?
Sì — POST /v1/convert/ubl-to-cii converte senza perdite o indica esattamente cosa non è supportato. Vedi la nostra pagina CII.