商品查詢（無需審核）

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

此 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

OPENAPI 관련 안내

此段落內的文章

路徑

範例端點

請求參數

Path 參數

請求範例

回應欄位說明

Response Example

錯誤說明

API 名稱

OPENAPI 관련 안내

此段落內的文章

路徑

範例端點

請求參數

Path 參數

請求範例

回應欄位說明

Response Example

錯誤說明

API 名稱

相關文章