업체 코드를 통해 반품지를 조회한다.
Path
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnShippingCenters
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/returnShippingCenters?pageNum=1&pageSize=50
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||
Query String Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| pageNum | Number |
페이지 수
기본값 1
|
|||||
| pageSize | Number |
페이지당 건수
기본값 10, 최대값 50
|
|||||
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": "SUCCESS",
"data": {
"content": [
{
"vendorId": "A00012345",
"returnCenterCode": "1000557004",
"shippingPlaceName": "32777 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": 1581195908000,
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": 3000,
"vendorCreditFee10kg": 3000,
"vendorCreditFee20kg": 3000,
"vendorCashFee02kg": null,
"vendorCashFee05kg": 3000,
"vendorCashFee10kg": 3000,
"vendorCashFee20kg": 3000,
"consumerCashFee02kg": null,
"consumerCashFee05kg": 3000,
"consumerCashFee10kg": 3000,
"consumerCashFee20kg": 3000,
"returnFee02kg": null,
"returnFee05kg": 3000,
"returnFee10kg": 3000,
"returnFee20kg": 3000,
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "02-111-1111",
"phoneNumber2": "000-0000-0000",
"returnZipCode": "42701",
"returnAddress": "대구시 달서구 성서공단로",
"returnAddressDetail": "235"
}
]
},
{
"vendorId": "A00012345",
"returnCenterCode": "1000557003",
"shippingPlaceName": "32776 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": 1581195906000,
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": 3000,
"vendorCreditFee10kg": 3000,
"vendorCreditFee20kg": 3000,
"vendorCashFee02kg": null,
"vendorCashFee05kg": 3000,
"vendorCashFee10kg": 3000,
"vendorCashFee20kg": 3000,
"consumerCashFee02kg": null,
"consumerCashFee05kg": 3000,
"consumerCashFee10kg": 3000,
"consumerCashFee20kg": 3000,
"returnFee02kg": null,
"returnFee05kg": 3000,
"returnFee10kg": 3000,
"returnFee20kg": 3000,
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "010-9857-****",
"phoneNumber2": "010-9857-****",
"returnZipCode": "28805",
"returnAddress": "충청북도 청주시 서원구 장성동",
"returnAddressDetail": "111"
}
]
},
{
"vendorId": "A00012345",
"returnCenterCode": "1000555466",
"shippingPlaceName": "27487 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": 1580795274000,
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": 3000,
"vendorCreditFee10kg": 3000,
"vendorCreditFee20kg": 3000,
"vendorCashFee02kg": null,
"vendorCashFee05kg": 3000,
"vendorCashFee10kg": 3000,
"vendorCashFee20kg": 3000,
"consumerCashFee02kg": null,
"consumerCashFee05kg": 3000,
"consumerCashFee10kg": 3000,
"consumerCashFee20kg": 3000,
"returnFee02kg": null,
"returnFee05kg": 3000,
"returnFee10kg": 3000,
"returnFee20kg": 3000,
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "02-722-****",
"phoneNumber2": "000-0000-0000",
"returnZipCode": "12615",
"returnAddress": "경기도 여주시 북내면 가정1길",
"returnAddressDetail": "62 (가정리)"
}
]
},
{
"vendorId": "A00012345",
"returnCenterCode": "1000552893",
"shippingPlaceName": "32759 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": 1579813508000,
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": 3000,
"vendorCreditFee10kg": 3000,
"vendorCreditFee20kg": 3000,
"vendorCashFee02kg": null,
"vendorCashFee05kg": 3000,
"vendorCashFee10kg": 3000,
"vendorCashFee20kg": 3000,
"consumerCashFee02kg": null,
"consumerCashFee05kg": 3000,
"consumerCashFee10kg": 3000,
"consumerCashFee20kg": 3000,
"returnFee02kg": null,
"returnFee05kg": 3000,
"returnFee10kg": 3000,
"returnFee20kg": 3000,
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "000-1588-0***",
"phoneNumber2": "000-0000-0000",
"returnZipCode": "07345",
"returnAddress": "서울시 영등포구 63로",
"returnAddressDetail": "50 "
}
]
}
],
"pagination": {
"currentPage": 1,
"totalPages": 749,
"totalElements": 7488,
"countPerPage": 10
}
}
}
Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | The vendorId in path or requestBody doesn't match the one got from api-gateway. | 판매자ID(VendorId)가 올바로 입력됐는지 확인합니다. |
| 500 (서버오류) | Read timed out | 조회기간을 줄여서 일정시간 이후 재호출합니다. 관련 FAQ 클릭! |
URL API Name
GET_SHIPPING_CENTER_BY_VENDOR