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

物流信息

POST/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters2609170000

退货地创建

# 01

简介

退货地创建

# 02

详细内容

API支持的买家用户地区：韩国、台湾
创建退货地。
卖家可使用该API创建多个退货地。
生成的退货地会使用注册商品时输入的退货地信息。

※如果没有物流公司合约代码，您可在不创建退货地的情况下注册商品，
但海外配送商品必须创建退货地。 *附加指南(点击)

路径

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

示例端点

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

URL API Name

UPDATE_SHIPPING_CENTER_BY_VENDOR

# 03

Path 参数

Name	Type	Description
vendorId*	string	卖家ID 酷澎提供给卖家的固有代码 ex) A00012345

# 04

请求体参数

请求参数

请求体参数

Name

Type

Description

vendorId*

string

卖家ID

酷澎提供给卖家的固有代码

ex) A00012345

userId*

string

用户ID (酷澎Wing登录账户)

shippingPlaceName*

string

退货地名称

goodsflowInfoOpenApiDto*

object

物流公司信息

deliverCode

goodsflowInfoOpenApiDto.deliverCode

string

物流公司代码

CODE	NAME
HYUNDAI	乐天物流
KGB	Logen物流
EPOST	邮政
HANJIN	韩进物流
CJGLS	CJ大韩通运
ILYANG	Ilyang物流

仅上述物流公司可注册为退货物流公司。

deliverName

goodsflowInfoOpenApiDto.deliverName

string

物流公司名称

contractNumber

goodsflowInfoOpenApiDto.contractNumber

string

物流公司合约代码

contractCustomerNumber

goodsflowInfoOpenApiDto.contractCustomerNumber

string

卖家编号

使用邮政快递时需输入

vendorCreditFee05kg

goodsflowInfoOpenApiDto.vendorCreditFee05kg

number

商品重量为5kg时的信用费(卖家信用)

必须大于 0

*输入费用时的注意事项

请输入与物流Goodsflow物流公司的签约金额，而不是向顾客收取的金额。
如果您输入的金额大于签约金额，可能会按您输入的金额支付。

适用对象: vendorCreditFee05kg~returnFee20kg

vendorCreditFee10kg

goodsflowInfoOpenApiDto.vendorCreditFee10kg

number

商品重量为10kg时的信用费(卖家信用)

必须大于 0。

vendorCreditFee20kg

goodsflowInfoOpenApiDto.vendorCreditFee20kg

number

商品重量为20kg时的信用费(卖家信用)

必须大于 0。

vendorCashFee05kg

goodsflowInfoOpenApiDto.vendorCashFee05kg

number

商品重量为 5kg时的预付费用(卖家现金)

必须大于 0。

vendorCashFee10kg

goodsflowInfoOpenApiDto.vendorCashFee10kg

number

商品重量为 10kg时的预付费用(卖家现金)

必须大于 0。

vendorCashFee20kg

goodsflowInfoOpenApiDto.vendorCashFee20kg

number

商品重量为 20kg时的预付费用(卖家现金)

必须大于 0。

consumerCashFee05kg

goodsflowInfoOpenApiDto.consumerCashFee05kg

number

商品重量为 5kg时的货到付款费用(买家现金)

必须大于 0。

consumerCashFee10kg

goodsflowInfoOpenApiDto.consumerCashFee10kg

number

商品重量为 10kg时的货到付款费用(买家现金)

必须大于 0。

consumerCashFee20kg

goodsflowInfoOpenApiDto.consumerCashFee20kg

number

商品重量为 20kg时的货到付款费用(买家现金)

必须大于 0。

returnFee05kg

goodsflowInfoOpenApiDto.returnFee05kg

number

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

必须大于 0。

returnFee10kg

goodsflowInfoOpenApiDto.returnFee10kg

number

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

必须大于 0。

returnFee20kg

goodsflowInfoOpenApiDto.returnFee20kg

number

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

必须大于 0。

placeAddresses*

object[]

退货地址

addressType

placeAddresses[].addressType

string

地址类型

JIBUN, JIBUN&ROADNAME

CODE	Mean
JIBUN	地区编号
ROADNAME	道路名

companyContactNumber

placeAddresses[].companyContactNumber

string

	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个字符

# 05

响应体

响应消息

Name	Type	Description
code	string	服务器响应码
message	string	服务器响应消息
data	object	退货地列表数据
resultCode data.resultCode	string	结果代码 SUCCESS or FAIL
resultMessage data.resultMessage	string	结果信息 (退货地代码) returnCenterCode

Response Example

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

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (确认请求参数)	服务申请信息已经被注册。	请确认是否存在使用相同退货地名称 (shippingPlaceName) 及地址 (returnAddress, returnAddressDetail) 注册的退货地。不可使用相同的退货地名称和地址重复注册。
400	400 (确认请求参数)	[发货地重复]该地址名已被注册。(重复地址编号: 1000*******).	请确认是否注册过相同退货地名称 (shippingPlaceName) 的退货地。退货地不可重复注册。
400	400 (重复输入)	[发货地重复] Duplicated request. 公司名:xxxxx	请确认是否输入过相同的shippingPlaceName值。
500	500 (确认请求参数)	shipping-places create error.	请确认输入的物流公司合同代码(contractNumber)数值是否正确。
500	500 (确认请求参数)	已被注册，但无法确认到合同。	请确认输入的物流公司合同代码(contractNumber)数值是否正确。
500	500 (确认请求参数)	服务器错误 (未知错误/新错误)	请确认您输入的卖家编号(contractCustomerNumber)数值是否正确。仅在物流公司为邮政(EPOST)时输入即可。
400	400 (确认请求参数)	Please input the correct phone number format including numbers and '-' (min 9, max 13)	请检查companyContactNumber 或者 phoneNumber2 字段值是否输入正确。正确格式为9-13位数字，包括 '-'
400	400 (确认请求参数)	Invalid vendor ID	查看输入的卖家ID（vendorID）是否正确。
400	400 (确认请求参数)	The vendorId in path or requestBody doesn't match the one got from api-gateway.	请确认您输入的卖家ID(VendorId)是否正确。