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

이미출고 처리

# 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 Required Type Description
receiptId O Number 
접수 ID
vendorId O String 
 
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345

Body Parameter

Name Required 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