18 września 2024
One Fulfillment - awizo: zmiana w obiekcie "shipping" dla wysyłki towaru kurierem
Zmieniamy sposób, w jaki przekażesz nam dane o przesyłkach, gdy tworzysz awizo w ramach One Fulfillment.
Co zmieniliśmy?
Zmiana dotyczy:
- GET /fulfillment/advance-ship-notices
- POST /fulfillment/advance-ship-notices
- GET /fulfillment/advance-ship-notices/{id}
- PUT /fulfillment/advance-ship-notices/{id}
- PUT /fulfillment/advance-ship-notices/{id}/submitted.
W obiekcie "shipping", dla typu COURIER_BY_SELLER (w polu "method"), wdrożyliśmy nowy obiekt "courier", w którym:
- w polu "id" - przekażesz ID firmy kurierskiej, która dostarczy przesyłkę. Dostępne wartości to:
- ALLEGRO
- DB_SCHENKER
- DHL
- DPD
- DPD_SK
- INPOST
- ORLEN
- POCZTA_POLSKA
- SUUS
- UPS
- OTHER.
- w polu "name" - przekażesz nazwę firmy kurierskiej, jeżeli w "id" wskażesz wartość OTHER. W przeciwnym wypadku wartość zostanie zignorowana.
- w tablicy "trackingNumbers" - przekażesz numery przesyłek.
Dodatkowo dodaliśmy pole "estimatedTimeOfArrival" dla PUT /fulfillment/advance-ship-notices/{id}/submitted, który służy do edycji zgłoszonego już awizo.
Przykład obiektu "shipping" z nowym obiektem "courier":
...
"shipping": {
"method": "COURIER_BY_SELLER",
"courier": {
"id": "OTHER",
"name": "Test name",
"trackingNumbers": [
"00340433982034779798",
"12340433982034779888"
]
}
}
...
Równocześnie, pole "shipping.trackingNumber", które dotychczas służyło do przekazania numeru przesyłki, zostało oznaczone jako deprecated. Będziemy wspierać je do 29 listopada 2024. Zadbaj o to, aby do tego czasu, przy tworzeniu i edycji awizo, przekazywać numer przesyłki w nowym obiekcie "courier".
Dlaczego wdrożyliśmy zmianę?
Dzięki tej zmianie określisz, jaka firma kurierska zrealizuje przesyłkę oraz przekażesz więcej niż jeden numer przesyłki w ramach pojedynczego awizo.
Więcej o One Fulfillment by Allegro przeczytasz w naszym poradniku.