Allegro REST API

gdzie?

15 lutego 2023

One Fulfillment by Allegro - wdrożymy zmiany w zarządzaniu awizo

One Fulfillment by Allegro 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:

przygotuj niezbędne zmiany w swoim oprogramowaniu. Zmiany możesz już przetestować na Sandboxie.

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.
Kliknij, aby zobaczyć 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"
    }
  }'
Kliknij, aby zobaczyć 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.