10 stycznia 2026

KSeF REST API — endpointy, formaty i przykłady

Przegląd REST API Krajowego Systemu e-Faktur. Lista endpointów, formaty danych, kody odpowiedzi.

KSeF REST API — przegląd techniczny

REST API Krajowego Systemu e-Faktur umożliwia programistyczną integrację z KSeF.

Bazowe URL

  • •Testowe: `https://ksef-test.mf.gov.pl/api`
  • •Produkcyjne: `https://ksef.mf.gov.pl/api`

    • Główne endpointy

    Sesja

  • •POST /api/online/Session/AuthorisationChallenge — pobranie challenge
  • •POST /api/online/Session/InitToken — otwarcie sesji (token)
  • •POST /api/online/Session/InitSigned — otwarcie sesji (certyfikat)
  • •GET /api/online/Session/Terminate — zamknięcie sesji

    • Faktury

  • •PUT /api/online/Invoice/Send — wysyłka faktury
  • •GET /api/online/Invoice/Get/{KSeFReferenceNumber} — pobranie faktury
  • •GET /api/online/Invoice/Status/{InvoiceElementReferenceNumber} — status faktury

    • Zapytania

  • •POST /api/online/Query/Invoice/Sync — zapytanie o faktury (synchroniczne)
  • •POST /api/online/Query/Invoice/Async/Init — zapytanie asynchroniczne

    • Formaty danych

  • •Request/Response: JSON
  • •Faktury: XML (schemat FA(2))
  • •Podpisy: XMLDSig, XAdES

    • Kody odpowiedzi

  • •200 — sukces
  • •400 — błąd walidacji
  • •401 — brak autoryzacji
  • •404 — nie znaleziono
  • •500 — błąd serwera

    • Nagłówki

  • •SessionToken — token sesji (wymagany po otwarciu sesji)
  • •Content-Type — application/json lub application/octet-stream

    • Limity

  • •Maksymalna wielkość faktury XML
  • •Limit sesji na podmiot
  • •Rate limiting na endpointach

    • Podsumowanie

    REST API KSeF jest kompleksowe, ale złożone. Proxy KSeF pozwala uprościć komunikację do kilku prostych endpointów.

    ksef rest apiksef api endpointyksef api dokumentacjaksef api formaty

    Powiązane usługi KSeF

    Wdrożenie KSeF

    Analiza procesów, projekt integracji i uruchomienie produkcyjne.

    Proxy KSeF

    Warstwa pośrednia upraszczająca komunikację z API KSeF.

    Pomoc dla firm

    Tokeny, uprawnienia, certyfikaty i pierwsze faktury w KSeF.

    Inne artykuły

    10 marca 2026

    Jak działa KSeF — wyjaśnienie krok po kroku

    10 marca 2026

    Co to jest KSeF? Czym jest Krajowy System e-Faktur — wyjaśnienie

    8 marca 2026

    Jak odebrać fakturę z KSeF — instrukcja krok po kroku

    Potrzebujesz pomocy z KSeF?

    Oferujemy integrację, proxy KSeF, aplikację Spektra i pomoc wdrożeniową.

    Skontaktuj się