来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
Significant OpenAPI Updates
Dear Developers,
1.To enhance price competitiveness, we are introducing location-based pricing for cross-border (CB) sellers.
Currently, CB sellers can only set one price per SKU, regardless of whether the item is shipped from local warehouses or CB warehouses. As shipping from local warehouses is typically cheaper, this limitation results in higher-than-necessary local stock pricing and reduced competitiveness.
With this update, CB sellers will be able to set differentiated prices by stock location, ensuring better alignment with actual logistics costs and stronger market competitiveness.
The following updates are introduced:
[Update]
1.Product:
- v2.product.get_item_base_info: Added response fields "local_promotion_price" and "local_price"
- v2.product.get_model_list: Added response fields "local_promotion_price" and "local_price"
- item_price_update_push: The field update_field now supports a new enum value "local_price"
2.Discount:
v2.discount.get_discount API add the following response fields:
| Name | Type | Description |
|---|---|---|
| item_list | object[] | / |
| >item_local_price | float | The local price of item calculated as: Local Price = CB Original Price × Local Adjustment Rate. |
| >item_local_promotion_price | float | The local discount price of item calculated as: Local Discount Price = Local Price × Discount Rate. |
| >item_local_price_inflated | float | The local price after tax of item. |
| >item_local_promotion_price_inflated | float | The local discount price after tax of item. |
| >model_list | object[] | / |
| >model_local_price | float | The local price of model calculated as: Local Price = CB Original Price × Local Adjustment Rate. |
| >model_local_promotion_price | float | The local discount price of model calculated as: Local Discount Price = Local Price × Discount Rate. |
| >model_local_price_inflated | float | The local price after tax of model. |
| >model_local_promotion_price_inflated | float | The local discount price after tax of model. |
[New]
- v2.global_product.get_local_adjustment_rate: Retrieve adjustment rates for local stock pricing.
- v2.global_product.update_local_adjustment_rate: Update adjustment rates for local stock pricing.
Usage Example: Developers can first use get_local_adjustment_rate to check the current adjustment rate applied to local warehouse prices, and then call update_local_adjustment_rate to modify the rate when sellers want to align their local stock prices with changing logistics or market conditions.
2.[Update] Payment APIs
v2.payment.get_escrow_detail
v2.payment.get_escrow_detail_batch
New response fields:
1.bulky_handling_fee – A fee charged to the buyer for special handling and transportation of bulky items (only for ID local sellers).
2.trade_in_bonus_by_seller – The discount provided by sellers/retailers for buyers who opt for trade-in.
3.trade_in_bonus_subtotal – The total amount of all trade-in bonuses in a transaction, summing contributions from Shopee, Seller, Bank, and Trade-in Partner.
4.buyer_paid_packaging_fee – A fee charged to the buyer for packaging materials, mainly applicable to Instant Mart projects.
Please ensure your systems can read and process the new response fields and APIs.
尊敬的开发者，
1.为提升商品价格竞争力，我们现已为跨境卖家推出 按库存位置设置价格 的能力。
目前，跨境卖家只能为每个 SKU 设置一个价格，无法区分本地仓与跨境仓的发货渠道。由于本地仓发货成本通常更低，这一限制导致本地库存价格偏高，从而削弱了价格竞争力。
本次更新后，跨境卖家可根据库存所在位置设置 差异化价格，更好地匹配实际物流成本，提升整体市场竞争力。
本次更新包含以下内容：
【更新接口】
Product：
- v2.product.get_item_base_info：新增响应字段 "local_price" 和 "local_promotion_price"
- v2.product.get_model_list：新增响应字段 "local_price" 和 "local_promotion_price"
- item_price_update_push：字段 update_field 新增枚举值 "local_price"
Discount：
v2.discount.get_discount 接口新增以下响应字段：
| Name | Type | Description |
|---|---|---|
| item_list | object[] | / |
| >item_local_price | float | 商品维度的本地价格，Local Price = CB Original Price × Local Adjustment Rate。 |
| >item_local_promotion_price | float | 商品维度的本地折后价格，Local Discount Price = Local Price × Discount Rate。 |
| >item_local_price_inflated | float | 商品维度的税后本地价格。 |
| >item_local_promotion_price_inflated | float | 商品维度的税后本地折后价格。 |
| >model_list | object[] | / |
| >model_local_price | float | 变体维度的本地价格，Local Price = CB Original Price × Local Adjustment Rate。 |
| >model_local_promotion_price | float | 变体维度的本地折后价格，Local Discount Price = Local Price × Discount Rate。 |
| >model_local_price_inflated | float | 变体维度的税后本地价格。 |
| >model_local_promotion_price_inflated | float | 变体维度的税后本地折后价格。 |
【新增接口】
- v2.global_product.get_local_adjustment_rate：获取本地库存定价的调整系数
- v2.global_product.update_local_adjustment_rate：更新本地库存定价的调整系数
使用场景：开发者可通过 get_local_adjustment_rate 查询当前的本地仓价格调整系数，当卖家希望根据物流成本或市场变化优化本地库存价格时，再调用 update_local_adjustment_rate 进行更新。
2.更新接口 - 支付相关
v2.payment.get_escrow_detail
v2.payment.get_escrow_detail_batch
新增响应字段：
1.bulky_handling_fee – 向买家收取的大件商品特殊搬运与运输费用（暂时仅适用于印尼本地卖家）。
2.trade_in_bonus_by_seller – 卖家/零售商为选择以旧换新的买家提供的优惠金额。
3.trade_in_bonus_subtotal – 交易中所有以旧换新优惠金额的总和，包括 Shopee、卖家、银行与合作方的贡献。
4.buyer_paid_packaging_fee – 向买家收取的包装材料费用，暂仅适用于 Instant Mart 项目。
请确保您的系统能够正确读取并处理新增的响应字段与接口。