Optimize Route

POST 
/optimize/route

Optimize Route

Request

Query Parameters

synchronous Synchronous

Default value: true

application/json

Body

required

wave_id Wave Idnullable

The id of the wave.

site_name Site Namerequired

The name of the site.

start_points arraynullable

Single or list of starting locations.

end_points arraynullable

Single or list of ending locations.

handling_units arraynullable

A list containing information for every Handling Unit Type

parameters object

allow_interpolation Allow Interpolation

Default value: false

Allow interpolation of input locations

allow_extrapolation Allow Extrapolation

Default value: false

Allow extrapolation of input locations

location_regex arraynullable

How a location name should be processed before looking it up in the warehouseAn example could be that locations are stored as 'A1-24-006A', but the last character is irrelevant.In this case, the matching regex would be r'^(A1-[0-9]{2}-[0-9]{3})([A-Z])$'and the replacement regex would be r'\1'.Multiple regexes can be provided. If two or more regexes match, the first match is used.

generate_visualization Generate Visualization

Default value: false

Whether or not to generate a visualization for the route.

location_intersection_fallback Location Intersection Fallback

Default value: false

When enabling this, the algorithm will replace location sets that are not mutually exclusive by their intersection. As an example, if two picks with locations [A, B] and [B, C] are provided, the algorithm will replace these with [B].

asis_routing Asis Routing

Default value: false

Whether or not to use the asis routing when "optimizing" the route or cluster.

generate_instructions Generate Instructions

Default value: false

Whether or not to generate instructions for the route.

allow_loop_closing Allow Loop Closing

Default value: false

Only relevant when generating_instructions is True. Allow loop closing.

max_loop_picks Max Loop Picksnullable

Only relevant if allow_loop_closing is True. The maximum number of picks in a loop. If None, no limit is imposed.

max_loop_distance Max Loop Distancenullable

Only relevant if allow_loop_closing is True. The maximum distance of a loop. If None, no limit is imposed.

max_loop_deviation Max Loop Deviationnullable

Only relevant if allow_loop_closing is True. The maximum deviation by the closing of a loop. If None, no limit is imposed.

generate_paths Generate Paths

Default value: false

Whether or not to generate a path for the picks in the route.

route_id Route Idnullable

The id of the route.

picks object[]required
Possible values: >= 1
A list of picks that need to be routed.
Array [
pick_id Pick Idrequired
ID to unique identify this pick
location_id string[]required
The location(s) of the pick in the warehouse.
asis_sequence Asis Sequencenullable
The sequence number of the pick in the as-is route.Required for calculating as-is distances.
priority Prioritynullable
Higher priority picks are picked first.
sku_id Sku Idnullable
The id of the SKU on the location.
order_id Order Idnullable
The order id of the pick.
hu_id Hu Idnullable
The handling unit id of the pick.
hu_type Hu Typenullable
The handling unit type of the pick.
]

Responses

200

Successful Response

application/json

Schema

Schema

site_name Site Namenullable

The site name of the site.

site_id Site Idnullable

The site id of the site.

wave_id Wave Idnullable

The id of the wave.

request_id Request Idnullable

The ObjectId of the corresponding request.

timestamp date-time

The timestamp of the response.

computation_time Computation Time

Time our algorithm spent calculating.

error Errornullable

An error message, if an error occurred.

visualization_url Visualization Urlnullable

Link to a visualization of the optimization, if enabled in request parameters.

route_id Route Idnullable

The id of the route.

picks object[]
The optimized sequence of picks.
Array [
pick_id Pick Idrequired
ID to unique identify this pick
location_id Location Idrequired
The location of the pick in the warehouse.
asis_sequence Asis Sequencenullable
The sequence number of the pick in the as-is route.Required for calculating as-is distances.
priority Prioritynullable
Higher priority picks are picked first.
sku_id Sku Idnullable
The id of the SKU on the location.
order_id Order Idnullable
The order id of the pick.
hu_id Hu Idnullable
The handling unit id of the pick.
hu_type Hu Typenullable
The handling unit type of the pick.
optim_sequence Optim Sequencerequired
The optimal sequence of this pick in the optimized route.
path arraynullable
The path to the pick in the warehouse.
instructions object
hallways arraynullable
The hallways that should be crossed to reach the pick in the shortest path.
end_loop End Loopnullable
Whether the pick should ends the loop.
start_loop Start Loopnullable
Whether the pick should starts a new loop.A pick can both end a loop and start a new one.
]
asis_distance Asis Distance

The distance of the as-is route.

optimal_distance Optimal Distance

The distance of the optimized route.

property name* any

Example (from schema)

{
  "asis_distance": 100,
  "computation_time": 0.05,
  "optimal_distance": 80,
  "picks": [],
  "request_id": "675177e2aea9bc14fe7c0c02",
  "route_id": "Route01",
  "site_id": "675177e91539871b3ce6e156",
  "site_name": "Example Site",
  "timestamp": "2024-12-05T09:41:39.792Z",
  "visualization_url": "https://example.com/visualization",
  "wave_id": "wave001"
}

422

Validation Error

application/json

Schema

Schema

detail object[]
Array [
loc object[]required
Array [
anyOf
MOD2
string
integer
]
msg Messagerequired
type Error Typerequired
]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...