退货地列表查询

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

通过卖家代码查询退货地.

Path

GET

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

Example Endpoint

https://api-gateway.coupang.com/v5/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters?pageNum=1&pageSize=50

Request Parameters

Path Segment Parameter

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

Query String Parameter

Name

Required

Type

Description

pageNum

Number

页数

默认值1

pageSize

Number

每页订单数

默认值10，最大值50

Request Example

not require body

Response Message

Name

Type

Description

code

Number

服务器响应码

message

String

服务器响应消息

data

Array

退货地列表数据

vendorId

String

卖家代码

returnCenterCode

String

退货中心代码

shippingPlaceName

String

退货地名称

deliverCode

String

物流公司代码

deliverName

String

物流公司名称

goodsflowStatus

String

物流状态

errorMessage

String

错误信息

createAt

String

创建日期

vendorCreditFee02kg

Number

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

必须大于 0。

vendorCreditFee05kg

Number

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

必须大于 0。

vendorCreditFee10kg

Number

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

必须大于 0。

vendorCreditFee20kg

Number

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

必须大于 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	道路名
OVERSEA	海外

countryCode

String

国家代码，韩国国内为"KR"

companyContactNumber

String

退货地电话号码

phoneNumber2

String

备用电话号码

returnZipCode

String

退货地邮政编码

returnAddress

String

退货地址

returnAddressDetail

String

退货地详细地址

Response Example


{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "content": [
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000557004",
        "shippingPlaceName": "32777 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1581195908000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "02-111-1111",
            "phoneNumber2": "000-0000-0000",
            "returnZipCode": "42701",
            "returnAddress": "대구시 달서구 성서공단로",
            "returnAddressDetail": "235"
          }
        ]
      },
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000557003",
        "shippingPlaceName": "32776 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1581195906000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "010-9857-****",
            "phoneNumber2": "010-9857-****",
            "returnZipCode": "28805",
            "returnAddress": "충청북도 청주시 서원구 장성동",
            "returnAddressDetail": "111"
          }
        ]
      },
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000555466",
        "shippingPlaceName": "27487 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1580795274000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "02-722-****",
            "phoneNumber2": "000-0000-0000",
            "returnZipCode": "12615",
            "returnAddress": "경기도 여주시 북내면 가정1길",
            "returnAddressDetail": "62  (가정리)"
          }
        ]
      },
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000552893",
        "shippingPlaceName": "32759 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1579813508000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "000-1588-0***",
            "phoneNumber2": "000-0000-0000",
            "returnZipCode": "07345",
            "returnAddress": "서울시 영등포구 63로",
            "returnAddressDetail": "50 "
          }
        ]
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 749,
      "totalElements": 7488,
      "countPerPage": 10
    }
  }
}

Error Spec

HTTP status code (error type)

Error message

How to resolve

400 (确认请求参数)

The vendorId in path or requestBody doesn't match the one got from api-gateway.

请确认您输入的卖家ID(VendorId)是否正确。

500 (服务器错误)

Read timed out

请缩短查询时间段后重试。

点击FAQ!

URL API Name

GET_SHIPPING_CENTER_BY_VENDOR

OPENAPI 관련 안내

此组别内的文章

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Query String Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

OPENAPI 관련 안내

此组别内的文章

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Query String Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

相关文章