[NEWS] W czwartym kwartale 2024 roku wyłączymy zasoby /parcel-management służące do zarządzania przesyłkami w ramach Wysyłam z Allegro / In the fourth quarter of 2024, we will remove the /parcel-management resources used to manage shipments as part of Ship with Allegro

[Lukasz-Zurek]

W czwartym kwartale 2024 roku całkowicie usuniemy zasoby na ścieżce /parcel-management, służące do zarządzania przesyłkami w ramach Wysyłam z Allegro.

We wrześniu 2023 roku, z uwagi na potrzebę optymalizacji procesu zarządzania przesyłkami oraz konieczność dostosowania się do systemu w oparciu, o który funkcjonują nasi operatorzy logistyczni, udostępniliśmy nowe zasoby na ścieżce /shipment-management, za pomocą których m.in.:

• utworzysz nową paczkę,
• zamówisz odbiór paczek przez kuriera,
• utworzysz etykietę.

Zasoby /shipment-management będą jedynymi, które umożliwią zarządzanie przesyłkami w ramach usługi Wysyłam z Allegro. Zadbaj o to, aby przed całkowitym wyłączeniem zasobów /parcel-management Twoje oprogramowanie korzystało z odpowiedników tych zasobów na ścieżce  /shipment-management:

Opis endpointu	Endpoint, który usuniemy	Odpowiednik endpointu
Pobierz listę dostępnych usług dostawy	GET /parcel-management/delivery-services	GET /shipment-management/delivery-services
Utwórz nową paczkę	PUT /parcel-management/parcel-create-commands/{commandId}	POST /shipment-management/shipments/create-commands
Sprawdź status utworzenia paczki	GET /parcel-management/parcel-create-commands/{commandId}	GET /shipment-management/shipments/create-commands/{commandId}
Anuluj paczkę	PUT /parcel-management/parcel-cancel-commands/{commandId}	POST /shipment-management/shipments/cancel-commands
Sprawdź status anulowania paczki	GET /parcel-management/parcel-cancel-commands/{commandId}	GET /shipment-management/shipments/cancel-commands/{commandId}
Pobierz szczegółowe dane paczki	GET /parcel-management/parcels/{parcelId}	GET /shipment-management/shipments/{shipmentId}
Utwórz etykietę	GET /parcel-management/parcels/label	POST /shipment-management/label
Pobierz protokół nadania	GET /parcel-management/parcels/protocol	POST /shipment-management/protocol
Pobierz propozycje daty odbioru paczek przez kuriera	GET /parcel-management/pickup-date-proposals	POST /shipment-management/pickup-proposals
Zamów odbiór paczek przez kuriera	PUT /parcel-management/parcel-pickup-request-commands/{commandId}	POST /shipment-management/pickups/create-commands
Sprawdź status zamówienia odbioru paczek	GET /parcel-management/parcel-pickup-request-commands/{commandId}	GET /shipment-management/pickups/create-commands/{commandId}

Więcej informacji o zasobach /shipment-management znajdziesz w naszym poradniku.

---

In the fourth quarter of 2024, we will completely remove the resources on the /parcel-management path used to manage shipments within Ship with Allegro.

In September 2023, to optimize the shipment management process and to adapt to the system based on which our logistics operators operate, we introduced new resources on the /shipment-management path, through which you will, among others:

• create a new shipment,
• request shipments pickup,
• create a label.

The /shipment-management resources will be the only ones that will enable you to manage shipments as part of the Ship with Allegro. Before completely removing /parcel-management resources, ensure that your software uses the equivalent of these resources in the /shipment-management path:

Endpoint description	Endpoint that we will remove	Endpoint equivalent
Get available delivery services	GET /parcel-management/delivery-services	GET /shipment-management/delivery-services
Create new shipment	PUT /parcel-management/parcel-create-commands/{commandId}	POST /shipment-management/shipments/create-commands
Get shipment creation command status	GET /parcel-management/parcel-create-commands/{commandId}	GET /shipment-management/shipments/create-commands/{commandId}
Cancel shipment	PUT /parcel-management/parcel-cancel-commands/{commandId}	POST /shipment-management/shipments/cancel-commands
Get shipment cancellation status	GET /parcel-management/parcel-cancel-commands/{commandId}	GET /shipment-management/shipments/cancel-commands/{commandId}
Get shipment details	GET /parcel-management/parcels/{parcelId}	GET /shipment-management/shipments/{shipmentId}
Get shipments labels	GET /parcel-management/parcels/label	POST /shipment-management/label
Get shipments protocol	GET /parcel-management/parcels/protocol	POST /shipment-management/protocol
Get shipments pickup proposals	GET /parcel-management/pickup-date-proposals	POST /shipment-management/pickup-proposals
Request shipments pickup	PUT /parcel-management/parcel-pickup-request-commands/{commandId}	POST /shipment-management/pickups/create-commands
Create pickup command status	GET /parcel-management/parcel-pickup-request-commands/{commandId}	GET /shipment-management/pickups/create-commands/{commandId}

You will find more information about /shipment-management resources in our tutorial.

[mkawczynski]

Korzystam z zasobu parcel-management. Dla testów próbowałem wywołać GET /shipment-management/delivery-services zamiast GET /parcel-management/delivery-services

Otrzymuję w zwrocie: code: "AccessDenied", message: "Access is denied" userMessage: "No access to the specified resource."

Czy muszę uzyskać jakieś dodatkowe uprawnienia?

[Lukasz-Zurek]

@mkawczynski Musisz edytować uprawnienia aplikacji na tej stronie. Konieczna będzie jednak ponowna autoryzacja, z nowymi uprawnieniami.

We wspomnianym newsie z września 2023, rozpisałem uprawnienia wymagane dla nowych zasobów na ścieżce /shipment-management. W przypadku GET /shipment-management/delivery-services wymagamy allegro:api:shipments:write.