[NEWS] Wysyłam z Allegro - wprowadzamy zmiany w obsłudze pola “pickup” / Ship with Allegro - we are introducing changes to the handling of the “pickup” field

Jednym z etapów zarządzania przesyłkami w ramach Wysyłam z Allegro jest zamówienie ich odbioru przez kuriera. Za miejsce przekazania paczek odpowiada pole “pickup”.

**Jak dotychczas wyglądała obsługa pola “pickup”?**

Podczas tworzenia przesyłki za pomocą [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation#operation/createNewShipment) miejsce odbioru przesyłek należało ustawić w opcjonalnym polu **“pickup”**. Jeśli nie przekazano żadnych informacji, jako miejsce przekazania paczek uznawaliśmy dane nadawcy z pola **“sender”**.
Tych danych, po utworzeniu przesyłki, nie można było już edytować.

**Jakie zmiany wprowadzamy?**

Pole **“pickup”** w [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation#operation/createNewShipment) oznaczyliśmy jako *deprecated* i w przyszłości całkowicie je **usuniemy**.

Dodaliśmy również opcjonalne pola **“address”**, gdzie możesz wskazać adres odbioru przesyłek, w:
- [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.

Pola **w przyszłości oznaczymy jako wymagane**.

Jeśli aktualnie przekażesz inne miejsce odbioru w polu “pickup” podczas tworzenia przesyłki, a inne w jednym z dwóch powyższych zasobów, to pod uwagę weźmiemy lokalizację z pola “address”.

O dacie wprowadzenia niekompatybilnych zmian poinformujemy z odpowiednim wyprzedzeniem w osobnym komunikacie.

**Dlaczego wprowadzamy zmiany?**

Chcemy rozdzielić proces tworzenia przesyłki od miejsca odbioru przesyłek przez kuriera i tym samym umożliwić dowolność w zakresie edycji adresu przekazania paczek do wysyłki.

-----

One of the steps in managing shipments within Ship with Allegro is ordering the courier to pick them up. The “pickup” field is responsible for the location where the parcels are handed over.

**How was the “pickup” field handled until now?**

When creating a shipment using [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation#operation/createNewShipment), the parcel pickup location can be set in the optional **“pickup”** field. If no information was provided, we considered the sender's data from the **“sender”** field as the pickup location. This data could no longer be edited after the shipment was created.

**What changes are we introducing?**

We have marked the **“pickup”** field in [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation#operation/createNewShipment) as **deprecated** and will completely remove it in the future.

We have also added the optional **“address”** fields, where you can specify the parcel pickup address, in:
- [POST /shipment-management/pickup-proposals](https://developer.allegro.pl/documentation#operation/getPickupProposals) - retrieve shipments pickup proposals,
- [POST /shipment-management/pickups/create-commands](https://developer.allegro.pl/documentation#operation/createPickup) - request shipments pickup.

These **fields will be marked as required in the future**.

If you currently provide a different pickup location in the “pickup” field when creating a shipment and a different one in one of the two resources above, then we will take into account the location from the “address” field.

We will inform you about the date of introducing incompatible changes in due time in a separate announcement.

**Why are we introducing these changes?**

We want to separate the shipment creation process from the courier pickup location, thereby enabling full flexibility in editing the address for handing over parcels for shipment.