[NEWS] Udostępniliśmy nowe zasoby do tworzenia i zarządzania przesyłkami w ramach Wysyłam z Allegro / We have introduced new resources for creating and managing shipments with Ship with 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](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) - pobierz listę dostępnych usług dostawy,
- [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) - utwórz nową paczkę,
- [GET /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/getShipmentCreationStatus) - sprawdź status utworzenia paczki,
- [POST /shipment-management/shipments/cancel-commands](https://developer.allegro.pl/documentation/#operation/cancelShipment) - anuluj paczkę,
- [GET /shipment-management/shipments/cancel-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getShipmentCancellationStatus) - sprawdź status anulowania paczki,
- [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails) - pobierz szczegółowe dane paczki,
- [POST /shipment-management/label](https://developer.allegro.pl/documentation/#operation/getShipmentLabels) - utwórz etykietę,
- [POST /shipment-management/protocol](https://developer.allegro.pl/documentation/#operation/getShipmentProtocol) - pobierz protokół nadania,
- [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation/#operation/getPickupProposals) - pobierz propozycje daty odbioru paczek przez kuriera,
- [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup) - zamów odbiór paczek przez kuriera
- [GET /shipment-management/pickups/create-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/createPickupStatus) - 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](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) | [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails)
[POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) | [POST /shipment-management/label](https://developer.allegro.pl/documentation/#operation/getShipmentLabels)
[GET /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/getShipmentCreationStatus) | [POST /shipment-management/protocol](https://developer.allegro.pl/documentation/#operation/getShipmentProtocol)
[POST /shipment-management/shipments/cancel-commands](https://developer.allegro.pl/documentation/#operation/cancelShipment) |  
[GET /shipment-management/shipments/cancel-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getShipmentCancellationStatus) |  
[POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation/#operation/getPickupProposals) |  
[POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup) |  
[GET /shipment-management/pickups/create-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/createPickupStatus)

**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](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY).

----------

We have introduced new **/shipment-management** resources, thanks to which you can create and manage shipments via Ship with Allegro.

**What functionalities have we implemented?**

- [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) - get available delivery services,
- [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) - create new shipment,
- [GET /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/getShipmentCreationStatus) - get shipment creation command status,
- [POST /shipment-management/shipments/cancel-commands](https://developer.allegro.pl/documentation/#operation/cancelShipment) - cancel shipment,
- [GET /shipment-management/shipments/cancel-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getShipmentCancellationStatus) - get shipment cancellation status,
- [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails) - get shipment details,
- [POST /shipment-management/label](https://developer.allegro.pl/documentation/#operation/getShipmentLabels) - get shipments labels,
- [POST /shipment-management/protocol](https://developer.allegro.pl/documentation/#operation/getShipmentProtocol) - get shipments protocol,
- [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation/#operation/getPickupProposals) - get shipments pickup proposals,
- [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup) - request shipments pickup,
- [GET /shipment-management/pickups/create-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/createPickupStatus) - create pickup command status.

**What permissions do we require to use new resources?**

The new resources will function based on new permissions (scopes) for shipments managing:

allegro:api:shipments:write | allegro:api:shipments:read
-- | --
[GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) | [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails)
[POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) | [POST /shipment-management/label](https://developer.allegro.pl/documentation/#operation/getShipmentLabels)
[GET /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/getShipmentCreationStatus) | [POST /shipment-management/protocol](https://developer.allegro.pl/documentation/#operation/getShipmentProtocol)
[POST /shipment-management/shipments/cancel-commands](https://developer.allegro.pl/documentation/#operation/cancelShipment) |  
[GET /shipment-management/shipments/cancel-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/getShipmentCancellationStatus) |  
[POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation/#operation/getPickupProposals) |  
[POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup) |  
[GET /shipment-management/pickups/create-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/createPickupStatus)

**What about current shipment management resources?**

We plan to remove the current resources from the **/parcel-management** in the future, therefore:

- on **September 21, 2023**, we marked them as **Deprecated** and ended their further support and development,
- **in the fourth quarter of 2024** we will **remove** them completely.

**Why do we decide to make the above changes?**

We want to optimize the shipment management process and adapt to the system in which our logistics operators work.

More information about the new process of creating and managing packages can be found in [our guide](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY).