商品 API 品类 API 品牌 API 运输 / 订单 API 退货 API 换货 API 促销 / 优惠券物流信息客服 / 咨询结算 CGF / CGF lite Rocket Growth

物流信息

PUT/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}2609170000

更改退货地址

# 01

简介

更改退货地址

# 02

详细内容

API支持的买家用户地区：韩国、台湾

更改退货地址功能。

更改退货地址时需要退货地址代码（returnCenterCode），使用查看退货地列表API获取退货地址代码

路径

PUT/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}

示例端点

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters/1100044653

URL API Name

UPDATE_SHIPPING_CENTER_BY_RETURN_CENTER_CODE

# 03

Path 参数

Name	Type	Description
vendorId*	string	卖家ID 酷澎分配给卖家的固有代码 ex) A00012345
returnCenterCode*	number	退货地址代码

# 04

请求体参数

请求参数

请求体参数

Name

Type

Description

vendorId*

string

卖家ID

酷澎分配给卖家的固有代码

ex) A00012345

returnCenterCode*

string

退货地址代码

userId*

string

用户ID(酷澎WING ID)

shippingPlaceName

string

退货地名

如为"null,"则退货地名不改变。

usable

string

能否使用 ture/false

placeAddresses*

object[]

退货地址

addressType

placeAddresses[].addressType

string

地址类型
JIBUN, JIBUN&ROADNAME

CODE	Mean
JIBUN	地块编号
ROADNAME	道路名称

companyContactNumber

placeAddresses[].companyContactNumber

string

手机号, e.g.: xx-yyy-zzzz,

	Min~Max
x	2~4个字符
y	3~4个字符
z	4个字符

phoneNumber2

placeAddresses[].phoneNumber2

string

备选电话号码（格式和电话号码1相同）

returnZipCode

placeAddresses[].returnZipCode

string

邮编：数字，最短5个字符，最长6个字符

returnAddress

placeAddresses[].returnAddress

string

地址，最长150个字符

returnAddressDetail

placeAddresses[].returnAddressDetail

string

详细地址，最长200个字符

goodsflowInfoDto*

object

Goodflow 配送对接信息

vendorCreditFee05kg

goodsflowInfoDto.vendorCreditFee05kg

number

商品重量为 5kg时的信用费用（卖家信用）

必须大于 0。

该项无其它使用的地方，

输入在商品注册 API 中输入的退货运费。

对象: vendorCreditFee05kg~returnFee20kg

vendorCreditFee10kg

goodsflowInfoDto.vendorCreditFee10kg

number

商品重量为 10 kg时的信用费用（卖家信用）

必须大于 0。

vendorCreditFee20kg

goodsflowInfoDto.vendorCreditFee20kg

number

商品重量为 20 kg时的信用费用（卖家信用）

必须大于 0。

vendorCashFee05kg

goodsflowInfoDto.vendorCashFee05kg

number

商品重量为5kg时的寄付现结费用（卖家现金）

必须大于 0。

vendorCashFee10kg

goodsflowInfoDto.vendorCashFee10kg

number

商品重量为10kg时的寄付现结费用（卖家现金）

必须大于 0。

vendorCashFee20kg

goodsflowInfoDto.vendorCashFee20kg

number

商品重量为20kg时的寄付现结费用（卖家现金）

必须大于 0。

consumerCashFee05kg

goodsflowInfoDto.consumerCashFee05kg

number

商品重量为5kg时的货到付款费（买家现金）

必须大于 0。

consumerCashFee10kg

goodsflowInfoDto.consumerCashFee10kg

number

商品重量为10kg时的货到付款费（买家现金）

必须大于 0。

consumerCashFee20kg

goodsflowInfoDto.consumerCashFee20kg

number

商品重量为20kg时的货到付款费（买家现金）

必须大于 0。

returnFee05kg

goodsflowInfoDto.returnFee05kg

number

商品重量为5kg时的退货费

必须大于 0。

returnFee10kg

goodsflowInfoDto.returnFee10kg

number

商品重量为10kg时的退货费

必须大于 0。

returnFee20kg

goodsflowInfoDto.returnFee20kg

number

商品重量为20kg时的退货费

必须大于 0。

请求示例application/json

{
  "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": "하나로빌딩"
    }
  ]
}

# 05

响应体

响应消息

Name	Type	Description
code	integer	服务器响应代码
message	string	服务器响应信息
data	object	退货地址更改结果
resultCode data.resultCode	string	结果代码 SUCCESS or FAIL
resultMessage data.resultMessage	string	结果信息

Response Example

{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "resultCode": "SUCCESS",
    "resultMessage": "Modify successfully"
  }
}

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (check request parameter)	参数不可为空...	查看是否没有输入卖家ID（vendorId）、退货地址代码（returnCenterCode）、用户ID（userId）的输入值是否缺失。
400	400 (check request parameter)	已有注册的地址名(重复地址代码: 1000*******)	查看是否已注册具有相同退货地名 (shippingPlaceName) 的退货地址。请进行处理，使其不重复。
400	400 (确认请求参数)	Please input the correct phone number format including numbers and '-' (min 9, max 13)	请检查companyContactNumber 或者 phoneNumber2 字段值是否输入正确。正确格式为9-13位数字，包括 '-'

HTTP

类型

错误消息

解决方案

400

400 (check request parameter)

参数不可为空...

查看是否没有输入卖家ID（vendorId）、退货地址代码（returnCenterCode）、用户ID（userId）的输入值是否缺失。

400

400 (check request parameter)

已有注册的地址名(重复地址代码:

1000*******)

查看是否已注册具有相同退货地名 (shippingPlaceName) 的退货地址。请进行处理，使其不重复。

400

400 (确认请求参数)

Please input the correct phone number format including numbers and '-' (min 9, max 13)

请检查companyContactNumber 或者 phoneNumber2 字段值是否输入正确。正确格式为9-13位数字，包括 '-'