Przewodniki

Status, zmiany i wsparcie

Na jakim etapie jest API, jak je wersjonujemy, gdzie śledzić zmiany i jak najszybciej dostać pomoc.

Status API

API jest we wczesnym dostępie: działa tryb testowy z KSeF TEST, a klucze wydajemy partiami osobom z listy startowej. Tryb produkcyjny włączymy później; o terminie napiszemy uczestnikom. Publicznej strony statusu jeszcze nie ma: o planowanych przerwach i problemach informujemy uczestników e-mailem.

Gdy KSeF nie odpowiada, nie musisz nic robić: faktury czekają w kolejce i wysyłają się same (ksef_unavailable).

Wersje

Każda odpowiedź ma nagłówek KSeF-Api-Version z datą wersji (obecnie 2026-10-19). Bez zapowiedzi dodajemy tylko zmiany zgodne wstecz: nowe pola w odpowiedziach, nowe typy zdarzeń i nowe kody błędów. Pisz kod, który ignoruje nieznane pola i obsługuje nieznany kod błędu jak ogólny błąd danego typu. Zmiany niezgodne wstecz zapowiemy e-mailem z wyprzedzeniem i oznaczymy nową datą wersji.

Historia zmian

Wszystkie zmiany w aplikacji, API i na stronie publikujemy w historii zmian. Specyfikację OpenAPI zawsze pobierzesz w aktualnej wersji: openapi.yaml.

Pomoc techniczna

Napisz na kontakt@ksefshop.pl. Żeby pomóc szybko, podaj:

• Request-Id z nagłówka odpowiedzi (np. req_8Kq2Lm4Np6Rs8Tu0Vw2X),
• id faktury lub korekty (inv_..., cor_...) i tryb (test czy produkcja),
• kod błędu i czas żądania.

Nigdy nie wysyłaj nam pełnego klucza API ani sekretu webhooka. Wystarczą pierwsze znaki, np. sk_test_4f....