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:
- GET /fulfillment/advance-ship-notices,
- POST /fulfillment/advance-ship-notices,
- GET /fulfillment/advance-ship-notices/{id},
- PUT /fulfillment/advance-ship-notices/{id},
przygotuj niezbędne zmiany w swoim oprogramowaniu. Zmiany możesz już przetestować na Sandboxie.
Jakie zmiany wprowadzimy?
- 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.
- 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).
- W polu shipping.method dodamy nową wartość THIRD_PARTY_DELIVERY, dzięki której sprzedający może zadeklarować dostawę bezpośrednio od producenta.
- 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.
- 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.
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"
}
}'{
"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.
