POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/completeLongTermUndelivery2609170000장기미배송 배송완료 처리
KRTW
# 01
요약
장기미배송 배송완료 처리
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국
송장 등록 후 1달이 경과하였으나, 배송추적 결과를 확인할 수 없는 내용에 대해 배송완료로 상태를 변경합니다.
정산된 주문에 대한 미배송으로 인해 고객 분쟁 발생 시 분쟁처리에 대한 비용은 판매자가 부담해야 하므로 정확한 확인이 필요합니다.
배송지시(DEPARTURE) 이후 30일이 지난 배송지시, 배송중 상태인 주문만 처리 가능합니다.
경로
POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/completeLongTermUndelivery
예시 엔드포인트
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/completeLongTermUndeliveryURL API Name
UPDATE_INVOICE_DELIVERY_BY_INVOICE_NO
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 판매자 ID
|
# 04
요청 본문
요청 파라미터
본문 파라미터
| Name | Type | Description |
|---|---|---|
| shipmentBoxId* | integer | 묶음배송번호
|
| invoiceNumber* | string | 운송장번호
|
요청 예시application/json
{
"shipmentBoxId": 123456789012345680,
"invoiceNumber": "505124853844"
}# 05
응답 본문
응답 메시지
| Name | Type | Description |
|---|---|---|
| code | string | server response status info
|
| message | string | detail info
|
| data | boolean | true/false
|
Response Example
{
"code": "200",
"message": "SUCCESS",
"data": true
}# 06
에러 코드
| HTTP | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | 배송완료 처리 실패. 배송상태: INSTRUCT | 상품준비중(INSTRUCT) 상태의 주문은 배송완료 처리를 할 수 없습니다. 배송지시 이후 상태의 주문만 처리 가능합니다. |
| 400 | 400 (요청변수확인) | 배송완료 처리 실패. 배송상태: DEPARTURE | 올바른 송장번호인지 확인합니다. 또한 배송지시 이후 30일이 지난 주문 건인지 확인합니다. 배송지시 시각에 따라 32일이 지난 후에 처리 가능할 수 있습니다. |
| 400 | 400 (요청변수확인) | 배송완료 처리 실패. 배송상태: NONE_TRACKING | 업체직송(NONE_TRACKING) 상태의 주문은 배송완료 처리를 할 수 없습니다. 더 이상 완료처리 시도를 하지 않도록 처리합니다. |