修改发货地址。
修改发货地址，需要outboundShippingPlaceCode及remoteInfoId。
您可通过“发货地查询”API获取outboundShippingPlaceCode及remoteInfoId
※ 注册收货地址时设定的国内或海外分类确定后，不能从国内更改为海外或从海外更改为国内。 如果您想更改国内和海外之间的划分，请重新注册一个新的收货地址.
Path
PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/outboundShippingCenters/123456
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
卖家ID 酷澎提供给卖家的固有代码 例) A00012345 |
||||
| outboundShippingPlaceCode | O | Number |
想要修改的发货地代码 |
||||
Body Parameter
| Name | Required | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| vendorId | O | String |
卖家ID 酷澎提供给卖家的固有代码 例) A00012345 |
||||||||||||
| userId | O | String |
用户ID (酷澎Wing登录账户) |
||||||||||||
| outboundShippingPlaceCode | Number |
发货地代码 如果为"null", 则发货地名称不变 |
|||||||||||||
| shippingPlaceName | String |
发货地名称 |
|||||||||||||
| usable | Boolean |
是否可用 |
|||||||||||||
| global | Boolean |
国内或海外
|
|||||||||||||
| placeAddresses | O | Array |
发货地址
|
||||||||||||
| addressType | String |
地址类型
|
|||||||||||||
| countryCode | String |
国家代码，韩国国内为“KR”, 有效长度: 2
|
|||||||||||||
| companyContactNumber | String |
电话号码，例：xx-yyy-zzzz
|
|||||||||||||
| phoneNumber2 | String |
备用电话号码(格式：与电话号码相同) |
|||||||||||||
| returnZipCode | String |
邮政编码: 数字，5～6位数 |
|||||||||||||
| returnAddress | String |
地址，最长150个字符 |
|||||||||||||
| returnAddressDetail | String |
详细住址，最长200个字符 |
|||||||||||||
| remoteInfos | Array |
偏远地区额外运费
|
|||||||||||||
| remoteInfoId | Number |
创建新的配送信息时无需填写该字段。 修改/删除配送信息时则必须输入。 您可通过查询 API 获取该字段的值。 |
|||||||||||||
| deliveryCode | String |
物流代码 可注册多个物流公司，但不可重复注册 |
|||||||||||||
| jeju | Number |
济州岛运费（韩元）
例外：EPOST快递可填0或100 - 400KRW 之间（以KRW 100为单位）； 不包括货到付款。 |
|||||||||||||
| notJeju | Number |
济州地区外的配送费(韩元) 与济州地区相同 |
|||||||||||||
| usable | Boolean |
是否使用 创建新的配送信息时无需填写此字段。 如果修改，设置为“true”。 如果删除，则设置为“false”。 |
|||||||||||||
Request Example
{
"vendorId": "A00012345",
"userId": "Test11",
"outboundShippingPlaceCode": 123456,
"shippingPlaceName": "테스트 출고지 코드",
"placeAddresses": [
{
"addressType": "ROADNAME",
"countryCode": "KR",
"companyContactNumber": "02-1111-1111",
"phoneNumber2": "",
"returnZipCode": "05510",
"returnAddress": "서울특별시 송파구 송파대로 570 (신천동)",
"returnAddressDetail": "테스트 주소 101동 101호"
},
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "02-1111-1111",
"phoneNumber2": "",
"returnZipCode": "05510",
"returnAddress": "서울특별시 송파구 신천동 7-30",
"returnAddressDetail": "테스트 주소 101동 101호"
}
],
"remoteInfos": [
{
"remoteInfoId": 176476,
"deliveryCode": "DONGBU",
"jeju": 0,
"notJeju": 0,
"usable": true
}
],
"usable": true
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
服务器响应状态码 |
||||
| message | String |
详细信息 |
||||
| data | Object |
|
||||
| resultCode | String |
代码 |
||||
| resultMessage | String |
消息 |
||||
Response Example
{
"code": "200",
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Modify successfully"
}
}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 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位数字，包括 '-' |
URL API Name
UPDATE_OUTBOUND_SHIPPING_PLACECODE