UBL 2.1 / Peppol BIS 3.0
EU · grenzüberschreitend & öffentlicher SektorUBL (Universal Business Language) 2.1 ist die XML-Syntax hinter Peppol BIS Billing 3.0 — das Nächste, was die EU an einem einheitlichen E-Invoicing-Standard hat: ein Netzwerk, ein Regelwerk, genutzt für grenzüberschreitenden Handel und öffentliche Rechnungsstellung in den meisten Mitgliedstaaten. CrateAPI erzeugt, validiert und konvertiert UBL-Rechnungen nach den offiziellen Peppol/EN-16931-Regeln — denselben Artefakten, gegen die auch Ihr Access Point prüft.
Worum es geht
Peppol BIS Billing 3.0 ist eine CIUS (Core Invoice Usage Specification) auf Basis der EN-16931-UBL-Syntax, gepflegt von OpenPeppol. Sie legt das Adressierungsschema, Pflichtfelder und Geschäftsregeln fest, die eine Rechnung ohne bilaterale Vereinbarung zwischen Sender und Empfänger durch jeden Peppol Access Point laufen lassen.
Wo es Pflicht ist
Öffentliche Rechnungsstellung (B2G) über Peppol läuft bereits in den meisten EU-Mitgliedstaaten — viele Behörden akzeptieren nur Peppol BIS oder ein gleichwertiges Profil. Die Nutzung im Privatsektor ist heute freiwillig, wächst aber schnell, da Peppol zur Standardoption für grenzüberschreitenden Handel wird, während einzelne Länder bis 2030 ihre eigenen nationalen Pflichten einführen (ViDA).
Was wir nicht tun. CrateAPI ist kein Peppol Access Point — wir betreiben das Netzwerk nicht und übermitteln keine Rechnungen darüber. Wir erzeugen und validieren das Dokument; es ins Netzwerk zu bringen bleibt Aufgabe Ihres Access Points (Ihrem eigenen oder dem eines Anbieters).
Ausprobieren
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
Relevante Endpoints
| Endpoint | Hinweise |
|---|---|
POST /v1/generate/ubl?profile=peppol | Vor der Rückgabe gegen die Peppol-BIS-3.0-Regeln vorvalidiert — eine ungültige Rechnung verlässt uns nie mit einer 200. |
POST /v1/validate/ubl?profile=peppolkostenlos | Offizielle Peppol-BIS-3.0- + EN-16931-Regeln, jeder Befund mit seiner Regel-ID. |
POST /v1/convert/cii-to-ubl?profile=peppol | Aus CII, verlustfrei-oder-abgelehnt — ein 422 listet genau auf, was nicht überstanden hat. |
POST /v1/render/{html,pdf}?lang=en|de | Menschenlesbares HTML oder PDF der Rechnung, offizielle KoSIT-Stylesheets. |
Beispiele & Dokumentation
Laden Sie ein validiertes UBL/Peppol-Beispiel aus unserer Beispielbibliothek herunter, oder lesen Sie die vollständige API-Referenz.
FAQ
Ist UBL dasselbe wie Peppol?
Nein — UBL ist die XML-Syntax; Peppol BIS Billing 3.0 ist ein konkretes, darauf aufbauendes Regelwerk (CIUS). Das peppol-Profil von CrateAPI erzeugt UBL, das bereits Peppol BIS entspricht.
Übermitteln Sie meine Rechnung über das Peppol-Netzwerk?
Nein. Wir erzeugen ein Peppol-konformes Dokument; es ins Netzwerk zu bringen ist Aufgabe Ihres Access Points.
Kann ich dieselbe Rechnung auch als CII bekommen?
Ja — POST /v1/convert/ubl-to-cii konvertiert verlustfrei oder nennt genau, was nicht unterstützt wird. Siehe unsere CII-Seite.