고객이 주문을 취소처리 하여
반품요청목록 조회 시 상태가 출고중지요청(RELEASE_STOP_UNCHECKED) 이거나 반품접수미확인(RETURNS_UNCHECKED) 이면서 releaseStatus가 "N" 일 경우에 사용가능합니다.
아직 상품을 발송하지 않아, 고객 요청대로 상품을 출고하지 않았을 때 사용합니다.
아직 상품을 발송하지 않아, 고객 요청대로 상품을 출고하지 않았을 때 사용합니다.
<주의!> 출고 중지 요청 상품이 배송되면 왕복 반품 배송비는 판매자의 귀책입니다.
Path
PATCH PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/stoppedShipment
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/returnRequests/363667/stoppedShipment
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| receiptId | O | Number |
접수 ID
|
||||
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||
| receiptId | O | Number |
접수 ID
|
||||
| cancelCount | O | Number |
출고 수량
|
||||
Request Example
{
"vendorId": "A00012345",
"receiptId": 363667,
"cancelCount": 2
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
서버 응답 코드
|
||||
| message | String |
서버 응답 메세지
|
||||
| data | Object |
|
||||
| resultCode | String |
SUCCESS/FAIL
|
||||
| resultMessage | String |
결과 메세지
|
||||
Response Example
{
"code": "200",
"message": "OK",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "출고중지완료요청이 성공하였습니다"
}
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 이미 반품이 완료 되었습니다. | 반품요청 단건조회 API로 접수번호(receiptId)의 반품상태가 완료인지 확인합니다. 반품완료된 경우 더 이상 출고중지 완료 처리하지 않도록 조치합니다. |
| 400 (요청변수확인) | 취소반품접수수량과 cancelCount가 일치하지 않습니다. | 출고중지할 수량(cancelCount)을 반품접수수량과 동일하게 입력했는지 확인합니다. |
| 400 (요청변수확인) | 상품준비 중 또는 배송지시 상태가 아닙니다. 배송완료 | 출고중지할 주문이 상품준비중 또는 배송지시 상태인지 확인합니다. 배송완료 상태일 경우 처리 시 에러가 발생합니다. |
| 400 (요청변수확인) | cancelType이 A 또는 RA가 아닙니다. | 접수번호(receiptId)가 올바른 값인지 올바른 반품상태 인지 확인하고 더 이상 출고중지 완료 처리를 하지 않도록 조치합니다. |
| 500 (요청변수확인) | 출고 되어 처리할 수 없습니다. | 반품요청 단건조회 API로 접수번호(receiptId)의 반품상태가 완료인지 확인합니다. 반품완료된 경우 더 이상 출고중지 완료 처리하지 않도록 조치합니다. |
URL API Name
STOP_RETURN_REQUEST_SHIPMENT