/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCentersv1建立發貨地址
簡介
API 適用的买方用户區域：韓國、台灣 建立發貨地址。您可透過該API建立多個發貨地，所建立的發貨地將被指定為註冊商品時使用的的發貨地。 建立相同地址的發貨地會受限。 建立/修改發貨地時，請將usable引數值設定為true (use)。
詳細內容
API 適用的买方用户區域：韓國、台灣
建立發貨地址。您可透過該API建立多個發貨地，所建立的發貨地將被指定為註冊商品時使用的的發貨地。
建立相同地址的發貨地會受限。
建立/修改發貨地時，請將usable引數值設定為true (use)。
路徑
POST
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters
示例
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/outboundShippingCenters
請求引數
路徑引數
| 名稱 | 是否必須 | 型別 | 描述 |
| vendorId | O | String |
賣家ID 酷澎提供給賣家的固有程式碼 例) A00012345 |
請求體引數
| 名稱 | 是否必須 | 型別 | 描述 | ||||||||||||
| vendorId | O | String |
賣家ID 酷澎提供給賣家的固有程式碼 例) A00012345 |
||||||||||||
| userId | O | String | 使用者ID (酷澎Wing登入賬戶) | ||||||||||||
| shippingPlaceName | O | String |
發貨地名稱，最多50個字元 不可重複註冊相同名稱的發貨地 |
||||||||||||
| usable | boolean |
是否可用
預設值: true |
|||||||||||||
| global | boolean |
預設值: false 國內或海外
|
|||||||||||||
| placeAddresses | O | Array | 發貨地址 | ||||||||||||
| addressType | String |
地址型別 JIBUN, ROADNAME, OVERSEA
註冊道路名時，請務必一併註冊地區編號 |
|||||||||||||
| countryCode | String | 國家程式碼（符合ISO-3166標準 ），有效長度: 2 。例如：韓國國內為“KR”, 臺灣地區為 “TW” | |||||||||||||
| companyContactNumber | String | 電話號碼 (格式需符合E.164標準) | |||||||||||||
| phoneNumber2 | String | 備用電話號碼(格式：與電話號碼相同) | |||||||||||||
| returnZipCode | String | 郵政編碼: 數字，最短5位數，最長6位數 | |||||||||||||
| returnAddress | String | 地址，最長150個字元 | |||||||||||||
| returnAddressDetail | String | 詳細住址，最長200個字元 | |||||||||||||
| remoteInfos | Array | 偏遠地區額外資訊 | |||||||||||||
| deliveryCode | String |
物流程式碼 查看物流程式碼 可註冊多個物流公司，但不可重複註冊 |
|||||||||||||
| jeju | Object |
濟州島運費 當currencyCode是KRW時：您可以輸入0或1,000-8,000之間的費用（以100韓元為單位）； 不包括貨到付款。 例外：EPOST快遞可填0或100 - 400KRW 之間（以KRW 100為單位）； 不包括貨到付款。 |
|||||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | |||||||||||||
| units | Number | 貨幣整數部分，64-bit | |||||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | |||||||||||||
| notJeju | Object |
濟州地區外的配送費(韓元) 與濟州地區相同 |
|||||||||||||
| currencyCode | String | 貨幣程式碼（符合ISO-4217標準），3位大寫字元 | |||||||||||||
| units | Number | 貨幣整數部分，64-bit | |||||||||||||
| nanos | Number | 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999] | |||||||||||||
請求體示例
{
"vendorId": "A00011620",
"userId": "testId",
"shippingPlaceName": "상품출고지 생성",
"global": "false",
"usable": "true",
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "+1(555)444-1234",
"phoneNumber2": "+1(555)444-1234",
"returnZipCode": "10516",
"returnAddress": "경기도 파주시 탄현면 월롱산로",
"returnAddressDetail": "294-58"
}
],
"remoteInfos": [
{
"deliveryCode": "KGB",
"jeju": {
"currencyCode": "KRW",
"units": 5000,
"nanos": 0
},
"notJeju": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
}
},
{
"deliveryCode": "CJGLS",
"jeju": {
"currencyCode": "KRW",
"units": 5000,
"nanos": 0
},
"notJeju": {
"currencyCode": "KRW",
"units": 2500,
"nanos": 0
}
}
]
}
返回消息
| 名稱 | 型別 | 描述 | |
| code | Number | 伺服器響應碼 | |
| message | String | 伺服器響應訊息 | |
| data | Object | 發貨地建立結果 | |
| resultCode | String |
結果程式碼 SUCCESS or FAIL |
|
| resultMessage | String |
結果資訊(發貨地程式碼) 顯示為outbound shipping place code 可透過該程式碼檢視發貨地列表 |
|
返回訊息示例
{
"code": "200",
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "115"
}
}
錯誤程式碼
| HTTP狀態程式碼(錯誤型別) | 錯誤資訊 | 解決方案 |
|---|---|---|
|
400 (確認請求引數)
|
You can enter KRW 0 or between KRW 100 - 400 | 當currencyCode是KRW時，如果是 EPOST 快遞，請確保輸入0 KRW 或100 - 400 KRW之間 |
| 400 (確認請求引數) | Post code can't be empty | 請確認是否輸入了returnZipCode值。 |
| 400 (重複輸入) | [發貨地重複] 該地址已被登入。(重複地址程式碼: 2026xxxx) | 請確認是否輸入過相同的returnAddress 值。 |
| 400 (重複輸入) | [發貨地重複] Duplicated request. 公司名:xxxxx | 請確認是否輸入過相同的shippingPlaceName值。 |
| 400 (確認請求引數) | 運費可為0韓元或1000～20000韓元。 | 請確認您輸入的jeju, notJeju數值範圍是否正確 。當currencyCode是KRW時，偏遠地區配送費請輸入0韓元或1,000～20,000韓元。 |
| 400 (確認請求引數) | The format of postal code is invalid, it can only be number | 請為 returnZipCode值輸入非數字字元。 |
| 400 (確認請求引數) | params are not allowed null... | 請確認是否輸入了null 值。 |
| 400 (確認請求引數) | params's vendorId not equals gateway's vendorId! | 請確認您輸入的 vendorId是否正確。 |
| 400 (確認請求引數) | The max length of the shipping place name is 50, please input the correct length name | 請確認shippingPlaceName值是否小於50個字元。 |
| 400 (確認請求引數) | The address detail info can't be null(placeAddress) | 請確認是否輸入了returnAddress值。 |
| 400 (確認請求引數) | Must input the default phone number(phoneNumber1) | 請確認是否輸入了phoneNumber1值。 |
| 400 (確認請求引數) | Must input the default address(address1) | 請確認是否輸入了returnAddress值。 |
| 400 (確認請求引數) | The length of country code is 2, please input correct length country code | 請確認您輸入的countryCode值是否正確。 |
| 400 (確認請求引數) | The format of phone number is invalid, min length is 11 and max length is 14 | |
| 400 (確認請求引數) | include the character '-' | 請確認您輸入的companyContactNumber值是否符合格式要求。正確格式需符合E.164標準。 |
| 400 (確認請求引數) | The format of postal code is invalid, it can only be number, min length is 5 and max length is 6 | 請確認您輸入的returnZipCode值是否正確。請輸入5～6個數字。 |
| 400 (確認請求引數) | Please input the correct phone number format including numbers and '-' (min 9, max 13) | 請檢查companyContactNumber 或者 phoneNumber2 欄位值是否輸入正確。正確格式需符合E.164標準 。 |
| 500 (確認請求引數) | shipping-places create error. | 請確認輸入的物流公司合同程式碼(contractNumber)數值是否正確。 |
介面名稱
REGISTER_OUTBOUND_SHIPPING_CENTER