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.
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 "$BASE/v1/generate/ubl?profile=peppol" \ -H "X-API-Key: $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.