GET
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters2609170000透過賣家程式碼查詢退貨地
KRTW
# 01
簡介
透過賣家程式碼查詢退貨地
# 02
詳細內容
API 適用區域：韓國、台灣
透過賣家程式碼查詢退貨地
路徑
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters
範例端點
https://api-gateway.coupang.com/v5/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters?pageNum=1&pageSize=50# 03
Path 參數
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 賣家ID 酷澎提供給賣家的固有程式碼 例) A00012345 |
| vendorId* | string | 賣家ID 酷澎提供給賣家的固有程式碼 例) A00012345 |
# 04
Query 參數
| Name | Type | Description |
|---|---|---|
| pageNum | number | 頁數 預設值1 |
| pageSize | number | 每頁訂單數 預設值10，最大值50 |
| pageNum | number | 頁數 預設值1 |
| pageSize | number | 每頁訂單數 預設值10，最大值50 |
# 05
回應內容
回應訊息
| Name | Type | Description |
|---|---|---|
| code | integer | 伺服器響應碼
|
| message | string | 伺服器響應訊息
|
| data | object | 退貨地陣列資料
|
| content data.content | object[] | |
| vendorId data.content[].vendorId | string | |
| returnCenterCode data.content[].returnCenterCode | string | |
| shippingPlaceName data.content[].shippingPlaceName | string | |
| deliverCode data.content[].deliverCode | string | |
| deliverName data.content[].deliverName | string | |
| goodsflowStatus data.content[].goodsflowStatus | string | |
| errorMessage data.content[].errorMessage | string | |
| createdAt data.content[].createdAt | string | |
| vendorCreditFee02kg data.content[].vendorCreditFee02kg | string | |
| vendorCreditFee05kg data.content[].vendorCreditFee05kg | object | |
| currencyCode data.content[].vendorCreditFee05kg.currencyCode | string | |
| units data.content[].vendorCreditFee05kg.units | integer | |
| nanos data.content[].vendorCreditFee05kg.nanos | integer | |
| vendorCreditFee10kg data.content[].vendorCreditFee10kg | object | |
| currencyCode data.content[].vendorCreditFee10kg.currencyCode | string | |
| units data.content[].vendorCreditFee10kg.units | integer | |
| nanos data.content[].vendorCreditFee10kg.nanos | integer | |
| vendorCreditFee20kg data.content[].vendorCreditFee20kg | object | |
| currencyCode data.content[].vendorCreditFee20kg.currencyCode | string | |
| units data.content[].vendorCreditFee20kg.units | integer | |
| nanos data.content[].vendorCreditFee20kg.nanos | integer | |
| vendorCashFee02kg data.content[].vendorCashFee02kg | string | |
| vendorCashFee05kg data.content[].vendorCashFee05kg | object | |
| currencyCode data.content[].vendorCashFee05kg.currencyCode | string | |
| units data.content[].vendorCashFee05kg.units | integer | |
| nanos data.content[].vendorCashFee05kg.nanos | integer | |
| vendorCashFee10kg data.content[].vendorCashFee10kg | object | |
| currencyCode data.content[].vendorCashFee10kg.currencyCode | string | |
| units data.content[].vendorCashFee10kg.units | integer | |
| nanos data.content[].vendorCashFee10kg.nanos | integer | |
| vendorCashFee20kg data.content[].vendorCashFee20kg | object | |
| currencyCode data.content[].vendorCashFee20kg.currencyCode | string | |
| units data.content[].vendorCashFee20kg.units | integer | |
| nanos data.content[].vendorCashFee20kg.nanos | integer | |
| consumerCashFee02kg data.content[].consumerCashFee02kg | string | |
| consumerCashFee05kg data.content[].consumerCashFee05kg | object | |
| currencyCode data.content[].consumerCashFee05kg.currencyCode | string | |
| units data.content[].consumerCashFee05kg.units | integer | |
| nanos data.content[].consumerCashFee05kg.nanos | integer | |
| consumerCashFee10kg data.content[].consumerCashFee10kg | object | |
| currencyCode data.content[].consumerCashFee10kg.currencyCode | string | |
| units data.content[].consumerCashFee10kg.units | integer | |
| nanos data.content[].consumerCashFee10kg.nanos | integer | |
| consumerCashFee20kg data.content[].consumerCashFee20kg | object | |
| currencyCode data.content[].consumerCashFee20kg.currencyCode | string | |
| units data.content[].consumerCashFee20kg.units | integer | |
| nanos data.content[].consumerCashFee20kg.nanos | integer | |
| returnFee02kg data.content[].returnFee02kg | string | |
| returnFee05kg data.content[].returnFee05kg | object | |
| currencyCode data.content[].returnFee05kg.currencyCode | string | |
| units data.content[].returnFee05kg.units | integer | |
| nanos data.content[].returnFee05kg.nanos | integer | |
| returnFee10kg data.content[].returnFee10kg | object | |
| currencyCode data.content[].returnFee10kg.currencyCode | string | |
| units data.content[].returnFee10kg.units | integer | |
| nanos data.content[].returnFee10kg.nanos | integer | |
| returnFee20kg data.content[].returnFee20kg | object | |
| currencyCode data.content[].returnFee20kg.currencyCode | string | |
| units data.content[].returnFee20kg.units | integer | |
| nanos data.content[].returnFee20kg.nanos | integer | |
| usable data.content[].usable | boolean | |
| placeAddresses data.content[].placeAddresses | object[] | |
| addressType data.content[].placeAddresses[].addressType | string | |
| countryCode data.content[].placeAddresses[].countryCode | string | |
| companyContactNumber data.content[].placeAddresses[].companyContactNumber | string | |
| phoneNumber2 data.content[].placeAddresses[].phoneNumber2 | string | |
| returnZipCode data.content[].placeAddresses[].returnZipCode | string | |
| returnAddress data.content[].placeAddresses[].returnAddress | string | |
| returnAddressDetail data.content[].placeAddresses[].returnAddressDetail | string | |
| pagination data.pagination | object | |
| currentPage data.pagination.currentPage | integer | |
| totalPages data.pagination.totalPages | integer | |
| totalElements data.pagination.totalElements | integer | |
| countPerPage data.pagination.countPerPage | integer |
Response Example
{
"code": 200,
"message": "SUCCESS",
"data": {
"content": [
{
"vendorId": "A00012345",
"returnCenterCode": "1000557004",
"shippingPlaceName": "32777 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": "2025-01-15T14:17:13.973885-08:00",
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee02kg": null,
"vendorCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee02kg": null,
"consumerCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee02kg": null,
"returnFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "+82101234567",
"phoneNumber2": "+82101234567",
"returnZipCode": "42701",
"returnAddress": "대구시 달서구 성서공단로",
"returnAddressDetail": "235"
}
]
},
{
"vendorId": "A00012345",
"returnCenterCode": "1000557003",
"shippingPlaceName": "32776 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": "2025-01-15T14:17:13.973885-08:00",
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee02kg": null,
"vendorCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee02kg": null,
"consumerCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee02kg": null,
"returnFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "+82101234567",
"phoneNumber2": "+82101234567",
"returnZipCode": "28805",
"returnAddress": "충청북도 청주시 서원구 장성동",
"returnAddressDetail": "111"
}
]
},
{
"vendorId": "A00012345",
"returnCenterCode": "1000555466",
"shippingPlaceName": "27487 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": "2025-01-15T14:17:13.973885-08:00",
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee02kg": null,
"vendorCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee02kg": null,
"consumerCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee02kg": null,
"returnFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "+82101234567",
"phoneNumber2": "+82101234567",
"returnZipCode": "12615",
"returnAddress": "경기도 여주시 북내면 가정1길",
"returnAddressDetail": "62 (가정리)"
}
]
},
{
"vendorId": "A00012345",
"returnCenterCode": "1000552893",
"shippingPlaceName": "32759 R",
"deliverCode": "HANJIN",
"deliverName": "한진택배",
"goodsflowStatus": "승인",
"errorMessage": "",
"createdAt": "2025-01-15T14:17:13.973885-08:00",
"vendorCreditFee02kg": null,
"vendorCreditFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCreditFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee02kg": null,
"vendorCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"vendorCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee02kg": null,
"consumerCashFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"consumerCashFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee02kg": null,
"returnFee05kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee10kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"returnFee20kg": {
"currencyCode": "KRW",
"units": 3000,
"nanos": 0
},
"usable": true,
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "+82101234567",
"phoneNumber2": "+82101234567",
"returnZipCode": "07345",
"returnAddress": "서울시 영등포구 63로",
"returnAddressDetail": "50 "
}
]
}
],
"pagination": {
"currentPage": 1,
"totalPages": 749,
"totalElements": 7488,
"countPerPage": 10
}
}
}# 06
錯誤碼
| HTTP | 代碼 | 訊息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
錯誤說明
| HTTP | 類型 | 錯誤訊息 | 解決方案 |
|---|---|---|---|
| 400 | 400 (確認請求引數) | The vendorId in path or requestBody doesn't match the one got from api-gateway. | 請確認您輸入的賣家ID(VendorId)是否正確。 |
| 500 | 500 (伺服器錯誤) | Read timed out | 請縮短查詢時間段後重試。 |