UBL 2.1 / Peppol BIS 3.0
UE · transfrontalier și sector publicUBL (Universal Business Language) 2.1 este sintaxa XML din spatele Peppol BIS Billing 3.0 — cel mai apropiat lucru de un standard unic de e-facturare în UE: o singură rețea, un singur set de reguli, folosit pentru comerț transfrontalier și facturare către sectorul public în majoritatea statelor membre. CrateAPI generează, validează și convertește facturi UBL pe regulile oficiale Peppol/EN 16931 — aceleași artefacte pe care le verifică Access Point-ul tău.
Ce este
Peppol BIS Billing 3.0 este o CIUS (Core Invoice Usage Specification) construită peste sintaxa UBL EN 16931, întreținută de OpenPeppol. Definește schema de adresare electronică, câmpurile obligatorii și regulile de business care permit unei facturi să circule prin orice Access Point Peppol fără un acord bilateral între emitent și destinatar.
Unde e obligatoriu
Facturarea electronică către sectorul public (B2G) prin Peppol e deja live în majoritatea statelor membre UE — multe guverne acceptă doar Peppol BIS sau un profil echivalent. Adoptarea în sectorul privat e azi voluntară, dar crește rapid, devenind opțiunea implicită pentru comerțul transfrontalier pe măsură ce fiecare țară își introduce propriile obligații naționale până în 2030 (ViDA).
Ce nu facem. CrateAPI nu este un Access Point Peppol — nu operăm în rețea și nu transmitem facturi prin ea. Generăm și validăm documentul; trimiterea lui în rețea rămâne treaba Access Point-ului tău (propriu sau al unui furnizor).
Încearcă
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-uri relevante
| Endpoint | Note |
|---|---|
POST /v1/generate/ubl?profile=peppol | Pre-validată pe regulile Peppol BIS 3.0 înainte de a fi returnată — o factură invalidă nu iese niciodată cu un 200. |
POST /v1/validate/ubl?profile=peppolgratuit | Reguli oficiale Peppol BIS 3.0 + EN 16931, fiecare constatare cu ID-ul regulii. |
POST /v1/convert/cii-to-ubl?profile=peppol | Din CII, fără pierderi sau respinsă — un 422 listează exact ce nu a supraviețuit. |
POST /v1/render/{html,pdf}?lang=en|de | HTML sau PDF lizibil al facturii, foi de stil KoSIT oficiale. |
Exemple și documentație
Descarcă o factură UBL/Peppol de exemplu, validată, din biblioteca noastră de exemple, sau citește referința API completă.
Întrebări frecvente
UBL e același lucru cu Peppol?
Nu — UBL e sintaxa XML; Peppol BIS Billing 3.0 e un set specific de reguli (CIUS) construit peste ea. Profilul peppol al CrateAPI generează UBL deja conform cu Peppol BIS.
Îmi transmiteți factura prin rețeaua Peppol?
Nu. Producem un document conform Peppol; trimiterea lui în rețea e treaba Access Point-ului tău.
Pot obține aceeași factură și ca CII?
Da — POST /v1/convert/ubl-to-cii convertește fără pierderi sau spune exact ce nu e suportat. Vezi pagina noastră CII.