API 적용 가능한 구매자 사용자 지역: 한국, 대만
반품지 센터코드(returncenterCode)로 반품지 정보를 조회합니다.
Path
GET
/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code?returnCenterCodes=1000000051,1000006047
Request Parameters
Query String Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| returnCenterCodes | O | String |
반품지 센터코드
일괄 조회가능한 returnCenterCodes의
최대 개수는 100. 예) 1000554021,1000554704
|
||||
Request Example
not require body
Response Message
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
서버 응답 코드
|
||||||||||
| message | String |
서버 응답 메시지
|
||||||||||
| data | Array |
반품지 정보
|
||||||||||
| vendorId | String |
업체 코드
|
||||||||||
| returnCenterCode | String |
반품지 센터코드
|
||||||||||
| shippingPlaceName | String |
반품지 이름
|
||||||||||
| deliverCode | String |
택배사 코드
|
||||||||||
| deliverName | String |
택배사명
|
||||||||||
| goodsflowStatus | String |
굿스플로 상태
|
||||||||||
| errorMessage | String |
에러 메시지
|
||||||||||
| createAt | String |
생성일
|
||||||||||
| vendorCreditFee02kg | Number |
상품이 2kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
|
||||||||||
| vendorCreditFee05kg | Number |
상품이 5kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
|
||||||||||
| vendorCreditFee10kg | Number |
상품이 10kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
|
||||||||||
| vendorCreditFee20kg | Number |
상품이 20kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
|
||||||||||
| vendorCashFee02kg | Number |
상품이 2kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
||||||||||
| vendorCashFee05kg | Number |
상품이 5kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
||||||||||
| vendorCashFee10kg | Number |
상품이 10kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
||||||||||
| vendorCashFee20kg | Number |
상품이 20kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
|
||||||||||
| consumerCashFee02kg | Number |
상품이 2kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
||||||||||
| consumerCashFee05kg | Number |
상품이 5kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
||||||||||
| consumerCashFee10kg | Number |
상품이 10kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
||||||||||
| consumerCashFee20kg | Number |
상품이 20kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
|
||||||||||
| returnFee02kg | Number |
상품이 2kg일때의 반품비
0보다 커야합니다.
|
||||||||||
| returnFee05kg | Number |
상품이 5kg일때의 반품비
0보다 커야합니다.
|
||||||||||
| returnFee10kg | Number |
상품이 10kg일때의 반품비
0보다 커야합니다.
|
||||||||||
| returnFee20kg | Number |
상품이 20kg일때의 반품비
0보다 커야합니다.
|
||||||||||
| usable | boolean |
사용여부
|
||||||||||
| placeAddresses | Array |
반품지 주소
|
||||||||||
| addressType | String |
주소 타입
JIBUN, JIBUN&ROADNAME
|
||||||||||
| countryCode | String |
국가코드, 국내의 경우 "KR"
|
||||||||||
| companyContactNumber | String |
반품지 전화번호
|
||||||||||
| phoneNumber2 | String |
보조 전화번호
|
||||||||||
| returnZipCode | String |
반품지 우편번호
|
||||||||||
| returnAddress | String |
반품지 주소
|
||||||||||
| returnAddressDetail | String |
반품지 상세주소
|
||||||||||
Response Example
{
"code": 200,
"message": "OK",
"data": [
{
"vendorId": "A00123456",
"returnCenterCode": "1000552675",
"shippingPlaceName": "32757 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": 1579727107000,
"vendorCreditFee02kg": 3000,
"vendorCreditFee05kg": 3000,
"vendorCreditFee10kg": 3000,
"vendorCreditFee20kg": 3000,
"vendorCashFee02kg": 3000,
"vendorCashFee05kg": 3000,
"vendorCashFee10kg": 3000,
"vendorCashFee20kg": 3000,
"consumerCashFee02kg": 3000,
"consumerCashFee05kg": 3000,
"consumerCashFee10kg": 3000,
"consumerCashFee20kg": 3000,
"returnFee02kg": 3000,
"returnFee05kg": 3000,
"returnFee10kg": 3000,
"returnFee20kg": 3000,
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "051-261-6120",
"phoneNumber2": "000-0000-0000",
"returnZipCode": "49525",
"returnAddress": "부산시 사하구 다대로",
"returnAddressDetail": "613"
}
]
}
]
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | center code should not be empty... | 반품지 센터코드(returnCenterCodes) 입력이 누락되지 않았는지 확인합니다. |
| 500 (서버오류) | Read timed out | 반품지 조회 시 오류가 발생했습니다. 일정시간 이후 재호출 하거나 입력 값을 수정합니다. 관련 FAQ 클릭! |
URL API Name
GET_SHIPPING_BY_CENTER_CODE