coupang
API 文件
商品 API品類 API運輸 / 訂單 API退貨 API物流資訊客服 / 諮詢
GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partialv1

商品查詢（無需審核）

# 01

簡介

適用買家市場：韓國、台灣 此 API 用於查詢商品相關資訊，例如配送與退貨地址等。 您可透過本 API 回傳結果，快速更新 [商品修改 API（無需審核）] 中的資訊。

# 02

詳細內容

適用買家市場：韓國、台灣

此 API 用於查詢商品相關資訊，例如配送與退貨地址等。

您可透過本 API 回傳結果，快速更新[商品修改 API（無需審核）] 中的資訊。

 

路徑

GET

/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial

範例端點

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/30100201234/partial 

請求參數

Path 參數

名稱
必填
類型
說明
sellerProductId O
String
已註冊商品 ID（商品建立後顯示的 ID）

請求範例

不需要 Request Body

回應欄位說明

名稱
類型
說明
code String
結果代碼（SUCCESS / ERROR）
message String
訊息
data    
  sellerProductId Number
已註冊商品 ID
商品建立後所顯示的商品 ID（data 欄位）.
  companyContactNumber String
退貨地址聯絡電話
可於 Coupang Wing 查詢，或透過退貨地址查詢 API 註冊後取得
  deliveryCharge Number
標準配送費
適用於收費配送及條件免運時，填寫單程配送費金額
  deliveryChargeOnReturn Number
退貨初始運費
免運商品退貨時由顧客負擔的配送費用
  deliveryChargeType String
配送費類型
參數名稱
狀態
FREE
免運費
NOT_FREE
收費配送
CHARGE_RECEIVED 到付
CONDITIONAL_FREE
條件免運

設定說明

  • 免運費（FREE）：
    設定退貨時的初始配送費（單程）【deliveryChargeOnReturn】以及退貨配送費（單程）【returnCharge】
  • 收費配送（NOT_FREE）：
    設定標準配送費【deliveryCharge】以及退貨配送費（單程）
  • 條件免運（CONDITIONAL_FREE）：
    設定標準配送費以及退貨配送費（單程）
  • 到付（CHARGE_RECEIVED）：
    適用到付的商品類別已預先定義，並由賣家客服中心提供相關指引
※ 對於【CONDITIONAL_FREE】，可自由設定免運條件金額
  deliveryCompanyCode String
物流公司代碼
  deliveryMethod String
配送方式
參數名稱
說明
SEQUENCIAL
一般配送（依序配送）
COLD_FRESH
冷藏／冷凍配送
MAKE_ORDER
訂製商品（接單製作）
AGENT_BUY
代購
VENDOR_DIRECT
賣家直送（含安裝配送或由賣家直接配送）
「INSTRUCTURE」與「MAKE_ORDER_DIRECT」已整合為 VENDOR_DIRECT.
  extraInfoMessage  String
訂製商品相關說明訊息
當客戶選擇「訂製商品（made to order）」配送類型時所顯示的訊息.
  freeShipOverAmount Number
免運條件金額
● 範例：若希望設定「滿 10,000 韓元免運」，請將［deliveryChargeType］設定為 CONDITIONAL_FREE，並在［freeShipOverAmount］輸入 10000。

※ 僅可輸入 100 韓元為單位（或其倍數）
※ 輸入 0 表示免運
  outboundShippingPlaceCode Number
出貨地地址代碼
選擇「合併配送」時為必填項，請透過出貨地查詢 API 進行確認.
  pccNeeded Boolean 
是否需要 PCC（個人通關編碼）

否需要於海外代購時填寫 PCC。

  • 預設值：不需要（false）
true
客戶需輸入 PCC 後才能購買（PCC 會包含在訂單中) 
false
客戶無需輸入 PCC 即可購買
  remoteAreaDeliverable String
是否支援偏遠地區配送
參數名稱
 狀態
Y
可配送至偏遠地區
N
不可配送至偏遠地區
  returnAddress String
退貨地址
可於 Coupang Wing 查詢，或透過「退貨地址查詢 API」註冊後取得
  returnAddressDetail String
退貨詳細地址
可於 Coupang Wing 查詢，或透過「退貨地址查詢 API」註冊後取得
  returnCenterCode String
退貨中心代碼

建立退貨地址後，請擷取並輸入退貨中心代碼

  • 退貨地址可透過 WING 或「退貨地址建立 API」新增
  • 若無法建立退貨地址，請輸入 "NO_RETURN_CENTERCODE" 以手動填寫退貨資訊
※ 自動退貨整合服務（Goodsflow）僅適用於已簽約之物流公司
※ 退貨中心代碼為必填項目
  returnCharge Number
退貨運費
退貨回收時所收取的單程配送費用
  returnChargeName String
退貨地址名稱
可於 Coupang Wing 查詢，或透過「退貨地址查詢 API」註冊後取得
  returnZipCode String 
退貨地郵遞區號
可於 Coupang Wing 查詢，或透過「退貨地址查詢 API」註冊後取得
  unionDeliveryType String 
是否支援合併配送
參數名稱
狀態
UNION_DELIVERY
可進行合併配送
NOT_UNION_DELIVERY
不可進行合併配送

※ 合併配送條件： 

  • 必須填寫出貨地資訊（僅限相同出貨地的商品才可合併配送） 
  • 不可限制「到付」的配送方式
 

Response Example

{
    "code": "SUCCESS",
    "message": "",
    "data": {
        "sellerProductId": 30100201234,
        "deliveryMethod": "SEQUENCIAL",
        "deliveryCompanyCode": "HYUNDAI",
        "deliveryChargeType": "NOT_FREE",
        "deliveryCharge": 2500,
        "freeShipOverAmount": 0,
        "deliveryChargeOnReturn": 0,
        "remoteAreaDeliverable": "N",
        "unionDeliveryType": "NOT_UNION_DELIVERY",
        "returnCenterCode": "56642",
        "returnChargeName": "타워730",
        "companyContactNumber": "02-123-7678",
        "returnZipCode": "13590",
        "returnAddress": "서울특별시 송파구 송파대로 570 (신천동)",
        "returnAddressDetail": "타워",
        "returnCharge": 2500,
        "outboundShippingPlaceCode": 63714,
        "extraInfoMessage": "",
        "pccNeeded": false
    }
}

錯誤說明

HTTP 狀態碼
錯誤訊息
解決方法
400 Data of product (XXXXXXXXX) doesn't exist.
確認 sellerProductId 是否存在
  
 

API 名稱

GET_PARTIAL_PRODUCT_BY_PRODUCT_ID