coupang
API 文件
商品 API品類 API運輸 / 訂單 API退貨 API物流資訊客服 / 諮詢
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCentersv1

透過賣家程式碼查詢退貨地

# 01

簡介

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 請求引數 路徑引數 名稱 是否必須 型別 描述 vendorId O String 賣家ID 酷澎提供給賣家的固有程式碼

# 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

請求引數

路徑引數

名稱 是否必須 型別 描述
vendorId O String

賣家ID  

酷澎提供給賣家的固有程式碼 

例) A00012345 

查詢引數

名稱 是否必須 型別 描述
pageNum   Number

頁數 

預設值1  
pageSize   Number

每頁訂單數 

預設值10，最大值50 

請求體例子

無

返回訊息

名稱 型別 描述
code Number 伺服器響應碼 
message String 伺服器響應訊息 
data Array 退貨地陣列資料 
  vendorId String 賣家程式碼 
  returnCenterCode String 退貨中心程式碼 
  shippingPlaceName String 退貨地名稱 
  deliverCode String 物流公司程式碼 
  deliverName String 物流公司名稱 
  goodsflowStatus String 物流狀態 
  errorMessage String 錯誤資訊 
  createAt String

建立日期  (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
  vendorCreditFee02kg Object

商品重量為 2kg時的信用費(賣家信用) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCreditFee05kg Object

商品重量為 5kg時的信用費(賣家信用) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCreditFee10kg Object

商品重量為 10kg時的信用費(賣家信用) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCreditFee20kg Object

商品重量為 20kg時的信用費(賣家信用) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCashFee02kg Object

商品重量為 2kg時的預付費用(賣家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCashFee05kg Object

商品重量為 5kg時的預付費用(賣家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCashFee10kg Object

商品重量為 10kg時的預付費用(賣家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  vendorCashFee20kg Object

商品重量為 20kg時的預付費用(賣家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  consumerCashFee02kg Object

商品重量為 2kg時的貨到付款費用(買家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  consumerCashFee05kg Object

商品重量為 5kg時的貨到付款費用(買家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  consumerCashFee10kg Object

商品重量為 10kg時的貨到付款費用(買家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  consumerCashFee20kg Object

商品重量為 20kg時的貨到付款費用(買家現金) 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  returnFee02kg Object

商品重量為 2kg時的退貨費 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  returnFee05kg Object

商品重量為 5kg時的退貨費 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  returnFee10kg Object

商品重量為 10kg時的退貨費 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  returnFee20kg Object

商品重量為 20kg時的退貨費 

必須大於 0。 
    currencyCode String 貨幣程式碼（符合ISO-4217標準），3位大寫字元
    units Number 貨幣整數部分，64-bit
    nanos Number 貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
  usable boolean 是否必須 
  placeAddresses Array 退貨地址 
    addressType String

地址型別  

JIBUN, JIBUN&ROADNAME 

程式碼 含義
JIBUN 地區編號  
ROADNAME 道路名 
OVERSEA 海外 

 
    countryCode String 國家程式碼（符合ISO-3166標準），有效長度: 2 。例子：韓國國內為“KR”, 臺灣地區為 “TW”
    companyContactNumber String 退貨地電話號碼  (格式需符合E.164標準)
    phoneNumber2 String 備用電話號碼  (格式需符合E.164標準)
    returnZipCode String 退貨地郵政編碼 
    returnAddress String 退貨地址 
    returnAddressDetail String 退貨地詳細地址 

返回訊息例子

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

錯誤程式碼

HTTP狀態程式碼(錯誤型別)  錯誤資訊 解決方案
400 (確認請求引數)  The vendorId in path or requestBody doesn't match the one got from api-gateway.  請確認您輸入的賣家ID(VendorId)是否正確。  
500 (伺服器錯誤)  Read timed out 

請縮短查詢時間段後重試。 

點擊FAQ! 

介面名稱

GET_SHIPPING_CENTER_BY_VENDOR