Kod QR KSeF do faktury
Faktura z KSeF przekazana klientowi na papierze albo w PDF musi mieć kod QR z linkiem weryfikacyjnym. Wysyłasz plik XML faktury, dostajesz link i gotowy kod QR w SVG. Działa też w drugą stronę: z linku odczytanego z kodu na otrzymanej fakturze dostajesz NIP sprzedawcy, datę i informację, czy pasuje do pliku.
Programy do faktur, obieg dokumentów, biura rachunkowe
Start
29 złnetto miesięcznie
do 1 000 faktur dziennie
Mały program do faktur albo obieg dokumentów w firmie.
Więcej
69 złnetto miesięcznie
do 3 000 faktur dziennie
Biura rachunkowe i systemy dla wielu firm.
Zapytanie i odpowiedź
curl https://odswiezona.pl/api/v1/ksef \ -H "Authorization: Bearer odsw_TWÓJ_KLUCZ" \ -H "Content-Type: application/json" \ -d "{\"xml_base64\": \"$(base64 -w0 faktura.xml)\"}"
200 OK, odpowiedź skrócona
{ "ok": true, "faktura": { "nip": "1133067162", "nip_poprawny": true, "data_wystawienia": "2026-09-28", "skrot": "q3vY…Tw" }, "link": "https://qr.ksef.mf.gov.pl/invoice/1133067162/28-09-2026/q3vY…Tw", "qr_svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" …>", "limit": { "dzienny": 1000, "wykorzystano": 1 }}
| Co | Jak |
|---|---|
| Zapytanie | POST /api/v1/ksef, JSON: xml_base64 (plik faktury, zalecane) albo xml (treść), link (tekst z kodu QR), srodowisko: prod (domyślnie), test albo demo, qr: false bez obrazka |
| Link | https://qr.ksef.mf.gov.pl/invoice/{NIP sprzedawcy}/{data wystawienia DD-MM-RRRR}/{SHA-256 pliku w Base64URL} (KOD I z dokumentacji Ministerstwa Finansów) |
| Sprawdzenie | plik i link razem: pole zgodny mówi, czy kod QR na fakturze pasuje do pliku (NIP, data i skrót) |
| Wielkość | plik do 2 MB; skrót liczę z dokładnych bajtów, więc prześlij plik bez zmian (najlepiej Base64) |
| Klucz | nagłówek Authorization: Bearer odsw_…; ten sam klucz może obsługiwać kilka API (wszystkie API) |
| Limity | dzienny według planu (liczy się każda faktura) i 20 zapytań na minutę; limit odnawia się o północy |
| Błędy | 400 złe dane (nie liczą się do limitu), 401 zły klucz, 429 limit, 502 chwilowy błąd |
Pod kodem QR na wizualizacji faktury umieść numer KSeF (albo napis OFFLINE dla faktury wystawionej w trybie offline, która wymaga też drugiego kodu z certyfikatem). Czy faktura jest w KSeF, pokaże strona Ministerstwa Finansów po otwarciu linku.
Plik faktury przetwarzam w pamięci i od razu zapominam: nie zapisuję ani nie loguję treści faktur, liczę tylko ich liczbę na klucz. Zasady usługi: warunki usług płatnych; umowę powierzenia danych akceptujesz razem z zamówieniem.
Klucz testowy na tydzień
Napisz, w jakim programie wystawiasz faktury. Dostaniesz klucz testowy (działa też ze środowiskiem testowym KSeF).