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ź

POST /api/v1/ksef
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 }}
CoJak
ZapytaniePOST /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
Linkhttps://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)
Sprawdzenieplik 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)
Klucznagłówek Authorization: Bearer odsw_…; ten sam klucz może obsługiwać kilka API (wszystkie API)
Limitydzienny według planu (liczy się każda faktura) i 20 zapytań na minutę; limit odnawia się o północy
Błędy400 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).