DOCS
Checkout•
Trang chủTài liệu tham khảo API Checkout REST API Cập nhật trạng thái đơn hàng

Cập nhật trạng thái đơn hàng

Tìm hiểu cách hoạt động của điểm cuối cập nhật trạng thái đơn hàng.

Điểm cuối updateVendorOrderStatus được sử dụng để cập nhật trạng thái đơn hàng của một đơn hàng bên trong Hệ thống Zonos. Điều này sẽ được sử dụng để cập nhật trạng thái vận chuyển của đơn hàng bằng phương thức lập trình hoặc để yêu cầu hủy.

Các giá trị trạng thái đơn hàng hiện tại 

Dưới đây là danh sách hiện tại các trạng thái đơn hàng mà một đơn hàng có thể có.

Cảnh báo - Zonos có thể thêm nhiều trạng thái bất kỳ lúc nào; hệ thống của bạn nên có khả năng xử lý sự xuất hiện của các trạng thái bổ sung.

Các trạng thái đã có trong production sẽ vẫn được giữ nguyên trong production. Zonos sẽ không bao giờ xóa các trạng thái hiện có.

Trạng thái↕Mô tả↕Có thể đặt bởi↕
IGLOBAL_FRAUD_REVIEWĐơn hàng hiện đang được iGlobal xem xét gian lận.Zonos
IGLOBAL_ORDER_IN_PROCESSĐơn hàng hợp lệ và sẵn sàng để xử lý.Zonos
IGLOBAL_ORDER_ON_HOLDĐơn hàng hiện đang ở trạng thái tạm thời.Zonos
IGLOBAL_ORDER_CANCELLEDĐơn hàng đã bị hủy trong Hệ thống iGlobal.Zonos
VENDOR_PREPARING_ORDERNhà cung cấp đã đánh dấu đơn hàng đang chuẩn bị.Nhà cung cấp
VENDOR_SHIPMENT_READYNhà cung cấp đã đánh dấu đơn hàng sẵn sàng vận chuyển.Nhà cung cấp
VENDOR_LABELS_PRINTED_DATENhà cung cấp đã in nhãn vận chuyển.Nhà cung cấp
VENDOR_CANCELLATION_REQUESTĐơn hàng đã được yêu cầu hủy.Nhà cung cấp
VENDOR_END_OF_DAY_COMPLETEĐơn hàng đã được hoàn tất và hoàn thành.Nhà cung cấp

vendorOrderStatus không thể được cập nhật bởi nhà cung cấp khi đơn hàng ở một trong các trạng thái đơn hàng sau:

IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE

Yêu cầu HTTPS

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

Trường↕Giá trị↕
Phương thức HTTPPOST
URL Điểm cuốihttps://api.iglobalstores.com/v1/updateVendorOrderStatus
Giao thứcHTTPS
Định dạng tin nhắnJSON
Tiêu đề HTTP AcceptAccept: application/json
Tiêu đề HTTP Content-TypeContent-Type: application/json

Cặp khóa/giá trị JSON trong phần thân yêu cầu

Định dạng tin nhắn: JSON

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

Định nghĩa JSON yêu cầu

Trường↕Ghi chú↕
orderId BẮT BUỘCID đơn hàng Zonos có thể được chuyển với hoặc không có ID cửa hàng và dấu gạch ngang của bạn (Ví dụ: 123-45678 hoặc 45678). Sau khi hoàn tất đơn hàng và thanh toán, khách hàng sẽ được chuyển hướng đến một trang hoàn tất đơn hàng/cảm ơn được lưu trữ trên miền của bạn. URL sẽ chứa một tham số chuỗi truy vấn orderID sẽ chứa giá trị này.integer / string
orderStatus BẮT BUỘCTrường này được sử dụng để cập nhật hệ thống Zonos với trạng thái mới của một đơn hàng. Các trạng thái đơn hàng có thể đặt thông qua API này như sau:- VENDOR_PREPARING_ORDER
  • VENDOR_SHIPMENT_READY
  • VENDOR_LABELS_PRINTED
  • VENDOR_END_OF_DAY_COMPLETE
  • VENDOR_CANCELLATION_REQUEST``string | | secret BẮT BUỘC | API secret GUID được cung cấp bởi Zonos.string | | store BẮT BUỘC | ID cửa hàng được cung cấp bởi Zonosinteger |

Phản hồi HTTPS

Định dạng tin nhắn: JSON

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

Phản hồi lỗi HTTP

Mã Phản hồi HTTP↕Mô tả/Ví dụ Thân Phản hồi↕
406 - Không Chấp nhậnThực thể HTML. Tiêu đề HTTP "Accept" không hợp lệ.
415 - Loại phương tiện không được hỗ trợThực thể HTML. Tiêu đề HTTP "Content-Type" không hợp lệ.
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"

Định nghĩa JSON phản hồi

Tin nhắn↕Định nghĩa↕
successTham số này sẽ chứa một bản tóm tắt của bản cập nhật.string
errorTham số này sẽ chỉ xuất hiện trong phản hồi khi đã xảy ra lỗi và sẽ chứa mô tả về nguyên nhân.string

Trang này có hữu ích không?

Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
Trên trang này:
  • Cập nhật trạng thái đơn hàng
  • Các giá trị trạng thái đơn hàng hiện tại