產品API

產品相關API的常見問題

• 關於所有類別購買選項變更的通知（2024 年 10 月 10 日）：常見問題集
Q：什麼正在改變？ 您現在需要輸入由 Coupang 目錄定義的購買選項。您必須註冊每個購買選項可用的屬性值。不允許創建自定義購買選項。 例如，如果您要列出飲料產品，則必須輸入數量和每件商品尺寸或每件商品重量。它應該像“Count: 1”並且不允許任何自定義選項（例如，“Option: None”）。也不允許“Quantity: single item”。   Q：此變更是否也適用於現有產品... 檢視更多
• 如何透過 API 建立新的套裝或組合商品清單？
您應該首先選擇一個可以組成套裝商品的類別。請查看附件檔案並選擇適合註冊商品的類別。 範例）「5 種女性護膚套組」。 * Category ID: 56180 Skin>Basic Set>Set of 4 or more* Mandatory Options: 수량* Option value: 1세트 檢視更多
• 當建立或修改商品時，出現退貨運費錯誤
請查看下面的通知連結，以查看您輸入的運費和退貨費用是否符合標準。https://wing.coupang.com/tenants/wing-account/partner/notices/54932 檢視更多
• 我可以透過 OpenAPI 搜尋 SupplyHub 和 Rocket Growth 產品嗎？
目前，您詢問的 SupplyHub 和 Rocket Growth 產品不支援 OpenAPI。 請注意，只有賣家配送的產品可以透過 OpenAPI 查看 檢視更多
• 產品組成、當日送達、目錄匹配管理以及 OpenAPI 支援的自動價格調整功能？
您詢問的產品組成、當日送達、目錄匹配管理和自動價格調整功能不受 OpenAPI 支援。 請在 WING (wing.coupang.com) 上使用它。 檢視更多
• 當使用 API 修改商品時，發生「Required options (weight per piece, other) have not been entered.」錯誤
當修改已在 Coupang 註冊的商品時，1. 首先，使用商品查詢 API (GET) 在 Coupang 中搜尋商品2. 在僅更改您想要編輯的部分值之後，在您檢視的整個 JSON 格式的文本中3. 您必須請求修改整個 JSON 才能正確反映出來。 當修改商品時，如果排除某些已註冊的商品選項，將顯示您請求的錯誤訊息。如果您排除如下所示輸入的 attributeTypeName 和 attri... 檢視更多
• 錯誤 'duplicated item name exists' 發生在使用 API 修改產品時
當透過 API 修改在 Coupang 註冊的產品時，1. 首先，使用產品查詢 API (GET) 搜索在 Coupang 註冊的產品2. 僅在 JSON 格式的整個文本中編輯部分值後3. 如果您請求完整的 JSON 文本，則可以正常編輯。 請檢查初始註冊資訊中是否缺少 attributeTypeName, attributeValueName 值。 檢視更多
• 當使用 API 修改商品時，出現錯誤訊息 '您無法刪除正在銷售中的商品'
當透過 API 修改在 Coupang 註冊的商品時，1. 首先，使用商品查詢 API (GET) 搜尋在 Coupang 註冊的商品2. 僅在更改 JSON 格式的文本中要編輯部分的值之後3. 如果您請求完整的 JSON 文本，則可以正常編輯。 當修改商品時，如果註冊商品的部分或全部選項遺失或排除，將會顯示錯誤訊息。商品註冊後，如果審核完成，則無法刪除該選項商品。請檢查是否遺失選項項目 (... 檢視更多
• 如何透過 API 建立新的套裝或組合商品清單？
您應該首先選擇一個可以組成套裝商品的類別。請查看附件檔案並選擇適合註冊商品的類別。 範例）「5 種女性護膚套組」。 * Category ID: 56180 Skin>Basic Set>Set of 4 or more* Mandatory Options: 수량* Option value: 1세트 檢視更多
• 我可以透過產品修改 API 為已註冊為單一產品（單一選項產品）的產品新增選項嗎？
無法透過修改產品來將選項新增到註冊為單一產品（一個可選產品）的產品。如果您想新增選項，我們建議刪除現有產品並建立新產品。 檢視更多
• 透過 API 註冊或修改商品時，輸入的 itemName 值未正確顯示
在 API JSON 文本中，itemName 是一個用於區分每個項目（選項）的內部值。API 上的 itemName 和 WING 中顯示的選項名稱不相關，並且在通過 API 修改 itemName 時可能會顯示不同。請注意，顯示順序也不保證。 檢視更多
• 使用 API 註冊商品時，發生錯誤 "The item with the same option and option value as an item exists in duplicate"
1. 請檢查在商品建立 JSON 文字中，每個選項是否沒有重複的 itemName 值。2. 檢查 attributeTypeName 和 attributeValueName 值是否已輸入到 attribute 陣列中，以便它們不被重複。 檢視更多
• 我透過修改商品 API 變更了運費類型和免運費條件金額。何時會反映在 Coupang 前台？
如果使用修改商品 API 修改運費，則需要審核流程。審核完成後，可能至少需要 4 小時或最多 24 小時才能反映在 Coupang 前台，因此在修改運費時，請使用商品修改（無需審核）API。 檢視更多
• 如何從客戶那裡取得個人海關通關號碼 (PCC)？
您可以在產品建立 API 中將 pccNeeded 值設定為 true。 檢視更多
• 如何刊登平行進口貨品？
要刊登平行進口貨品，請檢查以下兩件事，如下所示： 1. 輸入平行進口（平行進口）商品的「PARALLEL_IMPORTED」。 {"parrallelImported": "PARALLEL_IMPORTED"} 2. 在 json 檔案中註冊所需的檔案（「requiredDocuments」）。 對於平行進口，您需要註冊所需的文件（進口通知證書）。 要註冊或修改，請如下所示在 json 訊... 檢視更多
• 商品刊登的搜尋關鍵字有哪些規則？
每個關鍵字不應超過 20 個字元。您最多可以輸入 20 個關鍵字。 您的關鍵字不應包含任何特殊字元，但以下字元除外：!@#$%^&*-+;:'. 一般而言，所有與產品相關的關鍵字都是可以接受的。 如需更多有關搜尋關鍵字的詳細資訊，請參閱以下連結中的指南： 前往 [關鍵字刊登指南] 檢視更多
• 當我呼叫 List Product API 時，出現以下錯誤：「Input error」
這個錯誤通常出現在程式碼行有問題時。 請修改 json body 中相應的程式碼行。 檢視更多
• 我可以使用 Coupang 註冊賣家提供的唯一金鑰（產品管理代碼）來管理我的產品嗎？
當您創建產品時，請輸入 “externalVendorSku”（賣家產品代碼）以在您的產品訂單中使用該代碼，以便進行管理等。 對於其他值，請使用“extraProperties”（額外選項）欄位。此欄位未在前端公開。這是為了方便賣家。您可以輸入自己的管理代碼/您需要額外儲存的其他值。 欲了解更多詳情，請參考[創建產品 API] 獲取參數信息。 檢視更多
• 我想要新增一個商品 (供應商商品)
將所有子類別新增到項目陣列中的相應選項中。請勿在新增的選項中輸入 "sellerProductItemId"。 檢視更多
• API會發生這樣的錯誤-“已創建為供應商項目的商品無法刪除”
當您嘗試刪除已經核准的商品時，會發生此錯誤。 對於已經核准的商品，您無法刪除這些選項。因此，請將選項標記為「暫停銷售」並相應地操作。 檢視更多
• 我的商品可以按照我註冊的選項順序顯示在網站上嗎？
不，它們不能。 這些商品將按照Coupang自己的邏輯顯示在前面（銷售頁面）上。 檢視更多
• 我想搜尋產品。我可以在哪裡找到 sellerProductId？
sellerProductId 可以在產品建立時以「response」的形式提供，並透過 [Product List paging retrieve API] 和 [Product List segment retrieve API] 進行檢查。 檢視更多
• 顯示的訊息顯示，“賣家商品[********]未找到或無法刪除。商品只能在“已保存”或“暫時保存”的狀態下刪除。
您可以刪除商品，僅當所有選項在商品切換到“暫停銷售”狀態下時。 請在暫停所有選項進行銷售後再次嘗試。 檢視更多
• '搜尋範圍已超過。螢幕上顯示「最大搜尋範圍為 10 分鐘」的錯誤訊息。'
您只能在 [產品清單區段擷取 API] 中設定的 10 分鐘範圍內查詢產品。 請重新設定查詢範圍。 檢視更多
• 如何在我想要批准產品時檢查 sellerProductId？
sellerProductId 將會在產品建立階段顯示為回應訊息。(或者你可以在賣家入口網站 (WING) 的產品查詢中，根據「註冊產品 ID」搜尋。) 檢視更多
• 錯誤訊息 "Object text must begin with '{' at character 0" is displayed.“
請檢查 vendorItemld。 vendorItemld 是產品核准後建立的選項 ID。 請檢查並確認您已輸入正確的值。 檢視更多
• 錯誤訊息 'There is an error in the input value. line:1' ，這樣的錯誤如何解決？
當無法識別確切錯誤位置時，會顯示錯誤訊息 'line:1'，因為輸入值以單行輸入。 請在使用 JSON Viewer 更改 JSON 格式後重試。 * 參考推薦的 JSON Viewer: http://jsonviewer.stack.hu/ 檢視更多
• 我能使用 <iframe> 標籤？
在接口中，您不能使用 <iframe> 標籤，除了 YouTube 和一般圖片之外。 檢視更多
• 我想要刪除一個商品（供應商商品）。
您可以僅在商品首次上架且尚未被批准前刪除該商品。（一旦 "vendorItemId" 建立並獲批准後，您就無法刪除它。） 若要在批准前刪除，刪除商品陣列中各個選項的所有子類別。（您希望保留的選項應包含 "sellerProductItemId"。） 檢視更多
• 我收到以下錯誤訊息：「無法變更銷售價格。您可以在以下範圍內變更：比之前的銷售價格低至 50% - 高至 100%。」
為了防止賣家提供不正確的價格，並保護他們免於犯錯，Coupang 限制了給定範圍內的價格修改。 如果您需要一次性大幅調整價格，請使用「商品價格變更 API」將 "forceSalePriceUpdate" 設置為 'True'。 檢視更多