消費者市場：韓國、台灣
可在不經過任何審核流程的情況下，快速修改配送與退貨地點資訊。
狀態為「Temporarily saved」及「Awaiting approval」的商品無法進行修改。
通路
PUT
/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/30100208559/partial
參數需求
請求範例
| 名稱 | 必填 | 類別 | 描述 |
| sellerProductId | O | String |
註冊商品ID 商品建立完成後，將顯示已註冊的商品 ID。 |
請求主體參數
| 名稱 | 必填 | 類別 | 描述 | |
| sellerProductId | O | Number |
Registered product ID 商品建立完成後，將顯示已註冊的商品 ID。 |
|
| companyContactNumber | String |
退貨地點聯絡電話 請於透過 Coupang WING 或退貨地點建立 API 註冊退貨地點後進行確認。 |
||
| deliveryCharge | Number |
標準運費 若為付費配送或條件式免運，請輸入單程配送費用金額。 |
||
| deliveryChargeOnReturn | Number |
退貨時的初始配送費用 免運配送情況下，由顧客負擔的退貨運費。 |
||
| deliveryChargeType | String | 配送費用類型 | ||
| 參數名稱 | 狀態 | |||
| FREE | 免運配送 | |||
| NOT_FREE | 付費配送 | |||
| CHARGE_RECEIVED | 到貨付款（運費到付） | |||
| CONDITIONAL_FREE | 條件式免運 | |||
|
● 若為免運配送： 請設定退貨時的初始配送費（單程）[deliveryChargeOnReturn] 以及退貨運費（單程）[returnCharge]。 ● 若為付費配送： 請設定標準配送費 [deliveryCharge] 以及退貨運費（單程）。 ● 若為條件式免運配送： 請設定標準配送費及退貨運費（單程）。 ● 若為到貨付款： 適用到貨付款的商品類別已預先定義，並由賣家支援中心提供指引給商家。 ※ 針對【CONDITIONAL_FREE】，您可自行設定免運條件金額。 | ||||
| deliveryCompanyCode | String | Courier code | ||
| deliveryMethod | String | 配送方式 | ||
| 參數名稱 | 狀態 | |||
| SEQUENCIAL | 一般配送（依序配送） | |||
| COLD_FRESH | *台灣市場無售。 | |||
| MAKE_ORDER | ||||
| AGENT_BUY | ||||
| VENDOR_DIRECT | ||||
| extraInfoMessage | String |
接單後製作商品的說明訊息 當顧客選擇配送方式為「made to order」時顯示的訊息。 |
||
| freeShipOverAmount | Number |
免運配送的條件金額 例如：若要設定消費滿 10,000 NTD即可免運，請將 [deliveryChargeType] 設為「CONDITIONAL_FREE」，並於 [freeShipOverAmount] 輸入 10000。 ※ 僅可輸入 100 NTD為單位或以上的金額 ※ 輸入 0 表示免運配送 |
||
| outboundShippingPlaceCode | Number |
出貨地點地址代碼 選擇合併配送時為必填項目，可透過 Shipping Location Query API 進行查詢。 |
||
| outboundShippingTimeDay | Number |
出貨所需天數（天） 請輸入自訂單成立日（D-day）起，幾天後商品會出貨。 例如：若隔天出貨，請輸入「1」（D+1）。 |
||
| pccNeeded | Boolean | 不適用用 TW 市場 | ||
| remoteAreaDeliverable | String | 不使用 TW 市場 | ||
| returnAddress | String |
退貨地點地址 請於 Coupang Wing 查詢，或透過 Return Location Query API 註冊退貨地點後確認。 |
||
| returnAddressDetail | String |
退貨地點詳細地址 請於 Coupang Wing 查詢，或透過 Return Location Query API 註冊後確認。 |
||
| returnCenterCode | String |
退貨中心代碼 建立退貨地點後，請擷取並輸入退貨中心代碼。 ● 退貨地點可透過 WING 或退貨地點建立 API 建立。 ● 若無法建立退貨地點，請輸入「NO_RETURN_CENTERCODE」以手動新增退貨地點資訊。 自動退貨整合服務（Goodsflow）僅限已簽約物流使用，且必須填寫退貨中心代碼。 |
||
| returnCharge | Number |
退貨運費 退貨取件的單程配送費用。 |
||
| returnChargeName | String |
退貨地點名稱 請於 Coupang Wing 查詢，或透過 Return Location Query API 註冊後確認。 |
||
| returnZipCode | String |
退貨地點郵遞區號 請於 Coupang Wing 查詢，或透過 Return Location Query API 註冊後確認。 |
||
| unionDeliveryType | String | 是否可進行合併配送 | ||
| 參數名稱 | 狀態 | |||
| UNION_DELIVERY | 可合併配送 | |||
| NOT_UNION_DELIVERY | 不可合併配送 | |||
|
※ 合併配送條件： 出貨地點資訊為必填，僅限出貨地點相同的商品可進行合併配送。 不可限制到貨付款選項。 | ||||
請求範例
{
"sellerProductId": 30100201234,
"deliveryMethod": "SEQUENCIAL",
"deliveryCompanyCode": "KERRY_TW",
"deliveryChargeType": "CONDITIONAL_FREE",
"deliveryCharge": 2500,
"freeShipOverAmount": 10000,
"deliveryChargeOnReturn": 0,
"remoteAreaDeliverable": "N",
"unionDeliveryType": "UNION_DELIVERY",
"returnCenterCode": "1000274592",
"returnChargeName": "RETRUNCENTER_1",
"companyContactNumber": "02-123-1234",
"returnZipCode": "15200",
"returnAddress": "",
"returnAddressDetail": "",
"returnCharge": 2500,
"outboundShippingPlaceCode": 63714,
"extraInfoMessage": "",
"pccNeeded": false,
"outboundShippingTimeDay": 2
}
除 sellerProductId 為必填欄位外，其餘欄位皆為選填，僅需提供欲修改的欄位即可。
{
"sellerProductId": 30100208559,
"deliveryCharge": 3000
}
返回信息
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 30100201234
}
}
錯誤說明
|
HTTP status code (error type) |
Error message | Solution |
| 400 | Recheck seller product ID. | 請確認 URL 路徑中的 sellerProductId 與 request body 中的 sellerProductId 是否一致。 |
| 400 | Must input seller product ID. | Check if you've entered sellerProductId in requestBody. |
| 400 | Registered product ID [xxxxxx] does not exist. | 請確認是否已在 request body 中輸入 sellerProductId。 |
| 400 | Cannot change deleted product. | 請確認是否輸入了不存在的 sellerProductId。 |
| 400 | Cannot change product that is awaiting approval. | 請確認商品狀態是否為「awaiting approval」。 |
| 400 | Cannot change product that is in process of being created. | 請確認商品狀態是否為「temporarily being saved」。 |
| 500 | Failed to modify product. Please contact Coupang. | 如發生非預期的系統錯誤，請透過線上諮詢聯絡 Coupang。 |
URL API Name
UPDATE_PARTIAL_PRODUCT