/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}v1更改退货地址
简介
API支持的买家用户地区：韩国、台湾 更改退货地址功能。
详细内容
Path
PUT
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters/1100044653
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
卖家ID 酷澎分配给卖家的固有代码 ex) A00012345 |
||||
| returnCenterCode | O | Number | 退货地址代码 | ||||
Body Parameter
| Name | Required | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
地址类型
JIBUN, JIBUN&ROADNAME
|
|||||||||||||
| companyContactNumber | String |
手机号, e.g.: xx-yyy-zzzz,
|
|||||||||||||
| phoneNumber2 | String | 备选电话号码（格式和电话号码1相同） | |||||||||||||
| returnZipCode | String | 邮编：数字，最短5个字符，最长6个字符 | |||||||||||||
| returnAddress | String | 地址，最长150个字符 | |||||||||||||
| returnAddressDetail | String | 详细地址，最长200个字符 | |||||||||||||
| goodsflowInfoDto | O | Object |
Goodflow 配送对接信息
|
||||||||||||
| vendorCreditFee05kg | Number |
商品重量为 5kg时的信用费用（卖家信用） 必须大于 0。 该项无其它使用的地方， 输入在商品注册 API 中输入的退货运费。 对象: vendorCreditFee05kg~returnFee20kg |
|||||||||||||
| vendorCreditFee10kg | Number |
商品重量为 10 kg时的信用费用（卖家信用） 必须大于 0。 |
|||||||||||||
| vendorCreditFee20kg | Number |
商品重量为 20 kg时的信用费用（卖家信用） 必须大于 0。 |
|||||||||||||
| vendorCashFee05kg | Number |
商品重量为5kg时的寄付现结费用（卖家现金） 必须大于 0。 |
|||||||||||||
| vendorCashFee10kg | Number |
商品重量为10kg时的寄付现结费用（卖家现金） 必须大于 0。 |
|||||||||||||
| vendorCashFee20kg | Number |
商品重量为20kg时的寄付现结费用（卖家现金） 必须大于 0。 |
|||||||||||||
| consumerCashFee05kg | Number |
商品重量为5kg时的货到付款费（买家现金） 必须大于 0。 |
|||||||||||||
| consumerCashFee10kg | Number |
商品重量为10kg时的货到付款费（买家现金） 必须大于 0。 |
|||||||||||||
| consumerCashFee20kg | Number |
商品重量为20kg时的货到付款费（买家现金） 必须大于 0。 |
|||||||||||||
| returnFee05kg | Number |
商品重量为5kg时的退货费 必须大于 0。 |
|||||||||||||
| returnFee10kg | Number |
商品重量为10kg时的退货费 必须大于 0。 |
|||||||||||||
| returnFee20kg | Number |
商品重量为20kg时的退货费 必须大于 0。 |
|||||||||||||
Request Example
{
"userId":"testId",
"vendorId":"A00012345",
"returnCenterCode":"1000558900",
"shippingPlaceName":"반품지 -20200214-2modi",
"usable":"true",
"goodsflowInfoOpenApiDto":{
"vendorCreditFee05kg":"2500",
"vendorCreditFee10kg":"2500",
"vendorCreditFee20kg":"2500",
"vendorCashFee05kg":"2500",
"vendorCashFee10kg":"2500",
"vendorCashFee20kg":"2500",
"consumerCashFee05kg":"2500",
"consumerCashFee10kg":"2500",
"consumerCashFee20kg":"2500",
"returnFee05kg":"2500",
"returnFee10kg":"2500",
"returnFee20kg":"2500"
},
"placeAddresses": [{
"addressType":"JIBUN",
"companyContactNumber":"070-****-8008",
"phoneNumber2":"010-****-7993",
"returnZipCode":"110794",
"returnAddress":"서울특별시 종로구 인사동5길 25 (인사동)",
"returnAddressDetail":"하나로빌딩"
}]
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number | 服务器响应代码 | ||||
| message | String | 服务器响应信息 | ||||
| data | Array | 退货地址更改结果 | ||||
| resultCode | String |
结果代码 SUCCESS or FAIL |
||||
| resultMessage | String | 结果信息 | ||||
Response Example
{
"code": 200,
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Modify successfully"
}
}Error Spec
| HTTP status code (error type) | Error message | How to resolve |
|---|---|---|
| 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 字段值是否输入正确。正确格式为9-13位数字，包括 '-' |
URL API Name
UPDATE_SHIPPING_CENTER_BY_RETURN_CENTER_CODE