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

物流信息

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

退货地列表查询

# 01

简介

退货地列表查询

# 02

详细内容

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

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

路径

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

示例端点

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

URL API Name

GET_SHIPPING_CENTER_BY_VENDOR

# 03

Path 参数

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

# 04

Query 参数

Name	Type	Description
pageNum	number	页数默认值1
pageSize	number	每页订单数默认值10，最大值50

# 05

响应体

响应消息

Name	Type	Description
code	integer	服务器响应码
message	string	服务器响应消息
data	object	退货地列表数据
content data.content	object[]
vendorId data.content[].vendorId	string
returnCenterCode data.content[].returnCenterCode	string
shippingPlaceName data.content[].shippingPlaceName	string
deliverCode data.content[].deliverCode	string
deliverName data.content[].deliverName	string
goodsflowStatus data.content[].goodsflowStatus	string
errorMessage data.content[].errorMessage	string
createdAt data.content[].createdAt	integer
vendorCreditFee02kg data.content[].vendorCreditFee02kg	string
vendorCreditFee05kg data.content[].vendorCreditFee05kg	integer
vendorCreditFee10kg data.content[].vendorCreditFee10kg	integer
vendorCreditFee20kg data.content[].vendorCreditFee20kg	integer
vendorCashFee02kg data.content[].vendorCashFee02kg	string
vendorCashFee05kg data.content[].vendorCashFee05kg	integer
vendorCashFee10kg data.content[].vendorCashFee10kg	integer
vendorCashFee20kg data.content[].vendorCashFee20kg	integer
consumerCashFee02kg data.content[].consumerCashFee02kg	string
consumerCashFee05kg data.content[].consumerCashFee05kg	integer
consumerCashFee10kg data.content[].consumerCashFee10kg	integer
consumerCashFee20kg data.content[].consumerCashFee20kg	integer
returnFee02kg data.content[].returnFee02kg	string
returnFee05kg data.content[].returnFee05kg	integer
returnFee10kg data.content[].returnFee10kg	integer
returnFee20kg data.content[].returnFee20kg	integer
usable data.content[].usable	boolean
placeAddresses data.content[].placeAddresses	object[]
addressType data.content[].placeAddresses[].addressType	string
countryCode data.content[].placeAddresses[].countryCode	string
companyContactNumber data.content[].placeAddresses[].companyContactNumber	string
phoneNumber2 data.content[].placeAddresses[].phoneNumber2	string
returnZipCode data.content[].placeAddresses[].returnZipCode	string
returnAddress data.content[].placeAddresses[].returnAddress	string
returnAddressDetail data.content[].placeAddresses[].returnAddressDetail	string
pagination data.pagination	object
currentPage data.pagination.currentPage	integer
totalPages data.pagination.totalPages	integer
totalElements data.pagination.totalElements	integer
countPerPage data.pagination.countPerPage	integer

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
    }
  }
}

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400 (确认请求参数)	The vendorId in path or requestBody doesn't match the one got from api-gateway.	请确认您输入的卖家ID(VendorId)是否正确。
500	500 (服务器错误)	Read timed out	请缩短查询时间段后重试。点击FAQ!

HTTP

类型

错误消息

解决方案

400

400 (确认请求参数)

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

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

500

500 (服务器错误)

Read timed out

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

点击FAQ!