Integracje
Jak przygotować firmę do KSeF i integracji
Integracja nie zaczyna się od endpointu API. Najpierw trzeba ustalić źródło danych, odpowiedzialność, obsługę błędów i sposób pracy, gdy jeden z systemów jest niedostępny.
Opublikowano:
Opisz pełny obieg dokumentu
Warto rozpisać, gdzie powstaje faktura, kto ją zatwierdza, kiedy jest wysyłana, gdzie zapisuje się identyfikator i co ma się wydarzyć po odrzuceniu dokumentu.
Uporządkuj dane podstawowe
Integracja ujawnia rozbieżności w danych kontrahentów, stawkach podatkowych, jednostkach i numeracji. Im wcześniej zostaną rozpoznane, tym mniej wyjątków trzeba obsługiwać w kodzie.
Zaplanuj błędy i ponowienia
- Kolejka dokumentów oczekujących na wysłanie.
- Kontrolowane ponowienia po błędzie technicznym.
- Rozróżnienie błędu danych od niedostępności usługi.
- Panel lub raport pozwalający sprawdzić stan dokumentu.
- Rejestr zdarzeń potrzebny do diagnozy i audytu.
Testuj poza produkcją
Przed uruchomieniem potrzebne są scenariusze poprawne i błędne, środowisko testowe oraz osoba odpowiedzialna za decyzje procesowe. Sama poprawna odpowiedź API nie oznacza, że cały obieg działa prawidłowo.
Nie traktuj integracji jako jednorazowego skryptu
API i wymagania biznesowe zmieniają się. Rozwiązanie powinno mieć monitoring, dokumentację, wersjonowanie i możliwość bezpiecznej aktualizacji.
Przygotowujesz integrację?
Opisz system źródłowy, dane i moment, w którym dokument powinien trafić do kolejnego kroku.