UWAGA!!!
Do włączenia nowego API musimy zmienić uprawnienia aplikacji w systemie Allegro.
Przed włączeniem sprawdź czy nowe uprawnienia są już dostępne. Szczegóły w wątku:
https://forum.prostapaczka.pl/allegro/zmiana-uprawnien-aplikacji-28-03-2024/EDIT: Uprawnienia zostały już zmienione po stronie aplikacji i aby używać nowego API będzie wymagana ponowna autoryzacja konta Allegro.
Jeżeli autoryzacja nie zostanie zrobiona to Allegro będzie zwracało błąd:
AccessDenied: Brak dostępu do danego zasobu. (: )
Allegro w 2023 roku wprowadziło nowe API do tworzenia listów przewozowych (ShipmentManagemetn), które ma zastąpić obecne (Parcel Management) w okolicach III kwartału 2024.
W wersji v24.3 aplikacji ProstaPaczka dodaliśmy obsługę nowego API. Aby na danym koncie WZA używać nowego API należy w konfiguracji konta dostępowego (PP2 -> zakładka WZA -> przycisk zębatki -> przycisk KONTA) zaznaczyć flagę "Używaj nowego API".
Po zapisaniu ustawień program będzie używał nowego API do tworzenia przesyłek.
Co się zmieniło w nowym API? - Usunięto wartość paczki
- usunięto opis paczki
- dodano opis dla całej przesyłki
- dodano ubezpieczenie przesyłki
- dodano pole do wpisania numeru ulicy w danych adresowych (nadawcy, miejsca podjęcia i odbiorcy)
- zamieniono miejscami Adres podjęcia z nadawcą
- inne rzeczy techniczne, które nie są widoczne dla użytkownika jak nazwy metod, pól itd.
Co się zmieniło w programie?Staraliśmy się przygotować zmiany w taki sposób aby nie było konieczności zmian w konfiguracji programu i zachowały się istniejące już mapowania.
Jeżeli opcja użycia nowego API nie zostanie włączona, to obsługa będzie wyglądała tak jak do tej pory i nie trzeba wprowadzać zmian.
W oknie konfiguracji konta dostępowego WZA:
- dodaliśmy opcję włączającą używanie nowego API
- zmieniliśmy miejscami etykiety nadawcy i adresu podjęcia
- dodaliśmy przycisk zmiany miejscami adresu nadawcy i miejsca podjęcia
W oknie edycji listu:
- zmieniliśmy miejscami etykiety adresu podjęcia i nadawcy
- w tabeli paczek usunęliśmy kolumnę wartość i opis
- dodaliśmy pole do wpisania ubezpieczenia
- dodaliśmy pole do wpisania opisu przesyłki
- w danych adresowych nadawcy, miejsca podjęcia i odbiorcy dodaliśmy pole do wpisania numeru ulicy
W ustawieniach przetwarzania:
- brak widocznych zmian
- zmieniliśmy mechanizm przygotowania listu, aby dla konta z włączonym nowym API opis i ubezpieczenie przekazywało się do nowych pól zamiast do tabeli paczek
Co zrobić aby używać nowego API?W większości przypadków wystarczy włączyć używanie nowego API w ustawieniach konta dostępowego WZA i użyć przycisku przeniesienia adresów (jeżeli zostały wypełnione).
Można też utworzyć całkowicie nowe konto, nawet zdublować istniejące) i tylko na jednym koncie używać nowego API a na pozostałych starego, dzięki czemu w razie jakiś trudności problemy nie będą dotyczyły wszystkich przesyłek.