Nowe API Wysyłam z Allegro

[Piotr]

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/


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.