Allegro REST API

gdzie?

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).
Kliknij, aby zobaczyć 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
      }
  }
}’
Kliknij, aby zobaczyć 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.