특정 주문에 대한 배송상태 히스토리를 조회합니다.
Path
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/ordersheets/{shipmentBoxId}/history
Request Parameters
Path Segment Parameter
Name | Required | Type | Description | ||||
---|---|---|---|---|---|---|---|
vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345
|
||||
shipmentBoxId | O | Number |
묶음배송번호
발주서 목록 조회 API를 통해 확인 가능
|
Request Example
not require body
Response Message
Name | Type | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | Number |
서버 응답 코드
|
||||||||||||||||||
message | String |
서버 응답 메세지
|
||||||||||||||||||
data | Array |
결제완료목록
|
||||||||||||||||||
shipmentBoxId | Number |
묶음배송번호
|
||||||||||||||||||
details | Array |
히스토리 상세
|
||||||||||||||||||
deliveryStatus | String |
배송상태
|
||||||||||||||||||
deliveryStatusDesc | String |
배송상태 설명
|
||||||||||||||||||
updatedAt | String |
변경시간
yyyy-MM-dd'T'hh:mm:ss
|
Response Example
{
"shipmentBoxId": 396844285,
"details": [
{
"deliveryStatus": "FINAL_DELIVERY",
"deliveryStatusDesc": "배송완료",
"updatedAt": "2017-06-08T14:03:06"
},
{
"deliveryStatus": "DELIVERING",
"deliveryStatusDesc": "배송중",
"updatedAt": "2017-06-07T10:12:56"
},
{
"deliveryStatus": "DEPARTURE",
"deliveryStatusDesc": "배송지시",
"updatedAt": "2017-06-07T09:52:30"
},
{
"deliveryStatus": "INSTRUCT",
"deliveryStatusDesc": "상품준비중",
"updatedAt": "2017-06-02T16:17:04"
},
{
"deliveryStatus": "ACCEPT",
"deliveryStatusDesc": "결제완료",
"updatedAt": "2017-06-02T15:36:31"
}
]
}
Error Spec
HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
---|---|---|
400 (요청변수확인) | Invalid vendor ID | 판매자 ID(vendorId) 값을 올바로 입력했는지 확인합니다. |
500 (요청변수확인) | Internal Exception | 묶음배송번호(shipmentBoxId) 값을 올바로 입력했는지 확인합니다. |
URL API Name
GET_ORDERSHEET_HISTORY