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

物流信息

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

查看单件退货地址

# 01

简介

查看单件退货地址

# 02

详细内容

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

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

路径

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

示例端点

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

URL API Name

GET_SHIPPING_BY_CENTER_CODE

# 03

Query 参数

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

# 04

响应体

响应消息

Name

Type

Description

code

integer

服务器响应代码

message

string

服务器响应信息

data

object[]

退货地址信息

vendorId

data[].vendorId

string

卖家代码

returnCenterCode

data[].returnCenterCode

string

退货地址中心代码

shippingPlaceName

data[].shippingPlaceName

string

退货地名

deliverCode

data[].deliverCode

string

快递公司代码

deliverName

data[].deliverName

string

快递公司名

goodsflowStatus

data[].goodsflowStatus

string

Goodsflow状态

errorMessage

data[].errorMessage

string

错误信息

createAt

data[].createAt

string

创建日期

vendorCreditFee02kg

data[].vendorCreditFee02kg

integer

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

必须大于 0。

vendorCreditFee05kg

data[].vendorCreditFee05kg

integer

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

必须大于 0。

vendorCreditFee10kg

data[].vendorCreditFee10kg

integer

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

必须大于 0。

vendorCreditFee20kg

data[].vendorCreditFee20kg

integer

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

必须大于 0。

vendorCashFee02kg

data[].vendorCashFee02kg

integer

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

必须大于 0。

vendorCashFee05kg

data[].vendorCashFee05kg

integer

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

必须大于 0。

vendorCashFee10kg

data[].vendorCashFee10kg

integer

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

必须大于 0。

vendorCashFee20kg

data[].vendorCashFee20kg

integer

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

必须大于 0。

consumerCashFee02kg

data[].consumerCashFee02kg

integer

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

必须大于 0。

consumerCashFee05kg

data[].consumerCashFee05kg

integer

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

必须大于 0。

consumerCashFee10kg

data[].consumerCashFee10kg

integer

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

必须大于 0。

consumerCashFee20kg

data[].consumerCashFee20kg

integer

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

必须大于 0。

returnFee02kg

data[].returnFee02kg

integer

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

必须大于 0。

returnFee05kg

data[].returnFee05kg

integer

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

必须大于 0。

returnFee10kg

data[].returnFee10kg

integer

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

必须大于 0。

returnFee20kg

data[].returnFee20kg

integer

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

必须大于 0。

usable

data[].usable

boolean

能否使用

placeAddresses

data[].placeAddresses

object[]

退货地址

addressType

data[].placeAddresses[].addressType

string

地址类型
JIBUN, JIBUN&ROADNAME

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

countryCode

data[].placeAddresses[].countryCode

string

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

companyContactNumber

data[].placeAddresses[].companyContactNumber

string

退货地址电话号码

phoneNumber2

data[].placeAddresses[].phoneNumber2

string

备选电话号码

returnZipCode

data[].placeAddresses[].returnZipCode

string

退货地址邮编

returnAddress

data[].placeAddresses[].returnAddress

string

退货地址

returnAddressDetail

data[].placeAddresses[].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"
        }
      ]
    }
  ]
}

# 05

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (check request parameter)	中心代码不可为空...	查看是否没有输入退货地址中心代码（returnCenterCodes）。
500	500 (server error)	读取超时	查看退货地址时发生错误。稍后重试或更改输入值。点击查看相关FAQ!

HTTP

类型

错误消息

解决方案

400

400 (check request parameter)

中心代码不可为空...

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

500

500 (server error)

读取超时

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

点击查看相关FAQ!