[NEWS] One Fulfillment by Allegro - wdrożyliśmy zmiany w zarządzaniu awizo / One Fulfillment by Allegro - we have implemented changes in ASN management

Dla [PUT /fulfillment/advance-ship-notices/{id}](https://developer.allegro.pl/documentation#operation/updateAdvanceShipNotice) dodaliśmy dzisiaj możliwość edycji awizo, które zostało już zakończone i wysłane do magazynu.

**Jak to działało do tej pory?**

Po prawidłowym żądaniu zakończenia edycji awizo otrzymywało status “IN_TRANSIT” i po wygenerowaniu powiadomienia do magazynu o planowanej dostawie - nie można już było edytować zawartości awizo.

**Jakie zmiany wprowadziliśmy?**

Od dzisiaj możliwa jest - ograniczona w zakresie - edycja danych zakończonego awizo o statusie “IN_TRANSIT”, do momentu rozpoczęcia rozpakowywania przez magazyn towarów zadeklarowanych w awizo.

Za pomocą [PUT /fulfillment/advance-ship-notice/{id}/submitted](https://developer.allegro.pl/documentation/#operation/updateSubmittedAdvanceShipNotice) zmodyfikujesz dane zakończonego awizo. Jako **“id”** przekaż identyfikator, który otrzymałeś w odpowiedzi dla [POST /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation/#operation/createAdvanceShipNotice) lub [GET /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation/#operation/getAdvanceShipNotices).

Modyfikacje zakończonego awizo ograniczone są do:

- zmiany liczby sztuk produktu,
- usunięcia produktu,
- zmiany liczby nośników, w których zostaną wysłane produkty,
- zmiany szczegółów dostawy:
- numeru rejestracyjnego pojazdu (gdy w zakończonym awizo, w polu “shipping.method” zadeklarowano metodę dostawy OWN_TRANSPORT),
- numeru listu przewozowego (gdy w zakończonym awizo, w polu “shipping.method” zadeklarowano metodę dostawy COURIER_BY_SELLER),
- nazwy oraz numeru zamówienia (gdy w zakończonym awizo, w polu “shipping.method” zadeklarowano metodę dostawy THIRD_PARTY_DELIVERY).

**Przykładowy request:**

```
curl -X PUT \
'https://api.allegro.pl/fulfillment/advance-ship-notices/33dd66df-20e2-4b92-9c76-700f4c8fc185/submitted’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H if-match: 123456' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d ‘{
"items": [
{
"product": {
"id": "4b215fa1-0cba-4a2a-9fb3-db740de4bbe1"
},
"quantity": 1000
}
],
"handlingUnit": {
"amount": 8 - w przypadku, gdy unitType to ‘BOX’ lub
‘PALLET’, amount oznacza ilość
odpowiednio kartonów lub palet.
W przypadku unitType równego
‘CONTAINER’, amount oznacza ilość
nośników w kontenerze.
},
"shipping": : {
"thirdParty": : { - dane producenta
"name": "TOYS", - nazwa producenta
"orderNumber": "O-1234566789" - nr zamówienia producenta
}
}
}’
```
**Przykładowy response:**

```
200 OK
etag: 123457

{
"id": "33dd66df-20e2-4b92-9c76-700f4c8fc185",
"displayNumber": "A-210302-0000002"
"status": "IN_TRANSIT",
"createdAt": "2021-03-02T13:39:12.739Z",
"updatedAt": "2021-03-02T13:40:12.739Z",
"items": [
{
"product": {
"id": "4b215fa1-0cba-4a2a-9fb3-db740de4bbe1"
},
"quantity": 1000
}
],
"handlingUnit": {
"unitType": "BOX",
"amount": 8,
"labelsType": "ONE_FULFILMENT"
},
"labels": null,
"shipping": : {
"method": "THIRD_PARTY_DELIVERY",
"estimatedTimeOfArrival": "2023-02-10T10:55:50.550672Z",
"thirdParty": : {
"name": "TOYS",
"orderNumber": "O-1234566789"
},
"countryCode": "PL"
},
"submittedAt": "2021-03-02T13:45:12.739Z"
}’
```

Więcej informacji na temat edycji zakończonego awizo znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/one-fulfillment-by-allegro-0ADwgOLqWSw#edytuj-zakonczone-awizo).

-------

Today, for [PUT /fulfillment/advance-ship-notices/{id}](https://developer.allegro.pl/documentation#operation/updateAdvanceShipNotice) we have added the option to edit the advance ship note that has already been completed and sent to the warehouse.

**How has it worked so far?**

After a correct request to complete editing, the ASN received the status "IN_TRANSIT" and after generating a notification to the warehouse about the planned delivery - it was no longer possible to edit the content of it.

**What changes have we made?**

From today, it is possible - limited in scope - to edit the data of the completed ASN with “IN_TRANSIT” status, until the warehouse starts unpacking the goods declared in it.

Using [PUT /fulfillment/advance-ship-notice/{id}/submitted](https://developer.allegro.pl/documentation/#operation/updateSubmittedAdvanceShipNotice) you will modify the details of the completed ASN. As **"id"** pass the identificator which you received in response to [POST /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation/#operation/createAdvanceShipNotice) or [GET /fulfillment/advance-ship-notices](https://developer.allegro.pl/documentation/#operation/getAdvanceShipNotices).

Modifications are limited to:

- changing items quantity,,
- removing items,,
- changing handling unit amount,
- changing delivery details:
- vehicle licence plate (when the OWN_TRANSPORT delivery method was declared in the "shipping.method" field in the completed ASN),
- shipping tracking number (when the COURIER_BY_SELLER delivery method was declared in the "shipping.method" field in the completed ASN),
- third party delivery details (when the THIRD_PARTY_DELIVERY delivery method was declared in the "shipping.method" field in the completed ASN).

**Sample request:**

```
curl -X PUT \
'https://api.allegro.pl/fulfillment/advance-ship-notices/33dd66df-20e2-4b92-9c76-700f4c8fc185/submitted’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H if-match: 123456' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d ‘{
"items": [
{
"product": {
"id": "4b215fa1-0cba-4a2a-9fb3-db740de4bbe1"
},
"quantity": 1000
}
],
"handlingUnit": {
"amount": 8 - in case unitType is ‘BOX’ or
‘PALLET’, amount means quantity of
cartons or pallets, respectively..
For unitType equal to
‘CONTAINER’, amount means quantity
of the media in the container.
},
"shipping": : {
"thirdParty": : { - manufacturer's data
"name": "TOYS", - manufacturer's name
"orderNumber": "O-1234566789" - manufacturer's order number
}
}
}’
```
**Sample response:**

```
200 OK
etag: 123457

{
"id": "33dd66df-20e2-4b92-9c76-700f4c8fc185",
"displayNumber": "A-210302-0000002"
"status": "IN_TRANSIT",
"createdAt": "2021-03-02T13:39:12.739Z",
"updatedAt": "2021-03-02T13:40:12.739Z",
"items": [
{
"product": {
"id": "4b215fa1-0cba-4a2a-9fb3-db740de4bbe1"
},
"quantity": 1000
}
],
"handlingUnit": {
"unitType": "BOX",
"amount": 8,
"labelsType": "ONE_FULFILMENT"
},
"labels": null,
"shipping": : {
"method": "THIRD_PARTY_DELIVERY",
"estimatedTimeOfArrival": "2023-02-10T10:55:50.550672Z",
"thirdParty": : {
"name": "TOYS",
"orderNumber": "O-1234566789"
},
"countryCode": "PL"
},
"submittedAt": "2021-03-02T13:45:12.739Z"
}’
```

More information on editing a completed ASN you can find in [our guide](https://developer.allegro.pl/tutorials/one-fulfillment-by-allegro-4R9dXyMPlc9#edit-advance-ship-notice).