繁體中文 English (United States) 한국어 简体中文
Support

OPENAPI 관련 안내

[ 2021/07/07 OPENAPI 서비스 장애 안내 / OPENAPI Service Disability Information]

[Korean]
안녕하세요? 쿠팡 입니다.
금일 오전 OPENAPI 를 통한 주문 수집에 문제가 발생하여 아래와 같이 안내드립니다.
- OpenAPI 셀러가 오전에 발주서 API 수집시 수취인 안심번호 값이 null 로 표시되는 문제 발생
- 진행시간 : 2021년 7월 7일 04:21 ~ 10:22 KST
- 현재는 조치완료되어 정상이용 가능
위 내용 참고하시어 필요시 주문을 재수집해주시기 바랍니다.
이용에 불편을 드려 죄송합니다.
관련 문의는 https://deverlopers.coupangcorp.com 또는 openapisupport@coupang.com 으로 부탁드립니다.
감사합니다.

[English]
There is a problem with order collection through OPENAPI this morning, and we inform you as follows.
- When the OpenAPI seller collects the order form API in the morning, the recipient's security number value is displayed as null.
- Running time: July 7, 2021 04:21 ~ 10:22 KST
- Currently, the measures have been completed and can be used normally.
Please refer to the above and recollect your order if necessary.
We apologize for the inconvenience.
For related inquiries: https://deverlopers.coupangcorp.com Or, please contact openapisupport@coupang.com.
Thank you.

 오늘 하루 이 창을 열지 않음 [닫기]

此段落內的文章

查看單件退貨地址

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

請求引數

查詢引數

名稱是否必須型別描述
returnCenterCodesOString

退貨地址中心程式碼  

批次搜尋 returnCenterCodes的最大數量為 100。 

ex) 1000554021,1000554704

請求體引數

無請求體要求

返回訊息

名稱型別描述
codeNumber伺服器響應程式碼 
messageString伺服器響應資訊 
dataArray退貨地址資訊 
 vendorIdString賣家程式碼 
 returnCenterCodeString退貨地址中心程式碼 
 shippingPlaceNameString退貨地名 
 deliverCodeString快遞公司程式碼 
 deliverNameString快遞公司名 
 goodsflowStatusStringGoodsflow狀態 
 errorMessageString錯誤資訊 
 createAtString

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

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

 vendorCreditFee02kgObject

商品重量為 2 kg時的信用費用（賣家信用） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCreditFee05kgObject

商品重量為 5kg時的信用費用（賣家信用） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCreditFee10kgObject

商品重量為 10 kg時的信用費用（賣家信用） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCreditFee20kgObject

商品重量為 20 kg時的信用費用（賣家信用） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCashFee02kgObject

商品重量為2kg時的寄付現結費用（賣家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCashFee05kgObject

商品重量為5kg時的寄付現結費用（賣家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCashFee10kgObject

商品重量為10kg時的寄付現結費用（賣家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 vendorCashFee20kgObject

商品重量為20kg時的寄付現結費用（賣家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 consumerCashFee02kgObject

商品重量為2kg時的貨到付款費（買家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 consumerCashFee05kgObject

商品重量為5kg時的貨到付款費（買家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 consumerCashFee10kgObject

商品重量為10kg時的貨到付款費（買家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 consumerCashFee20kgObject

商品重量為20kg時的貨到付款費（買家現金） 

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 returnFee02kgObject

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

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 returnFee05kgObject

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

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 returnFee10kgObject

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

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 returnFee20kgObject

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

必須大於 0。 

  currencyCodeString貨幣程式碼（符合ISO-4217標準），3位大寫字元
  unitsNumber貨幣整數部分，64-bit
  nanosNumber貨幣小數部分，32-bit，取值範圍 [-999999999, 999999999]
 usableboolean能否使用 
 placeAddressesArray退貨地址 
  addressTypeString

地址型別   
JIBUN, JIBUN&ROADNAME

代码含义
JIBUN地块编号 
ROADNAME道路名称 
  countryCodeString國家程式碼（符合ISO-3166標準 ），有效長度: 2 。例如：韓國國內為“KR”, 臺灣地區為 “TW”
  companyContactNumberString退貨地址電話號碼  (格式需符合E.164標準)
  phoneNumber2String備選電話號碼  (格式需符合E.164標準)
  returnZipCodeString退貨地址郵編 
  returnAddressString退貨地址 
  returnAddressDetailString詳細退貨地址 

返回訊息示例

{

  "code": 200,

  "message": "OK",

  "data": [

    {

      "vendorId": "A00123456",

      "returnCenterCode": "1000552675",

      "shippingPlaceName": "32757 R",

      "deliverCode": "HANJIN",

      "deliverName": "한진택배",

      "goodsflowStatus": "승인",

      "errorMessage": "",

      "createdAt": "2025-01-15T14:17:13.973885-08:00",

      "vendorCreditFee02kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCreditFee05kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCreditFee10kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCreditFee20kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCashFee02kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCashFee05kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCashFee10kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "vendorCashFee20kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "consumerCashFee02kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "consumerCashFee05kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "consumerCashFee10kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "consumerCashFee20kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "returnFee02kg": {

"currencyCode": "KRW",

"units": 3000,

"nanos": 0

},

      "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": " +1(555)444-1234",

          "phoneNumber2": " +1(555)444-1234",

          "returnZipCode": "49525",

          "returnAddress": "부산시 사하구 다대로",

          "returnAddressDetail": "613"

        }

      ]

    }

  ]

}

錯誤程式碼

HTTP狀態程式碼 (錯誤型別)錯誤資訊解決方案
400 (check request parameter) 中心程式碼不可為空... 檢視是否沒有輸入退貨地址中心程式碼（returnCenterCodes）。 
500 (server error) 讀取超時 

檢視退貨地址時發生錯誤。稍後重試或更改輸入值。 

 點擊檢視相關FAQ

介面名稱

GET_SHIPPING_BY_CENTER_CODE

相關文章