Coupang Developer Center

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

创建退货地。

卖家可使用该API创建多个退货地。

生成的退货地会使用注册商品时输入的退货地信息。

※如果没有物流公司合约代码，您可在不创建退货地的情况下注册商品，

但海外配送商品必须创建退货地。 *附加指南(点击)

Path

POST

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

Example Endpoint

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

Request Parameters

Path Segment Parameter

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

Body Parameter

Name

Required

Type

Description

vendorId

String

卖家ID

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

ex) A00012345

userId

String

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

shippingPlaceName

String

退货地名称

goodsflowInfoOpenApiDto

Object

物流公司信息

deliverCode

String

物流公司代码

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

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

deliverName

String

物流公司名称

contractNumber

String

物流公司合约代码

contractCustomerNumber

String

卖家编号

使用邮政快递时需输入

vendorCreditFee05kg

Number

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

必须大于 0

*输入费用时的注意事项

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

适用对象: vendorCreditFee05kg~returnFee20kg

vendorCreditFee10kg

Number

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

必须大于 0。

vendorCreditFee20kg

Number

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

必须大于 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。

placeAddresses

Array

退货地址

addressType

String

地址类型

JIBUN, JIBUN&ROADNAME

CODE	Mean
JIBUN	地区编号
ROADNAME	道路名

companyContactNumber

String

	Min~Max
x	2~4 位
y	3~4 位
z	4 位

phoneNumber2

String

备用电话号码(格式：与电话号码1相同)

returnZipCode

String

邮政编码: 数字，最短5位数，最长6位数

returnAddress

String

地址，最长150个字符

returnAddressDetail

String

详细住址，最长200个字符

{
  "userId": "coupang20",
  "vendorId": "A00012345",
  "shippingPlaceName": "반품지01",
  "goodsflowInfoOpenApiDto": {
    "deliverCode": "CJGLS",
    "contractNumber": "85500067",
    "contractCustomerNumber": "",
    "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": "02-1234-5678",
      "phoneNumber2": "",
      "returnZipCode": "112207",
      "returnAddress": "경기도 파주시 탄현면 월롱산로",
      "returnAddressDetail": "294-58"
    }
  ]
}

Response Message

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

Response Example

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

Error Spec

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

URL API Name

UPDATE_SHIPPING_CENTER_BY_VENDOR

退货地创建

简介

详细内容

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Response Message

Response Example

Error Spec

URL API Name