商品 API 品類 API 運輸 / 訂單 API 退貨 API 換貨 API 物流資訊客服 / 諮詢

商品 API

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

商品修改（無需審核）

# 01

簡介

商品修改（無需審核）

# 02

詳細內容

消費者市場：韓國、台灣

可在不經過任何審核流程的情況下，快速修改配送與退貨地點資訊。

可修改的屬性請參考 Body Parameter。

狀態為「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/{sellerProductId}/partial

URL API Name

UPDATE_PARTIAL_PRODUCT

# 03

Path 參數

Name	Type	Description
sellerProductId*	string	註冊商品ID 商品建立完成後，將顯示已註冊的商品 ID。

# 04

請求內容

請求參數

請求內容參數

Name	Type	Description
sellerProductId*	integer	Registered product ID 商品建立完成後，將顯示已註冊的商品 ID。
companyContactNumber	string	退貨地點聯絡電話請於透過 Coupang WING 或退貨地點建立 API 註冊退貨地點後進行確認。
deliveryCharge	integer	標準運費若為付費配送或條件式免運，請輸入單程配送費用金額。
deliveryChargeOnReturn	number	退貨時的初始配送費用免運配送情況下，由顧客負擔的退貨運費。
deliveryChargeType	string	配送費用類型
deliveryCompanyCode	string	Courier code
deliveryMethod	string	配送方式
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	是否可進行合併配送

請求範例application/json

{
  "sellerProductId": 30100208559,
  "deliveryCharge": 3000
}

# 05

回應內容

Response Example

{
  "code": "200",
  "message": "",
  "data": {
    "code": "SUCCESS",
    "message": "",
    "data": 30100201234
  }
}

# 06

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
400	400	Recheck seller product ID.	請確認 URL 路徑中的 sellerProductId 與 request body 中的 sellerProductId 是否一致。
400	400	Must input seller product ID.	Check if you've entered sellerProductId in requestBody.
400	400	Registered product ID [xxxxxx] does not exist.	請確認是否已在 request body 中輸入 sellerProductId。
400	400	Cannot change deleted product.	請確認是否輸入了不存在的 sellerProductId。
400	400	Cannot change product that is awaiting approval.	請確認商品狀態是否為「awaiting approval」。
400	400	Cannot change product that is in process of being created.	請確認商品狀態是否為「temporarily being saved」。
500	500	Failed to modify product. Please contact Coupang.	如發生非預期的系統錯誤，請透過線上諮詢聯絡 Coupang。