Significant OpenAPI Updates

Dear Developer,

Please find below updates:

1.Once the first-mile tracking number is binded to the order, the order status will immediately change to SHIPPED. Open API does not support printing airwaybill under SHIPPED status. The SHIPPED order airwaybill can only be printed in the Seller Center. So the recommended process for the seller to use Open API is to print the airwaybill first and then bind the first-mile tracking number.

Related API: shopee.logistics.GetAirwayBill / shopee.logistics.GetOrderLogistics

Effective Date on Live: Lived

2.For Brazilian local sellers, if Thermal Printing is disabled in the seller center, the AirwayBill link will be returned when calling Open API GetAirwayBill to retrieve the AirwayBill. The AirwayBill link will contain the AirwayBill file and declaration file both in PDF format; if Thermal Printing is enabled in the Seller Center, when calling the Open API GetAirwayBill to obtain the AirwayBill, a compressed file will be downloaded directly. This compressed file contains the AIrwayBill file in ZPL2 format and the declaration file in PDF format.

Related API: shopee.logistics.GetAirwayBill

Effective Date on Live: Lived

3.For sellers in the Singapore market, if the thermal printing is turned off in the seller center, Packlist will be added to the AirwayBill file.

Related API: shopee.logistics.GetAirwayBill

Effective Date on Live: Lived

4. The GetLogistics API responded to a new structural body volume_limits which has two new fields: item_max_volume,item_min_volume, and return the volume range supported by the channel.

Related API: shopee.logistics.GetLogistics

Effective Date on Live: 2021/01/15

5.Optimize the error_message for add/update item when the size volume has exceeded the max limit. The error_message will indicate specific limit info, eg:"msg": "Volume (package_length x package_width x package_hight) should be between 50.0 and 100000.0";

Related API: shopee.item.Add

Effective Date on Live: Lived

6.Optimize the error_message for add/update item when the price have exceed the price limit, the error_message will indicate the specific price limit info, eg:"msg": "price should less than :9999999.0";

Related API: shopee.item.Add/shopee.item.UpdatePrice/shopee.item.UpdatePriceBatch/shopee.item.UpdateVariationPrice/shopee.item.UpdateVariationPriceBatch/shopee.item.InitTierVariation [2-Tier]/shopee.item.AddTierVariation [2-Tier]

Effective Date on Live: 2021/01/07

尊敬的開發者，

請留意以下變動：

1.首公里追踪號綁定訂單後，訂單狀態会马上触发更新为SHIPPED，Open API 側暫不支持狀態為SHIPPED的訂單打印面單，若狀態為SHIPPED的訂單需要補打面單則需要在Seller Center進行打印。對於使用Open API的用戶建議流程為先打印面單，然後再綁定首公里追踪號。

影響接口：shopee.logistics.GetAirwayBill / shopee.logistics.GetOrderLogistics

上線日期：已上線

2. 對於巴西local賣家，如果在賣家中心將熱敏打印關閉，在使用接口GetAirwayBill獲取面單時會返回面單link，面單link會包含PDF格式的面單文件和申報文件；如果在賣家中心將熱敏打印打開，在使用接口GetAirwayBill獲取面單時會直接下載壓縮文件，此壓縮文件中包含ZPL2格式的面單文件以及PDF格式的申報文件。

影響接口：shopee.logistics.GetAirwayBill

上線日期：已上線

3. 對於新加坡市場賣家，在賣家中心將熱敏打印關閉的情況下，會在面單文件添加Packlist

影響接口：shopee.logistics.GetAirwayBill

上線日期：已上線

4. GetLogistics接口新增結構體volume_limits，包含2個新增參數：item_max_volume, item_min_volume，表示渠道支持的體積範圍。

影響接口：shopee.logistics.GetLogistics

上線日期：2021/01/15

5.優化了關於新增/更新商品時，對應體積超限的error_message優化後會提示具體限制信息，例如："msg": "Volume (package_length x package_width x package_hight) should be between 50.0 and 100000.0"；

影響接口：shopee.item.Add

上線日期：已上線

6.優化了關於新增/更新商品時，對應價格信息超限的error_message優化後的error_message會提示具體的價格限制信息，例如："msg": "price should less than :9999999.0"；

影響接口：shopee.item.Add/shopee.item.UpdatePrice/shopee.item.UpdatePriceBatch/shopee.item.UpdateVariationPrice/shopee.item.UpdateVariationPriceBatch/shopee.item.InitTierVariation [2-Tier]/shopee.item.AddTierVariation [2-Tier]

上線日期：2021/01/07