[Important] Shopee launched the Advance Fulfillment Program

Dear Developers，

Shopee launched the Advance Fulfillment / Pengiriman Kilat program in Indonesia, Phillipines, and Vietnam. This program supports sellers to ship out parcels in advance to Shopee designated, and the system will prioritize using those advance stock to fulfill directly when buyers place orders to achieve shorter delivery time.

The specific updates are:

On seller center, there are 2 new fulfillment types: 1) Advance bookings, which are generated by Shopee system automatically, and require sellers to prepare and ship out those parcels per normal orders to Shopee designated address; 2) Advance orders, which are matched automatically with the ready advance stock, such stock will be delivered to buyer directly, and do not require sellers to ship out again. (Refer here for more seller center UI illustrations and logic details).

1. New API Integration：

Advance bookings have a new set of API, while parameters are similar to existing order APIs.

Use following APIs to retrieve booking list & details, support sellers to arrange shipment, track parcel status and booking match status.

Bookings have 2 important status fields, booking_status and match_status, and definition is listed below:

2. New Field Integration：

1. v2.order.get_order_detail API has 2 new fields, advance_package and booking_sn, to indicate whether this order is an advance order

When buyer places order, system will immediately know if it is an advance order (advance_package = true/false). If it is true, “Arrange Shipment” button on the seller center will be greyed out to disable sellers from arranging shipment/printing AWB.

Once the system matches a particular booking to this order (usually 15 mins later), this order status will be updated to “shipped“ automatically and receives the corresponding booking_sn.

Note: Before shipment is auto arranged and receives a corresponding booking_sn, it is possible that an advance order is changed back to a normal order, and requires sellers to ship out directly (The deducted sellable_advance_stock will be released and the seller_stock will be deducted). The order will be confirmed as Advance order only after the system returns the booking_sn. After that, the advance_package field and booking_sn will not be changed, the order status will be shipped.

2. v2.order.get_order_list API has a new booking_sn field, to return the corresponding advance booking_sn of an advance order

3. v2.product.get_item_base_info and v2.product.get_model_list APIs have 2 new fields, sellable_advance_stock and in_transit_advance_stock

- Sellable_advance_stock refers to Advance Fulfilment stock that Seller has shipped out and is available to be used to fulfil an order

- In_transit_advance_stock refers to Advance Fulfilment stock that seller has arranged shipment or has shipped out, and is still in transit and unavailable to be used to fulfil an order

Note: Both fields are read-only, auto updated based on parcel status (e.g. shipped); seller should still use actual on-hand stock when updating seller stock, no manual logic adjustment is required

尊敬的开发者，

您好，Shopee已经在印尼/菲律宾/越南推出了预先履行计划 (Advance Fulflment / Pengiriman Kilat)，该计划支持卖家提前将包裹打包寄出到Shopee指定地址，当买家下单时，系统将优先使用提前寄出的包裹来直接进行履约，从而实现更快速的送达时效。

具体更新如下：

在卖家中心有两种新的履约类型，其中1) 预先履行是由系统自动下发的Booking生成，需要卖家像普通订单一样进行打包和发货到Shopee指定地址， 2) 匹配订单将被自动匹配到提前寄出的包裹，平台会将包裹寄送给买家，卖家无需再次发货。(更多卖家中心界面展示和逻辑介绍，可参考这里）。

1. 新接口对接：

预先履行(Booking)有一套新的API，与目前的普通订单(order)的发货流程API类似。

使用下方API来拉取Booking列表及详情，支持卖家发货、跟踪包裹轨迹和匹配状态。

预先履行包裹有两个重要的状态字段为booking_status和match_status, 定义如下：

2. 新字段对接：

1. v2.order.get_order_detail接口新增advance_package和booking_sn字段，用于标识该订单为匹配订单

当买家下订单时，系统会立刻标识该订单是否可成为匹配订单(advance_package = true/false), 若为true, 卖家中心会将该订单的发货按钮置灰处理。当系统匹配到某个特定预先履行包裹后 (一般是在15分钟左右), 系统会自动将该订单状态变为已发货并返回booking_sn。

注意：订单有可能从匹配订单变为普通订单 (advance_package 从 true 变为 false)，需要卖家对该订单进行发货 (此时原本已扣减的sellable_advance_stock会被释放，同时扣减seller_stock)；只当系统返回了booking_sn之后，该订单会被确认为匹配订单， 之后advance_package字段和booking_sn不会发生任何改变，order status会变成SHIPPED。

2. v2.order.get_order_list接口新增booking_sn字段，来返回匹配订单对应的预先履行订单号

3. v2.product.get_item_base_info和v2.product.get_model_list接口新增sellable_advance_stock和in_transit_advance_stock字段

- sellable_advance_stock定义：卖家已发货的预先履行库存，并可用于完成订单

- in_transit_advance_stock定义： 卖家已安排发货的预先履行库存，但仍等待取件或仍在运输途中，无法用于完成订单

注意：这两个字段都是read-only, 会根据包裹状态自动更新 (例如，已发货)；卖家更新产品库存时应仍使用实际在库库存量，不需要做任何逻辑改动。