快工助手跨境电商知识与商机助手

Significant Open Platform Update

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/api-mediaspacetopic/api-producttopic/changelogtopic/developertopic/openapi-updates

资料正文

§1 Significant Open Platform Update

Dear Developers,

1.[TW]Updates on Item Certification

Please be advised of the important updates regarding the specifications and policies for item listings in TW shops.

Starting from September 22, 2025, you must provide a "輸入許可通知" and a "繁體中文標示" when listing imported food items. If your items fit into these categories, system will verify that you have uploaded the required certificates before allowing you to add or update the item.

For detailed explanation of the policy, please refer to the Seller Education Hub article: 一般食品商品上架說明

Timeline - Aguust 28, 2025: Allow upload ”輸入許可通知” &”繁體中文標示”, optional - September 22, 2025: ”輸入許可通知” & “繁體中文標示” will be mandatory for add or update some imported food items.

To upload the relevant certificate files via OpenAPI, you'll need to use the following APIs:

APIsDescription
v2.product.get_product_certification_ruleYou can use the “category_id”, “attribute_id”, or “value_id” to check if a certificate file is required. If your query allows for a certificate file upload, this API will return the corresponding information. Please note that if the “is_mandatory” field returns true, it means this certificate file is a required field when you add or update an item.
v2.media_space.upload_imageUse this API to upload the certificate file and obtain an “image_id” to be included when adding or updating an item.
v2.product.add_itemv2.product.update_itemWhen adding or updating an item, you can use the “certification_info” field in the request to input the certificate file information.
v2.product.get_item_base_infoAfter an item has been added or updated, you can use this API to retrieve the certificate file information you previously uploaded.

Suggest call flow:

2.Category Recommendation Model Upgrade

Starting today, the v2.product.category_recommend API has been upgraded to the Smart Template model.

With this enhancement, the system will deliver more accurate category recommendations, improving listing efficiency and precision.

Please note that this is solely a model update. There are no changes to the API itself, and no re-integration is required. You can continue using the API as usual.

Related API:

v2.product.category_recommend

Effective Date on Live:

August 22, 2025

尊敬的开发者,

1.[TW] 商品认证相关更新

請注意有關 台灣店舖 商品刊登規範和政策的重要更新。

自 2025 年 09 月 22 日起,上架進口食品商品須提供「輸入許可通知」及「繁體中文標示」。若您的商品符合此類型,系統會校驗是否有上傳證書才會允許商品進行新增 或 更新。

政策面的詳細規範說明可以參考賣家幫助中心文章:一般食品商品上架說明

時程說明: - 2025 年 08 月 28 日:允許上傳「輸入許可通知」及「繁體中文標示」,選填 - 2025 年 09 月 22 日:新增或更新部分進口食品商品必填「輸入許可通知」及「繁體中文標示」

透過 OpenAPI 上傳相關證書檔案,您將會需要使用以下 API:

APIs說明
v2.product.get_product_certification_rule您可以使用 “category_id” 或 “attribute_id” 或 “value_id” 來確認是否需要上傳相關證書;若您所查詢的內容允許上傳證書,此 API 將會返回您對應的資訊,請特別留意若 “is_mandatory” 欄位返回值為 true,則代表執行商品新增或更新時,該類證書為必填。
v2.media_space.upload_image您可以透過此 API 來上傳證書檔案,並取得 image_id 用於新增或更新商品時附上證書檔案
v2.product.add_itemv2.product.update_item新增或更新商品時,可以使用 request 中的 “certification_info” 欄位來填入證書資訊。
v2.product.get_item_base_info當商品完成新增或更新時,您可以使用此 API 取得先前上傳的證書資訊。

建議呼叫流程:

2.类目推荐模型升级通知

自即日起,v2.product.category_recommend 接口已切换至 Smart Template 模型。新的推荐模型将提供更精准的类目推荐,进一步提升商品刊登的效率和准确性。

请注意,本次仅为模型更新,接口本身没有任何改动,无需重新对接。您可以继续正常使用该接口。

影响接口:

v2.product.category_recommend

生效日期:

2025年8月22号

#