W nadchodzących miesiącach UPS ma zamiar zrezygnować z API Web Service z których korzystała ProstaPaczka.
W wersji v23.11 dodaliśmy integrację za pomocą interfejsu API REST.
W ustawieniach konta dostępowego (zakładka UPS - ikona zębatki -> przycisk KONTA) dodaliśmy możliwość wyboru integracji dla danego konta:
- WebService - stosowanie dotychczasowej metody integracji za pomocą loginu i hasła
- TokenRest - wykorzystywanie API REST z autoryzacją O/Auth
Aby używać nowego API należy:
1. Dodać nowe konto dostępowe
2. Wybrać sposób autoryzacji 'TokenRest' - pokażą się przyciski autoryzacji
3. Kliknąć w przycisk Autoryzacji konta - wyświetlone zostanie okno przeglądarki
4. W oknie przeglądarki wprowadzić dane dostępowe do konta UPS
Po pomyślnej autoryzacji program otrzyma specjalny kod (Token) który będzie używany do komunikacji z API UPS.
W polach wyświetlona będzie informacja o dacie ważności tokenu.
Jeżeli list będzie przygotowany po utracie ważności tokenu to UPS będzie zwracał błąd autoryzacji. Wtedy należy odświeżyć token w ustawieniach konta dostępowego aby UPS przyznało nowy token.
Możliwość odświeżania tokenu ma swoje ograniczenia i po pewnym czasie może się okazać konieczna ponowna autoryzacja konta.
Zamiast podawania loginu i hasła trzeba kliknąć w przycisk Autoryzacji konta, gdzie w oknie przeglądarki
Teoretycznie jest możliwość zmiany sposobu integracji na istniejącym koncie aby zachować ciągłość pracy, jednak zalecamy aby przed tym skonsultować się ze swoim opiekunem w UPS.