coupang
PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment

이미출고 처리

# 01

요약

API 적용 가능한 구매자 사용자 지역 : 한국 고객이 주문을 취소처리 하여 반품요청목록 조회 시 취소진행 상태가 출고중지요청( RELEASE_STOP_UNCHECKED ) 이거나 반품접수미확인( RETURNS_UNCHECKED ) 이면서 releaseStatus가 "N" 일 경우에 사용가능합니다. 이미 판매자가 상품을 발송한 상태일 때 사용합니다. <주의!>고객의 출고중지요청에도 불구하고 상품을 출고했다면 왕복 반품 배송비는 판매자의 귀책입니다.

# 02

상세

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

고객이 주문을 취소처리 하여
반품요청목록 조회 시 취소진행 상태가 출고중지요청(RELEASE_STOP_UNCHECKED) 이거나 반품접수미확인(RETURNS_UNCHECKED) 이면서 releaseStatus가 "N" 일 경우에 사용가능합니다. 
이미 판매자가 상품을 발송한 상태일 때 사용합니다.

<주의!>고객의 출고중지요청에도 불구하고 상품을 출고했다면 왕복 반품 배송비는 판매자의 귀책입니다.

Path

PATCH PUT

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment

Request Parameters

Path Segment Parameter

Name Type Description
receiptId* Number 
접수 ID
vendorId* String 
 
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345

Body Parameter

Name Type Description
vendorId* String
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345
receiptId* Number
접수 ID
deliveryCompanyCode* String
택배사 코드
invoiceNumber* String
송장번호

Request Example

{
  "vendorId": "TESTVENDORID",
  "receiptId": 12346897,
  "deliveryCompanyCode": "KDEXP",
  "invoiceNumber": "70432743577"
}

Response Message

Name Type Description
code String
서버 응답 코드
message String
서버 응답 메세지
data Object
 
  resultCode String
SUCCESS/FAIL
  resultMessage String
 
결과 메세지 

Response Example

{
  "data": {
    "code": "200",
    "message": "OK",
    "resultCode": "SUCCESS",
    "resultMessage": "이미출고 상태변경이 성공하였습니다."
  }
}

Error Spec

HTTP 상태 코드 (오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) 이미 저장된 송장번호가 있어 송장번호 등록이 불가능합니다. (동일송장번호 업로드 조건 : 수취인정보 동일) [합포장번호 : 10275****15] 등록한 송장번호가 이미 쿠팡에 등록된 번호인지 확인합니다. FAQ 참조
400 (요청변수확인) 송장번호가 유효하지 않습니다. [합포장번호 : 1167***03] 입력한 송장번호(invoiceNumber)가 올바른 값인지 확인합니다. 

URL API Name

STOP_RETURN_REQUEST_BY_RECEIPT