coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산Rocket Growth
POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/completeLongTermUndeliveryv1

장기미배송 배송완료 처리

# 01

요약

API 적용 가능한 구매자 사용자 지역 : 한국 송장 등록 후 1달이 경과하였으나, 배송추적 결과를 확인할 수 없는 내용에 대해 배송완료로 상태를 변경합니다. 정산된 주문에 대한 미배송으로 인해 고객 분쟁 발생 시 분쟁처리에 대한 비용은 판매자가 부담해야 하므로 정확한 확인이 필요합니다. 배송지시(DEPARTURE) 이후 30일이 지난 배송지시, 배송중 상태인 주문만 처리 가능합니다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국

송장 등록 후 1달이 경과하였으나, 배송추적 결과를 확인할 수 없는 내용에 대해 배송완료로 상태를 변경합니다.
정산된 주문에 대한 미배송으로 인해 고객 분쟁 발생 시 분쟁처리에 대한 비용은 판매자가 부담해야 하므로 정확한 확인이 필요합니다.
배송지시(DEPARTURE) 이후 30일이 지난 배송지시, 배송중 상태인 주문만 처리 가능합니다.

Path

POST

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/completeLongTermUndelivery

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/completeLongTermUndelivery

Request Parameters

Path Segment Parameter

Name Required Type Description
vendorId O  String
판매자 ID

Body Parameter

Name Required Type Description
shipmentBoxId O Number
묶음배송번호
invoiceNumber O String
운송장번호

Request Example

{
  "shipmentBoxId": 123456789012345678,
  "invoiceNumber": "505124853844"
}

Response Message

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
}

Error Spec

HTTP 상태 코드(오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) 배송완료 처리 실패. 배송상태: INSTRUCT 상품준비중(INSTRUCT) 상태의 주문은 배송완료 처리를 할 수 없습니다. 배송지시 이후 상태의 주문만 처리 가능합니다.
400 (요청변수확인) 배송완료 처리 실패. 배송상태: DEPARTURE 올바른 송장번호인지 확인합니다. 또한 배송지시 이후 30일이 지난 주문 건인지 확인합니다. 배송지시 시각에 따라 32일이 지난 후에 처리 가능할 수 있습니다.
400 (요청변수확인) 배송완료 처리 실패. 배송상태: NONE_TRACKING 업체직송(NONE_TRACKING) 상태의 주문은 배송완료 처리를 할 수 없습니다. 더 이상 완료처리 시도를 하지 않도록 처리합니다.

URL API Name

UPDATE_INVOICE_DELIVERY_BY_INVOICE_NO