API 적용 가능한 구매자 사용자 지역: 한국, 대만
Path
PUT
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters/1100044653
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345 |
||||
| returnCenterCode | O | Number | 반품지 코드 |
||||
Body Parameter
| Name | Required | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345 |
||||||||||||
| returnCenterCode | O | Number | 반품지 코드 |
||||||||||||
| userId | O | String | 사용자 ID(쿠팡 WING ID) |
||||||||||||
| shippingPlaceName | String |
반품지 이름
"null"인 경우, 반품지이름은 변하지 않습니다
|
|||||||||||||
| usable | boolean |
사용 가능 여부
사용하지 않는 반품지를 사용안함처리 할 수 있습니다.
단 해당 반품지를 사용하고 있는 상품 정보도 함께 수정해주셔야 합니다.
|
|||||||||||||
| placeAddresses | O | Array | 반품지 주소 |
||||||||||||
| addressType | String |
주소 타입
JIBUN, JIBUN&ROADNAME
|
|||||||||||||
| companyContactNumber | String |
전화번호, e.g. : xx-yyy-zzzz,
|
|||||||||||||
| phoneNumber2 | String | 보조 전화번호 (형식 : 전화번호1과 같습니다) |
|||||||||||||
| returnZipCode | String | 우편번호 : 숫자, 최소길이 5, 최대길이 6 |
|||||||||||||
| returnAddress | String | 주소, 최대길이는 150 |
|||||||||||||
| returnAddressDetail | String | 상세주소, 최대길이는 200 |
|||||||||||||
| goodsflowInfoDto | O | Object | 굿스플로 택배 연동 정보 |
||||||||||||
| vendorCreditFee05kg | Number |
상품이 5kg일때의 신용요금 (판매자 신용)
0보다 커야합니다
해당 항목은 따로 사용하는 곳이 없기에 상품등록API에서 입력하는 반품배송비로 입력 대상:vendorCreditFee05kg~returnFee20kg
|
|||||||||||||
| vendorCreditFee10kg | Number |
상품이 10kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
|
|||||||||||||
| vendorCreditFee20kg | Number |
상품이 20kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
|
|||||||||||||
| vendorCashFee05kg | Number |
상품이 5kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
|||||||||||||
| vendorCashFee10kg | Number |
상품이 10kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
|||||||||||||
| vendorCashFee20kg | Number |
상품이 20kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
|||||||||||||
| consumerCashFee05kg | Number |
상품이 5kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
|||||||||||||
| consumerCashFee10kg | Number |
상품이 10kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
|||||||||||||
| consumerCashFee20kg | Number |
상품이 20kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
|||||||||||||
| returnFee05kg | Number |
상품이 5kg일때의 반품비
0보다 커야합니다.
|
|||||||||||||
| returnFee10kg | Number |
상품이 10kg일때의 반품비
0보다 커야합니다.
|
|||||||||||||
| returnFee20kg | Number |
상품이 20kg일때의 반품비
0보다 커야합니다.
|
|||||||||||||
Request Example
{
"userId":"testId",
"vendorId":"A00012345",
"returnCenterCode":"1000558900",
"shippingPlaceName":"반품지 -20200214-2modi",
"usable":"true",
"goodsflowInfoOpenApiDto":{
"deliverCode":"CJGLS",
"vendorCreditFee05kg":"2500",
"vendorCreditFee10kg":"2500",
"vendorCreditFee20kg":"2500",
"vendorCashFee05kg":"2500",
"vendorCashFee10kg":"2500",
"vendorCashFee20kg":"2500",
"consumerCashFee05kg":"2500",
"consumerCashFee10kg":"2500",
"consumerCashFee20kg":"2500",
"returnFee05kg":"2500",
"returnFee10kg":"2500",
"returnFee20kg":"2500"
},
"placeAddresses": [{
"addressType":"JIBUN",
"companyContactNumber":"070-****-8008",
"phoneNumber2":"010-****-7993",
"returnZipCode":"110794",
"returnAddress":"서울특별시 종로구 인사동5길 25 (인사동)",
"returnAddressDetail":"하나로빌딩"
}]
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number | 서버 응답 코드 |
||||
| message | String | 서버 응답 메시지 |
||||
| data | Array | 반품지 수정 결과 |
||||
| resultCode | String |
결과 코드
SUCCESS or FAIL
|
||||
| resultMessage | String | 결과 메시지 |
||||
Response Example
{
"code": 200,
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Modify successfully"
}
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | params are not allowed null... | 판매자ID(vendorId), 반품지코드(returnCenterCode), 사용자ID(userId)의 입력값이 누락되지 않았는지 확인합니다. |
| 400 (요청변수확인) | 이미 등록된 주소지명이 있습니다 (중복 주소지 코드:1000*******) | 동일한 반품지이름(shippingPlaceName)의 반품지가 이미 등록되었는지 확인합니다. 반품지를 중복 등록하지 않도록 처리합니다. |
| 400 (요청변수확인) | Please input the correct phone number format including numbers and '-' (min 9, max 13) | companyContactNumber 또는 phoneNumber2 값을 올바른 형식의 전화번호로 입력했는지 확인합니다. '-'를 포함하여 최소 9자 이상 최대 13자 이하로 입력합니다. |
URL API Name
UPDATE_SHIPPING_CENTER_BY_RETURN_CENTER_CODE