创建发货地址。您可通过该API创建多个发货地,所创建的发货地将被指定为注册商品时使用的的发货地。
创建相同地址的发货地会受限。
创建/修改发货地时,请将usable参数值设置为true (use)。
Path
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/outboundShippingCenters
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/outboundShippingCenters
Request Parameters
Path Segment Parameter
Name | Required | Type | Description | |||
---|---|---|---|---|---|---|
vendorId | O | String |
卖家ID 酷澎提供给卖家的固有代码 例) A00012345 |
Body Parameter
Name | Required | Type | Description | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
vendorId | O | String |
卖家ID 酷澎提供给卖家的固有代码 例) A00012345 |
|||||||||||
userId | O | String |
用户ID (酷澎Wing登录账户) |
|||||||||||
shippingPlaceName | O | String |
发货地名称,最多50个字符 不可重复注册相同名称的发货地 |
|||||||||||
0usable | boolean |
是否可用
默认值: true |
||||||||||||
global | boolean |
默认值: false 国内或海外
|
||||||||||||
placeAddresses | O | Array |
发货地址
|
|||||||||||
addressType | String |
地址类型 JIBUN, ROADNAME, OVERSEA
注册道路名时,请务必一并注册地区编号
|
||||||||||||
countryCode | String |
国家代码,韩国国内为“KR”, 有效长度: 2
|
||||||||||||
companyContactNumber | String |
话号码,例:xx-yyy-zzzz
|
||||||||||||
phoneNumber2 | String |
备用电话号码(格式:与电话号码相同) |
||||||||||||
returnZipCode | String |
邮政编码: 数字,最短5位数,最长6位数 |
||||||||||||
returnAddress | String |
地址,最长150个字符 |
||||||||||||
returnAddressDetail | String |
详细住址,最长200个字符 |
||||||||||||
remoteInfos | Array |
偏远地区额外信息 |
||||||||||||
deliveryCode | String | |||||||||||||
jeju | Number |
济州岛运费(韩元)
例外:EPOST快递可填0或100 - 400KRW 之间(以KRW 100为单位); 不包括货到付款。 |
||||||||||||
notJeju | Number |
济州地区外的配送费(韩元) 与济州地区相同 |
Request Example
{
"vendorId": "A00011620",
"userId": "testId",
"shippingPlaceName": "상품출고지 생성",
"global": "false",
"usable": "true",
"placeAddresses": [
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "02-1234-5678",
"phoneNumber2": "010-1234-5678",
"returnZipCode": "10516",
"returnAddress": "경기도 파주시 탄현면 월롱산로",
"returnAddressDetail": "294-58"
}
],
"remoteInfos": [
{
"deliveryCode": "KGB",
"jeju": "5000",
"notJeju": "2500"
},
{
"deliveryCode": "CJGLS",
"jeju": "5000",
"notJeju": "2500"
}
]
}
Response Message
Name | Type | Description | |||
---|---|---|---|---|---|
code | Number |
服务器响应码 |
|||
message | String |
服务器响应消息 |
|||
data | Object |
发货地创建结果 |
|||
resultCode | String |
结果代码 SUCCESS or FAIL |
|||
resultMessage | String |
结果信息(发货地代码) 显示为outbound shipping place code 可通过该代码查看发货地列表 |
Response Example
{
"code": "200",
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "115"
}
}
Error Spec
HTTP status code (type of error) | Error message | Solution |
---|---|---|
400 (确认请求参数)
|
You can enter KRW 0 or between KRW 100 - 400 |
如果是 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数值范围是否正确 。偏远地区配送费请输入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值是否符合格式要求。须包含'-',且为11~14个字符。 |
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 字段值是否输入正确。正确格式为9-13位数字,包括 '-' |
500 (确认请求参数) |
shipping-places create error. |
请确认输入的物流公司合同代码(contractNumber)数值是否正确。 |
URL API Name
REGISTER_OUTBOUND_SHIPPING_CENTER