KSeF API — przykład integracji krok po kroku

KSeF API — przykład integracji

Przedstawiamy praktyczny przykład integracji z API KSeF, krok po kroku.

Krok 1: Wygenerowanie challenge

Przed otwarciem sesji pobieramy challenge (wyzwanie) z API KSeF.

Endpoint: POST /api/online/Session/AuthorisationChallenge

Request:

{
  "contextIdentifier": {
    "type": "onip",
    "identifier": "1234567890"
  }
}

Krok 2: Podpisanie challenge i otwarcie sesji

Challenge podpisujemy tokenem lub certyfikatem i otwieramy sesję interaktywną.

Endpoint: POST /api/online/Session/InitToken

Krok 3: Wysyłka faktury

Faktura w formacie XML (FA_VAT) jest wysyłana w ramach otwartej sesji.

Endpoint: PUT /api/online/Invoice/Send

Faktura musi być zgodna ze schematem XSD opublikowanym przez MF.

Krok 4: Sprawdzenie statusu

Po wysłaniu faktury sprawdzamy jej status.

Endpoint: GET /api/online/Invoice/Status/{referenceNumber}

Statusy:

Krok 5: Pobranie UPO

Po przetworzeniu faktury pobieramy UPO z numerem KSeF.

Krok 6: Zamknięcie sesji

Po zakończeniu operacji zamykamy sesję.

Wskazówki

Potrzebujesz pomocy?

Oferujemy gotowe proxy KSeF, które upraszcza cały ten workflow do kilku prostych żądań REST API.