UBL 2.1 / Peppol BIS 3.0
UE · transfrontalier & secteur publicUBL (Universal Business Language) 2.1 est la syntaxe XML derrière Peppol BIS Billing 3.0 — ce qui se rapproche le plus d'un standard unique de facturation électronique dans l'UE : un seul réseau, un seul jeu de règles, utilisé pour le commerce transfrontalier et la facturation du secteur public dans la plupart des États membres. CrateAPI génère, valide et convertit des factures UBL selon les règles officielles Peppol/EN 16931 — les mêmes artefacts que vérifie votre Access Point.
Ce que c'est
Peppol BIS Billing 3.0 est une CIUS (Core Invoice Usage Specification) construite sur la syntaxe UBL EN 16931, maintenue par OpenPeppol. Elle définit le schéma d'adressage électronique, les champs obligatoires et les règles métier qui permettent à une facture de circuler via n'importe quel Access Point Peppol sans accord bilatéral entre émetteur et destinataire.
Où c'est obligatoire
La facturation électronique du secteur public (B2G) sur Peppol est déjà en place dans la plupart des États membres de l'UE — de nombreux gouvernements n'acceptent que Peppol BIS ou un profil équivalent. L'adoption dans le secteur privé est aujourd'hui volontaire mais progresse rapidement, devenant l'option transfrontalière par défaut à mesure que chaque pays déploie ses propres obligations nationales jusqu'en 2030 (ViDA).
Ce que nous ne faisons pas. CrateAPI n'est pas un Access Point Peppol — nous n'opérons pas sur le réseau et ne transmettons pas de factures via celui-ci. Nous générons et validons le document ; le faire circuler sur le réseau reste le travail de votre Access Point (le vôtre, ou celui d'un prestataire).
Essayer
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
Endpoints pertinents
| Endpoint | Notes |
|---|---|
POST /v1/generate/ubl?profile=peppol | Pré-validé selon les règles Peppol BIS 3.0 avant d'être renvoyé — une facture invalide ne sort jamais avec un 200. |
POST /v1/validate/ubl?profile=peppolgratuit | Règles officielles Peppol BIS 3.0 + EN 16931, chaque constat avec son ID de règle. |
POST /v1/convert/cii-to-ubl?profile=peppol | Depuis CII, sans perte ou refusé — un 422 liste exactement ce qui n'a pas survécu. |
POST /v1/render/{html,pdf}?lang=en|de | HTML ou PDF lisible de la facture, feuilles de style KoSIT officielles. |
Exemples et documentation
Téléchargez un exemple de facture UBL/Peppol validée depuis notre bibliothèque d'exemples, ou consultez la référence API complète.
FAQ
UBL, est-ce la même chose que Peppol ?
Non — UBL est la syntaxe XML ; Peppol BIS Billing 3.0 est un jeu de règles spécifique (CIUS) construit dessus. Le profil peppol de CrateAPI génère un UBL déjà conforme à Peppol BIS.
Transmettez-vous ma facture via le réseau Peppol ?
Non. Nous produisons un document conforme à Peppol ; le faire circuler sur le réseau est le travail de votre Access Point.
Puis-je obtenir la même facture en CII ?
Oui — POST /v1/convert/ubl-to-cii convertit sans perte ou indique exactement ce qui n'est pas pris en charge. Voir notre page CII.