API REST
Każda operacja fakturowania, jaką wykonuje CrateAPI, pogrupowana według tego, co chcesz zrobić — Generate, Validate, Convert & Render, Extract & Embed — a nie według formatu, w jakim akurat jest faktura.
Dwie rzeczy warto wiedzieć od razu: walidacja jest darmowa — bez karty, bez konta — a ekstrakcja jest deterministyczna — odczytuje XML rzeczywiście osadzony w PDF, niczego nie rekonstruuje ani nie zgaduje.
Wypróbuj na żywo
Wybierz operację, wklej lub wczytaj przykład i wywołaj prawdziwe API — od razu tutaj, bez rejestracji.
Faktura JSON na wejściu, zgodny XML — albo PDF Factur-X — na wyjściu. Każdy wynik jest wstępnie zwalidowany, zanim w ogóle do Ciebie dotrze.
To ścieżka dla deweloperów — jeśli wolisz formularz krok po kroku, użyj generatora bez kodu na stronie głównej.
Generate
Faktura JSON na wejściu, zgodny XML — albo PDF Factur-X — na wyjściu. Każdy wynik jest wstępnie zwalidowany, zanim w ogóle do Ciebie dotrze.
POST /v1/generate/ublWstępnie zwalidowany XML faktury UBL 2.1 — wybierz Peppol BIS, XRechnung lub RO_CIUS przez ?profile=. Jeśli nie przejdzie oficjalnych reguł, dostajesz błąd zamiast błędnej faktury.
POST /v1/generate/ciiTa sama gwarancja, w CII D16B — składni wewnątrz Factur-X i ZUGFeRD.
POST /v1/generate/facturxKompletny PDF Factur-X: nasz czysty układ wizualny, ze zgodnym XML-em CII EN 16931 osadzonym w środku.
POST /v1/generate/fatturapaPOST /v1/generate/facturaePOST /v1/generate/ksefWłoska FatturaPA, hiszpańska Facturae i polska FA_VAT/KSeF — trzy zastrzeżone krajowe słowniki XML, jeden model faktury JSON na wejściu.
Validate
Dokładnie te same zestawy reguł, które stoją za każdym wywołaniem generowania, udostępnione jako osobny produkt. To też jedyna darmowa rzecz na tej stronie.
Darmowe, bez klucza, od razu:
curl -X POST https://api.crateapi.com/v1/validate/ubl \ -H "Content-Type: application/xml" \ --data-binary @invoice.xml {"profile":"peppol","valid":true,"counts":{"fatal":0,"warning":0},"findings":[],"duration_ms":12}
POST /v1/validate/ublPOST /v1/validate/ciiPełna walidacja XSD + Schematron względem EN 16931, Peppol BIS, XRechnung, RO_CIUS i BR-FR. Ustrukturyzowane wyniki z identyfikatorami reguł — darmowe, bez rejestracji, bez klucza.
POST /v1/validate/ubl/reportTa sama kontrola, w formie drukowalnego raportu PDF: baner VALID/INVALID i tabela wyników. Płatne, w przeciwieństwie do powyższego endpointu JSON.
POST /v1/pdfa/validateSprawdza dowolny PDF względem PDF/A-3 za pomocą veraPDF, referencyjnego walidatora zbudowanego dla PDF Association — darmowe, tak jak walidacja faktury.
Convert & Render
Przenieś fakturę między składniami albo zamień ją w coś, co człowiek naprawdę może przeczytać.
POST /v1/convert/{source}-to-{target}Osiem kierunków między UBL, CII, XRechnung i Factur-X. Bezstratnie albo odrzucona: wszystko, czego nie da się przekonwertować czysto, wraca jako 422 z dokładnym powodem, nigdy jako po cichu okrojona faktura.
POST /v1/render/pdfPOST /v1/render/htmlXML faktury na wejściu, czytelna strona PDF lub HTML na wyjściu — oficjalne arkusze stylów wizualizacji KoSIT, ten sam widok, którego potrzebują portale, gdy klient dostaje XML, którego nie może otworzyć.
Extract & Embed
Wyciągnij dane odczytywalne maszynowo z PDF — albo je tam włóż.
POST /v1/extract/xmlOdczytuje załącznik XML rzeczywiście znajdujący się wewnątrz PDF Factur-X/ZUGFeRD i go zwraca — deterministycznie, nigdy nie odtwarzając ani nie zgadując.
POST /v1/extract/attachmentsWylicza każdy osadzony plik w PDF, nie tylko XML faktury — łącznie z dokumentami towarzyszącymi (BG-24).
POST /v1/generate/facturx/embedTwój oznakowany PDF faktury plus JSON faktury, połączone w Factur-X/PDF/A-3 ze zgodnym XML-em osadzonym w środku. Zachowujesz swój projekt, zyskujesz zgodność.
Gotowy, żeby wywołać ją samodzielnie?
Każda operacja powyżej jest o jedno wywołanie HTTP — weź klucz albo najpierw przeczytaj pełną dokumentację.