allegro / allegro/allegro-api

[NEWS] Wysyłam z Allegro - udostępniliśmy możliwość zamawiania przesyłek InPost z użyciem metod nadania / Ship with Allegro - we have introduced the option of creating InPost shipments using dedicated sending methods

未關閉
#9,915 0 則留言 0 個 reaction 已指派 1 人 已被 @Lukasz-Zurek 認領 在 GitHub 檢視
News Orders - shipment management
主要語言
沒有語言資料
星號
244
分支
40
PR 合併指標
30 天內沒有已合併 PR

描述

**Na początku kwietnia** [udostępniliśmy](https://developer.allegro.pl/news/udostepnilismy-nowe-pole-additionalproperties-ktore-umozliwi-realizacje-stalych-podjazdow-i-zwrotow-dla-przesylek-packeta-1nPxORDMwiL) nowe pole **“additionalProperties”** służące m.in. do realizacji stałych podjazdów i zwrotów dla przesyłek Packeta. Informowaliśmy wtedy, że w przyszłości dla [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) planujemy zwracać dane dla kolejnych metod dostawy. Tym sposobem od dzisiaj umożliwiliśmy realizację przesyłek InPost z użyciem metod nadania.

**Jak to działa obecnie?**

W przypadku, gdy tworzysz nową przesyłkę InPost za pomocą [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) automatycznie ustawiamy metody nadania dla każdej z metod dostawy InPost, na podstawie wewnętrznie skonfigurowanych warunków.

Od dzisiaj ustawienie metod nadania dla przesyłek InPost będzie w pełni zależne od sprzedającego.

**Co zmieniliśmy?**

W odpowiedzi dla [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices), w polu **“additionalProperties”**, dla metod dostawy z **“carrierId”: “INPOST”**, zwrócimy klucz **inpost#sendingMethod**, który oznacza możliwość przekazania metody nadania.

Podczas tworzenia nowej przesyłki za pomocą [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment), przekaż dla wybranej metody dostawy z **“carrierId”: “INPOST”** jedną z obsługiwanych wartości metody nadania:

- **parcel_locker** - nadaj w paczkomacie InPost,
- **dispatch_order** - zleć odbiór/zamów kuriera,
- **pop** - nadaj w Punkcie Obsługi Przesyłek,
- **any_point** - nadaj w dowolnym automacie Paczkomacie lub PaczkoPunkcie InPost.

**Przykładowy fragment requestu:**

```
curl -X POST \
'https://api.allegro.pl/shipment-management/shipments/create-commands' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
-H 'Content-type: application/vnd.allegro.public.v1+json'

"additionalProperties": {
"inpost#sendingMethod": "parcel_locker"
},

```

**Ważne!** Obecnie nie musisz przekazywać powyższych danych podczas nadawania przesyłki InPost. W przyszłości wskazanie metody nadania będzie **obowiązkowe**. Poinformujemy o tym fakcie z odpowiednim wyprzedzeniem.

**Dlaczego wprowadziliśmy zmianę?**

Oprócz potrzeby wynikającej z optymalizacji procesu zarządzania przesyłkami i konieczności dostosowania się do systemu InPostu, chcemy aby sprzedający byli bardziej świadomi tego, jaki sposób nadania wybierają dla każdej z metod dostawy InPost.

---------

**At the beginning of April**, we [introduced](https://developer.allegro.pl/news/we-have-introduced-a-new-additionalproperties-field-that-will-enable-permanent-pick-ups-and-returns-for-packeta-shipments-MRwXLqM27UL) a new field **“additionalProperties”** used, among other things, to implement regular pick-ups and returns for Packeta shipments. At that time, we informed that in the future, for [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices), we plan to return data for additional delivery methods. This way, from today, you can create InPost shipments using sending methods.

**How does it work currently?**

When you create a new InPost shipment using [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment), we automatically set sending methods for each InPost delivery method, based on internally configured conditions.

Starting today, setting sending methods for InPost shipments will be entirely up to the seller.

**What have we changed?**

In response to [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices), in the **“additionalProperties”** field, for delivery methods with **“carrierId”: “INPOST”**, we will return the conditions within the so-called **inpost#sendingMethod** which means the possibility of providing the sending method.

When creating a new shipment using [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) for selected shipping method with **“carrierId”: “INPOST”**, pass one of the supported values of the sending method:

- **parcel_locker** - send it to an InPost parcel locker,
- **dispatch_order** - arrange a pickup/order a courier,
- **pop** - send it at the Parcel Service Point,
- **any_point** - send it at any Parcel Locker or InPost Parcel Point.

**Sample request fragment:**

```
curl -X POST \
'https://api.allegro.pl/shipment-management/shipments/create-commands' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
-H 'Content-type: application/vnd.allegro.public.v1+json'

"additionalProperties": {
"inpost#sendingMethod": "parcel_locker"
},

```

**Note!** Currently, you do not have to provide the above data when sending an InPost shipment. In the future, indicating the method of sending will be **required**. We will inform you about this fact in due time.

**Why did we make this change?**

In addition to optimizing the shipment management process and adapting to the InPost system, we want sellers to be more aware of the shipping method they choose for each of the InPost delivery methods.

貢獻指南

這個儲存庫沒有索引到貢獻指南

評估

這個 Issue 還沒有評估資料。

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。