Return Request by Vendor
Vendor 측으로 반품 접수가 된 경우 쿠팡으로 반품 정보를 전송하기 위한 API 입니다.
- API 호출 방향 : Vendor -> Coupang
- URL : /v1/3pfl/return/request
- Interface Style : Restful API
- HTTP Protocol : HTTPS
- Method : POST
Request Body
| Property Name | Parent Object | Data Type | Size | Mandatory | Description |
| orderNumber | Root | Long | Y | 주문번호 | |
| invoiceNumber | Root | String | Y | 상품 송장 번호 (한 제품이 여러개의 송장 번호를 가질 경우 대표 번호) | |
| vendorItemId | Root | Long | Y | ||
| reasonCode | Root | String | Y | 업체 반품 접수 사유 코드 | |
| reasonMessage | Root | String | Y | 업체 반품 접수 사유 메시지 | |
| customerAddress1 | Root | String | Y | 회수지 기본 주소 | |
| customerAddress2 | Root | String | Y | 회수지 상세 주소 | |
| customerZipCode | Root | String | Y | 회수지 우편번호 | |
| customerMobile | Root | String | Y | 고객 모바일 번호 | |
| customerPhone | Root | String | Y | 고객 전화 번호 | |
| customerName | Root | String | Y | 고객 이름 | |
| requestType | Root | String | Y |
반품 접수 타입 enum COLLECT : 회수 필요 |
|
| instantReturn | Root | Boolean | Y |
고객이 받지 않은 상태 (수취 전 또는 수취거부)로 반품 |
|
| shippingCompanyId | Root | String | Y |
회수 업체 아이디 |
Request Example
{
"orderNumber": 10012345678,
"invoiceNumber": "1234567890",
"vendorItemId": 88000001,
"reasonCode": "80",
"reasonMessage": "반품 사유 메시지",
"customerAddress1": "회수지 주소",
"customerAddress2": "회수지 상세 주소",
"customerZipCode": "01010",
"customerMobile": "01000000000",
"customerPhone": "01000000000",
"customerName": "고객명",
"requestType": "COLLECT",
"instantReturn": false,
"shippingCompanyId": "SHIPPING_COMPANY"
}
Response
| Property Name | Data Type | Size | Mandatory | Description |
| code | String | 20 | N | 결과값
|
| message | String | 100 | N | 에러 사유 |
| data | String/Object | - | N | Response Data |
Response Example
{
"code": "0",
"message": null,
"data": null
}
유의사항
- requestType은 꼭 COLLECT로 보내주세요.
- 만약 회수 프로세스가 없다면, 이후 Vendor -> Coupang 회수요청 API를 받았을 때, 회수 트래킹만 보내도록 업체쪽에 설계되어 있으면 됩니다.
- Summary
- Vendor -> Coupang COLLECTING 상태로 업체반품요청
- Coupang -> Vendor 업체 회수 지시
- Vendor -> Coupang 회수 트래킹 COLLECTING/COLLECTING_COMPLETE로 전달