来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Important OpenAPI Update
Dear Developer,
Please note the following changes:
1.Add export_cfop for BR export products
Applicable Region: BR
We are now support BR SIP to help BR sellers sell products to Mexico, Colombia, Chile. For BR export products seller need to input export_cfop in v2.product.add_item and v2.product.update_item API. And you can get export_cfop in v2.product.get_item_base_info after filling in.
Related APIs:
v2.product.add_item
v2.product.update_item
v2.product.get_item_base_info
Effective Date on Live:
2025.03.14
- New Transaction Type Added for wallet API
Applicable Region: BR
To comply with Brazilian tax regulations, Shopee will introduce a new transaction type to handle Differential Rate (DIFAL) fees under the Tax on Circulation of Goods and Services (ICMS).Type: BR_DIFAL_FEE_CHARGE
API v2.payment.get_wallet_transaction_list add a new transaction type: BR_DIFAL_FEE_CHARGE:445 // ICMS value for Destination Uf (Difal) generated in the order
Related APIs:
v2.payment.get_wallet_transaction_list
Effective Date on Live:
2025.03.14
- Add Shopee Consignment Service Purchase API Verification
Applicable developers: Service CNCB sellers for Shopee Confignment Service(SCS) (1) Modify Reason Requirement for PO Updates
In v2.purchase.modify_purchase_order, when modifying a non-zero requested_purchase_qty or setting need_removed = true, a valid modify_reason must be provided. Otherwise, an error will be returned:
➡ "Modify reason is required if modifying qty or removing SKU."
(2) Logistics Number Validation for 3PL Delivery
For API v2.purchase.update_asn_logistics_info, when delivery_method = DeliveryBy3PL, the field logistics_no must be provided. Otherwise, an error will be returned:
➡ "If you select DeliveryBy3PL, must input logistics_no."
Related APIs:
v2.purchase.modify_purchase_order
v2.purchase.update_asn_logistics_info
Effective Date on Live:
2025.03.14
- Certain categories in CBSC will soon require a mandatory size chart when listing products.
Applicable Regions: All regions
From April 15, some categories in CBSC will require a size chart when listing products. Please use v2.global_product.get_global_item_limit API to check size_chart_mandatory field to decide if it is mandatory. P.S. If any region under the global product category is mandatory, size_chart_mandatory would be true
Related APIs:
v2.global_product.get_global_item_limit
v2.global_product.add_global_item
v2.global_product.update_global_item
Effective Date on Live:
2025.03.14
- Shopee now supports the following four new return reasons：
Applicable Developer: All shops
- SIZE_DEVIATION
- LOOK_DEVIATION
- DATE_DEVIATION
- DIFFERENT_DESCRIPTION
Related APIs:
v2.returns.get_return_list
v2.returns.get_return_detail
Effective Date on Live:
2025.03.14
尊敬的开发者，
请留意以下OpenAPI更新： 1. 巴西出口商品新增export_cfop字段 适用地区：BR 现支持巴西SIP（跨境销售计划），帮助巴西卖家向墨西哥、哥伦比亚、智利销售商品。 巴西出口商品需通过API v2.product.add_item 和 v2.product.update_item 输入export_cfop字段。填写后，可通过 v2.product.get_item_base_info 获取该字段值。 相关API： - v2.product.add_item - v2.product.update_item - v2.product.get_item_base_info 生效日期：2025年3月14日 --- 2. 钱包API新增交易类型 适用地区：BR 为遵守巴西税务法规，Shopee将新增交易类型以处理ICMS（商品服务流通税）下的差价税率（DIFAL）费用。 类型：BR_DIFAL_FEE_CHARGE API v2.payment.get_wallet_transaction_list 新增交易类型： BR_DIFAL_FEE_CHARGE:445 // 订单中生成的“目的地联邦单位ICMS值（DIFAL）” 相关API： - v2.payment.get_wallet_transaction_list 生效日期：2025年3月14日 --- 3. 新增Shopee代运营服务采购API验证 适用开发者：使用Shopee代运营服务（SCS）的中国跨境卖家 (1) 修改采购订单需提供原因 通过 v2.purchase.modify_purchase_order 修改requested_purchase_qty（非零值）或设置need_removed = true时，必须填写有效modify_reason，否则返回错误： ➡ "Modify reason is required if modifying qty or removing SKU." (2) 3PL物流单号验证 通过 v2.purchase.update_asn_logistics_info 提交时，若delivery_method = DeliveryBy3PL，必须填写logistics_no，否则返回错误： ➡ "If you select DeliveryBy3PL, must input logistics_no." 相关API： - v2.purchase.modify_purchase_order - v2.purchase.update_asn_logistics_info
生效日期：2025年3月14日 --- 4. CBSC部分类目将强制要求商品发布时提供尺码表 适用地区：所有地区 自4月15日起，CBSC 中部分类目需在商品发布时提供尺码表。 请通过 v2.global_product.get_global_item_limit 检查size_chart_mandatory字段以确认是否强制要求。若商品在该地区强制要求填写尺码表， 添加和更新商品时未进行填写时该地区将发布失败 注：若全球商品类目下任一地区要求强制提供，则size_chart_mandatory为true。 相关API： - v2.global_product.get_global_item_limit - v2.global_product.add_global_item - v2.global_product.update_global_item 生效日期：2025年3月14日 ---
- Shopee新增以下4种退货原因 适用地区：所有地区 -
SIZE_DEVIATION（尺寸偏差） -LOOK_DEVIATION（外观差异） -DATE_DEVIATION（日期不符） -DIFFERENT_DESCRIPTION（描述不符） 相关API： - v2.returns.get_return_list - v2.returns.get_return_detail 生效日期：2025年3月14日