来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
尊敬的开发者，
请留意以下变动：
1.为了方便BR local卖家使用多种渠道进行发货，v2.product.add_item、v2.product.update_item接口，新增tax info相关字段包括tax_info、 ncm、same_state_cfop、diff_state_cfop、csosn、cest、measure_unit、origin等。如果卖家为CNPJ类卖家且被加入到invoice info的白名单中，则需要在seller center的store profile>NF-e settings配置invoice issuer为shopee或other。
若invoice issuer为shopee，则添加以及更新商品时需要正确填写这些字段。
1.0接口不支持添加、更新、查询tax info字段，我们会在shopee.item.Add和shopee.item.UpdateItem返回warning提示您使用2.0接口
2.0接口支持添加、更新、查询tax info字段，v2.product.add_item和v2.product.update_item均要求您填写正确有效的全部tax info字段信息，否则会返回报错并提示对应文案。如果添加或更新商品成功，response中不会返回invoice信息，您需要通过v2.product.get_item_base_info并传need tax info为true来获取。
若invoice issue为other，则这些字段均为非必填，但如果您填写了字段，我们依旧会检查他们的值是否正确。
对于之前的存量商品，如果您在v2.product.update_item不传tax info信息，则不会去校验，但需要注意的是，如果在seller center更新商品并保存，将会视为商品信息全量更新，包括发票信息。
上线时间：已上线
影响接口:
shopee.item.Add
shopee.item.GetItemDetail
shopee.item.UpdateItem
v2.product.add_item
v2.product.get_item_base_info
v2.product.update_item
- Open API v2.get.order.detail接口返回参数cancel_by新增枚举值"accepted buyer cancel request"，表示卖家接受买家提出的订单取消申请。
上线时间：2022.3.31
影响接口：v2.get.order.detail
- Open API v2.0 Publish&Push接口字段优化，新增返回字段"error"，"message"字段，用于返回error message。
上线时间：已上线
影响接口：
v2.public.get_shops_by_partner
v2.public.get_merchants_by_partner
v2.shop.get_shop_info
v2.merchant.get_merchant_info
v2.merchant.get_shop_list_by_merchant
v2.push.get_push_config
v2.push.set_push_config
- Open Platform支持Columbia(CO), Chile(CL)开发者入驻，对于新入驻的CO,CL的local店铺仅能调用Open API 2.0接口。
上线时间：2022.3.24
影响接口：All Open API 1.0
- 自2022.3.28日起新创建的app仅能调用Open API 2.0接口，而不可以调用Open API 1.0接口，否则报错：This APP does not have access to v1.0 API. You will only have access to v2.0 API。
上线时间：2022.3.28
影响接口：All Open API 1.0
Dear Developer,
Please find below updates:
1.In order to make BR local sellers be able to use more channels to ship order, v2.product.add_item、v2.product.update_item have added tax info related parameters which include tax_info、ncm、same_state_cfop、diff_state_cfop、csosn、cest、measure_unit、origin...If the shop type is CNPJ and added into Invoice setting whitelist, the shop will need to set invoice issuer at store profile>NF-e settings in the seller center.
if the invoice issuer is “Shopee”, sellers need to pass these parameters correctly.
1.0 API doesn't support add/update/search for tax info.We will return warning to make you use 2.0 in your response but not block your request.
2.0 API support add/update/search for tax info.v2.product.add_item and v2.product.update_item will need you to pass all correct value in tax info otherwise it will return error with messages. If you add or update items successfully, tax info will not return in the response, you need to call v2.product.get_item_base_info and pass "need tax info" with "true" to fetch.
if the invoice issuer is “other”, these all parameters are not required, but if you still pass them, we will also check whether all the value are correct
For those reserved items in the history, if you don't pass tax info in v2.product.update_item, we will not block. But please pay attention that updating in seller center and clicking "save" will be considered as an update for the whole item which include tax information.
Effective Date on Live: Lived
Related APIs:
shopee.item.Add
shopee.item.GetItemDetail
shopee.item.UpdateItem
v2.product.add_item
v2.product.get_item_base_info
v2.product.update_item
- Responding a new value "accepted buyer cancel request" of cancel_by field to indicate the scenario when the seller accept the buyer's cancel request in the Open API v2.get.order.detail.
Effective Date on Live: March 31, 2022
Related APIs: v2.get.order.detail
- Responding the new fields "error" and "message" to indicate the error key and error message in the Open API v2.0 Publish and Push Category APIs.
Effective Date on Live: Lived
Related APIs:
v2.public.get_shops_by_partner
v2.public.get_merchants_by_partner
v2.shop.get_shop_info
v2.merchant.get_merchant_info
v2.merchant.get_shop_list_by_merchant
v2.push.get_push_config
v2.push.set_push_config
- The developer from Columbia(CO), Chile(CL) can register Shopee Open platform now, but for the new local shop from CO and CL can only using the Open API 2.0.
Effective Date on Live: Lived
Related APIs: All Open API 1.0
- The new app that created after March 28, 2022 can only calling the Open API 2.0 but can't calling the Open API 1.0, when calling the version 1.0 then will respond error message "This APP does not have access to v1.0 API. You will only have access to v2.0 API".
Effective Date on Live: March 28, 2022
Related APIs: All Open API 1.0