[NEWS] One Fulfillment by Allegro - wdrożymy zmiany w zarządzaniu awizo / One Fulfillment by Allegro - we will implement changes in ASN management

[One Fulfillment by Allegro](https://allegro.pl/kampania/fulfillment) to usługa kompleksowej obsługi logistycznej dla e-commerce. W ramach niej sprzedawcy wysyłają do centrum logistycznego Allegro swoje towary, a my zajmujemy się ich przechowywaniem oraz obsługą zamówień i zapytań posprzedażowych ich klientów.

Aby ułatwić proces awizowania, przygotowujemy zmiany, które wdrożymy **27 marca 2023**.

Jeżeli korzystasz z endpointów:

- [GET /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation#operation/getAdvanceShipNotices),
- [POST /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation#operation/createAdvanceShipNotice),
- [GET /fulfillment/advance-ship-notices/{id}](https://developer.allegro.pl/documentation#operation/getAdvanceShipNotice),
- [PUT /fulfillment/advance-ship-notices/{id}](https://developer.allegro.pl/documentation#operation/updateAdvanceShipNotice),

przygotuj niezbędne zmiany w swoim oprogramowaniu. Zmiany możesz już przetestować na [Sandboxie](https://allegro.pl.allegrosandbox.pl/).

**Jakie zmiany wprowadzimy?**

1. Usuniemy tablice **content** i pozostawiamy jedynie zagnieżdżoną w niej tablice **items**. Dzięki temu sprzedający nie musi deklarować, co znajduje się w kartonach, a jedynie liczbę poszczególnych przedmiotów w całym awizo.
2. Dodamy nowy obiekt **handlingUnit**, w którym sprzedający może zadeklarować:
- **unitType** - rodzaj awizowanej jednostki, gdzie prócz wcześniej dostępnej wartości **BOX** (karton), sprzedający może zadeklarować również **PALLET** (paletę) oraz **CONTAINER** (kontener),
- **amount** - liczba sztuk podanej jednostki (lub ile jednostek znajdzie się w kontenerze),
- **labelsType** - rodzaj etykiety, dostępne wartości to: **ONE_FULFILLMENT** (sprzedający samodzielnie naklei etykiety), **NONE** (brak etykiet na jednostkach, może wiązać się z dodatkowymi opłatami).
3. W polu **shipping.method** dodamy nową wartość **THIRD_PARTY_DELIVERY**, dzięki której sprzedający może zadeklarować dostawę bezpośrednio od producenta.
4. W obiekcie shipping dodamy obiekt **thirdParty**, który musisz uzupełnić dla metody **THIRD_PARTY_DELIVERY** - zawiera pola:
- **name** - nazwa producenta lub dystrybutora,
- **orderNumber** - indywidualny numer zamówienia u producenta.
5. W obiekcie **shipping** dodamy również pole **countryCode** w którym zadeklarujesz, z jakiego kraju nastąpi wysyłka. Przekazanie wartości w polu jest obowiązkowe.

**Przykładowy request:**

```
curl -X POST \
'https://api.allegro.pl/fulfillment/advance-ship-notices \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"items": [
{
"product": {
"id": "a1520fab-7801-4832-9ccd-fb068c707a74"
},
"quantity": 2
},
{
"product": {
"id": "67df7d34-811e-11ed-a1eb-0242ac120002"
},
"quantity": 3
}
],
"handlingUnit": {
"unitType": "BOX",
"amount": 1,
"labelsType": "ONE_FULFILMENT"
},
"shipping": {
"method": "THIRD_PARTY_DELIVERY",
"trackingNumber": null,
"truckLicencePlate": null,
"estimatedTimeOfArrival": "2023-02-16T11:00:00Z",
"thirdParty": {
"name": "Producer name",
"orderNumber" : "O-123"
},
"countryCode": "PL"
}
}'
```
**Przykładowy response:**

```
{
"id": "3f79982b-a978-4ca3-ae38-b552a43b287b",
"displayNumber": "A-230215-0000026",
"status": "DRAFT",
"createdAt": "2023-02-15T07:37:41.766343917Z",
"updatedAt": "2023-02-15T07:37:41.766343917Z",
"items": [
{
"product": {
"id": "a1520fab-7801-4832-9ccd-fb068c707a74"
},
"quantity": 2
},
{
"product": {
"id": "67df7d34-811e-11ed-a1eb-0242ac120002"
},
"quantity": 3
}
],
"labels": {
"fileUrl": "https://api.allegro.pl.allegrosandbox.pl/fulfillment/advance-ship-notices/3f79982b-a978-4ca3-ae38-b552a43b287b/labels"
},
"shipping": {
"estimatedTimeOfArrival": "2023-02-16T11:00:00Z",
"method": "THIRD_PARTY_DELIVERY",
"trackingNumber": null,
"truckLicencePlate": null,
"thirdParty": {
"name": "Producer name",
"orderNumber": "O-123"
},
"countryCode": "PL"
},
"handlingUnit": {
"unitType": "BOX",
"amount": 1,
"labelsType": "ONE_FULFILMENT"
}
}
```

**Dlaczego wdrożymy zmianę?**

Udostępnimy nowy sposób awizowania, aby ułatwić i usprawnić ten proces dla sprzedających. Dzięki temu uniknie on błędów podczas deklarowania produktów w poszczególnych kartonach.

Chcemy także ułatwiać i usprawniać operacje logistyczne sprzedających, dlatego udostępniliśmy opcję wysłania do magazynu produktów sprzedającego bezpośrednio od producentów i dystrybutorów.

Z kolei możliwość dostawy kontenerowej jest odpowiedzią na potrzeby zagranicznych sprzedających.

Więcej o One Fulfillment by Allegro przeczytasz w [naszym poradniku](https://developer.allegro.pl/tutorials/one-fulfillment-by-allegro-0ADwgOLqWSw).

-----

[One Fulfillment by Allegro](https://allegro.pl/kampania/fulfillment) is a comprehensive logistic service for e-commerce. As part of it, sellers can send their goods to the Allegro logistics center, and we will take care of their storage, handling of orders, and after-sales inquiries of their customers.

To facilitate the ASN process, we are preparing changes that we will implement on **March 27, 2023**.

If you use endpoints:

- [GET /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation#operation/getAdvanceShipNotices),
- [POST /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation#operation/createAdvanceShipNotice),
- [GET /fulfillment/advance-ship-notices/{id}](https://developer.allegro.pl/documentation#operation/getAdvanceShipNotice),
- [PUT /fulfillment/advance-ship-notices/{id}](https://developer.allegro.pl/documentation#operation/updateAdvanceShipNotice),

prepare the necessary changes to your software. You can already test the changes[ on Sandbox](https://allegro.pl.allegrosandbox.pl/).

**What changes will we make?**

1. We will remove the **content** array and leave only the **items** array nested within it. This way, the seller doesn't have to declare what is in the boxes, only the number of individual items in the entire ASN.
2. We will add a new **handlingUnit** object in which the seller can declare:
- **unitType** - the type of unit in ANS, where in addition to the previously available value **BOX**, the seller can also declare **PALLET** and **CONTAINER**,
- **amount** - the number of items of the specified unit (or how many handling units inside a container will be sent),
- **labelsType** - type of label, available values are: **ONE_FULFILLMENT** (seller will apply labels himself), **NONE** (no labels on units, may incur additional charges).
3. In the **shipping.method** field, we will add a new value **THIRD_PARTY_DELIVERY**, so that the seller can declare delivery directly from the manufacturer.
4. In **shipping** object we will add a **thirdParty** structure, which you need to complete for the **THIRD_PARTY_DELIVERY** method - it contains fields:
- **name** - the name of the manufacturer or distributor,
- **orderNumber** - individual order number from the manufacturer.
5. In the **shipping** object, we will also add a **countryCode** field in which you declare from which country the shipment will arrive. This field is mandatory.

**Sample request:**

```
curl -X POST \
'https://api.allegro.pl/fulfillment/advance-ship-notices \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"items": [
{
"product": {
"id": "a1520fab-7801-4832-9ccd-fb068c707a74"
},
"quantity": 2
},
{
"product": {
"id": "67df7d34-811e-11ed-a1eb-0242ac120002"
},
"quantity": 3
}
],
"handlingUnit": {
"unitType": "BOX",
"amount": 1,
"labelsType": "ONE_FULFILMENT"
},
"shipping": {
"method": "THIRD_PARTY_DELIVERY",
"trackingNumber": null,
"truckLicencePlate": null,
"estimatedTimeOfArrival": "2023-02-16T11:00:00Z",
"thirdParty": {
"name": "Producer name",
"orderNumber" : "O-123"
},
"countryCode": "PL"
}
}'
```

**Sample response:**

```
{
"id": "3f79982b-a978-4ca3-ae38-b552a43b287b",
"displayNumber": "A-230215-0000026",
"status": "DRAFT",
"createdAt": "2023-02-15T07:37:41.766343917Z",
"updatedAt": "2023-02-15T07:37:41.766343917Z",
"items": [
{
"product": {
"id": "a1520fab-7801-4832-9ccd-fb068c707a74"
},
"quantity": 2
},
{
"product": {
"id": "67df7d34-811e-11ed-a1eb-0242ac120002"
},
"quantity": 3
}
],
"labels": {
"fileUrl": "https://api.allegro.pl.allegrosandbox.pl/fulfillment/advance-ship-notices/3f79982b-a978-4ca3-ae38-b552a43b287b/labels"
},
"shipping": {
"estimatedTimeOfArrival": "2023-02-16T11:00:00Z",
"method": "THIRD_PARTY_DELIVERY",
"trackingNumber": null,
"truckLicencePlate": null,
"thirdParty": {
"name": "Producer name",
"orderNumber": "O-123"
},
"countryCode": "PL"
},
"handlingUnit": {
"unitType": "BOX",
"amount": 1,
"labelsType": "ONE_FULFILMENT"
}
}
```

**Why will we implement the change?**

We will provide a new way of ASN creation to make the process easier and more efficient for sellers. This will avoid errors when declaring products in individual boxes.

We also want to make sellers' logistics operations easier and more efficient, so we have provided the option to send sellers' products directly from manufacturers and distributors to the warehouse.

The container delivery option, on the other hand, addresses the needs of foreign sellers.

You can read more about One Fulfillment by Allegro in [our guide](https://developer.allegro.pl/tutorials/one-fulfillment-by-allegro-4R9dXyMPlc9).