09.29 Significant OpenAPI Updates

Significant OpenAPI Updates

Dear Developers,

Shopee is enhancing the Kit feature in order to address seller pain points and improve overall product listing and transaction experiences.

Change Details

1. New API: v2.product.generate_kit_image

· Description: Generate a composite image by combining all cover images of the selected items in a kit.

2. API: v2.product.get_item_base_info

New Response Field: "tag": {

"kit": false

}

3. API: v2.product.add_kit_item & v2.product.update_kit_item

New API Error Message: Quantity must be higher than one for kits with one model

4. API: v2.payment.get_escrow_detail,v2.payment.get_escrow_detail_batch

· New Fields(Only for BR local shops):

· is_kit (boolean: true/false)

· kit_items: returns component-level details of the kit.

· mt_item_id → The merchant item identifier of the product within the kit

· mt_model_id → The merchant product model of the item within the kit.

· total_qty → The quantity of this specific component within the kit

· parent_item_price → The price of the item when it is listed as a standalone item.

· item_price_prorated → The price of the item when it is listed as a standalone item.

Effective Date

Lived

Impact to Developers

· Developers must update their integration to handle the new API,new fields and new error messages.

尊敬的开发者，

本次更新主要聚焦于套装（Kit）功能的优化，并提升托管金（Escrow）相关接口的能力，目标是为卖家提供更灵活的套装创建与管理体验，同时确保套装交易的支付信息更加透明和清晰。

接口变更

1. 新接口：v2.product.generate_kit_image

· 功能：合成生成套装图片，将所选商品的主图合并为一张套装主图。

2. 接口：v2.product.get_item_base_info

新增响应字段： "tag": {

"kit": false

}

3. 接口：v2.product.add_kit_item & v2.product.update_kit_item

新增错误信息： Quantity must be higher than one for kits with one model

4. 接口：v2.payment.get_escrow_detail, v2.payment.get_escrow_detail_batch

· 新增字段(仅适用于巴西本土店铺)：

· is_kit（tboolean: true/false）

· kit_items：返回套装子商品的明细。

· mt_item_id → 套装内商品的商品编号

· mt_model_id → 套装内商品的商品型号

· total_qty → 该组件在套装中的数量

· parent_item_price → 指商品在不属于套装时，单独上架时的原始价格

· item_price_prorated → 商品在套装中按比例分摊后的价格

生效日期

· Lived

开发者操作

· 开发者需更新接口同时确保能正确处理新增字段与错误信息。