Programy do faktur, obieg dokumentów, biura rachunkowe

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.

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)\"}"

{
  "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 liczymy 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 przetwarzamy w pamięci i od razu zapominamy: nie zapisujemy ani nie logujemy treści faktur, liczymy tylko ich liczbę na klucz. Umowę powierzenia danych podpisujemy razem z umową na API.

Klucz testowy na tydzień

Napisz, w jakim programie wystawiasz faktury. Dostaniesz klucz testowy (działa też ze środowiskiem testowym KSeF).

Poproś o klucz testowy