Path
PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/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 | 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