25 sierpnia 2023
One Fulfillment by Allegro - wdrożyliśmy zmiany w zarządzaniu awizo
Dla PUT /fulfillment/advance-ship-notices/{id} 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 zmodyfikujesz dane zakończonego awizo. Jako “id” przekaż identyfikator, który otrzymałeś w odpowiedzi dla POST /fulfillment/advance-ship-notices lub GET /fulfillment/advance-ship-notices.
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).
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
}
}
}’
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.