KSeF API: przykłady scenariuszy testowych

Przykłady pracy z KSeF API warto zacząć od określenia środowiska i wyniku próby. Udane pojedyncze wywołanie nie potwierdza całego obiegu faktury. W odbiorze integracji potrzebne są także statusy, obsługa przerw i sposób rozpoznawania ponowienia.

Ten poradnik opisuje scenariusze do uzgodnienia z wykonawcą. Nie zawiera gotowego klienta API ani relacji z uruchomionego testu. Aktualne endpointy i uwierzytelnienie należy sprawdzać w oficjalnej dokumentacji.

TEST, DEMO i produkcja mają inne przeznaczenie

Repozytorium CIRFMF rozróżnia środowisko TEST z wersjami RC, przedprodukcyjne DEMO oraz PRD. Dokumentacja przestrzega przed przesyłaniem produkcyjnych faktur i rzeczywistych danych do środowisk testowych. Wskazuje też brak izolacji danych między integratorami w TEST przy opisanym sposobie uwierzytelnienia. Środowiska KSeF API 2.0, sprawdzone 9 października 2026.

Do próby przygotuj dane zgodnie z tymi zasadami. Nie kopiuj produkcyjnych poświadczeń ani faktur do przykładu tylko dlatego, że ułatwi to wykonanie pierwszego żądania. Odpowiedzialna osoba powinna wiedzieć, do którego środowiska kierowane jest wywołanie.

Co sprawdzić w scenariuszu?

Szczegóły oczekiwanego zachowania zależą od wybranej operacji i aktualnego kontraktu API. Tabela nie opisuje gwarancji protokołu ani wyników wykonanych prób. Z wykonawcą ustal, jak odtworzyć każdy przypadek i jaki zapis potwierdzi jego obsługę.

Dane testowe są częścią przygotowania

Oficjalne repozytorium zawiera przykłady tworzenia danych i uprawnień testowych, między innymi dla JDG i grupy VAT. To materiał do przygotowania właściwego kontekstu testu, nie instrukcja nadawania uprawnień w produkcji. Scenariusze danych testowych CIRFMF.

Przy odbiorze zachowaj wersję dokumentacji, opis środowiska i wynik każdej próby. Własny numer sprawy powinien prowadzić do materiału, który pozwala wyjaśnić przebieg. Sama informacja „API odpowiedziało” jest za mało dokładna, żeby księgowość wiedziała, co ma zrobić dalej.

Kiedy potrzebujesz własnej integracji?

Jeżeli używany program ma obsługę KSeF, zacznij od jego funkcji. Przykład konfiguracji opisuje poradnik Fakturownia i KSeF. Dodatkowa automatyzacja może dotyczyć pracy po odebraniu dokumentu, na przykład zebrania opisu kosztu.

Przed zleceniem połączenia porównaj koszt modułu, konfiguracji i dodatkowego obiegu KSeF. W budżecie uwzględnij także odbiór integracji i późniejszą obsługę wyjątków.

Syntalith może omówić automatyzację KSeF, z osobno określonym zakresem połączeń, kontroli i odbioru. Informacje o wycenie są w cenniku. Zakres wymaga sprawdzenia używanego ERP; nie zakładamy gotowego połączenia z każdym programem. Do rozmowy wystarczy wskazać system i czynność, która pozostaje ręczna mimo istniejącego połączenia.