Coupang Developer Center

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

使用退货地址中心代码 (returncenterCode)查看退货地址信息。

Path

GET

/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code?returnCenterCodes=1000000051,1000006047

Request Parameters

Query String Parameter

Name					Required	Type	Description
returnCenterCodes					O	String	退货地址中心代码批量搜索 returnCenterCodes的最大数量为 100。 ex) 1000554021,1000554704

Request Example

无请求体要求

Response Message

Name

Type

Description

code

Number

服务器响应代码

message

String

服务器响应信息

data

Array

退货地址信息

vendorId

String

卖家代码

returnCenterCode

String

退货地址中心代码

shippingPlaceName

String

退货地名

deliverCode

String

快递公司代码

deliverName

String

快递公司名

goodsflowStatus

String

Goodsflow状态

errorMessage

String

错误信息

createAt

String

创建日期

vendorCreditFee02kg

Number

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

必须大于 0。

vendorCreditFee05kg

Number

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

必须大于 0。

vendorCreditFee10kg

Number

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

必须大于 0。

vendorCreditFee20kg

Number

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

必须大于 0。

vendorCashFee02kg

Number

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

必须大于 0。

vendorCashFee05kg

Number

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

必须大于 0。

vendorCashFee10kg

Number

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

必须大于 0。

vendorCashFee20kg

Number

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

必须大于 0。

consumerCashFee02kg

Number

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

必须大于 0。

consumerCashFee05kg

Number

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

必须大于 0。

consumerCashFee10kg

Number

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

必须大于 0。

consumerCashFee20kg

Number

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

必须大于 0。

returnFee02kg

Number

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

必须大于 0。

returnFee05kg

Number

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

必须大于 0。

returnFee10kg

Number

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

必须大于 0。

returnFee20kg

Number

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

必须大于 0。

usable

boolean

能否使用

placeAddresses

Array

退货地址

addressType

String

地址类型
JIBUN, JIBUN&ROADNAME

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

countryCode

String

国家代码，韩国国内选“KR”

companyContactNumber

String

退货地址电话号码

phoneNumber2

String

备选电话号码

returnZipCode

String

退货地址邮编

returnAddress

String

退货地址

returnAddressDetail

String

详细退货地址

Response Example

{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "vendorId": "A00123456",
      "returnCenterCode": "1000552675",
      "shippingPlaceName": "32757 R",
      "deliverCode": "HANJIN",
      "deliverName": "한진택배",
      "goodsflowStatus": "승인",
      "errorMessage": "",
      "createdAt": 1579727107000,
      "vendorCreditFee02kg": 3000,
      "vendorCreditFee05kg": 3000,
      "vendorCreditFee10kg": 3000,
      "vendorCreditFee20kg": 3000,
      "vendorCashFee02kg": 3000,
      "vendorCashFee05kg": 3000,
      "vendorCashFee10kg": 3000,
      "vendorCashFee20kg": 3000,
      "consumerCashFee02kg": 3000,
      "consumerCashFee05kg": 3000,
      "consumerCashFee10kg": 3000,
      "consumerCashFee20kg": 3000,
      "returnFee02kg": 3000,
      "returnFee05kg": 3000,
      "returnFee10kg": 3000,
      "returnFee20kg": 3000,
      "usable": true,
      "placeAddresses": [
        {
          "addressType": "JIBUN",
          "countryCode": "KR",
          "companyContactNumber": "051-261-6120",
          "phoneNumber2": "000-0000-0000",
          "returnZipCode": "49525",
          "returnAddress": "부산시 사하구 다대로",
          "returnAddressDetail": "613"
        }
      ]
    }
  ]
}

Error Spec

HTTP status code (error type)	Error message	How to resolve
400 (check request parameter)	中心代码不可为空...	查看是否没有输入退货地址中心代码（returnCenterCodes）。
500 (server error)	读取超时	查看退货地址时发生错误。稍后重试或更改输入值。点击查看相关FAQ!

HTTP status code (error type)

Error message

How to resolve

400 (check request parameter)

中心代码不可为空...

查看是否没有输入退货地址中心代码（returnCenterCodes）。

500 (server error)

读取超时

查看退货地址时发生错误。稍后重试或更改输入值。

点击查看相关FAQ!

URL API Name

GET_SHIPPING_BY_CENTER_CODE

查看单件退货地址

简介

详细内容

Path

Example Endpoint

Request Parameters

Query String Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name