DOCS

Aktualizacja statusu zamówienia

Dowiedź się, jak działa punkt końcowy do aktualizacji statusu zamówienia.

Punkt końcowy updateVendorOrderStatus jest używany do aktualizacji statusu zamówienia wewnątrz systemu Zonos. Będzie on używany do programistycznej aktualizacji statusu wysyłki zamówienia lub do prośby o anulowanie.

Bieżące wartości statusu zamówienia 

Poniżej znajduje się aktualna lista statusów zamówień, które mogą być przypisane do zamówienia.

Uwaga - Zonos może dodawać więcej statusów w dowolnym momencie; Twój system powinien obsługiwać dodatkowe statusy.

Statusy w środowisku produkcyjnym pozostaną w środowisku produkcyjnym. Zonos nigdy nie usunie istniejących statusów.

StatusOpisMożliwe do ustawienia przez
IGLOBAL_FRAUD_REVIEWZamówienie jest obecnie poddawane kontroli pod kątem oszustw przez iGlobal.Zonos
IGLOBAL_ORDER_IN_PROCESSZamówienie jest ważne i gotowe do przetworzenia.Zonos
IGLOBAL_ORDER_ON_HOLDZamówienie jest obecnie wstrzymane w czasowym statusie.Zonos
IGLOBAL_ORDER_CANCELLEDZamówienie zostało anulowane w systemie iGlobal.Zonos
VENDOR_PREPARING_ORDERSprzedawca oznaczył zamówienie jako przygotowywane.Sprzedawca
VENDOR_SHIPMENT_READYSprzedawca oznaczył zamówienie jako gotowe do wysyłki.Sprzedawca
VENDOR_LABELS_PRINTED_DATESprzedawca wydrukował etykiety wysyłkowe.Sprzedawca
VENDOR_CANCELLATION_REQUESTZamówienie zostało zgłoszone do anulowania.Sprzedawca
VENDOR_END_OF_DAY_COMPLETEZamówienie zostało sfinalizowane i ukończone.Sprzedawca

vendorOrderStatus nie może być aktualizowany przez sprzedawcę, podczas gdy zamówienie znajduje się w jednym z następujących statusów:

IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE

Żądanie HTTPS

POST | https://api.iglobalstores.com/v1/updateVendorOrderStatus

PoleWartość
Metoda HTTPPOST
Adres URL punktu końcowegohttps://api.iglobalstores.com/v1/updateVendorOrderStatus
ProtokółHTTPS
Format wiadomościJSON
Nagłówek Accept HTTPAccept: application/json
Nagłówek Content-Type HTTPContent-Type: application/json

Pary klucz/wartość JSON w treści żądania

Format wiadomości: JSON

1{
2 "store": "999",
3 "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
4 "orderId": "999-9999",
5 "orderStatus": "VENDOR_END_OF_DAY_COMPLETE"
6}

Definicje JSON żądania

PoleUwagi
orderId WYMAGANEIdentyfikator zamówienia Zonos można przekazać z identyfikatorem sklepu i myślnikiem lub bez (Przykład: 123-45678 lub 45678).Po zakończeniu zamówienia i płatności, klient zostanie przekierowany na stronę ukończenia zamówienia / podziękowania za zamówienie hostowaną w Twojej domenie. Adres URL będzie zawierać parametr querystring orderID zawierający tę wartość.integer / string
orderStatus WYMAGANETo pole jest używane do aktualizacji systemu Zonos o nowym statusie zamówienia.Następujące statusy zamówień można ustawić za pośrednictwem tego API.- VENDOR_PREPARING_ORDER
  • VENDOR_SHIPMENT_READY
  • VENDOR_LABELS_PRINTED
  • VENDOR_END_OF_DAY_COMPLETE
  • VENDOR_CANCELLATION_REQUEST``string | | secret WYMAGANE | Tajny klucz GUID API dostarczony przez Zonos.string | | store WYMAGANE | Identyfikator sklepu dostarczony przez Zonosinteger |

Odpowiedź HTTPS

Format wiadomości: JSON

1{
2 "success": "Updated Order: 99999 to new order status: VENDOR_PREPARING_ORDER"
3}

Odpowiedzi błędów HTTP

Kody odpowiedzi HTTPPrzykład treści odpowiedzi/Opis
406 - Nie do zaakceptowaniaJednostka HTML. Nagłówek HTTP „Accept" jest nieprawidłowy.
415 - Nieobsługiwany typ mediówJednostka HTML. Nagłówek HTTP „Content-Type" jest nieprawidłowy.
200"error":"could not parse input"
200"error":"Parameter orderId required for updateVendorOrderStatus"
200"error":"Parameter orderStatus required for updateVendorOrderStatus."
200"error":"orderId: 999-99999 is not a valid orderId"
200"error":"Could not retrieve order to updateVendorOrderStatus from orderId: 999-99999"
200"error":"OrderId: 999-99999 has already been cancelled and status cannot be updated."
200"error":"Cannot update order status to status: VENDOR_CANCELLATION_REQUEST"
200"error":"Cannot update order status to invalid status: NEW_ORDER_STATUS"
200"error":"OrderId: 999-99999 already has current status: VENDOR_SHIPMENT_READY"
200"error":"OrderId: 999-99999 cannot be moved to order status: VENDOR_CANCELLATION_REQUEST while in status: VENDOR_END_OF_DAY_COMPLETE"
200"error":"New Status: NEW_ORDER_STATUS is not a valid order status"
200"error":"Could not process updateVendorOrderStatus."
200"error":"Invalid security credentials"

Definicje JSON odpowiedzi

WiadomośćDefinicja
successTen parametr będzie zawierać podsumowanie aktualizacji.string
errorTen parametr będzie obecny w odpowiedzi tylko wtedy, gdy wystąpił błąd i będzie zawierać opis przyczyny.string

Czy ta strona była pomocna?