Create from orders
Create Picking Session from Orders
Creates a picking session for specific fulfillment order IDs with detailed allocation tracking. Uses a partial success strategy - creates session if at least one order can be allocated. Returns HTTP 400 if no orders can be allocated (no session is created).
Returns detailed information about which orders were successfully added and which failed, including specific failure reasons and actionable suggestions for each failed order.
Authorization
api_key In: header
Request Body
application/json
Input for the dedicated /by-fulfillment-order-ids route Does not include type since the route itself defines it
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/shipos/v1/picking-sessions/from-orders" \ -H "Content-Type: application/json" \ -d '{ "warehouse_id": "string", "fulfillment_order_ids": [ "string" ] }'{ "id": "string", "status": "string", "bins": 0.1, "warehouse_id": "string", "created_at": "2019-08-24T14:15:22Z", "allocation_results": { "allocation_summary": { "total_requested": 0.1, "total_succeeded": 0.1, "total_failed": 0.1, "partial_success": true }, "successful_orders": [ { "fulfillment_order_id": "string", "order_number": "string", "shop_name": "string", "total_units": 0.1, "line_items_count": 0.1 } ], "failed_orders": [ { "fulfillment_order_id": "string", "order_number": "string", "shop_name": "string", "failure_category": "CUSTOM_PRODUCTS", "failure_reason": "string", "failure_details": { "locked_by": "string", "lock_display_name": "string", "lock_type": "string", "required_quantity": 0, "available_quantity": 0, "missing_products": [ { "product_id": "string", "sku": "string", "name": "string", "required": 0.1, "available": 0.1 } ], "custom_line_items_count": 0, "assigned_warehouse_id": "string", "assigned_warehouse_name": "string" }, "actionable_suggestion": "string" } ] }}