来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
尊敬的开发者，请留意以下变动：
§2 1.【重要】CNSC 商品价格计算逻辑调整--必做服务费率设置
1.【重要】CNSC 商品价格计算逻辑调整--必做服务费率设置
为帮助卖家更准确地计算商品价格，现已优化CNSC商品价格计算逻辑，综合考虑了佣金费率、服务费率等平台费用因子。
新价格逻辑如下：
应用场景：
1、计算店铺商品价格：基于卖家上传的全球商品价格，系统会依据新价格公式计算店铺商品价格；
2、计算全球商品价格：卖家从各站点升级到CNSC，基于店铺商品价格，系统会依据新价格公式倒算全球商品价格；
3、更新店铺商品价格：如果商品价格设置为自动同步，更新全球商品价格后，系统会依据新公式同步刷新店铺商品价格；
主要变化点：
1、佣金率(6%)及交易费率(2%)系统固定自动写入
2、卖家可自行编辑店铺服务费率（上线后初次登录CNSC需要录入服务费率）
3、以上计算因子变更后不影响已发布店铺商品的价格
4、OpenAPI 接口使用说明：
功能上线后，卖家必须登录CNSC进行服务费率设置，否则部分接口不可使用。
get 接口不禁用，写接口禁用；若识别到店铺服务费率为空，禁用接口调用后返回报错：“lack shop service fee rate”。
（卖家登录CNSC设置服务费率后方可解禁，操作详情请查看卖家学习中心）
上线时间：2021.08.09
影响接口：
v2.global_product.add_global_item
v2.global_product.update_global_item
v2.global_product.delete_global_item
v2.global_product.update_size_chart
v2.global_product.init_tier_variation
v2.global_product.update_tier_variation
v2.global_product.add_global_model
v2.global_product.update_global_model
v2.global_product.update_price
v2.global_product.update_stock
v2.global_product.delete_global_model
v2.global_product.create_publish_task
v2.global_product.set_sync_field
§3 2.CNSC将支持SIP卖家使用
2.CNSC将支持SIP卖家使用
1、接口字段变动：由于SIP 成本价将维护在全球商品上，且与全球商品的货币保持一致，以下接口将有字段变动：
v2.global_product.get_global_model_list新增sip_item_price和sip_item_price_source字段
v2.global_product.get_global_item_info 新增sip_item_price和sip_item_price_source字段
v2.product.get_model_list 不再返回item price字段
v2.global_product.get_published_list 接口将返回商品已发布的SIP附属店铺产品
shopee.orders.MyIncome/shopee.orders.GetEscrowDetails，P currency 字段支持返回CNY的币种
2、新增接口新增v2.global_product.update_sip_item_price接口，以供已升级到CNSC的SIP卖家维护全球商品上的成本价
3、新增报错消息
对于升级到CNSC的SIP卖家，升级过程中需要卖家在CNSC内，确认升级后的SIP成本价，如果卖家未进行确认，则暂时无法编辑商品。
如果尝试编辑，将会返回报错消息，例如： "message": "not all shop is upgraded and confirmed, can not edit item"
上线时间：2021.08.09
影响接口：
v2.global_product.get_global_item_list
v2.global_product.get_global_item_info
v2.global_product.update_global_item
v2.global_product.delete_global_item
v2.global_product.update_size_chart
v2.global_product.init_tier_variation
v2.global_product.update_tier_variation
v2.global_product.update_price
v2.global_product.update_stock
v2.global_product.get_global_model_list
v2.global_product.delete_global_model
v2.global_product.add_global_model
v2.global_product.update_global_model
§4 3.get_shop_list_by_merchant接口支持SIP店铺返回
3.get_shop_list_by_merchant接口支持SIP店铺返回
get_shop_list_by_merchant接口返回CNSC的商家下升级了CNSC的Normal shop（普通店铺）和Primary shop（主店铺），以及Primary shop下的Affiliate shop（附属店铺），增加了字段sip_affi_shops支持返回授权成功的主店铺下附属店铺的列表；增加字段affi_shop_id用来返回每个附属店铺的shop_id；增加了字段shop_is_cnsc用来返回该shop是否被升级到了CNSC。同时，在授权页面，没有升级CNSC的店铺会被分到Unupgraded Shop Group下；当一个店铺转型为主店铺后，需要重新在授权页面对主店铺以及附属店铺进行授权，否则接口将不会返回相应的附属店铺。
上线时间：2021.08.09
影响接口：
v2.merchant.get_shop_list_by_merchant