Aktualizacja statusu zamówienia

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

Punkt końcowy updateVendorOrderStatus jest używany do aktualizacji statusu zamówienia w systemie Zonos. Będzie to używane do programatycznej aktualizacji statusu wysyłki zamówienia lub do złożenia prośby o anulowanie.

Aktualne wartości statusu zamówienia

Poniżej znajduje się aktualna lista statusów zamówienia, które może mieć zamówienie.

Uwaga - Zonos może dodać więcej statusów w dowolnym momencie; twój system powinien uwzględniać obecność dodatkowych statusów.

Statusy w produkcji pozostaną w produkcji. Zonos nigdy nie usunie istniejących statusów.

Status	Opis	Można ustawić przez
IGLOBAL_FRAUD_REVIEW	Zamówienie jest obecnie w trakcie przeglądu oszustw przez iGlobal.	Zonos
IGLOBAL_ORDER_IN_PROCESS	Zamówienie jest ważne i gotowe do przetwarzania.	Zonos
IGLOBAL_ORDER_ON_HOLD	Zamówienie jest obecnie w tymczasowym wstrzymaniu statusu.	Zonos
IGLOBAL_ORDER_CANCELLED	Zamówienie zostało anulowane w systemie iGlobal.	Zonos
VENDOR_PREPARING_ORDER	Sprzedawca oznaczył zamówienie jako w przygotowaniu.	Sprzedawca
VENDOR_SHIPMENT_READY	Sprzedawca oznaczył zamówienie jako gotowe do wysyłki.	Sprzedawca
VENDOR_LABELS_PRINTED_DATE	Sprzedawca wydrukował etykiety wysyłkowe.	Sprzedawca
VENDOR_CANCELLATION_REQUEST	Złożono prośbę o anulowanie zamówienia.	Sprzedawca
VENDOR_END_OF_DAY_COMPLETE	Zamówienie jest sfinalizowane i zakończone.	Sprzedawca

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

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

Pole	Wartość
Metoda HTTP	POST
URL punktu końcowego	`https://api.iglobalstores.com/v1/updateVendorOrderStatus`
Protokół	HTTPS
Format wiadomości	JSON
Nagłówek Accept HTTP	Accept: application/json
Nagłówek Content-Type HTTP	Content-Type: application/json

Klucze/wartości JSON w ciele żądania

Format wiadomości: JSON

PRZYKŁAD

{
  "store": "999",
  "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
  "orderId": "999-9999",
  "orderStatus": "VENDOR_END_OF_DAY_COMPLETE"
}

Definicje JSON żądania

Pole	Uwagi
`orderId` WYMAGANE	ID zamówienia Zonos może być przekazane z lub bez ID sklepu i myślnika (Przykład: 123-45678 lub 45678). Po zakończeniu zamówienia i płatności, klient zostanie przekierowany na stronę potwierdzenia zamówienia / podziękowania za zamówienie hostowaną na Twojej domenie. URL będzie zawierał parametr querystring `orderID`, który będzie zawierał tę wartość.`integer / string`
`orderStatus` WYMAGANE	To pole jest używane do aktualizacji systemu Zonos z nowym statusem zamówienia. Następujące statusy zamówienia mogą być ustawiane za pomocą tego API.- `VENDOR_PREPARING_ORDER`

VENDOR_SHIPMENT_READY
VENDOR_LABELS_PRINTED
VENDOR_END_OF_DAY_COMPLETE
VENDOR_CANCELLATION_REQUEST``string | | secret WYMAGANE | Sekretny klucz API GUID dostarczony przez Zonos.string | | store WYMAGANE | ID sklepu dostarczone przez Zonosinteger |

Odpowiedź HTTPS

Format wiadomości: JSON

Przykład odpowiedzi sukcesu

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

Przykładowa odpowiedź błędu

{
  "error": "OrderId: 99999 cannot be moved to order status: VENDOR_PREPARING_ORDER while in status: IGLOBAL_FRAUD_REVIEW"
}

Odpowiedzi błędów HTTP

Kody odpowiedzi HTTP	Przykład opisu/treści odpowiedzi
406 - Nieakceptowalne	HTML Entity. Nagłówek HTTP “Accept” jest nieprawidłowy.
415 - Nieobsługiwany typ mediów	HTML Entity. Nagłówek HTTP “Content-Type” jest nieprawidłowy.
200	“error”:“nie można przetworzyć wejścia”
200	“error”:“Wymagany parametr orderId do updateVendorOrderStatus”
200	“error”:“Wymagany parametr orderStatus do updateVendorOrderStatus.”
200	“error”:“orderId: 999-99999 nie jest prawidłowym orderId”
200	“error”:“Nie można pobrać zamówienia do updateVendorOrderStatus z orderId: 999-99999”
200	“error”:“OrderId: 999-99999 został już anulowany i status nie może być zaktualizowany.”
200	“error”:“Nie można zaktualizować statusu zamówienia na status: VENDOR_CANCELLATION_REQUEST”
200	“error”:“Nie można zaktualizować statusu zamówienia na nieprawidłowy status: NEW_ORDER_STATUS”
200	“error”:“OrderId: 999-99999 ma już bieżący status: VENDOR_SHIPMENT_READY”
200	“error”:“OrderId: 999-99999 nie może być przeniesiony do statusu zamówienia: VENDOR_CANCELLATION_REQUEST podczas statusu: VENDOR_END_OF_DAY_COMPLETE”
200	“error”:“Nowy status: NEW_ORDER_STATUS nie jest prawidłowym statusem zamówienia”
200	“error”:“Nie można przetworzyć updateVendorOrderStatus.”
200	“error”:“Nieprawidłowe dane uwierzytelniające”

Definicje JSON odpowiedzi

Wiadomość	Definicja
`success`	Ten parametr będzie zawierał podsumowanie aktualizacji.`string`
`error`	Ten 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?

Pytania?

Skontaktuj się z nami.

Zobacz Zonos

polityki i umowy