UBL 2.1 / Peppol BIS 3.0
UE · transgraniczne i sektor publicznyUBL (Universal Business Language) 2.1 to składnia XML stojąca za Peppol BIS Billing 3.0 — najbliższy odpowiednik jednego standardu e-fakturowania w UE: jedna sieć, jeden zestaw reguł, używany w handlu transgranicznym i fakturowaniu sektora publicznego w większości państw członkowskich. CrateAPI generuje, waliduje i konwertuje faktury UBL według oficjalnych reguł Peppol/EN 16931 — tych samych artefaktów, które sprawdza Twój Access Point.
Część pokrycia formatów CrateAPI — zobacz wszystkie formaty.
Ten format jest generowany i walidowany przez API e-fakturowania CrateAPI.
Czym to jest
Peppol BIS Billing 3.0 to CIUS (Core Invoice Usage Specification) zbudowany na składni UBL EN 16931, utrzymywany przez OpenPeppol. Określa schemat adresowania elektronicznego, pola obowiązkowe i reguły biznesowe, które pozwalają fakturze przejść przez dowolny Access Point Peppol bez dwustronnej umowy między nadawcą a odbiorcą.
Gdzie jest obowiązkowe
E-fakturowanie sektora publicznego (B2G) w sieci Peppol działa już w większości państw członkowskich UE — wiele rządów akceptuje wyłącznie Peppol BIS lub równoważny profil. Przyjęcie w sektorze prywatnym jest dziś dobrowolne, ale rośnie szybko, stając się domyślną opcją transgraniczną w miarę wdrażania własnych krajowych mandatów przez poszczególne kraje do 2030 roku (ViDA).
Czego nie robimy. CrateAPI nie jest Access Pointem Peppol — nie działamy w sieci ani nie przesyłamy przez nią faktur. Generujemy i walidujemy dokument; wprowadzenie go do sieci pozostaje zadaniem Twojego Access Pointa (własnego lub dostawcy).
Wypróbuj
curl -X POST "https://api.crateapi.com/v1/generate/ubl?profile=peppol" \ -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \ -d @invoice.json -o invoice.xml
Istotne endpointy
| Endpoint | Uwagi |
|---|---|
POST /v1/generate/ubl?profile=peppol | Wstępnie zwalidowana wg reguł Peppol BIS 3.0 przed zwróceniem — nieprawidłowa faktura nigdy nie wychodzi z kodem 200. |
POST /v1/validate/ubl?profile=peppoldarmowe | Oficjalne reguły Peppol BIS 3.0 + EN 16931, każde ustalenie z identyfikatorem reguły. |
POST /v1/convert/cii-to-ubl?profile=peppol | Z CII, bezstratnie albo odrzucona — błąd 422 wskazuje dokładnie, co nie przetrwało. |
POST /v1/render/{html,pdf}?lang=en|de | Czytelny dla człowieka HTML lub PDF faktury, oficjalne arkusze stylów KoSIT. |
Przykłady i dokumentacja
Pobierz zwalidowaną przykładową fakturę UBL/Peppol z naszej biblioteki przykładów lub przeczytaj pełną dokumentację API.
FAQ
Czy UBL to to samo co Peppol?
Nie — UBL to składnia XML; Peppol BIS Billing 3.0 to konkretny zestaw reguł (CIUS) zbudowany na niej. Profil peppol CrateAPI generuje UBL już zgodny z Peppol BIS.
Czy przesyłacie moją fakturę przez sieć Peppol?
Nie. Tworzymy dokument zgodny z Peppol; wprowadzenie go do sieci to zadanie Twojego Access Pointa.
Czy mogę otrzymać tę samą fakturę jako CII?
Tak — POST /v1/convert/ubl-to-cii konwertuje bezstratnie albo dokładnie wskazuje, co nie jest obsługiwane. Zobacz naszą stronę CII.