[NEWS] Wysyłam z Allegro - wprowadziliśmy zmiany na zasobach do zarządzania wysyłką przesyłek i ich odbiorem przez kuriera / Ship with Allegro - we have introduced changes to the resources for managing shipping and courier pickup

W ramach zarządzania zasobami [Wysyłam z Allegro](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY) nadasz przesyłkę, pobierzesz propozycje dotyczące odbioru przesyłek oraz zamówisz odbiór przesyłek przez kuriera. Wkrótce wprowadzimy zmiany w tych procesach.

**Co zmieniliśmy?**

1. Dla [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getPickupProposals), w odpowiedzi:

* oznaczyliśmy tablicę **"proposalItems"** jako **deprecated** i **do końca czerwca 2026 ją usuniemy**,

* zastąpiliśmy ją nową tablicą **"pickupTimes"** - proponowane terminy odbioru przesyłki przez kuriera, gdzie zwracamy pola:

* **"date"** - proponowana data odbioru przez kuriera,

* **"minTime"** - proponowana minimalna godzina odbioru,

* **"maxTime"** - proponowana maksymalna godzina odbioru,

**Przykładowy response:**

```
[
{
"proposals":[
{
"shipmentId":"ba88f0fb-acf3-438a-877e-580da50c0874",
"proposalItems":[ // array marked as deprecated
{
"id":"2023071210001300", // deprecated
"name":"2023-07-12 10:00-13:00", // deprecated
"description":"Odbiór A" // deprecated
}
],
"pickupTimes":[ // courier pickup time proposals
{
"date":"2026-01-17", // courier pickup date proposal
"minTime":"08:00", // courier pickup minimum time proposal
"maxTime":"12:00" // courier pickup maximum time proposal
}
]
}
],
"address":{
"..."
}
}
]
```

2. Dla [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup), zarówno w żądaniu, jak i odpowiedzi:

* oznaczyliśmy pole **"pickupDateProposalId”** jako **deprecated** i **do końca czerwca 2026 je usuniemy**,

* zastąpiliśmy je nowym obiektem **"pickupTime"** - termin odbioru przesyłki przez kuriera, gdzie zwracamy pola:

* **"date"** - data odbioru przez kuriera,

* **"minTime"** - minimalna godzina odbioru,

* **"maxTime"** - maksymalna godzina odbioru.

**Przykładowy request:**

```
curl -X POST \
'https://api.allegro.pl/shipment-management/pickups/create-commands' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d {
"commandId":"14e142cf-e8e0-48cc-bcf6-399b5fd90b32",
"input":{
"shipmentIds":[
"ba88f0fb-acf3-438a-877e-580da50c0874"
],
"pickupDateProposalId":"2023071210001300", // pole oznaczone jako deprecated
"pickupTime":{ // czas odbioru przez kuriera
"date":"2026-01-17", // termin odbioru przez kuriera
"minTime":"08:00", // minimalna godzina odbioru przez kuriera
"maxTime":"12:00" // maksymalna godzina odbioru przez kuriera
},
"address":{

}
}
}
```

**Przykładowy response:**

```
{
"commandId":"14e142cf-e8e0-48cc-bcf6-399b5fd90b32",
"input":{
"shipmentIds":[
"ba88f0fb-acf3-438a-877e-580da50c0874"
],
"pickupDateProposalId":"2023071210001300", // pole oznaczone jako deprecated
"pickupTime":{ // czas odbioru przez kuriera
"date":"2026-01-17", // termin odbioru przez kuriera
"minTime":"08:00", // minimalna godzina odbioru przez kuriera
"maxTime":"12:00" // maksymalna godzina odbioru przez kuriera
},
"address":{

}
}
}
```

3. Dla [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails), w odpowiedzi zwracamy nową tablicę **"packages.transportingInfo"**, w której znajdziesz:

* **"carrierId"** - ID przewoźnika (dostępne wartości sprawdzisz w odpowiedzi dla [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices)),

* **"carrierWaybill"** - numer listu przewozowego.

**Przykładowy fragment response:**

```
...
"packages":[
...
"transportingInfo":[ // informacje o przewoźnikach
{
"carrierId":"INPOST", // ID przewoźnika
"carrierWaybill":"123123" // numer listu przewozowego
},
{
"carrierId":"ALLEGRO",
"carrierWaybill":"456456"
}
]
}
],
]
...
```

**Ważne!** Dla każdej z utworzonych przesyłek, w tablicy **"packages.transportingInfo"** zwrócimy co najmniej jednego przewoźnika. Może się zdarzyć, że na tym etapie nie zwrócimy jeszcze numeru listu przewozowego i w takiej sytuacji znajdziesz tam pusty string w polu **“carrierWaybill”**.

