Skip to content

Create Picking Order

POST /picking-orders command bearer

Creates a warehouse picking order from a Fulfillment Order, assigning it to the optimal pick path.

Overview
ID create-picking-order-api
Method POST
Path /picking-orders
Classification command
Domain fulfillment
Capability fulfillment-execution
Service generate-picking
Application wms — WMS
Auth bearer

Request Body
Business Object fulfillment-order
Description Fulfillment-oriented grouping derived from an order for execution.
Classification aggregate-root
Lifecycle created → allocated → picking → packed → dispatched → delivered → failed-delivery → returned-to-sender → cancelled

Response
Business Object picking-task
Description An instruction to locate and collect specific items from a location to fulfil an order.

Events Emitted

Event Classification Object Description
picking-task-created created picking-task A warehouse picking task was generated from a fulfillment order and assigned to a pick path.

Integration Patterns

Pattern Flow Style Description
FMS → WMS Picking Order fms → wms event-driven When a Fulfillment Order is routed to a warehouse node, the FMS instructs the WMS to generate a picking order. Can be synchronous API or event-driven depending on WMS integration capability.

Scenarios using fulfillment-execution

Scenario Description
Buy Online, Pick Up In Store Customer browses and purchases online, then collects the order from a physical store. The canonical
Endless Aisle Store associate helps a customer order an item that is not physically stocked in the current store b
Ship From Store An online order is fulfilled by shipping the goods directly from a physical store rather than a cent
Ship To Store Customer places an online order for collection at a chosen store while stock is sourced from a wareh
Unified Return Customer returns an item regardless of the original purchase channel. The return may be initiated on
API Method Path Type
Get Fulfillment Order GET /fulfillment/orders/{id} query
Dispatch Fulfillment Order POST /fulfillment/orders/{id}/dispatch action
Create Return POST /returns command
Update Picking Status PUT /picking-orders/{id}/status action
Track Shipment GET /shipments/{id}/tracking query
Generate Shipping Label POST /shipments/{id}/label command