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。 ex) 1000554021,1000554704 |
||||
Request Example
Response Message
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
服务器响应代码 |
||||||||||
| message | String |
服务器响应信息 |
||||||||||
| data | Array |
退货地址信息 |
||||||||||
| vendorId | String |
卖家代码 |
||||||||||
| returnCenterCode | String |
退货地址中心代码 |
||||||||||
| shippingPlaceName | String |
退货地名 |
||||||||||
| deliverCode | String |
快递公司代码 |
||||||||||
| deliverName | String |
快递公司名 |
||||||||||
| goodsflowStatus | String |
Goodsflow状态 |
||||||||||
| errorMessage | String |
错误信息 |
||||||||||
| createAt | String |
创建日期 |
||||||||||
| vendorCreditFee02kg | Number |
商品重量为 2 kg时的信用费用（卖家信用） 必须大于 0。 |
||||||||||
| vendorCreditFee05kg | Number |
商品重量为 5kg时的信用费用（卖家信用） 必须大于 0。 |
||||||||||
| vendorCreditFee10kg | Number |
商品重量为 10 kg时的信用费用（卖家信用） 必须大于 0。 |
||||||||||
| vendorCreditFee20kg | Number |
商品重量为 20 kg时的信用费用（卖家信用） 必须大于 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 status code (error type) | Error message | How to resolve |
|---|---|---|
|
400 (check request parameter) |
中心代码不可为空... |
查看是否没有输入退货地址中心代码（returnCenterCodes）。 |
|
500 (server error) |
读取超时 |
查看退货地址时发生错误。稍后重试或更改输入值。 |
URL API Name
GET_SHIPPING_BY_CENTER_CODE