JIT Direct Shipment Open APIs Now Available

尊敬的开发者，

（适用于中国跨境全托管卖家）

为支持卖家更高效地完成Shopee 全托管JIT 直发转运仓（Just-In-Time Direct Shipment） 履约流程，Shopee 全托管现正式推出 JIT 直发转运仓相关 Open API，帮助 ISV 将直发发货能力集成至自身系统，实现库存管理、订单履约及物流操作的自动化。

在 JIT 直发模式下，卖家在接到订单后直接发货至 Shopee 转运仓，由平台完成后续履约。通过本次开放的 Open API，开发者可系统化支持卖家完成从库存查询到首公里交付的完整履约链路。

JIT 直发转运仓业务说明及操作规范可参考： JIT 直发转运仓发货指引和注意事项

1.1 库存查询

用于获取卖家直发商品的实时库存信息，支持库存监控与履约决策。

• v2.purchase.get_vendor_stock

1.2 订单与包裹查询

用于查询直发订单对应的包裹列表及包裹明细信息，支持履约状态跟踪。

• v2.purchase.get_direct_shipment_parcel_info：查询包裹列表及基础信息
• v2.purchase.get_direct_shipment_parcel_detail：查询单个包裹的详细履约信息
• v2.basis.get_category_cluster：查询商品所属 cluster（用于包裹查询的辅助条件）

1.3 包裹确认出货

用于确认包裹已完成出库，进入履约流程。

• v2.purchase.ship_direct_shipment_parcel

1.4 打印包裹商品清单与尾程物流面单

用于打印包裹商品清单及尾程物流所需面单。

• v2.purchase.create_parcel_label_print_task

• v2.basis.query_print_task_result

1.5 创建与管理直发发货批次（First Mile）

用于创建首公里发货批次、选择发货方式并补充物流信息，支持 SCS 后续履约跟进。

• 创建与申报批次： v2.purchase.direct_shipment_get_delivery_method v2.purchase.precheck_direct_shipment_first_mile v2.purchase.retry_direct_shipment_first_mile
• 查询与绑定批次： v2.purchase.get_direct_shipment_first_mile_list v2.purchase.declare_direct_shipment_first_mile v2.purchase.bind_with_existing_first_mile_task
• 基础信息查询： v2.supplier.get_supplier_shipping_info v2.supplier.get_transit_warehouse_info v2.basis.get_logistics_company_pickup_time v2.basis.get_third_party_delivery_info

1.6 查询直发发货批次与物流轨迹

用于查询首公里发货批次信息及物流状态。

• v2.purchase.get_direct_shipment_first_mile_list
• v2.purchase.get_direct_shipment_first_mile_track

1.7 打印首公里物流面单或揽收码

用于打印卖家发货至转运仓的首公里物流单据。

• v2.purchase.create_first_mile_label_print_task
• v2.basis.query_print_task_result

1.8 编辑、取消或解绑直发发货批次

用于处理发货信息变更或异常场景。

• 编辑批次信息：v2.purchase.edit_direct_shipment_first_mile_info
• 取消发货批次：v2.purchase.cancel_direct_shipment_first_mile
• 解绑包裹：v2.purchase.unbind_direct_shipment_parcel

完整接口参数说明请参考： Shopee JIT Direct Shipment Open API Developer Guide

如在接入过程中遇到任何问题，欢迎通过Shopee Open Platform 工单系统 联系我们。

感谢您对 Shopee Open Platform 的支持， Shopee 期待与您携手，共同提升 JIT 直发转运仓的履约效率与系统化水平。

Shopee OpenAPI Team

Dear Developers,

(Applicable to Chinese cross-border fully managed sellers)

To help sellers complete the Shopee JIT Direct Shipment to Transit Warehouse (Just-In-Time Direct Shipment) fulfillment process more efficiently, Shopee is officially introducing a set of JIT Direct Shipment Open APIs. These APIs enable ISVs to integrate direct shipment capabilities into their systems, supporting automation across inventory management, order fulfillment, and logistics operations.

Under the JIT Direct Shipment model, sellers ship orders directly to Shopee’s transit warehouse after receiving an order, where Shopee takes over downstream fulfillment. With the newly released Open APIs, developers can systematically support sellers throughout the end-to-end fulfillment journey—from inventory inquiry to first-mile delivery.

For an overview of the JIT Direct Shipment business model and operational guidelines, please refer to: JIT Direct Shipment to Transit Warehouse – Shipping Guidelines & Notes

1.1 Inventory Inquiry

Retrieve real-time inventory information for sellers’ direct shipment products to support inventory monitoring and fulfillment decisions.

• v2.purchase.get_vendor_stock

1.2 Order & Parcel Inquiry

Query parcel lists and parcel-level details for direct shipment orders, enabling fulfillment status tracking.

• v2.purchase.get_direct_shipment_parcel_info – Retrieve parcel lists and basic information
• v2.purchase.get_direct_shipment_parcel_detail – Retrieve detailed fulfillment information for a specific parcel
• v2.basis.get_category_cluster – Retrieve product cluster information (used as an optional filter for parcel queries)

1.3 Parcel Shipment Confirmation

Confirm that a parcel has been shipped and proceed with the fulfillment process.

• v2.purchase.ship_direct_shipment_parcel

1.4 Print Parcel Packing List & Last-Mile Shipping Label

Print parcel packing lists and last-mile logistics labels.

• v2.purchase.create_parcel_label_print_task
• v2.basis.query_print_task_result

1.5 Create & Manage Direct Shipment First-Mile Batches

Create first-mile shipment batches, select delivery methods, and provide logistics details to support subsequent SCS fulfillment.

• Batch creation & declaration v2.purchase.direct_shipment_get_delivery_method v2.purchase.precheck_direct_shipment_first_mile v2.purchase.retry_direct_shipment_first_mile
• Batch query & binding v2.purchase.get_direct_shipment_first_mile_list v2.purchase.declare_direct_shipment_first_mile v2.purchase.bind_with_existing_first_mile_task
• Basic declare information inquiry v2.supplier.get_supplier_shipping_info v2.supplier.get_transit_warehouse_info v2.basis.get_logistics_company_pickup_time v2.basis.get_third_party_delivery_info

1.6 Query First-Mile Batches & Logistics Tracking

Retrieve first-mile shipment batch information and logistics tracking details.

• v2.purchase.get_direct_shipment_first_mile_list
• v2.purchase.get_direct_shipment_first_mile_track

1.7 Print First-Mile Shipping Label or Pickup Code

Print first-mile logistics labels or pickup codes for shipments from sellers to transit warehouses.

• v2.purchase.create_first_mile_label_print_task

• v2.basis.query_print_task_result

1.8 Edit, Cancel, or Unbind Direct Shipment Batches

Handle shipment changes and exception scenarios.

• Edit batch information: v2.purchase.edit_direct_shipment_first_mile_info
• Cancel shipment batch: v2.purchase.cancel_direct_shipment_first_mile
• Unbind parcel: v2.purchase.unbind_direct_shipment_parcel

For detailed API parameter definitions and integration instructions, please refer to: Shopee JIT Direct Shipment Open API Developer Guide

If you encounter any issues during integration, feel free to contact us via the Shopee Open Platform ticketing system.

Thank you for your continued support of Shopee Open Platform. We look forward to working with you to further enhance the efficiency and systemization of JIT Direct Shipment fulfillment.

Shopee OpenAPI Team