KSeF REST API — endpointy, formaty i przykłady | KSeF Serwis

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 API — endpointy, formaty i przykłady

KSeF REST API — przegląd techniczny

Bazowe URL

Główne endpointy

Sesja

Faktury

Zapytania

Formaty danych

Kody odpowiedzi

Nagłówki

Limity

Podsumowanie

Inne artykuły

Jak zintegrować system z KSeF — kompletny przewodnik

Jak działa API KSeF — architektura i workflow

KSeF API — przykład integracji krok po kroku

Potrzebujesz pomocy z KSeF?