Pobierz darmowy klucz
100 zapytań miesięcznie, bez karty, bez konta. Klucz jest wyświetlany tylko raz; zapisz go w bezpiecznym miejscu.
Szybki start
curl -H "Authorization: Bearer ek_…" -F file=@invoice.pdf https://einvoicechecker.com/v1/validateWyślij fakturę jako pole multipart file, jako surowe body application/xml lub application/pdf, albo jako JSON {"xml": "…"}. PDF-y są akceptowane wszędzie: osadzony XML Factur-X / ZUGFeRD jest wyodrębniany automatycznie.
Endpointy
| Endpoint | Wynik |
|---|---|
POST /v1/detect | rodzina, składnia (ubl / cii / ksef-fa), standard, profil, kraj |
POST /v1/parse | znormalizowany JSON: sprzedawca, nabywca, pozycje, podsumowanie VAT, kwoty, płatność, referencje. Ta sama struktura dla każdego formatu. |
POST /v1/validate?kosit=true | scalony raport: valid, checks per silnik, errors i warnings z kodem reguły, komunikatem i XPath |
POST /v1/render?lang=en|de|fr|pl|nl | faktura HTML do wydruku |
POST /v1/render?format=pdf&lang=de | PDF A4 (application/pdf, nazwa pliku = numer faktury) |
POST /v1/inspect | rozpoznanie + odczyt + walidacja + HTML w jednym wywołaniu |
GET /v1/me | Twój plan, zużycie w miesiącu, pozostały limit, linki do ulepszenia |
Silniki walidacji
- KSeF FA(3): schema XSD Ministerstwa Finansów (25 czerwca 2025) plus reguły semantyczne (sumy kontrolne NIP, kwoty, daty, kody stawek VAT).
- XRechnung, ZUGFeRD, Factur-X, ogólne EN 16931: walidator KoSIT 1.6 z konfiguracją XRechnung 3.0.2, niemiecka implementacja referencyjna (schematron EN 16931 + reguły BR-DE).
- Peppol BIS Billing 3.0: oficjalne zestawy reguł OpenPeppol, wydanie 3.0.20 (CEN EN 16931 + PEPPOL-EN16931-R*), wykonywane w Saxon-JS.
Przykładowa odpowiedź
{
"format": { "family": "en16931", "syntax": "cii", "standard": "Factur-X", "profile": "urn:factur-x.eu:1p0:en16931", "country": "FR" },
"valid": false,
"checks": [
{ "name": "en16931-core", "engine": "@invoicenavigator/einvoice-validator", "valid": true, "errors": 0 },
{ "name": "kosit-xrechnung", "engine": "KoSIT Validator 1.6.3", "valid": false, "errors": 1, "scenario": "EN16931 (CII)" }
],
"errors": [
{ "source": "kosit", "rule": "BR-CO-15", "level": "error",
"message": "Invoice total amount with VAT (BT-112) = Invoice total amount without VAT (BT-109) + Invoice total VAT amount (BT-110).",
"path": "/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementHeaderMonetarySummation" }
],
"warnings": []
}
Błędy i limity
| Status | Code | Znaczenie |
|---|---|---|
| 401 | INVALID_API_KEY | nieznany klucz; sprawdź nagłówek Authorization: Bearer |
| 422 | UNSUPPORTED_FORMAT | nierozpoznany XML e-faktury |
| 422 | NO_EMBEDDED_XML | PDF bez załącznika Factur-X / ZUGFeRD |
| 429 | RATE_LIMITED | limit na minutę w Twoim planie |
| 429 | QUOTA_EXCEEDED | wyczerpany limit miesięczny |
Każda zliczana odpowiedź niesie nagłówki X-Quota-Limit, X-Quota-Used i X-Quota-Remaining. Zapytania bez klucza są dozwolone tylko do interaktywnego użycia z tej strony, 20 na minutę na IP.
Cennik
| Plan | Zapytań / miesiąc | Na minutę | Miesięcznie | Rocznie (2 miesiące gratis) | |
|---|---|---|---|---|---|
| Free | 100 | 10 | €0 | €0 | klucz powyżej |
| Starter | 1 000 | 60 | €24 | €240 | Ulepsz |
| Pro | 10 000 | 120 | €49 | €490 | Ulepsz |
| Business | 50 000 | 300 | €149 | €1 490 | Ulepsz |
Jedno zapytanie = jedno wywołanie detect, parse, validate, inspect lub render HTML, niezależnie od rozmiaru pliku (do 10 MB). Render PDF (format=pdf) liczy się jako 2 zapytania. Ceny netto; VAT jest doliczany przy płatności według Twojego kraju, faktury wystawiane są automatycznie. Rezygnacja w dowolnym momencie, plan pozostaje aktywny do końca opłaconego okresu.
Aby ulepszyć plan, wywołaj GET /v1/me ze swoim kluczem i otwórz link płatności dla wybranego planu i okresu, albo wklej klucz poniżej.
Masz już subskrypcję? Wklej klucz powyżej: przycisk Zarządzaj subskrypcją otwiera portal klienta Paddle (faktury, metoda płatności, anulowanie). Przez API: GET /v1/billing/portal z kluczem zwraca ten sam jednorazowy adres.
Prywatność i dane
Faktury są przetwarzane w pamięci i usuwane po odesłaniu odpowiedzi. Przechowujemy hash klucza, e-mail, plan i liczbę zapytań dziennie. Nic z treści faktur nie jest zachowywane. Przetwarzanie odbywa się w UE. Wdrożenie on-premise (Docker) jest dostępne w planie Business.