KSeF API – jak działa?

API (Application Programming Interface) to podstawowy mechanizm komunikacji między KSeF a oprogramowaniem zewnętrznym. Dzięki niemu możliwa jest pełna automatyzacja procesów – od logowania, przez wystawienie faktury, aż po jej pobranie i archiwizację.

Jak działa API KSeF:

REST API
KSeF udostępnia RESTful API, które wykorzystuje protokół HTTPS i standardowe metody (GET, POST) do wymiany danych w formacie XML.

Uwierzytelnienie i autoryzacja
Dostęp do API wymaga tokenu – generowanego przez użytkownika uprawnionego w systemie KSeF. Token musi być przesyłany w nagłówkach żądań jako element autoryzujący.

Struktura komunikatów
Każde żądanie i odpowiedź są w formacie XML. Wymagana jest zgodność z formatami technicznymi Ministerstwa Finansów (np. SendInvoiceRequest, QueryInvoiceResponse).

Dzienniki operacji i identyfikatory sesji
Każde żądanie jest logowane i otrzymuje identyfikator operacji (SessionID), który można wykorzystać do śledzenia statusu przetwarzania faktury.

Środowisko testowe (sandbox)
Dostępne jest środowisko testowe umożliwiające próby integracji bez wpływu na dane produkcyjne. To bezpieczna przestrzeń do testowania systemów ERP i automatyzacji.