Czy jeden poprawny test wysyłki wystarczy?

Nie. Trzeba przetestować scenariusze błędne, statusy, ponowienia, odbiór faktur, offline24 i monitoring wyjątków.

Kto powinien uczestniczyć w testach?

Księgowość, osoba wystawiająca faktury, administrator ERP lub IT oraz właściciel procesu, który podejmie decyzje przy wyjątkach.

Jak testować integrację z KSeF

Plan testów integracji KSeF: scenariusze biznesowe, FA(3), API, błędy walidacji, retry, offline24, logi, monitoring i odbiór faktur.

Test integracji z KSeF nie polega na wysłaniu jednej faktury i odhaczeniu projektu. Taki test mówi tylko, że idealny dokument w idealnym scenariuszu przeszedł przez system. W realnej firmie pojawią się błędy danych, korekty, faktury z integracji, przerwy w komunikacji i dokumenty, których nikt nie umie przypisać.

Dobry test ma pokazać, czy firma potrafi przejść przez cały proces: od danych źródłowych, przez FA(3), wysyłkę, status, numer KSeF, logi, odbiór kosztów i obsługę wyjątków.

Dla kogo jest ten poradnik

Dla zespołów IT, administratorów ERP, księgowości i osób odpowiedzialnych za wdrożenie. Przyda się też firmom, które kupują gotowy moduł KSeF i chcą sprawdzić, czy dostawca przetestował rzeczywiste przypadki.

Jeżeli faktury powstają automatycznie z innych systemów, testy muszą objąć te źródła danych. W przeciwnym razie sprawdzisz ekran ERP, ale nie sprawdzisz procesu.

Co zrobić krok po kroku

Wybierz reprezentatywne typy faktur i korekt.
Przygotuj dane z realnych źródeł: ERP, sklep, CRM, import, ręczne wprowadzenie.
Zweryfikuj strukturę FA(3) i mapowanie pól.
Przetestuj wysyłkę poprawnego dokumentu.
Przetestuj błędy danych: brak wymaganej informacji, niepoprawny kontrahent, nietypowa stawka.
Przetestuj błąd techniczny: przerwanie komunikacji, ponowienie, status oczekujący.
Przetestuj odbiór faktury kosztowej i procedurę offline24.

Scenariusze obowiązkowe

Minimalny zestaw scenariuszy powinien obejmować fakturę sprzedaży, korektę, fakturę z danymi z integracji, dokument z błędem walidacji, ponowienie wysyłki, odbiór faktury kosztowej i dokument wystawiony offline24.

W większej firmie dodaj scenariusze specyficzne: wiele oddziałów, wiele magazynów, eksport danych, nietypowe rabaty, faktury cykliczne, wielu wystawców i faktury tworzone automatycznie.

Co powinien pokazać raport z testu

Raport nie musi być długi. Powinien wskazywać: scenariusz, wynik, status w systemie, komunikat błędu, osobę odpowiedzialną za poprawkę i decyzję, czy scenariusz jest gotowy do produkcji.

Jeżeli test wykryje błąd, nie zamykaj go zdaniem „do poprawy”. Zapisz, czy problem dotyczy danych, konfiguracji, integracji, uprawnień, certyfikatu czy procedury. To skraca rozmowę z dostawcą ERP i integratorem.

Retry i monitoring

Wysyłka do KSeF powinna mieć kontrolowany mechanizm ponowień. Nie każdy błąd nadaje się do retry. Błąd sieciowy można ponowić, ale błąd danych wymaga poprawki w źródle. Jeżeli system ponawia wszystko bez rozróżnienia, może tylko zwiększać bałagan.

Monitoring powinien pokazywać faktury bez numeru KSeF, odrzucone, oczekujące, wystawione offline i wymagające interwencji człowieka. To jest ważniejsze niż ładna informacja o sukcesie przy pojedynczej fakturze.

Najczęstsze błędy

Test tylko jednej faktury.
Brak testu danych z integracji.
Brak testu odbioru faktur kosztowych.
Brak scenariusza offline24.
Brak właściciela błędów walidacji.
Brak raportu z testów i listy decyzji.

Minimum przed produkcją

Przed startem produkcyjnym firma powinna mieć potwierdzony zestaw scenariuszy, dostęp do logów, procedurę błędów, osobę odpowiedzialną za monitoring i plan awaryjny. Bez tego integracja może działać technicznie, ale zawieść organizacyjnie.