[NEWS] Udostępniliśmy nowe pole “additionalProperties”, które umożliwi realizację stałych podjazdów i zwrotów dla przesyłek Packeta / We have introduced a new "additionalProperties" field that will enable permanent pick-ups and returns for Packeta shipments

Od startu serwisu [allegro.cz](http://allegro.cz/) i uruchomienia [allegro.sk](http://allegro.sk/), sprzedający mogą korzystać z możliwości [Packeta](https://allegro.pl/pomoc/dla-kupujacych/metody-dostawy/dostawa-z-polski-do-czech-do-automatow-paczkowych-i-punktow-odbioru-packeta-E7376gkyMuB) - metody dostawy z Polski do Czech oraz z Polski na Słowację.

W przypadku użytkowników dysponujących własnymi magazynami w Czechach, system Packeta nie jest jednak w stanie umożliwić stałych podjazdów oraz obsłużyć nieodebranych przesyłek do wyżej wymienionych magazynów. Dlatego chcemy zoptymalizować ten proces w API.

**Co zmieniliśmy?**

1. W odpowiedzi dla [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) udostępniliśmy dzisiaj tablicę **“additionalProperties”**, gdzie dla metod dostawy z **“carrierId”: “PACKETA”**, zwrócimy dane użytkownika z systemu Packeta, które wymagane są do stałych podjazdów kuriera oraz obsługi zwrotów:

- **packeta#eshopId** - identyfikator magazynu nadawcy,
- **packeta#apiKey** - klucz API w systemie Packeta.

**Przykładowy response:**

```
…
{
"id": {
"deliveryMethodId": "1550a685-d5d3-46a4-8736-b816ca710d3d",
"credentialsId": null
},
"name": "Allegro Odbiór w Punkcie Packeta pobranie",
"carrierId": "PACKETA",
"additionalServices": [
{
"id": "additionalHandling",
"name": "Paczka niestandardowa",
"description": "Paczka o kształcie, który nie jest prostopadłościanem
(np. opona, tuba) lub taka, która jest owinięta stretchem,
folią lub innym materiałem utrudniającym przesuwanie."
}
],
"additionalProperties": [
{
“id”: "packeta#eshopId", - identyfikator magazynu nadawcy
"name": "Nadawca", - nazwa
"description": "Pole 'Nadawca' w systemie Packeta. Wymagane, gdy podano packeta#apiKey.
Tylko dla sprzedawców posiadających stałe podjazdy Packeta, więcej informacji:
https://allegro.cz/pro-prodejce/allegro-zasilkovna-informace-pro-
prodejce-E73GE8Mq0ul", - opis
"required": false, - czy dane są wymagane
"readOnly": false - informacja o tym, czy powyższe dane są tylko do odczytu;
true - dane są tylko do odczytu i zwrócimy je tylko w szczegółowych danych paczki;
false - zwracane dane użytkownik może użyć podczas tworzenia paczki
},
{
"id": "packeta#apiKey", - klucz API w systemie Packeta
"name": "Klucz API",
"description": "Pole 'Klucz API' w systemie Packeta. Wymagane, gdy podano packeta#eshopId.
Tylko dla sprzedawców posiadających stałe podjazdy Packeta, więcej informacji:
https://allegro.cz/pro-prodejce/allegro-zasilkovna-informace-
pro-prodejce-E73GE8Mq0ul”,
"required": false,
"readOnly": false
}
],
…

```
Informacje te zwrócimy **wyłącznie dla czeskich sprzedających zintegrowanych z systemem Packeta, którzy wysyłają swoje towary na terenie Czech lub na Słowację.**

Więcej informacji na temat konfiguracji konta w systemie Packeta udostępniliśmy w języku czeskim, na stronie “Pro prodejce” (“Dla sprzedających”), pod [tym adresem](https://help.allegro.com/sell/cs/a/allegro-zasilkovna-informace-pro-prodejce-m0PkVVwdOsq).

Jeżeli wartość w **“readOnly”** to:

- **true** - oznacza to, że są to dane tylko do odczytu. Zwrócimy je tylko w szczegółowych danych utworzonej paczki, gdy skorzystasz z [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails). Nie przekazuj tych danych podczas tworzenia nowej paczki,
- **false** - oznacza to, że możesz wykorzystać te dane podczas tworzenia nowej paczki, za pomocą [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment).

2. Na zasobie do tworzenia paczek [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment) udostępniliśmy pole **“additionalProperties”**, w którym dla wybranej metody dostawy z **“carrierId”: “PACKETA”** przekażesz dane uzyskane za pomocą [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices).

**Przykładowy request:**

```
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": {
"packeta#eshopId": "",
"packeta#apiKey": ""
},
…
```

W przyszłości dla [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) planujemy zwracać dane również dla innych metod dostawy. Natomiast dla tych metod, które nie wspierają **“additionalProperties”** - zwrócimy pustą tablicę.

Więcej informacji na temat dostawy zagranicznej Packeta, znajdziesz w [Pomocy Allegro](https://allegro.pl/pomoc/dla-kupujacych/metody-dostawy/dostawa-z-polski-do-czech-do-automatow-paczkowych-i-punktow-odbioru-packeta-E7376gkyMuB).

-------

Since the launch of the [allegro.cz](http://allegro.cz/) website and the launch of [allegro.sk](http://allegro.sk/), sellers can use [Packeta](https://allegro.pl/pomoc/dla-kupujacych/metody-dostawy/dostawa-z-polski-do-czech-do-automatow-paczkowych-i-punktow-odbioru-packeta-E7376gkyMuB) - a delivery method from Poland to the Czech Republic and from Poland to Slovakia.

In the case of users who have their own warehouses in the Czech Republic, the Packeta system is not able to enable permanent pick-ups and handle uncollected shipments to the above-mentioned warehouses. That's why we want to optimize this process in the API.

**What have we changed?**

1. Today, in the response to [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices), we have introduced the **"additionalProperties"** table, where for delivery methods with **"carrierId": "PACKETA"**, we will return user data from the Packeta system, which is required for permanent courier pick-ups and returns:

- **packeta#eshopId** - sender's warehouse ID,
- **packeta#apiKey** - API key in the Packeta system.

**Sample response:**

```
…
"additionalProperties":[
{
"id":"packeta#eshopId", - sender's warehouse ID
"name":"Eshop", - sender's warehouse name
"description":"Sender's 'Indication' field in Packeta system. Required when packeta#apiKey
was provided. Only for merchants with Packeta scheduled pickups, more info:
https://allegro.cz/pro-prodejce/allegro-zasilkovna-informace-
pro-prodejce-E73GE8Mq0ul", - description
"readOnly":false, - information whether the above data is read-only;
true - the data is read-only and we will return it only in the detailed package data;
false - the returned data can be used by the user when creating a package
"required":false - whether the data is required
},
{
"id":"packeta#apiKey",
"name":"API Key",
"description":"'API key' field in Packeta system. Required when packeta#eshopId
was provided. Only for merchants with Packeta scheduled pickups, more info:
https://allegro.cz/pro-prodejce/allegro-zasilkovna-informace-pro-prodejce-E73GE8Mq0ul",
"readOnly":false,
"required":false
}
],
…
```

We will provide this information **only to sellers integrated with the Packeta system who send their goods to the Czech Republic or Slovakia.**

More information about setting up an account in the Packeta system will be available in Czech language on the “Pro prodejce” (“For sellers”) website at [this address](https://help.allegro.com/sell/cs/a/allegro-zasilkovna-informace-pro-prodejce-m0PkVVwdOsq).

If **"readOnly"** is:

- **true** - this means that the data is read-only. We will only return them in the details of the created package when you use [GET /shipment-management/shipments/{shipmentId}](https://developer.allegro.pl/documentation/#operation/getShipmentDetails). Do not provide this data when creating a new package,
- **false** - this means that you can use this data when creating a new package using [POST /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment).

2. On the resource for creating [POST packages /shipment-management/shipments/create-commands](https://developer.allegro.pl/documentation/#operation/createNewShipment), today we have introduced the **"additionalProperties"** field in which for the selected delivery method from **"carrierId": "PACKETA"** you will provide the data obtained using [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices).

**Sample request:**

```
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": {
"packeta#eshopId": "",
"packeta#apiKey": ""
},
…
```

In the future, we plan to return data for other delivery methods for [GET /shipment-management/delivery-services](https://developer.allegro.pl/documentation/#operation/getDeliveryServices) as well. However, for those methods that do not support **"additionalProperties"** - we will return an empty array.

You can find more information about Packeta international delivery in [Allegro Help](https://allegro.pl/pomoc/dla-kupujacych/metody-dostawy/dostawa-z-polski-do-czech-do-automatow-paczkowych-i-punktow-odbioru-packeta-E7376gkyMuB).