Coupang Developer Center

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

교환할 상품의 운송장을 입력합니다.
[교환상품 입고 확인처리 API] 실행 후에 [교환요청 목록 조회] 시, 회수상태(collectStatus)가 업체전달완료(CompleteCollect) 일 때 [교환송장 업로드 처리 API]를 수행하실 수 있습니다.

교환상품 입고확인 처리 후, 교환요청 목록 조회를 하시면 deliveryInvoiceGroupDtos 정보가 생성됩니다.
교환송장 업로드처리 시 이 때, 새롭게 생성된 shipmentBoxId를 조회 및 입력하셔야 합니다.
※ 교환상품 입고확인 처리 후, 최대 10분 이후에 교환송장 업로드처리가 가능합니다.

Path

POST

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests/{exchangeId}/invoices

Example Endpoint

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

Request Parameters

Path Segment Parameter

Name					Required	Type	Description
vendorId					O	String	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345
exchangeId					O	Number	교환 접수번호 교환요청목록 조회 시 표시되는 exchangeId 입력

Body Parameter

Name	Required	Type	Description
exchangeId	O	Number	교환 접수번호 교환요청목록 조회 시 표시되는 exchangeId 입력
vendorId	O	String	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345
goodsDeliveryCode	O	String	택배사 코드 택배사 코드 바로가기
invoiceNumber	O	String	운송장번호
shipmentBoxId	O	Number	배송번호 재배송을 위한 배송번호 입고확인 처리 후 교환요청목록 조회 시 deliveryInvoiceGroupDtos 정보 아래에, 새로 생성된 shipmentBoxId를 입력해야합니다.

Request Example

[
  {
    "exchangeId": "100000170",
    "vendorId": "A00012345",
    "shipmentBoxId": "123456789012345678",
    "goodsDeliveryCode": "CJGLS",
    "invoiceNumber": "680405450931"
  }
]

Response Message

Name		Type	Description
code		Number	결과 코드
message		String	메시지
data		Object	리턴된 결과
	resultCode	String	SUCCESS or FAIL
	resultMessage	String	결과메시지

Response Example

{
  "code": "200",
  "message": "SUCCESS",
  "data": {
    "resultCode": "SUCCESS",
    "resultMessage": "Invoice number save successfully"
  }
}

Error Spec

HTTP 상태 코드(오류 유형)	오류 메시지	해결 방법
400 (요청변수확인)	params are not allowed null...	파라메터 값을 모두 입력했는지 확인합니다.

URL API Name

UPDATE_INVOICE_EXCHANGE_REQUEST

교환상품 송장 업로드 처리

요약

상세