**Co musisz zrobić?**

**Do końca czerwca 2026** dostosuj aplikację, aby na zasobach:

* [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getPickupProposals),

* [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup),

korzystać już z nowych pól. **1 lipca 2026** **usuniemy** pola, które dziś oznaczyliśmy jako **deprecated**.

Więcej informacji na temat zarządzania odbiorem paczek przez kuriera znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY#jak-sprawdzic-proponowana-date-odbioru-paczek-przez-kuriera).

--------

As part of managing [Ship with Allegro](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY) resources, you can create a shipment, retrieve proposals for shipment collection, and order a courier pickup. We will soon introduce changes to these processes.

**What have we changed?**

1. For [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getPickupProposals), in the response:

* we marked the **"proposalItems"** array as **deprecated** and **we will remove it by the end of June 2026**,

* we replaced it with a new array **"pickupTimes"** - proposed courier parcel pickup times, where we return the following fields:

* **"date"** - proposed courier pickup date,

* **"minTime"** - proposed minimum pickup hour,

* **"maxTime"** - proposed maximum pickup hour,

**Sample response:**

```
[
{
"proposals":[
{
"shipmentId":"ba88f0fb-acf3-438a-877e-580da50c0874",
"proposalItems":[ // array marked as deprecated
{
"id":"2023071210001300", // deprecated
"name":"2023-07-12 10:00-13:00", // deprecated
"description":"Odbiór A" // deprecated
}
],
"pickupTimes":[ // courier pickup time proposals
{
"date":"2026-01-17", // courier pickup date proposal
"minTime":"08:00", // courier pickup minimum time proposal
"maxTime":"12:00" // courier pickup maximum time proposal
}
]
}
],
"address":{
"..."
}
}
]
```

2. For [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup), both in the request and the response:

* we marked the field **"pickupDateProposalId”** as **deprecated** and **we will remove it by the end of June 2026**,

* we replaced it with a new object **"pickupTime"** - courier parcel pickup time, where we return the following fields:

* **"date"** - courier pickup date,

* **"minTime"** - minimum pickup hour,

* **"maxTime"** - maximum pickup hour,

**Sample request:**

```
curl -X POST \
'https://api.allegro.pl/shipment-management/pickups/create-commands' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d {
"commandId":"14e142cf-e8e0-48cc-bcf6-399b5fd90b32",
"input":{
"shipmentIds":[
"ba88f0fb-acf3-438a-877e-580da50c0874"
],
"pickupDateProposalId":"2023071210001300", // field marked as deprecated
"pickupTime":{ // courier pickup time
"date":"2026-01-17", // courier pickup date
"minTime":"08:00", // minimum courier pickup time
"maxTime":"12:00" // maximum courier pickup time
},
"address":{

}
}
}
```

**Sample response:**

```
{
"commandId":"14e142cf-e8e0-48cc-bcf6-399b5fd90b32",
"input":{
"shipmentIds":[
"ba88f0fb-acf3-438a-877e-580da50c0874"
],
"pickupDateProposalId":"2023071210001300", // field marked as deprecated
"pickupTime":{ // courier pickup time
"date":"2026-01-17", // courier pickup date
"minTime":"08:00", // minimum courier pickup time
"maxTime":"12:00" // maximum courier pickup time
},
"address":{

}
}
}
```

3. For [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails), in the response, we return a new array **"packages.transportingInfo"**, in which you will find:

* **"carrierId"** - carrier ID (you can check the available values in the response for [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices)),

* **"carrierWaybill"** - waybill number.

**Sample response fragment:**

```
...
"packages":[
...
"transportingInfo":[ // // information about carriers
{
"carrierId":"INPOST", // carrier ID
"carrierWaybill":"123123" // carrier waybill number
},
{
"carrierId":"ALLEGRO",
"carrierWaybill":"456456"
}
]
}
],
...
```

For each created shipment, we will return at least one carrier in the **"packages.transportingInfo"** array. It may happen that at this stage we do not yet return the waybill number, and in such a situation, you will find an empty string in the **“carrierWaybill”** field.

**What do you need to do?**

**By the end of June 2026** adjust your application so that for the resources:

* [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getPickupProposals),

* [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation/#operation/createPickup),

you already use the new fields. **On July 1, 2026**, we will remove the fields that we have marked as **deprecated** today.

You can find more information about managing shipment pickup collection by courier in [our guide](/tutorials/how-to-manage-parcels-via-wysylam-z-allegro-LRVjK7K21sY#how-to-check-the-proposed-date-of-parcel-collection-by-courier).