API 適用的买方用户區域：韓國、台灣
更改退貨地址功能。
更改退貨地址時需要退貨地址程式碼（returnCenterCode），使用[檢視退貨地列表API獲取退貨地址程式碼
路徑
PUT
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
示例
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters/1100044653
請求引數
路徑引數
| 名稱 | 是否必須 | 型別 | 描述 |
| vendorId | O | String | 賣家ID 酷澎分配給賣家的固有程式碼 ex) A00012345 |
| returnCenterCode | O | Number | 退貨地址程式碼 |
請求體引數
| 名稱 | 是否必須 | 型別 | 描述 | ||||||||
| vendorId | O | String | 賣家ID 酷澎分配給賣家的固有程式碼 ex) A00012345 | ||||||||
| returnCenterCode | O | Number | 退貨地址程式碼 | ||||||||
| userId | O | String | 使用者ID(酷澎WING ID) | ||||||||
| shippingPlaceName | String | 退貨地名 如為"null,"則退貨地名不改變。 | |||||||||
| usable | boolean | 能否使用 ture/false | |||||||||
| placeAddresses | O | Array | 退貨地址 | ||||||||
| addressType | String | 地址型別
| |||||||||
| companyContactNumber | String | 手機號 (格式需符合E.164標準) | |||||||||
| . | phoneNumber2 | String | 備選電話號碼（格式和電話號碼1相同） | ||||||||
| returnZipCode | String | 郵編：數字，最短5個字元，最長6個字元 | |||||||||
| returnAddress | String | 地址，最長150個字元 | |||||||||
| returnAddressDetail | String | 詳細地址，最長200個字元 | |||||||||
| goodsflowInfoDto | O | Object | Goodflow 配送對接資訊 | ||||||||
| vendorCreditFee05kg | Object | 商品重量為 5kg時的信用費用（賣家信用） 必須大於 0。 該項無其它使用的地方， 輸入在商品註冊 API 中輸入的退貨運費。 物件: vendorCreditFee05kg~returnFee20kg | |||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | |||||||||
| units | Number | 貨幣整數部分，64-bit | |||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | |||||||||
| vendorCreditFee10kg | Object | 商品重量為 10 kg時的信用費用（賣家信用） 必須大於 0。 | |||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | |||||||||
| units | Number | 貨幣整數部分，64-bit | |||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | |||||||||
| vendorCreditFee20kg | Object | 商品重量為 20 kg時的信用費用（賣家信用） 必須大於 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] | |||||||||
| 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] | |||||||||
| 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] | |||||||||
請求體示例
{
"userId":"testId",
"vendorId":"A00012345",
"returnCenterCode":"1000558900",
"shippingPlaceName":"반품지 -20200214-2modi",
"usable":"true",
"goodsflowInfoOpenApiDto":{
"vendorCreditFee05kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"vendorCreditFee10kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"vendorCreditFee20kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"vendorCashFee05kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"vendorCashFee10kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"vendorCashFee20kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"consumerCashFee05kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"consumerCashFee10kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"consumerCashFee20kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"returnFee05kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"returnFee10kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
},
"returnFee20kg": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
}
},
"placeAddresses": [{
"addressType":"JIBUN",
"companyContactNumber":" +1(555)444-1234",
"phoneNumber2":"+1(555)444-1234",
"returnZipCode":"110794",
"returnAddress":"서울특별시 종로구 인사동5길 25 (인사동)",
"returnAddressDetail":"하나로빌딩"
}]
}
返回訊息
| 名稱 | 型別 | 描述 | |
| code | Number | 伺服器響應程式碼 | |
| message | String | 伺服器響應資訊 | |
| data | Array | 退貨地址更改結果 | |
| resultCode | String | 結果程式碼 SUCCESS or FAIL | |
| resultMessage | String | 結果資訊 | |
返回訊息示例
{
"code": 200,
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Modify successfully"
}
}
錯誤程式碼
| HTTP狀態代碼 (錯誤型別) | 錯誤訊息 | 解決方案 |
| 400 (check request parameter) | 引數不可為空... | 檢視是否沒有輸入賣家ID（vendorId）、退貨地址程式碼（returnCenterCode）、使用者ID（userId）的輸入值是否缺失。 |
| 400 (check request parameter) | 已有註冊的地址名(重複地址程式碼: 1000*******) | 檢視是否已註冊具有相同退貨地名 (shippingPlaceName) 的退貨地址。 請進行處理，使其不重複。 |
| 400 (確認請求引數) | Please input the correct phone number format including numbers and '-' (min 9, max 13) | 請檢查companyContactNumber 或者 phoneNumber2 欄位值是否輸入正確。正確格式需符合E.164標準。 |
介面名稱
UPDATE_SHIPPING_CENTER_BY_RETURN_CENTER_CODE