21 września 2023
Udostępniliśmy nowe zasoby do tworzenia i zarządzania przesyłkami w ramach Wysyłam z Allegro
Udostępniliśmy dzisiaj nowe zasoby /shipment-management, dzięki którym możesz utworzyć i zarządzać przesyłkami przez Wysyłam z Allegro.
Jakie funkcjonalności wdrożyliśmy?
- GET /shipment-management/delivery-services - pobierz listę dostępnych usług dostawy,
- POST /shipment-management/shipments/create-commands - utwórz nową paczkę,
- GET /shipment-management/shipments/create-commands - sprawdź status utworzenia paczki,
- POST /shipment-management/shipments/cancel-commands - anuluj paczkę,
- GET /shipment-management/shipments/cancel-commands/{commandId} - sprawdź status anulowania paczki,
- GET /shipment-management/shipments/{shipmentId} - pobierz szczegółowe dane paczki,
- POST /shipment-management/label - utwórz etykietę,
- POST /shipment-management/protocol - pobierz protokół nadania,
- POST /shipment-management/pickup-proposals - pobierz propozycje daty odbioru paczek przez kuriera,
- POST /shipment-management/pickups/create-commands - zamów odbiór paczek przez kuriera
- GET /shipment-management/pickups/create-commands/{commandId} - sprawdź status zamówienia odbioru paczek.
Jakich uprawnień wymagamy do korzystania z nowych zasobów?
Nowe zasoby funkcjonować będą w oparciu o nowe uprawnienia (scope’y) do zarządzania przesyłkami:
allegro:api:shipments:write | allegro:api:shipments:read |
---|---|
GET /shipment-management/delivery-services | allegro:api:shipments:read |
POST /shipment-management/shipments/create-commands | allegro:api:shipments:read |
GET /shipment-management/shipments/create-commands | allegro:api:shipments:read |
POST /shipment-management/shipments/cancel-commands | allegro:api:shipments:read |
GET /shipment-management/shipments/cancel-commands/{commandId} | allegro:api:shipments:read |
POST /shipment-management/pickup-proposals | allegro:api:shipments:read |
POST /shipment-management/pickups/create-commands | allegro:api:shipments:read |
GET /shipment-management/pickups/create-commands/{commandId} |
Co z obecnymi zasobami do zarządzania przesyłkami?
Obecne zasoby ze ścieżki /parcel-management planujemy w przyszłości usunąć, dlatego:
- 21.09.2023 roku oznaczyliśmy je jako Deprecated i zakończyliśmy ich dalsze wsparcie i rozwój,
- w czwartym kwartale 2024 roku całkowicie je usuniemy.
Dlaczego decydujemy się na powyższe zmiany?
Zależy nam na optymalizacji procesu zarządzania przesyłkami oraz dostosowaniu się do systemu, w oparciu o który funkcjonują nasi operatorzy logistyczni.
Więcej informacji na temat nowego procesu tworzenia paczek i ich zarządzania znajdziesz w naszym poradniku.