Tryb awaryjny pakowania – obsługa błędu API kuriera dla pojedynczego zamówienia

W procesie pakowania wielu zamówień (HTML) dodano możliwość obsługi błędów komunikacji z API kuriera w odniesieniu do pojedynczego zamówienia.

W przypadku błędu (np. niepoprawny adres, problem z komunikacją sieciową) operator może zdecydować, czy ponowić próbę pobrania etykiety kurierskiej, czy wydrukować etykietę zastępczą dla konkretnego zamówienia.

Dotychczas wystąpienie błędu komunikacji z API kuriera (np. DPD, GLS) skutkowało wstrzymaniem całego procesu pakowania, nawet jeśli problem dotyczył tylko jednego zamówienia. Prowadziło to do przestojów oraz spadku efektywności. Wprowadzona funkcjonalność eliminuje przestoje w procesie pakowania oraz umożliwia lepsze zarządzanie wyjątkami i błędami w komunikacji z systemami zewnętrznymi.

W ramach wprowadzonej zmiany, w procesie pakowania wielu zamówień (HTML) dodano nowe okno dialogowe do obsługi błędów komunikacji z API kuriera w odniesieniu do pojedynczego zamówienia. W sytuacji, gdy podczas generowania etykiety kurierskiej wystąpi błąd (na przykład niepoprawny kod pocztowy lub chwilowy problem po stronie API kuriera), operator otrzymuje na ekranie komunikat o błędzie wraz z możliwością wyboru dalszego sposobu postępowania.

Nowe okno dialogowe prezentuje szczegóły błędu oraz umożliwia operatorowi podjęcie jednej z dostępnych akcji. Może on ponowić próbę wygenerowania etykiety kurierskiej, co spowoduje ponowne wywołanie API kuriera i w przypadku poprawnej odpowiedzi – wygenerowanie etykiety i kontynuację procesu pakowania. Alternatywnie, jeśli błąd dotyczy danych niemożliwych do natychmiastowej korekty (np. błędny adres odbiorcy), operator może wybrać opcję wydruku etykiety zastępczej. Treść komunikatu może różnić się w zależności od webserwisu kuriera oraz ewentualnych błędów związanych z samym zamówieniem.

Po wydruku etykiety zastępczej operator może kontynuować pakowanie kolejnych zamówień.

Rys. 1. Przykładowe okno dialogowe do obsługi błędu komunikacji z API kuriera

System umożliwia maksymalnie trzy próby ponowienia komunikacji, tj. wywołania usługi integracji kurierskiej, ponieważ dalsze próby mogłyby spowodować zablokowanie użytkownika w serwisie kurierskim. Po przekroczeniu tego limitu na ekranie pojawia się stosowne ostrzeżenie, a po zamknięciu komunikatu przycisk Ponów komunikację zostaje ukryty, pozostawiając operatorowi wyłącznie możliwość wydruku etykiety zastępczej.

Rys. 2. Komunikat informujący o przekroczeniu limitu ponowienia komunikacji z API kuriera

Rys. 3. Okno dialogowe po przekroczeniu limitu wywołania komunikacji z API kuriera

Zmiany w sposobie korzystania z funkcjonalności

Zmiana nie wymaga modyfikacji dotychczasowego sposobu pracy operatorów poza jedną nową sytuacją – pojawieniem się okna dialogowego z wyborem akcji w przypadku błędu komunikacji z API kuriera. Operatorzy powinni świadomie wybierać opcję Ponów komunikację w przypadku błędów tymczasowych (np. problem z siecią), a z opcji Wydruk etykiety zastępczej korzystać w przypadku błędnych danych.

Konfiguracja

Funkcjonalność wymaga nadania uprawnień: NIE

Funkcjonalność wymaga skonfigurowania: TAK