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

商品查詢（無需審核）

# 01

簡介

商品查詢（無需審核）

# 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/{sellerProductId}/partial

URL API Name

GET_PARTIAL_PRODUCT_BY_PRODUCT_ID
# 03

Path 參數

NameTypeDescription
sellerProductId*string
已註冊商品 ID（商品建立後顯示的 ID）
# 04

回應內容

回應訊息

NameTypeDescription
codestring
結果代碼（SUCCESS / ERROR）
messagestring
訊息
dataobject
sellerProductId
data.sellerProductId
integer
已註冊商品 ID
商品建立後所顯示的商品 ID（data 欄位）.
companyContactNumber
data.companyContactNumber
string
退貨地址聯絡電話
可於 Coupang Wing 查詢，或透過退貨地址查詢 API 註冊後取得
deliveryCharge
data.deliveryCharge
integer
標準配送費
適用於收費配送及條件免運時，填寫單程配送費金額
deliveryChargeOnReturn
data.deliveryChargeOnReturn
integer
退貨初始運費
免運商品退貨時由顧客負擔的配送費用
deliveryChargeType
data.deliveryChargeType
string
配送費類型
參數名稱 狀態
FREE 免運費
NOT_FREE 收費配送
CHARGE_RECEIVED 到付
CONDITIONAL_FREE 條件免運
設定說明
  • 免運費（FREE）：設定退貨時的初始配送費（單程）【deliveryChargeOnReturn】以及退貨配送費（單程）【returnCharge】
  • 收費配送（NOT_FREE）：設定標準配送費【deliveryCharge】以及退貨配送費（單程）
  • 條件免運（CONDITIONAL_FREE）：設定標準配送費以及退貨配送費（單程）
  • 到付（CHARGE_RECEIVED）：適用到付的商品類別已預先定義，並由賣家客服中心提供相關指引
※ 對於【CONDITIONAL_FREE】，可自由設定免運條件金額
deliveryCompanyCode
data.deliveryCompanyCode
string
物流公司代碼
deliveryMethod
data.deliveryMethod
string
配送方式
參數名稱 說明
SEQUENCIAL 一般配送（依序配送）
COLD_FRESH 冷藏／冷凍配送
MAKE_ORDER 訂製商品（接單製作）
AGENT_BUY 代購
VENDOR_DIRECT 賣家直送（含安裝配送或由賣家直接配送）
「INSTRUCTURE」與「MAKE_ORDER_DIRECT」已整合為 VENDOR_DIRECT.
extraInfoMessage
data.extraInfoMessage
string
訂製商品相關說明訊息
當客戶選擇「訂製商品（made to order）」配送類型時所顯示的訊息.
freeShipOverAmount
data.freeShipOverAmount
integer
免運條件金額
● 範例：若希望設定「滿 10,000 韓元免運」，請將［deliveryChargeType］設定為 CONDITIONAL_FREE，並在［freeShipOverAmount］輸入 10000。
※ 僅可輸入 100 韓元為單位（或其倍數）
※ 輸入 0 表示免運
outboundShippingPlaceCode
data.outboundShippingPlaceCode
integer
出貨地地址代碼
選擇「合併配送」時為必填項，請透過出貨地查詢 API 進行確認.
pccNeeded
data.pccNeeded
boolean
是否需要 PCC（個人通關編碼）

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

建立退貨地址後，請擷取並輸入退貨中心代碼
  • 退貨地址可透過 WING 或「退貨地址建立 API」新增
  • 若無法建立退貨地址，請輸入 "NO_RETURN_CENTERCODE" 以手動填寫退貨資訊
※ 自動退貨整合服務（Goodsflow）僅適用於已簽約之物流公司
※ 退貨中心代碼為必填項目
returnCharge
data.returnCharge
integer
退貨運費
退貨回收時所收取的單程配送費用
returnChargeName
data.returnChargeName
string
退貨地址名稱
可於 Coupang Wing 查詢，或透過「退貨地址查詢 API」註冊後取得
returnZipCode
data.returnZipCode
string
退貨地郵遞區號
可於 Coupang Wing 查詢，或透過「退貨地址查詢 API」註冊後取得
unionDeliveryType
data.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
  }
}
# 05

錯誤碼

HTTP代碼訊息
400HTTP_400Bad Request

錯誤說明

HTTP類型錯誤訊息解決方案
400400

Data of product (XXXXXXXXX) doesn't exist.

確認 sellerProductId 是否存在