Significant Open API Updates

尊敬的开发者，请留意以下变动:

1.针对PL 市场本土卖家新增发票相关接口，卖家可以通过get_pending_buyer_invoice_order_list 接口获取需要上传发票的订单列表，通过upload_invoice_doc 接口上传发票，download_invoice_doc 接口下载发票，核对上传后的发票。

影响接口：

v2.order.get_pending_buyer_invoice_order_list

v2.order.upload_invoice_doc

v2.order.download_invoice_doc

shopee.order.get_pending_buyer_invoice_order_list

shopee.order.upload_invoice_doc

shopee.order.download_invoice_doc

上线时间：已上线

2.针对PL 市场本土卖家新增tax_info 和complaint_policy 字段

影响接口：

v2.product.add_item

v2.product.update_item

v2.product.get_item_base_info

上线时间：已上线

3.为提高卖家满意度，对特定类别设置产品尺寸为必填，提高预估运费的准确性。对存量商品，更新商品如果类目要求尺寸必填，但卖家未填写，则返回error msg：Length/Width/Height is mandatory for current category。对于新增商品，也做同样的校验

影响接口：

shopee.item.Add

shopee.item.UpdateItem

v2.product.add_item

v2.product.update_item

v2.global_product.add_global_item

v2.global_product.update_global_item

上线时间：2021/10/14

4.V2.media_space.upload_image 接口原逻辑，只支持10241024 分辨率的图片，否则返回报错。接口优化为当图片分辨率大于10241024，系统将做压缩处理，接口不报错

影响接口：

v2.media_space.upload_image

上线时间：2021/10/14

5.新增属性推荐接口，卖家可以通过产品名称和图片匹配推荐的属性

影响接口：

v2.product.attribute_recommend

v2.golabl_product.attribute_recommend

上线时间：2021/10/14

6.CNSC 支持用美元和人民币定价，为便于用户识别MTSKU的货币类别信息，在接口中新增返回货币类别Currency信息，卖家请注意店铺的币种类型，更新商品和新增商品请按店铺币种类型进行定价。

影响接口:

v2.global_product.get_global_item_info

v2.global_product.get_global_model_list

上线时间：2021/10/14

Dear Developer,

Please find below updates:

1. Added invoice-related api for local sellers in the PL market. Sellers can get the list of orders that need to upload invoices through the get_pending_buyer_invoice_order_list api, upload the invoices through the upload_invoice_doc api, download the invoices through the download_invoice_doc api, so that check the uploaded invoices.

Related APIs:

v2.order.get_pending_buyer_invoice_order_list

v2.order.upload_invoice_doc

v2.order.download_invoice_doc

shopee.order.get_pending_buyer_invoice_order_list

shopee.order.upload_invoice_doc

shopee.order.download_invoice_doc

Effective Date on Live:Online

2.Added tax_info field and complaint_policy field for local sellers in the PL market

Related APIs:

v2.product.add_item

v2.product.update_item

v2.product.get_item_base_info

Effective Date on Live:Online

3.In order to improve sellers’ satisfaction, set product dimensions for specific categories as required to improve the accuracy of estimated shipping costs. For historical products, if the updated product category requires the dimensions, but the seller does not fill it out, the error msg: "Length/Width/Height is mandatory for current category" will be returned. So does the newly added products

Related APIs:

shopee.item.Add

shopee.item.UpdateItem

v2.product.add_item

v2.product.update_item

v2.global_product.add_global_item

v2.global_product.update_global_item

Effective Date on Live:2021/10/14

4.The original logic of the v2.media_space.upload_image api only supports 10241024 pixel images, otherwise an error will be returned. The api has been optimized, when the image is greater than 10241024 pixel, the system will compress, and the api won't report an error

Related APIs:

v2.media_space.upload_image

Effective Date on Live:2021/10/14

5.New attribute recommendation apis, sellers can match recommended attributes through product names and pictures

Related APIs:

v2.product.attribute_recommend

v2.golabl_product.attribute_recommend

Effective Date on Live:2021/10/14

6.CNSC supports the definition of prices in dollars and RMB. In order to facilitate the user to identify the currency information of MTSKU, Currency information is added to the api. Sellers should pay attention to the currency type of the shop. When sellers update and add product price, please according to the currency type.

Related APIs:

v2.global_product.get_global_item_info

v2.global_product.get_global_model_list

Effective Date on Live:2021/10/14