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
請求引數
路徑引數
| 名稱 | 是否必須 | 型別 | 描述 |
| vendorId | O | String |
賣家ID 酷澎提供給賣家的固有程式碼 例) A00012345 |
查詢引數
| 名稱 | 是否必須 | 型別 | 描述 |
| pageNum | Number |
頁數 預設值1 |
|
| pageSize | Number |
每頁訂單數 預設值10，最大值50 |
請求體例子
無
返回訊息
| 名稱 | 型別 | 描述 | ||||||||||
| code | Number | 伺服器響應碼 | ||||||||||
| message | String | 伺服器響應訊息 | ||||||||||
| data | Array | 退貨地陣列資料 | ||||||||||
| vendorId | String | 賣家程式碼 | ||||||||||
| returnCenterCode | String | 退貨中心程式碼 | ||||||||||
| shippingPlaceName | String | 退貨地名稱 | ||||||||||
| deliverCode | String | 物流公司程式碼 | ||||||||||
| deliverName | String | 物流公司名稱 | ||||||||||
| goodsflowStatus | String | 物流狀態 | ||||||||||
| errorMessage | String | 錯誤資訊 | ||||||||||
| createAt | String |
建立日期 (符合ISO-8601標準) 格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
||||||||||
| vendorCreditFee02kg | Object |
商品重量為 2kg時的信用費(賣家信用) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCreditFee05kg | Object |
商品重量為 5kg時的信用費(賣家信用) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCreditFee10kg | Object |
商品重量為 10kg時的信用費(賣家信用) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCreditFee20kg | Object |
商品重量為 20kg時的信用費(賣家信用) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCashFee02kg | Object |
商品重量為 2kg時的預付費用(賣家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCashFee05kg | Object |
商品重量為 5kg時的預付費用(賣家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCashFee10kg | Object |
商品重量為 10kg時的預付費用(賣家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| vendorCashFee20kg | Object |
商品重量為 20kg時的預付費用(賣家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| consumerCashFee02kg | Object |
商品重量為 2kg時的貨到付款費用(買家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| consumerCashFee05kg | Object |
商品重量為 5kg時的貨到付款費用(買家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| consumerCashFee10kg | Object |
商品重量為 10kg時的貨到付款費用(買家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| consumerCashFee20kg | Object |
商品重量為 20kg時的貨到付款費用(買家現金) 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| returnFee02kg | Object |
商品重量為 2kg時的退貨費 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| returnFee05kg | Object |
商品重量為 5kg時的退貨費 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| returnFee10kg | Object |
商品重量為 10kg時的退貨費 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| returnFee20kg | Object |
商品重量為 20kg時的退貨費 必須大於 0。 |
||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | ||||||||||
| units | Number | 貨幣整數部分，64-bit | ||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | ||||||||||
| usable | boolean | 是否必須 | ||||||||||
| placeAddresses | Array | 退貨地址 | ||||||||||
| addressType | String |
地址型別 JIBUN, JIBUN&ROADNAME
|
||||||||||
| countryCode | String | 國家程式碼（符合ISO-3166標準），有效長度: 2 。例子：韓國國內為“KR”, 臺灣地區為 “TW” | ||||||||||
| companyContactNumber | String | 退貨地電話號碼 (格式需符合E.164標準) | ||||||||||
| phoneNumber2 | String | 備用電話號碼 (格式需符合E.164標準) | ||||||||||
| returnZipCode | String | 退貨地郵政編碼 | ||||||||||
| returnAddress | String | 退貨地址 | ||||||||||
| returnAddressDetail | String | 退貨地詳細地址 | ||||||||||
返回訊息例子
{
"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
}
}
}錯誤程式碼
| HTTP狀態程式碼(錯誤型別) | 錯誤資訊 | 解決方案 |
| 400 (確認請求引數) | The vendorId in path or requestBody doesn't match the one got from api-gateway. | 請確認您輸入的賣家ID(VendorId)是否正確。 |
| 500 (伺服器錯誤) | Read timed out |
請縮短查詢時間段後重試。 |
介面名稱
GET_SHIPPING_CENTER_BY_VENDOR