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 摘要。