Significant OpenAPI Updates

Dear Developers,

Please find the below updates:

1.The Seller Center will checking whether the shop belongs to the channel pickup whitelist, when the order using pickup mode, the open API also needs to have the same logic with the Seller Center.When the order using pickup shipping method, the logic is as follows:

1.1The pickup channel does not open shop whitelist model, all the channel sellers can use pickup shipping method to ship orders.

1.2The pickup channel open shop whitelist model, only the whitelisted seller can use pickup shipping method to ship orders.

Related APIs:

• shopee.logistics.Init
• shopee.logistics.GetParameterForInit
• shopee.logistics.GetLogisticInfo

Effective Date on Live: Lived

2.The Open API will support the 3PL masking order shipping, the shipping order API call flow like before, add a new field: checkout_shipping_carrier, which response checkout channel carrier name.

To the 3PL masking order, if the scheduling process has done, the shipping_carrier will respond fulfillment channel display name; if the scheduling process has not done, the shipping_carrier will respond null.

Related APIs:

• shopee.orders.GetOrderDetails
• shopee.orders.GetForderInfo

Effective Date on Live: 2020.2.4

3.The Open API will support a bundle deal or an add on deal as a whole split with other items in an order. The new fields order_item_id and promotion_group_id are used for identify the order item and product promotion.

Related APIs:

• shopee.orders.GetOrderDetails
• shopee.order.SplitOrder

Effective Date on Live: 2020.2.4

4.The GetOrderLogistics API add new fields to support particular channel self-design airwaybill, including pickup_hub、delivery_hub、ec_order_no、create_date_ymd_sl.

Related APIs:

• shopee.logistics.GetOrderLogistics

Effective Date on Live: 2020.2.4

5.Some item categories need to apply TW government approval before selling. So shopee add the "NCC" attribute field to the merchant to fill in, and add more validation checks in this field, included:only accept alphanumeric,auto-convert to upper case ,auto-remove blank space,don't allow "space" as a value.

Related APIs:

• shopee.item.GetAttributes
• shopee.item.Add
• shopee.item.UpdateItem

Effective Date on Live: Lived

尊敬的开发者，

请留意以下更新：

1.当订单采用pickup 模式发货时，卖家后台会判断商店是否属于渠道pick up白名单，因此open api也需要具有相同的判断逻辑。当订单使用pickup模式时，判断逻辑如下：

1.1若pickup渠道未配置店铺白名单，则所有渠道卖家可以使用pickup方式进行发货；

1.2若pickup渠道配置了店铺白名单，则仅支持白名单卖家使用pickup方式进行发货。

影响接口：

• shopee.logistics.Init
• shopee.logistics.GetParameterForInit
• shopee.logistics.GetLogisticInfo

上线日期：已上线

2.Open API 支持3PL masking 订单发货，发货调用方式与现有流程保持不变，新增字段：checkout_shipping_carrier, 表示checkout channel 的渠道名称。

针对 3PL masking 订单若完成调度，则shipping_carrier为fulfillment channel display name；若未完成调度，则shipping_carrier为空。

影响接口：

• shopee.orders.GetOrderDetails
• shopee.orders.GetForderInfo

上线日期：2020.2.4

3.Open API 支持将订单中bundle deal或add on deal 作为一个整体与订单中的其他商品进行拆包。新增字段order_item_id，promotion_group_id分别用于标识订单商品以及订单促销组合。

影响接口：

• shopee.orders.GetOrderDetails
• shopee.order.SplitOrder

上线日期：2020.2.4

4.Open API 自画面单接口GetOrderLogistics接口新增参数pickup_hub、delivery_hub、ec_order_no、create_date_ymd_sl用于特定渠道自画面单。

影响接口：

• shopee.logistics.GetOrderLogistics

上线日期： 2020.2.4

5.某些商品类别在出售前需要获得TW政府的批准。因此，shopee向商家提供“ NCC”属性字段进行填写，并在此字段中添加更多验证检查，包括：仅接受字母数字，自动转换为大写字母，自动删除空格，不允许使用“空格”作为值。

影响接口：

• shopee.item.GetAttributes
• shopee.item.Add
• shopee.item.UpdateItem

上线日期： 已上线