DOCS
Checkout•
홈API 참조 Checkout REST API 주문 상태 업데이트

주문 상태 업데이트

주문 상태를 업데이트하는 엔드포인트가 어떻게 작동하는지 알아보세요.

updateVendorOrderStatus 엔드포인트는 Zonos 시스템 내 주문의 상태를 업데이트하는 데 사용됩니다. 이는 주문의 배송 상태를 프로그래밍 방식으로 업데이트하거나 취소를 요청하는 데 사용됩니다.

현재 주문 상태 값 

아래는 주문이 가질 수 있는 현재 주문 상태 목록입니다.

주의 - Zonos는 언제든지 상태를 추가할 수 있으므로, 시스템에서 추가 상태가 존재할 수 있음을 고려해야 합니다.

프로덕션에 있는 상태는 계속 프로덕션에 유지됩니다. Zonos는 기존 상태를 삭제하지 않습니다.

상태↕설명↕설정 가능 주체↕
IGLOBAL_FRAUD_REVIEW주문이 현재 iGlobal에서 사기 검토를 받고 있습니다.Zonos
IGLOBAL_ORDER_IN_PROCESS주문이 유효하며 처리 준비가 완료되었습니다.Zonos
IGLOBAL_ORDER_ON_HOLD주문이 현재 임시 보류 상태에 있습니다.Zonos
IGLOBAL_ORDER_CANCELLED주문이 iGlobal 시스템에서 취소되었습니다.Zonos
VENDOR_PREPARING_ORDER벤더가 주문을 준비 중으로 표시했습니다.벤더
VENDOR_SHIPMENT_READY벤더가 주문을 배송 준비 완료로 표시했습니다.벤더
VENDOR_LABELS_PRINTED_DATE벤더가 배송 라벨을 인쇄했습니다.벤더
VENDOR_CANCELLATION_REQUEST주문에 대한 취소가 요청되었습니다.벤더
VENDOR_END_OF_DAY_COMPLETE주문이 최종적으로 완료되었습니다.벤더

주문이 다음 상태 중 하나에 있는 동안에는 벤더가 vendorOrderStatus를 업데이트할 수 없습니다:

IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE

HTTPS 요청

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

필드↕값↕
HTTP 메서드POST
엔드포인트 URLhttps://api.iglobalstores.com/v1/updateVendorOrderStatus
프로토콜HTTPS
메시지 형식JSON
Accept HTTP 헤더Accept: application/json
Content-Type HTTP 헤더Content-Type: application/json

요청 본문의 JSON 키/값 쌍

메시지 형식: JSON

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

요청 JSON 정의

필드↕참고↕
orderId REQUIREDZonos 주문 ID는 스토어 ID와 하이픈을 포함하거나 포함하지 않은 형태로 전달할 수 있습니다(예: 123-45678 또는 45678). 주문 완료 및 결제 후 고객은 귀사 도메인에 호스팅된 주문 완료/감사 페이지로 리디렉션됩니다. URL에는 이 값을 담은 쿼리스트링 매개변수 orderID가 포함됩니다.integer / string
orderStatus REQUIRED이 필드는 주문의 새로운 상태로 Zonos 시스템을 업데이트하는 데 사용됩니다. 이 API를 통해 다음 주문 상태를 설정할 수 있습니다.- VENDOR_PREPARING_ORDER
  • VENDOR_SHIPMENT_READY
  • VENDOR_LABELS_PRINTED
  • VENDOR_END_OF_DAY_COMPLETE
  • VENDOR_CANCELLATION_REQUEST``string | | secret REQUIRED | Zonos에서 제공한 API 시크릿 GUID입니다.string | | store REQUIRED | Zonos에서 제공한 스토어 IDinteger |

HTTPS 응답

메시지 형식: JSON

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

오류 HTTP 응답

HTTP 응답 코드↕응답 본문 예시/설명↕
406 - Not AcceptableHTML 엔터티. HTTP “Accept” 헤더가 유효하지 않습니다.
415 - Unsupported media typeHTML 엔터티. HTTP “Content-Type” 헤더가 유효하지 않습니다.
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”

응답 JSON 정의

메시지↕정의↕
success이 매개변수는 업데이트에 대한 요약을 포함합니다.string
error이 매개변수는 오류가 발생한 경우에만 응답에 포함되며 원인에 대한 설명을 포함합니다.string

이 페이지가 도움이 되었나요?

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • 주문 상태 업데이트
  • 현재 주문 상태 값