판매자가 주문 발송이 불가능할 경우, 취소사유를 선택하여 판매자 취소요청 처리를 진행 할 수 있습니다.
- 판매자취소요청은 (202)배송요청, (301)배송준비중 상태에서 처리 가능합니다.
- 동일 배송비 묶음 그룹 내 여러 주문에 대해 동시에 취소를 요청하더라도, 클레임(취소 처리)은 주문 단위로 각각 생성됩니다.
- 해당 API는 판매자 귀책 사유에 한하여 사용 가능하며, 기타 사유의 경우 사용이 제한됩니다.
- 판매자 취소요청이 처리되면 고객에게 취소 안내 알림톡이 즉시 발송되며, 환불 및 주문 취소가 자동으로 완료 처리됩니다. 주문번호는 최대 50건까지 요청 가능합니다.
요청
POST /v1/shopping/claims/cancel/deliveries
HTTP/1.1 Content-type: application/json키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| orderIds | Array | 필수 | 주문번호 (N건) |
| claimCode | String | 필수 | 취소사유코드 |
Request body Sample code
{
"orderIds": [
3200073952
],
"claimCode": "CANCELED_BY_SELLER_DELAY_DELIVERY"
}
취소 사유 코드
| Code | 설명 |
|---|---|
| CANCELED_BY_SELLER_DELAY_DELIVERY | 배송지연 |
| CANCELED_BY_SELLER_OUT_OF_STOCK | 상품품절 |
| CANCELED_BY_SELLER_IMPOSSIBLE_CUSTOM_ORDER | 주문제작 불가 |
| CANCELED_BY_SELLER_UNDELIVERABLE_AREA | 배송불가지역 |
| CANCELED_BY_SELLER_LIMIT_EXCEEDED | 구매한도초과(*해외배송) |
응답
Response body Sample code
성공시
{
"failureList"
: [],
"success":
true
}
실패시
{
"failureList": [
{
"orderId": 3200073952,
"reason": "취소요청을 수행할 수 없는 code로 취소요 청 되었습니다."
}
],
"success": false
}
에러 메시지
메시지 | 설명 |
|---|---|
| "요청한 주문의 상품은 현재 지원되지 않습니다." | 취소 처리가 불가능한 주문 유형일 경우 |
| "클레임 사유를 찾을 수 없습니다." | 클레임 사유코드가 유효하지 않을 경우 |
| "해당 요청에 대해 진행 불가능한 상태입니다. " | 클레임 처리가 가능하지 않은 주문상태일 경우 |
| "쿠폰 금액 및 추가 배송비가 취소할 주문금액보다 크므로 취소할 수 없습니다.” | 쿠폰 & 추가 배송비가 환불금액 보다 클 경우 |
| "추가/반품 배송비가 환불금액보다 크므로 취소요청 처리가 불가합니다." | 추가 배송비가 환불금액 보다 클 경우 |
| "취소요청을 수행할 수 없는 code로 취소요청 되었습니다." | 취소 사유가 판매자귀책 사유가 아닐 경우 |
| "B2B 상품 취소요청은 담당 MD에게 전달 부탁드립니다." | 선물하기 B2B 상품 일 경우 |
| "배송상품만 요청 가능합니다." | 주문 유형이 픽업이나 교환권등 다른 유형일 경우 |
| "클레임 요청 기한이 지났습니다." | 주문일로부터 2년 경과시 |