현재 주문 상태 값
아래는 주문이 가질 수 있는 현재 주문 상태 목록입니다.
주의 - 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 |
엔드포인트 URL | https://api.iglobalstores.com/v1/updateVendorOrderStatus |
프로토콜 | HTTPS |
메시지 형식 | JSON |
수락 HTTP 헤더 | Accept: application/json |
Content-Type HTTP 헤더 | Content-Type: application/json |
요청 본문의 JSON 키/값 쌍
메시지 형식: JSON
예시
1
2
3
4
5
6
{
"store": "999",
"secret": "f5bde245-f55e-414d-b722-80b25161c12c",
"orderId": "999-9999",
"orderStatus": "VENDOR_END_OF_DAY_COMPLETE"
}
요청 JSON 정의
필드 | 비고 |
---|---|
orderId 필수 | Zonos 주문 ID는 상점 ID와 하이픈 없이 또는 함께 전달될 수 있습니다 (예: 123-45678 또는 45678). 주문 완료 및 결제 후, 고객은 귀하의 도메인에 호스팅된 주문 완료 / 감사 페이지로 리디렉션됩니다. URL에는 이 값을 포함하는 쿼리 문자열 매개변수 orderID 가 포함됩니다.정수 / 문자열 |
orderStatus 필수 | 이 필드는 Zonos 시스템에 주문의 새로운 상태를 업데이트하는 데 사용됩니다. 다음 주문 상태는 이 API를 통해 설정할 수 있습니다.- VENDOR_PREPARING_ORDER |
VENDOR_SHIPMENT_READY
VENDOR_LABELS_PRINTED
VENDOR_END_OF_DAY_COMPLETE
VENDOR_CANCELLATION_REQUEST``문자열
| |secret
필수 | Zonos에서 제공하는 API 비밀 GUID.문자열
| |store
필수 | Zonos에서 제공하는 상점 ID정수
|
HTTPS 응답
메시지 형식: JSON
예시 성공 응답
1
2
3
{
"success": "Updated Order: 99999 to new order status: VENDOR_PREPARING_ORDER"
}
예제 오류 응답
1
2
3
{
"error": "OrderId: 99999 cannot be moved to order status: VENDOR_PREPARING_ORDER while in status: IGLOBAL_FRAUD_REVIEW"
}
HTTP 오류 응답
HTTP 응답 코드 | 응답 본문 예시/설명 |
---|---|
406 - 허용되지 않음 | HTML 엔티티. HTTP “Accept” 헤더가 유효하지 않습니다. |
415 - 지원되지 않는 미디어 유형 | HTML 엔티티. HTTP “Content-Type” 헤더가 유효하지 않습니다. |
200 | “error”:“입력을 파싱할 수 없습니다” |
200 | “error”:“updateVendorOrderStatus에 필요한 매개변수 orderId” |
200 | “error”:“updateVendorOrderStatus에 필요한 매개변수 orderStatus.” |
200 | “error”:“orderId: 999-99999는 유효한 orderId가 아닙니다” |
200 | “error”:“orderId: 999-99999에서 updateVendorOrderStatus를 위한 주문을 검색할 수 없습니다” |
200 | “error”:“OrderId: 999-99999는 이미 취소되었으며 상태를 업데이트할 수 없습니다.” |
200 | “error”:“상태: VENDOR_CANCELLATION_REQUEST로 주문 상태를 업데이트할 수 없습니다” |
200 | “error”:“유효하지 않은 상태: NEW_ORDER_STATUS로 주문 상태를 업데이트할 수 없습니다” |
200 | “error”:“OrderId: 999-99999는 현재 상태: VENDOR_SHIPMENT_READY를 이미 가지고 있습니다” |
200 | “error”:“OrderId: 999-99999는 상태: VENDOR_END_OF_DAY_COMPLETE에 있는 동안 주문 상태: VENDOR_CANCELLATION_REQUEST로 이동할 수 없습니다” |
200 | “error”:“새 상태: NEW_ORDER_STATUS는 유효한 주문 상태가 아닙니다” |
200 | “error”:“updateVendorOrderStatus를 처리할 수 없습니다.” |
200 | “error”:“유효하지 않은 보안 자격 증명” |
응답 JSON 정의
메시지 | 정의 |
---|---|
success | 이 매개변수는 업데이트 요약을 포함합니다.string |
error | 이 매개변수는 오류가 발생했을 때만 응답에 존재하며 원인의 설명을 포함합니다.string |
주문 상태 업데이트
주문 상태를 업데이트하는 엔드포인트가 작동하는 방식에 대해 알아보세요.
updateVendorOrderStatus
엔드포인트는 Zonos 시스템 내에서 주문의 상태를 업데이트하는 데 사용됩니다. 이는 프로그래밍 방식으로 주문의 배송 상태를 업데이트하거나 취소 요청을 하는 데 사용됩니다.