11 marca 2026
Wysyłam z Allegro - wprowadziliśmy zmiany na zasobach do zarządzania wysyłką przesyłek i ich odbiorem przez kuriera
W ramach zarządzania zasobami Wysyłam z Allegro 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?
Dla POST /shipment-management/pickup-proposals, 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":[ // tablica oznaczona jako deprecated
{
"id":"2023071210001300", // deprecated
"name":"2023-07-12 10:00-13:00", // deprecated
"description":"Odbiór A" // deprecated
}
],
"pickupTimes":[ // proponowane terminy odbioru przez kuriera
{
"date":"2026-01-17", // proponowana data odbioru przez kuriera
"minTime":"08:00", // proponowana minimalna godzina odbioru przez kuriera
"maxTime":"12:00" // proponowana maksymalna godzina odbioru przez kuriera
}
]
}
],
"address":{
"..."
}
}
]Dla POST /shipment-management/pickups/create-commands, 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":{
}
}
}Dla GET /shipment-management/shipments/{shipmentId}, 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),
- "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"
}
]
}
],
]
...Co musisz zrobić?
Do końca czerwca 2026 dostosuj aplikację, aby na zasobach:
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.
