来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates for Payment and Product
Dear Developers
Please find below the OpenAPI updates released this time. These changes aim to enhance functionality, improve flexibility, and provide better integration support.
§3 2. [TW][Important] Product Attribute Adjustments for Selected Categories
2. [TW][Important] Product Attribute Adjustments for Selected Categories
To improve product information completeness and buyers' search experience, we will adjust the product attribute settings for selected categories, effectively enhancing product exposure and competitiveness. Please review and refine your product attribute settings before the effective date.
For details, please refer to the SEH article.
Scope of Impact
- TW local sellers
- Affected categories: (please refer to the attachment in the SEH article) Home Appliances Home & Living Computers & Accessories Mobile & Gadgets
Summary of Changes
- New attributes have been added for selected categories, and the legacy attributes will be removed starting from the effective date.
Recommendation
- Please refer to the attribute list and mandatory-field information in the SEH article and configure the affected categories accordingly.
- You can call v2.product.get_attribute_tree to dynamically retrieve the latest attribute definitions for each category, and use the “mandatory” field to confirm whether an attribute is required.
Related APIs
- v2.product.get_attribute_tree
- v2.product.search_attribute_value_list
- v2.product.get_recommend_attribute
- v2.product.add_item
- v2.product.batch_add_item
- v2.product.update_item
Note: The system will NOT automatically modify or delist existing items. Existing legacy attribute values will remain unchanged and will not be converted to the new attribute values until the seller edits them.
Effective Date
September 30, 2026
尊敬的开发者
请查收本次的 OpenAPI 功能更新。这些改动旨在提升功能灵活性、优化使用体验,并为集成提供更好的支持。
§4 1. [BR] Payment 接口调整 KIT 相关字段名称
1. [BR] Payment 接口调整 KIT 相关字段名称
背景
KIT 已于 2024年底在 BR 上线,用于支持卖家以更规范的方式创建组合商品。
为支持KIT业务,提升卖家和买家的使用体验, Payment相关接口将调整KIT相关字段名称。
适用范围
BR
更新内容
v2.payment.get_escrow_detail/ v2.payment.get_escrow_detail_batch 将调整以下 KIT 相关字段名称。
| Field | Type | Description |
|---|---|---|
| mt_item_id → original_product_id | Field Name Change | KIT 原商品 ID 字段名称调整。 |
| mt_model_id → original_model_id | Field Name Change | KIT 原 model ID 字段名称调整。 |
| parent_item_price → original_price | Field Name Change | KIT 原商品价格字段名称调整。 |
| item_price_prorated → proportional_price | Field Name Change | KIT 商品按比例分摊价格字段名称调整。 |
Note:
请开发者根据字段名称变更调整 Payment 接口解析、订单收入计算及退款相关处理逻辑,避免因字段名变更导致系统解析异常。
相关接口
v2.payment.get_escrow_detail_batch
生效日期
Lived
§5 2. 针对部分类目进行商品属性优化调整
2. 针对部分类目进行商品属性优化调整
為提升商品資訊完整性與買家搜尋體驗,我們將針對部分商品類別的商品屬性設定進行調整,以有效提升商品的曝光力與競爭力。請於生效日前檢視並更新完善您的商品屬性設定。
詳細請參考:賣家幫助中心文章
影響範圍
- TW local 賣家
- 影響商品類別:(請參閱 賣家幫助中心文章 中的附檔) 家用電器 居家生活 電腦與周邊配件 手機平板與周邊
變更重點摘要
- 系統已針對部分類別新增新的屬性,舊的屬性將於生效日起移除。
建議
- 請參考賣家幫助中心公告的屬性清單與必填資訊, 針對有影響的類別進行設定。
- 您可以呼叫v2.product.get_attribute_tree 動態取得類別的最新屬性定義,並透過“mandatory” 欄位確認是否必填。
相關 API
- v2.product.get_attribute_tree
- v2.product.search_attribute_value_list
- v2.product.get_recommend_attribute
- v2.product.add_item
- v2.product.batch_add_item
- v2.product.update_item
注意:系統不會主動更改或下架既有商品,既有舊的屬性值也不會自動調整為新的屬性值,需要由賣家自行編輯調整。
生效日期
2026年 09月 30 日