DOCS

Update order status

/

주문 상태 업데이트

주문 상태를 업데이트하는 엔드포인트가 작동하는 방식에 대해 알아보세요.

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
수락 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

이 페이지가 도움이 되었습니까?


질문 있으세요?

문의하세요.

Zonos을 보세요

정책 및 계약
이 페이지에서: