Add task

Name

Description

locations*

Type: svrp_request_locations_item[]

List of locations.
Location of order to deliver from depot.

Min items: 1

options*

Type: solver_options_svrp

Solver options. It is forbidden to specify options that are not present in the list below.

vehicle*

Type: vehicle

Vehicle specification.

depot

Type: depot_location_1

A depot, by default start and finish point for a vehicle on route.

depots

Type: svrp_request_depots_item[]

List of depots. Fields depot and depots are mutually exclusive. More information
A depot, by default start and finish point for a vehicle on route.

initial_routes

Type: svrp_request_initial_routes_item[]

List of routes in old response, which has to be loaded into solver.

zones

Type: svrp_request_zones_item[]

Name

Description

id*

Type: integer or string

Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information

point*

Type: coordinate_2

WGS84 coordinate of a location. More information

address

Type: string

Address of the location.

allow_trailers

Type: boolean

When true, vehicles with trailers can arrive at this location. Otherwise, they will have to leave the trailer at an anchor location beforehand. [More information](https://yandex.ru/routing/doc/vrp/concepts/properties-of-vehicles.html?lang=en#coupling

can_be_merged

can_be_split

Type: boolean

An order can be split into parts between different vehicles.

client_id

Type: integer or string

Defines id of a client corresponding to the location.

client_service_duration_s

Type: client_service_duration_0 or number

Duration of service at a location, which can be shared among the other orders of the same client (by client_id) at exactly the same location.

comments

Type: string

Comments.

crossdock_mode

Type: string

Defines whether it is allowed to deliver this order through a cross-dock depot.

• deny — prohibited, can only be delivered from a regular depot;
• allow — allowed, can be delivered either directly from a regular depot or through a cross-dock depot;
• mandatory — required, can only be delivered through a cross-dock depot.

Default: allow

Enum: deny, allow, mandatory

crossdock_service_duration_s

Type: crossdock_service_duration_0 or number

Time spent at a crossdock location during the unloading of this order. More information

custom_value

Type: number

A custom numeric value, associated with location (E.g. the reward for the courier for visiting this location). May be used as a component in vehicle cost function.

delivery_deadline

Type: string

Time by which the pickup order without specified delivery_to field should be delivered to any depot, in [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. More information

delivery_to

Type: integer or string

Defines id of a location where to deliver the shipment.More information

delivery_to_any

Type: (integer or string)[]

A list of drop_off location ID's, the pickup location must be delivered to any of these locations. More information
Reference to a location specified in locations. More information

depot_duration_s

Type: depot_duration_0 or number

Time spent at a depot during handling of this location (goods loading, document collection, etc.). More information

depot_expiring_time

Type: string

Time by which the order must be taken from the depot, in [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z

depot_id

Type: integer or string or array

depot_ready_time

Type: string

Time when the order is ready to be taken from any depot, in [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. More information

description

Type: string

Location description.

dropped_ratio

Type: number

Order ratio which have to stay in drop

Max value: 1

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Restricts time window relaxation during route planning. If location cannot be visited within a specified time window, it will be excluded from the route and added to dropped_orders field in the response. This field is useful to model orders that cannot be completed within the time window, (e.g. due to conflicts with other orders). More information

ignore_zones_compatibility

Type: boolean

Ignore the effects caused by the incompatible_zones, allowed_zones, forbidden_zones, optional_zones properties for the location.

in_lifo_order

Type: boolean

Orders with this field set to true are not allowed to move inside the vehicle and should be delivered in the reversed order of their pickups. Locations with this field set to false can appear anywhere in the route. This field only matters if both pickups and deliveries are present in route. More information

load_types

Type: string[]

Defines types of location load. mustnt be defined only for garage` location type.
Type of load.

max_split_parts

Type: integer

Maximal number of parts in which the order can be split

Default: 10

Min value: 1

max_total_vehicles

Type: integer

Maximal number of vehicles that can be served by an anchor location. Unlimited by default. More information

may_drop_in_crossdock

optional_tags

Type: svrp_request_locations_optional_tags_item[]

List of tags which are not required for a vehicle to serve the location, but they can decrease or increase the route cost if satisfied. More information
An optional tag with bonus or penalty.

parking_service_duration_s

Type: number

Duration of parking at location. If the order is delivered using routing_mode walking or transit, this time will not be spent. If the location was chosen as a parking for the walking part, then the time will be spent once before the start of the part.

Max value: 3153600000

penalty

Type: svrp_request_locations_penalty

Penalties for non-completion and time window failure. More information

phone

Type: string

Phone number of delivery receiver.

pickup_from_any

Type: boolean

Delivery-orders that have this field set to true must have multiple pickup orders associated with it. Any one of these pickup orders can be selected for delivery, and the rest will be ignored. The choice among the options is based on optimizing the cost of the route. More information

pickup_must_reach_depot

Type: boolean

The field determines whether the pickup is considered serviced if it is not delivered depot. The field shouldnt be defined for types other than pickup. The field is mutually exclusive with fields delivery_to and delivery_to_any. If depot_id is defined and not empty then the field is considered as True and the value to False in not acceptable.

preset_id

Type: string

Preset number for location properties.

quant

Type: number or locations_quant_0_1

ref

Type: string

Location reference.

required_tags

Type: string[]

List of tags a vehicle must have to arrive at the location. More information
An arbitrary tag.

rolling_throughput

Type: svrp_request_locations_rolling_throughput

Rolling throughput limit (supported for anchors).

sequence_order

Type: integer

All locations in vehicle route with specified sequence_order option have to be visited in non-decreasing order of its values. More information

service_duration_s

Type: service_duration_2_0 or number

Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information

service_durations

Type: service_durations

Structure storing location service durations.

shared_service_duration_s

Type: shared_service_duration_0 or number

Duration of service at a location, which can be shared among the other orders at exactly the same location. Shared service duration can include such operations as parking of a car, delivering documents, etc. More information

shared_with_company_ids

Type: integer[]

IDs of the companies that can access the order information.

shipment_size

Type: svrp_request_locations_shipment_size

Shipment size (dimensions and/or weight). More information

soft_depot_expiring_time

Type: string

Time by which the order must be taken from the depot, in [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z

soft_depot_ready_time

Type: string

Time when the order is ready to be taken from any depot, in [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. More information

split_parts_must_fill_whole_vehicle

Type: boolean

Parts, split from a splittable order, should fill the whole vehicle.

throughput

Type: svrp_request_locations_throughput

Location throughput limit (supported for the orders which can be split).

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: svrp_request_locations_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

title

Type: string

Location title.

transit_time

Type: svrp_request_locations_transit_time

Restrictions on the time the order spends inside a vehicle

type

Type: string

Defines a type of service at the location: delivery, pickup, drop_off or garage.

• delivery — the load is picked up at the depot or at another location, and delivered to this location;
• pickup — the load is picked up at this location, and delivered to another location (if delivery_to is specified), or to the depot;
• drop_off — a pickup location may be delivered to any of related drop_off locations (see delivery_to_any)`;
• garage — a location which can be used as the first or the last vehicle location via start_at or finish_at vehicle option;
• anchor — a location where trailers can be dropped and unloaded;
• parking — a location where trailers can be dropped to serve a single other location. Trailers can not be unloaded there.
• rest_place — a designated location where a vehicle can break work in cases when the work_break has the attribute "at_rest_place". More information

Default: delivery

Enum: depot, crossdock, delivery, pickup, drop_off, garage, anchor, parking, rest_place

use_in_proximity

Name

Description

time_zone*

Type: number or string

absolute_time

Type: boolean

Use ISO 8601 format (YYYY-MM-DDTHH:MM:SS+HH:MM) for time_window in the result.

avoid_tolls

Type: boolean

Do not use toll roads if possible (only for driving and truck routing modes). More information

avoid_zones

Type: string[]

List of zones that cannot be entered when performing a route. These zones will be avoided even if the fastest route passes through them. The total number of corners in zone polygons must not exceed 300.
Zone number.

Min length: 1

Max length: 80

Max items: 100

balanced_groups

Type: solver_options_svrp_balanced_groups_item[]

Each item in this array defines a balanced group of routes. Each route in a group corresponds to a single vehicle shift. Shifts are linked with groups by balanced_group_id field. Routes are balanced by metrics total_duration_s and/or total_stops depending on specified penalties. More information
A group of balanced routes. If the penalty field is not set, the penalty {stop: 100, hour: 200} is used for backward compatibility.

close_location_groups_radius_m

Type: number

The distance specifying how close the locations must be to belong to the same close location group

Max value: 1000000000

close_locations_during_post_optimization_only

Type: boolean

Apply penalties defined in close_locations only during post_optimization stage. If the field is true, post-optimization must be turned on.

critical_lateness_risk_probability

Type: number

If a probability of being late on a location is greater or equal than a specified value, than the location is accounted in lateness_risk_locations_count. The probability is defined in percent.

Default: 20

Min value: 1

Max value: 50

date

Type: string

Starting date for all routes (YYYY-MM-DD format), defaults to current date. More information

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

enable_vehicle_classes

fix_planned_shifts

Type: boolean

Fix shifts of locations from planned routes.

force_merge_multiorders

Type: boolean

Меняет поведение при включенной опции merge_multiorders - может объединить заказы, имеющие одинаковые координаты, даже если в результате ни одна машина не сможет доставить полученный заказ из-за ограничений вместимости, тегов или типов груза. Подробнее

global_proximity_factor

Type: number

Level of location proximity influence on vehicle routes. Recommended values are from 0.0 to 1.0. Using this option makes locations closer to the last location in route. Using both proximity_factor and global_proximity_factor makes routes more tolerant to moving locations to the end of route. Note, that using proximity will decrease optimality of computed routes in terms of costs and penalties. More information

Max value: 10

ignore_min_stops_for_unused

Type: boolean

Ignore minimal_stops option for unused vehicles. More information

ignore_zones

Type: boolean

Ignore all zone-related options in vehicles and locations. More information

immutable

Type: boolean

All routes, specified in initial_routes, are used without changes, new runs can not be added.

incompatible_load_types

Type: string[][]

Each item in this array defines list of location load types, that should not be handled within the same vehicle run. More information
List of load types.
Type of load.

incompatible_zones

Type: string[][]

Each item in this array defines list of location zones, that should not be visited within the same vehicle run. More information
List of zones.
Zone number.

Min length: 1

Max length: 80

load_when_ready

Type: boolean

Start load orders in depot when they are ready (in order of depot_ready_time). More information

location_groups

Type: solver_options_svrp_location_groups_item[]

Each item in this array defines a group of locations which should be assigned to the same vehicle shift. Some locations from the group might get dropped. Each location can be referenced by only one location group. More information
A group of locations which should be assigned to the same vehicle shift.

matrix_router

Type: string

Matrix router to be used for route planning

• main — recommended for Russia, CIS and Turkey.
• global — for other countries.
• geodesic — distances are calculated directly without taking into account traffic jams.
• auto — automatic router choice based on depot location.

Default: main

Enum: main, geodesic, global, auto

max_distance_to_projection_m

Type: number

Restriction for max distance to projcetion point. Will be ignored if order has not any suitable projection

Default: 1000000000

Max value: 1000000000

max_drop_penalty_percentage

Type: number

Maximal relation of drop penalty to the sum of drop penalties in all orders. More information

Default: 100

Max value: 100

max_split_orders_percentage

Type: number

Maximal ratio of orders which can be split into parts

Default: 100

Max value: 100

merge_multiorders

Type: boolean

If possible merge those orders which have the same coordinates, i.e. serve them by a single vehicle. More information

merge_multiorders_of_different_clients

minimize_lateness_risk

Type: boolean

Compute and minimize the probability of being late to locations. In other words, avoid routes such that the estimated time of arrival is close to the end of a time window. More information

multiorder_radius_m

Type: number

The distance specifying how close the locations must be to be merged into a multiorder

Default: 1

Max value: 1000000000

penalize_late_service

Type: boolean

This option determines whether to penalize for late arrivals or late service.

• When false, late penalty is applied if a vehicle arrived to the location/depot or started serving the depot after the end of the time window. Note that for multi-orders the service start time of the whole multi-order is used for each suborder rather than the suborder's own service start.
• When true, late penalty is applied if the location, depot or shift service was finished after the end of the time window. In most cases turning this option on is equivalent to decreasing the ends of all the time windows by service_duration_s of the corresponding locations, depots and shifts. However, it provides its own mechanics for the cases when it is not clear how much time will pass since arrival to the location till the end of service, e.g. in the cases of serving multi-orders and unloading pickups at the depot. It is recommended to set this to true if it is important to serve multi-orders in time rather than to arrive at a multi-order location in time. More information

penalty

Type: solver_options_svrp_penalty

Penalties for global solution limitations violation.

points_throughputs

Type: solver_options_svrp_points_throughputs_item[]

Each item in this array defines point throughput.
Point's throughput

post_optimization

Type: boolean

Use post optimization: restart algorithm in the last 10% operations with disabled global proximity and balancing. More information

proximity_factor

Type: number

Level of location proximity influence on vehicle routes. Recommended values are from 0.0 to 1.0. Using this option makes routes more tolerant to dropping locations. Note, that using proximity will decrease optimality of computed routes in terms of costs and penalties. More information

Max value: 10

restart_on_drop

Type: boolean

Restart to optimize only non-dropped orders, in case we haven't find solutions without drops. Enable this option if drops are expected and acceptable for your business scenario.

routing_mode

Type: string

Transportation method. More information

• driving — default mode, routing with car profile;
• truck — routing with truck profile;
• walking — routing with pedestrian profile, only on roads allowed for pedestrian traffic;
• transit — routing with pedestrian profile combined with public transport;
• bicycle — routing with bicycle profile.

Default: driving

Enum: driving, truck, walking, transit, bicycle

template_rest_schedules

Type: solver_options_svrp_template_rest_schedules_item[]

List of rest schedule templates. More information
Template schedule of rest breaks.

wait_in_multiorders

weighted_drop_penalty

Type: boolean

Compute drop penalty according to shipment weight and volume. It helps optimization when vehicles are highly loaded. Specified location drop penalties are ignored in this case. More information

Name

Description

id*

Type: integer or string

Vehicle ID. All vehicle IDs in task must be unique and have the same type: integer or string. More information

allow_different_depots_in_route

Type: boolean

Vehicle is allowed to visit depots with different ids in the same route

allowed_zones

Type: string[]

List of zones, which can be visited by vehicle. More information
Zone number.

Min length: 1

Max length: 80

can_change_depot_between_runs

Type: boolean

Vehicle is allowed to start the run from different depot than the one where its previous run has ended

capacity

Type: vehicle_capacity

Vehicle capacity. More information

close_locations

Type: vehicle_close_locations_item[]

cost

Type: vehicle_cost_0 or string or vehicle_cost_1

crossdock_mode

Type: string

Defines whether this machine is allowed to deliver orders to the cross-dock depot. More information

• deny — prohibited, can only deliver to locations;
• allow — allowed, can deliver both directly to locations and to a cross-dock depot;
• mandatory — required, can only deliver to a cross-dock depot.

Default: allow

Enum: deny, allow, mandatory

depot_extra_service_duration_s

Type: number

Additional time required to load this vehicle in the depot.

Max value: 3153600000

depot_id

Type: integer or string or array

depots_only_at_run_beginning

Type: boolean

Middle depots are allowed only until first order location.

ending_depot_id

Type: integer or string or array

excluded_tags

Type: string[]

List of excluding vehicle tags, checked for compatibility with location tags (POSIX-extended regular expression are used). More information
An arbitrary tag or POSIX-extended regular expression.

finish_at

Type: integer or string

Defines id of a location with type garage where the vehicle should finish the route.

finish_route_in_starting_depot

Type: boolean

Finish route in the same depot where it started.

finish_run_in_starting_depot

Type: boolean

Finish runs in the same depot where it started.

first_edges_penalty_factor

Type: number

A factor that determines extra penalty/bonus for the first edge of each run.If positive, solver tries to serve orders starting from the closest to depot. If negative, solver tries to serve orders starting from the most distant from depot

fixed_planned_route

Type: boolean

If true, planned route of the vehicle will be used without any changes. More information

fixed_work_breaks

Type: vehicle_fixed_work_breaks_item[]

This list can be used for setting the duration of work before each break for several first breaks in each shift (or the whole route, if no shifts are present). If the list of shifts (see shifts) is provided for the vehicle, you have to specify a valid shift_id for every work break. This option is primarily intended for combining with visited_locations to describe work breaks during visiting them, but they can be applied independently.

forbidden_zones

Type: string[]

List of zones, which can not be visited by vehicle. More information
Zone number.

Min length: 1

Max length: 80

global_proximity_attraction_point

Type: integer or string

Defines id of a location with type garage, the distance to which is calculated for the global_proximity penalty.

imei

Type: integer

The number of the GPS tracker.

immutable

Type: boolean

All routes for this vehicle, specified in initial_routes, are used without changes, new runs can not be added.

incompatible_load_types

Type: string[][]

Each item in this array defines list of location load types, that should not be handled within the same vehicle run (overrides incompatible_load_types value specified in options). More information
List of load types.
Type of load.

incompatible_zones

Type: string[][]

Each item in this array defines list of location zones, that should not be visited within the same vehicle run. (overrides incompatible_zones value specified in options). More information
List of zones.
Zone number.

Min length: 1

Max length: 80

last_edges_penalty_factor

Type: number

A factor that determines extra penalty/bonus for the last edge of each run.If positive, solver tries to end serving orders closer to depot. If negative, solver tries to end serving orders farther from depot

max_middle_depots

Type: integer

Maximal number of middle depots (i.e. depots which do not break the run) in the route

max_runs

Type: integer

Maximal number of the vehicle runs from the depot to locations in all shifts. More information

Default: 1

middle_depot_id

Type: integer or string or array

min_stop_weight

Type: number

Minimal total weight of all orders in one point. More information

onboard_incompatible_load_types

Type: boolean

Determine load type incompatibility with respect only to orders on vehicle board.

optional_zones

Type: vehicle_optional_zones_item[]

List of optional zones with bonus
An optional tag with bonus.

payout

Type: string or vehicle_payout_0

penalty

Type: vehicle_penalty

Penalties for vehicle limitations violation.

phone

Type: string

Phone number of the courier.

planned_route

Type: vehicle_planned_route

A planned vehicle route, should be used to assign already chosen locations to vehicles. These locations will not be dropped even if some strict constraint(s) is violated and will be served by the vehicle. The order of locations provided in this option can be changed for optimization of final route. By default shifts assigned to planned locations can be changed as well. They can be fixed with fix_planned_shifts solver option. More information

preset_id

Type: string

Preset number for vehicle properties.

ref

Type: string

Vehicle reference number.

rest_schedule

Type: vehicle_rest_schedule

Schedule of rest breaks. More information

rest_schedule_id

Type: string

ID of a rest schedule template used in this vehicle.

return_to_depot

routing_mode

Type: string

Transportation method. If present, overrides routing_mode specified in solver options. More information

• driving — default mode, routing with car profile;
• truck — routing with truck profile;
• walking — routing with pedestrian profile, only on roads allowed for pedestrian traffic;
• transit — routing with pedestrian profile combined with public transport;
• bicycle — routing wtih bicycle profile.

Enum: driving, truck, walking, transit, bicycle

service_duration_multiplier

Type: number

Service duration adjustment coefficient for slow or fast workers. More information

Default: 1

Min value: 0.001

shared_service_duration_multiplier

Type: number

Shared service duration adjustment coefficient for slow or fast workers. More information

Default: 1

Min value: 0.001

shifts

Type: vehicle_shifts_item[]

List of vehicle shifts. More information
Vehicle shift.

specs

Type: vehicle_specs

Vehicle specification. More information

start_at

Type: integer or string

Defines id of a location with type garage where the vehicle should start the route. More information

starting_depot_id

Type: integer or string or array

tags

Type: string[]

List of vehicle tags, checked for compatibility with location tags (POSIX-extended regular expression are used). More information
An arbitrary tag or POSIX-extended regular expression.

trailer

Type: vehicle_trailer

Trailer specification. Usage of trailer with walking_courier is forbidden.More information

travel_time_multiplier

Type: number

Travel duration adjustment coefficient for slow or fast vehicles. More information

Default: 1

Min value: 0.001

visit_depot_at_start

visited_locations

Type: vehicle_visited_locations_item[]

List of locations to be visited by a vehicle in exact order as fixed part of the route without optimizations, with optional times of departure from some locations. If the work breaks between visited locations need to be precisely scheduled, use fixed_work_breaks vehicle's option. More information

walking_courier

Type: vehicle_walking_courier

Description of a pedestrian courier. Usage of walking_courier in vehicle with trailer is forbidden.

Name

Description

point*

Type: coordinate_2

WGS84 coordinate of a location. More information

address

Type: string

Address of the location.

crossdock_safety_waiting_duration_s

Type: number

The duration of the minimum time interval between the moment the order arrives at the cross-dock depot and the moment when it can be picked up from there by a vehicle for delivery. This interval is needed so that there is a reserve of time in case the vehicle that brings the orders is late.

Default: 3600

Max value: 3153600000

description

Type: string

Location description.

finish_service_duration_s

Type: number

Duration of service at a depot in the end of a route. Finish service duration can include any operations at depot, e.g. unloading items, documents collection etc. More information

Max value: 3153600000

flexible_start_time

Type: boolean

By default vehicle start time is equal to either depot, or garage, or shift start time. When this option is set to true, vehicles can start earlier or later than the default start time. In this case the optimal start time will be computed according to cost minimization. More information Also when flexible_start_time option is used, the solver can generate routes where arrival time is very close to end of the time window. It is often undesired route plans, because there is a risk of being late on such locations. An option minimize_lateness_risk and/or penalize_late_service is recommended to be used together with flexible_start_time to avoid such routes.

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Restricts time window relaxation during route planning. When true, vehicles are allowed to return to depot only within the specified time window. More information

id

Type: integer or string

Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information

load_service_duration_s

Type: number

Additional duration for loading delivery orders into a vehicle, added only if there is at least one delivery order,loaded in this depot.

package_throughput

Type: depot_location_1_package_throughput

Restriction on packaging speed in depot.

penalty

Type: depot_location_1_penalty

Penalties for depot time window or throughput failure. More information

preliminary_service_duration_s

Type: number

Duration of preliminary service at depot. This duration can include any operations that can be done before loading the vehicle. These operations will be done before depot_ready_time of deliveries that are loaded at this vehicle. More information

Max value: 3153600000

preset_id

Type: string

Preset number for depot properties.

ref

Type: string

Location reference.

service_duration_s

Type: service_duration_2_0 or number

Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information

throughput

Type: depot_location_1_throughput

Depot throughput limit. More information

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depot_location_1_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

time_windows_loading

Type: depot_location_1_time_windows_loading

Time windows when the vehicle is allowed to leave the depot on the 1st run

time_windows_refilling

Type: depot_location_1_time_windows_refilling

Time windows when the vehicle is allowed to visit a depot (or middle depot) for additional loading

time_windows_unloading

Type: depot_location_1_time_windows_unloading

Time windows when the vehicle is allowed to return to the depot on the last run

title

Type: string

Location title.

type

Type: string

Defines a type of depot: depot or crossdock.

• depot — the main depot where orders are stored.
• crossdock — the additional depot where there are no orders initially. To deliver orders from this depot, another vehicle must first deliver them here from the main depot where they are stored.

Default: depot

Enum: depot, crossdock

unload_service_duration_s

Type: number

Additional duration for unloading pickup orders from a vehicle, added only if there is at least one pickup order,delivered in this depot.

use_in_proximity

Type: boolean

When false, this depot will be ignored in computation of proximity and global proximity. When true, this depot will be used in computation of proximity and global proximity.If parameter is not defined, this depot will be used in computation of proximity in compatible mode.

Name

Description

point*

Type: coordinate_2

WGS84 coordinate of a location. More information

address

Type: string

Address of the location.

crossdock_safety_waiting_duration_s

Type: number

The duration of the minimum time interval between the moment the order arrives at the cross-dock depot and the moment when it can be picked up from there by a vehicle for delivery. This interval is needed so that there is a reserve of time in case the vehicle that brings the orders is late.

Default: 3600

Max value: 3153600000

description

Type: string

Location description.

finish_service_duration_s

Type: number

Duration of service at a depot in the end of a route. Finish service duration can include any operations at depot, e.g. unloading items, documents collection etc. More information

Max value: 3153600000

flexible_start_time

Type: boolean

By default vehicle start time is equal to either depot, or garage, or shift start time. When this option is set to true, vehicles can start earlier or later than the default start time. In this case the optimal start time will be computed according to cost minimization. More information Also when flexible_start_time option is used, the solver can generate routes where arrival time is very close to end of the time window. It is often undesired route plans, because there is a risk of being late on such locations. An option minimize_lateness_risk and/or penalize_late_service is recommended to be used together with flexible_start_time to avoid such routes.

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Restricts time window relaxation during route planning. When true, vehicles are allowed to return to depot only within the specified time window. More information

id

Type: integer or string

Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information

load_service_duration_s

Type: number

Additional duration for loading delivery orders into a vehicle, added only if there is at least one delivery order,loaded in this depot.

package_throughput

Type: svrp_request_depots_package_throughput

Restriction on packaging speed in depot.

penalty

Type: svrp_request_depots_penalty

Penalties for depot time window or throughput failure. More information

preliminary_service_duration_s

Type: number

Duration of preliminary service at depot. This duration can include any operations that can be done before loading the vehicle. These operations will be done before depot_ready_time of deliveries that are loaded at this vehicle. More information

Max value: 3153600000

preset_id

Type: string

Preset number for depot properties.

ref

Type: string

Location reference.

service_duration_s

Type: service_duration_2_0 or number

Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information

throughput

Type: svrp_request_depots_throughput

Depot throughput limit. More information

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: svrp_request_depots_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

time_windows_loading

Type: svrp_request_depots_time_windows_loading

Time windows when the vehicle is allowed to leave the depot on the 1st run

time_windows_refilling

Type: svrp_request_depots_time_windows_refilling

Time windows when the vehicle is allowed to visit a depot (or middle depot) for additional loading

time_windows_unloading

Type: svrp_request_depots_time_windows_unloading

Time windows when the vehicle is allowed to return to the depot on the last run

title

Type: string

Location title.

type

Type: string

Defines a type of depot: depot or crossdock.

• depot — the main depot where orders are stored.
• crossdock — the additional depot where there are no orders initially. To deliver orders from this depot, another vehicle must first deliver them here from the main depot where they are stored.

Default: depot

Enum: depot, crossdock

unload_service_duration_s

Type: number

Additional duration for unloading pickup orders from a vehicle, added only if there is at least one pickup order,delivered in this depot.

use_in_proximity

Type: boolean

When false, this depot will be ignored in computation of proximity and global proximity. When true, this depot will be used in computation of proximity and global proximity.If parameter is not defined, this depot will be used in computation of proximity in compatible mode.

Name

Description

route*

Type: initial_routes_route_element_1[]

Sequence of route nodes, comprising a route.
Route node, contains information about a visited location or a work break, transit information and arrival time.

vehicle_id*

Type: integer or string

Vehicle ID. All vehicle IDs in task must be unique and have the same type: integer or string. More information

fixed_order

Type: boolean

Locations, specified in initial_routes, cannot be reordered

immutable

Type: boolean

A route, specified in initial_routes, is used without changes.

shift

Type: svrp_request_initial_routes_shift

Name

Description

geometry*

Type: svrp_request_zones_geometry

id*

Type: string

Zone number

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

Name

Description

fixed

Type: number

Fixed service duration for any part of the order.

Max value: 3153600000

scaled

Type: number

Service time for a part of an order, which is multiplied by order ratio.

Max value: 3153600000

Name

Description

fixed

Type: number

Fixed service duration for any part of the order.

Max value: 3153600000

scaled

Type: number

Service time for a part of an order, which is multiplied by order ratio.

Max value: 3153600000

Name

Description

fixed

Type: number

Fixed service duration for any part of the order.

Max value: 3153600000

scaled

Type: number

Service time for a part of an order, which is multiplied by order ratio.

Max value: 3153600000

Name

Description

tag*

Type: string

An arbitrary tag.

value*

Type: number

Value of the tag. When location is served by a vehicle with a matching tag in tags field, this value is subtracted from the route cost. When the matching tag is in excluded_tags field, this value is added to the route cost.

Name

Description

delivery_deadline

Type: locations_penalty_delivery_deadline

Penalty components for late deliveries from pickup locations to depots. Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option. More information

depot_expiring_time

Type: locations_penalty_depot_expiring_time

Penalty components for violation soft_depot_expiring_time restriction.

depot_ready_time

Type: locations_penalty_depot_ready_time

Penalty components for violation soft_depot_ready_time restriction.

drop

Type: penalty_drop_0_2 or number

Penalty for not delivering an order. More information

early

Type: locations_penalty_early

Penalty components for early service (used instead of out_of_time penalty).

late

Type: locations_penalty_late

Penalty components for late visits (used instead of out_of_time penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option.

out_of_time

Type: locations_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

rolling_throughput

Type: locations_penalty_rolling_throughput

Penalty components for throughput exceeding.

throughput

Type: locations_penalty_throughput

Penalty components for throughput exceeding.

time_between_visits

Type: locations_penalty_time_between_visits

Penalty components for exceeding max_time_between_visits_s restriction.

transit_time

Type: locations_penalty_transit_time

Penalty components for exceeding transit time

Name

Description

units

Type: number

Size of shipment in custom units.

volume_cbm

Type: number

Volume of minimal part, cubic meters.

weight_kg

Type: number

Weight of minimal part, kilograms.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

Name

Description

fixed

Type: number

Fixed service duration for any part of the order.

Max value: 3153600000

scaled

Type: number

Service time for a part of an order, which is multiplied by order ratio.

Max value: 3153600000

Name

Description

client

Type: client_service_duration_0 or number

Duration of service at a location, which can be shared among the other orders of the same client (by client_id) at exactly the same location.

crossdock

Type: crossdock_service_duration_0 or number

Time spent at a crossdock location during the unloading of this order. More information

depot

Type: depot_duration_0 or number

Time spent at a depot during handling of this location (goods loading, document collection, etc.). More information

location

Type: service_duration_2_0 or number

Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information

parking

Type: number

Duration of parking at location. If the order is delivered using routing_mode walking or transit, this time will not be spent. If the location was chosen as a parking for the walking part, then the time will be spent once before the start of the part.

Max value: 3153600000

stop

Type: shared_service_duration_0 or number

Duration of service at a location, which can be shared among the other orders at exactly the same location. Shared service duration can include such operations as parking of a car, delivering documents, etc. More information

Name

Description

fixed

Type: number

Fixed service duration for any part of the order.

Max value: 3153600000

scaled

Type: number

Service time for a part of an order, which is multiplied by order ratio.

Max value: 3153600000

Name

Description

custom

Type: number

Size of shipment in custom units. Sizes in custom units are defined in format "name": size, where name is a string denoting the name of a unit, and size is a non-negative floating-point number denoting the quantity of the corresponding unit in the shipment. If the name of a unit is present in other objects (locations/vehicles/trailers), but not this, it is assumed that the quantity of this unit in the shipment is zero. More information

units

Type: number

Size of shipment in custom units.

Max value: 1000000000

volume

Type: locations_shipment_size_volume

Shipment dimensions and type.

volume_cbm

Type: number

Explicit volume, cubic meters. By default, the value is taken from "volume", if nothing is specified here.

weight_kg

Type: number

Weight of shipment, kilograms.

Max value: 1000000000

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

Name

Description

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

Name

Description

hard_limit_s

Type: number

Hard time limit, values above it are unacceptable

Max value: 1000000000

limit_s

Type: number

Soft time limit, values above it are acceptable but they will be penalized

Max value: 1000000000

Name

Description

id*

Type: string

A unique ID of a balanced group of routes.

penalty

Type: solver_options_svrp_balanced_groups_penalty

Penalties for imbalanced routes.

Name

Description

location_ids*

Type: (integer or string)[]

Reference to a location specified in locations. More information

dependent

Type: boolean

When true, either all or none of the locations in group will be served.

solid

Type: boolean

When true, all assigned locations in group will be served consecutively, but their order is not fixed.

title

Type: string

Name

Description

close_location_groups

Type: solver_options_svrp_penalty_close_location_groups

Penalty components for extra visits to close location group poins.

drop_penalty_percentage

Type: solver_options_svrp_penalty_drop_penalty_percentage

Penalty components for max_drop_penalty_percentage violation.

multiorders

Type: solver_options_svrp_penalty_multiorders

Penalty components for extra visits to multiorder poins.

split_orders_percentage

Type: solver_options_svrp_penalty_split_orders_percentage

Penalty components for max_split_orders_percentage violation.

Name

Description

penalty

Type: solver_options_svrp_points_throughputs_penalty

point

Type: solver_options_svrp_points_throughputs_point

WGS84 coordinate of a location. More information

throughput

Type: solver_options_svrp_points_throughputs_throughput

Point throughput limit.

Name

Description

breaks*

Type: array

id*

Type: string

A unique ID of a template.

Name

Description

custom

Type: number

Amount of custom units a vehicle is able to carry. Capacities in custom units are defined in format "name": size, where name is a string denoting the name of a unit, and size is a non-negative floating-point number denoting the vehicle capacity with respect to this unit. If the name of a unit is present in objects (locations/vehicles/trailers), but not this, it is assumed that the capacity is unlimited.

limits

Type: vehicle_capacity_limits

Vehicle load limits.

units

Type: number

Amount of custom units a vehicle is able to carry.

Default: 1000000000

volume

Type: vehicle_capacity_volume

Vehicle dimensions.

volume_cbm

Type: number

Volume a vehicle is able to fit, cubic meters.

weight_kg

Type: number

Weight a vehicle is able to carry, kilograms.

Default: 1000000000

Name

Description

distance_till_service_m

Type: vehicle_close_locations_distance_till_service_m

duration_till_service_s

Type: vehicle_close_locations_duration_till_service_s

routing_mode

Type: string

Transportation method is used to determine close locations. This parameter can be used only if the walking_courier field is defined in the vehicle. In this case, the values walking and the value of the main transportation method of the vehicle are acceptable.

Enum: driving, truck, walking, transit, bicycle

search_radius_m

Type: number

Maximum distance between two locations in meters at which locations on which the restriction is applied.

Max value: 1000000000

soft_search_radius_m

Type: number

If value is greater than the corresponding value of the search_radius_m for locations at distances from search_radius_m to soft_search_radius_m, the penalty is linear reduced down to 0.

Max value: 1000000000

Name

Description

fixed

Type: number

Cost per fact of vehicle use (cost occurred if vehicle is included in route).

Default: 3000

hour

Type: number

Cost of using vehicle per hour. It should not be zero or very small, otherwise you may get routes which are not optimal in terms of time.

Default: 100

km

Type: number

Cost of using vehicle per kilometer. It should not be zero or very small, otherwise you may get routes which are not optimal in terms of distance.

Default: 8

location

Type: number

Cost of using vehicle per location (default 0).

run

Type: number

Cost per single vehicle run from depot to locations.

tonne_km

Type: number

Cost of carrying one tonne for one kilometer (default 0).

waiting_hour

Type: number

Cost of waiting per hour. If not defined, the value specified in the hour field is used.

Name

Description

route

Type: string

Arithmetic expression representing route cost

run

Type: string

Arithmetic expression representing run cost

shift

Type: string

Arithmetic expression representing shift cost

Name

Description

work_duration_s*

Type: number

Duration of continuous work before the break, seconds.

Max value: 3153600000

shift_id

Type: string

Unique identifier of a shift.

Name

Description

value*

Type: number

Value of the zone. This value is subtracted from the route cost for any served location with a matching zone.For location with multiple matching zones will be chosen the maximum bonus.

zone*

Type: string

Zone number.

Min length: 1

Max length: 80

Name

Description

route

Type: string

Arithmetic expression representing route cost

run

Type: string

Arithmetic expression representing run cost

shift

Type: string

Arithmetic expression representing shift cost

Name

Description

arrival_after_start

Type: vehicle_penalty_arrival_after_start

Penalty components for arrived after start of timewindow

empty_runs

Type: vehicle_penalty_empty_runs

Penalty components for empty runs, which cannot be skipped because of actual visit times.

min_stop_weight

Type: vehicle_penalty_min_stop_weight

Penalty components for insufficient total orders weight in point.

Name

Description

locations*

Type: vehicle_planned_route_locations_item[]

A planned order of locations in a vehicle route including all shifts and multiple runs. If the list of shifts (see shifts) is provided for the vehicle, you have to specify a valid shift_id for every location in the route.

planned_runs_first

Type: boolean

It is necessary to visit all depots, listed in planned_route, before making non-planned runs.

start_time

Type: string or array

work_breaks

Type: vehicle_planned_route_work_breaks_item[]

Planned work breaks for a vehicle route including all shifts and multiple runs. If the list of shifts (see shifts) is provided for the vehicle, you have to specify a valid shift_id for every work break. If both planned_work_breaks and fixed_work_breaks lists are provided for a vehicle, one must be a prefix of another upon restriction on any shift. Thus it is impossible to override fixed work breaks by planned work breaks.

Name

Description

breaks*

Type: array

Name

Description

id*

Type: string

Unique identifier of a shift.

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

balanced_group_id

Type: string

ID of a corresponding balanced group of routes (see the option balanced_groups).

hard_max_duration_s

Type: number

Hard limit on the maximum shift duration in seconds. If both max_duration_s and hard_max_duration_s are present, the value of hard_max_duration_s should be greater or equal to the value of max_duration_s.

Default: 2592000

Max value: 3153600000

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Restricts time window relaxation during route planning. When true, vehicles are allowed to finish a shift only within the specified time window. More information

immutable

Type: boolean

All routes for this shift, specified in initial_routes, are used without changes, new runs can not be added.

max_duration_s

Type: number

Maximal duration of a shift in seconds. If a planned shift duration is greater than specified, the shift out of time penalties are applied.

Default: 172800

Max value: 3153600000

max_mileage_km

Type: number

Maximal mileage of the vehicle during the shift in kilometers. If a planned mileage is greater than this value, the penalties from a shift parameter penalty.max_mileage are applied. More information

max_runs

Type: integer

Maximal number of the vehicle runs from the depot to locations in shift.

Default: 1

maximal_stops

Type: integer

Maximal number of shift stops, if the final stop count is greater than this value, stop_excess penalties are applied.More information

minimal_stops

Type: integer

Minimal number of shift stops, if the final stop count is less than this value, stop_lack penalties are applied. More information

minimal_unique_stops

Type: integer

Minimal number of shift stops with unique coordinates, if the final stop count is less than this value, unique_stop_lack penalties are applied.

penalty

Type: vehicle_shifts_penalty

Penalties for shift constraints violation.

preset_id

Type: string

Preset number for vehicle shift.

service_duration_s

Type: number

Duration of service in between shifts (in seconds). It can include any operations needed to finish the shift, such as time to change a driver, exchange papers etc (default: 0).

Max value: 3153600000

Name

Description

height

Type: number

Height of the vehicle, meters.

length

Type: number

Length of the vehicle, meters.

max_weight

Type: number

Maximum weight of the vehicle, tons.

max_weight_kg

Type: number

Maximum weight of the vehicle, kilograms. When solving the problem, the characteristic will be rounded up to tons.If both characteristics are set max_weight and max_weight_kg, `max_weight will be used.

width

Type: number

Width of the vehicle, meters.

Name

Description

capacity

Type: vehicle_trailer_capacity

Trailer capacity.

cost

Type: vehicle_trailer_cost

Trailer cost.

coupling_time_s

Type: number

Extra time to couple the trailer, seconds.

Max value: 3153600000

decoupling_time_s

Type: number

Extra time to decouple the trailer, seconds.

Max value: 3153600000

max_capacity_difference

Type: vehicle_trailer_max_capacity_difference

The maximum difference between the loading of the trailer and the head.

rolling_cost

Type: number

Penalty for each rolling of goods from the trailer to the head.

rolling_time

Type: vehicle_trailer_rolling_time

Time for loading shipments from trailer to head. In case multiple types of time are specified, the one that takes the most time is chosen. In case none of them is specified, only fixed loading time is used.

Name

Description

id*

Type: integer or string

Reference to a location specified in locations. More information

delivered_orders

Type: (integer or string)[]

List of IDs of orders delivered to the drop_off, depot or crossdock for delivery to the destination.
Reference to a location specified in locations. More information

order_ratio

Type: number

Order ratio, included in this part.

shift_id

Type: string

Unique identifier of a shift.

time

Type: string

Time of departure from a location, in [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z.

wait_if_early

Name

Description

capacity

Type: vehicle_walking_courier_capacity

Capacity of a courier

cost

Type: vehicle_walking_courier_cost

Courier work cost.

restrictions

Type: vehicle_walking_courier_restrictions

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

Name

Description

early

Type: depot_location_1_penalty_early

Penalty components for early service (used instead of out_of_time penalty).

late

Type: depot_location_1_penalty_late

Penalty components for late visits (used instead of out_of_time penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option.

out_of_time

Type: depot_location_1_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

package_throughput

Type: depot_location_1_penalty_package_throughput

Penalty components for package throughput exceeding.

throughput

Type: depot_location_1_penalty_throughput

Penalty components for throughput exceeding.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

Name

Description

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

Name

Description

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field.

penalty

Type: depot_location_1_time_windows_loading_penalty

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depot_location_1_time_windows_loading_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

Name

Description

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field.

penalty

Type: depot_location_1_time_windows_refilling_penalty

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depot_location_1_time_windows_refilling_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

Name

Description

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field.

penalty

Type: depot_location_1_time_windows_unloading_penalty

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depot_location_1_time_windows_unloading_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

Name

Description

early

Type: depots_penalty_early

Penalty components for early service (used instead of out_of_time penalty).

late

Type: depots_penalty_late

Penalty components for late visits (used instead of out_of_time penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option.

out_of_time

Type: depots_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

package_throughput

Type: depots_penalty_package_throughput

Penalty components for package throughput exceeding.

throughput

Type: depots_penalty_throughput

Penalty components for throughput exceeding.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

Name

Description

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

Name

Description

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field.

penalty

Type: depots_time_windows_loading_penalty

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depots_time_windows_loading_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

Name

Description

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field.

penalty

Type: depots_time_windows_refilling_penalty

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depots_time_windows_refilling_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

Name

Description

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

hard_window

Type: boolean

Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field.

penalty

Type: depots_time_windows_unloading_penalty

time_window

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

time_windows

Type: depots_time_windows_unloading_time_windows_item[]

List of allowed time windows. Time windows can not overlap. Fields time_window and time_windows are mutually exclusive. Either none or all of time_window must have corresponding hard_time_window. More information

Name

Description

node*

Type: initial_route_node_depot or initial_route_node_location_1 or initial_route_node_work_break or initial_route_node_courier_position

Route component.

actual_arrival_time_s

Type: number or string

Actual arrival time at the location.

actual_departure_time_s

Type: number or string

Actual time of departure from the location.

actual_service_start_time_s

Type: number or string

Actual time of service start in the location.

arrival_time_s

Type: number or string

Arrival time at the location. Arrival happened before the start of the time window, will incur waiting time.

departure_time_s

Type: number or string

Time of departure from the location.

load_to_head

Type: (integer or string)[]

List of orders that should be loaded to the head of the vehicle at depot or anchor location, in case trailers are used. Orders are listed in the order of serving.
Reference to a location specified in locations. More information

load_to_trailer

Type: (integer or string)[]

List of orders that should be loaded to the trailer of the vehicle at depot, in case trailers are used. Orders are listed in the order of serving.
Reference to a location specified in locations. More information

multi_order

Type: boolean

An order is one of several orders at exactly the same location which are served together. Arrival time is the same for all orders in the group, also the orders share shared_service_duration_s. Total service duration of all orders in multi-order group is computed as: max(shared_service_duration_s) + sum(service_duration_s).

waiting_duration_s

Type: number

Waiting duration, time spent at location after arrival and before the start of the time window, seconds.

Name

Description

id*

Type: string

Unique identifier of a shift.

balanced_group_id

Type: string

ID of a corresponding balanced group of routes (see the option balanced_groups).

end

Type: initial_routes_shift_end

Route node, contains information about a visited location or a work break, transit information and arrival time.

start

Type: initial_routes_shift_start

Route node, contains information about a visited location or a work break, transit information and arrival time.

Name

Description

coordinates

Type: number[][][]

Always consists of two elements: longitude and lattitude

type

Type: string

Always equals Polygon

Name

Description

fixed

Type: number

Fixed penalty applied if the depot is visited after the deadline.

Default: 1000

minute

Type: number

Penalty for each minute of lateness, when the depot is visited after the deadline.

Default: 17

Name

Description

fixed

Type: number

Penalty for violation, regardless of the size of the violation.

Default: 1000

minute

Type: number

Penalty for every minute of violation.

Default: 17

Name

Description

fixed

Type: number

Penalty for violation, regardless of the size of the violation.

Default: 1000

minute

Type: number

Penalty for every minute of violation.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty for not delivering any part of the order.

scaled

Type: number

Penalty for not delivering order ratio.

Default: 1000000

Name

Description

fixed

Type: number

Fixed penalty applied if the location starts being served before the start of the time window.

Default: 1000

minute

Type: number

Penalty for each minute of early arrival when the location starts being served before the start of the time window.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied if the location is visited after the end of the time window.

Default: 1000

minute

Type: number

Penalty for each minute of lateness, when the location is visited after the end of the time window.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied if the location is visited outside of the time window. See the specifications of early and late options for more details in each case.

Default: 1000

minute

Type: number

Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of early and late options for more details in each case.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied if throughput is exceeded.

Default: 1000

kg

Type: number

Penalty for each extra kg of throughput exceeding.

Default: 50

unit

Type: number

Penalty for each extra custom unit of throughput exceeding (units field).

Default: 100

vehicle

Type: number

Penalty for each extra vehicle per hour of throughput exceeding.

Default: 100000

Name

Description

fixed

Type: number

Fixed penalty applied if throughput is exceeded.

Default: 1000

kg

Type: number

Penalty for each extra kg of throughput exceeding.

Default: 50

unit

Type: number

Penalty for each extra custom unit of throughput exceeding (units field).

Default: 100

vehicle

Type: number

Penalty for each extra vehicle per hour of throughput exceeding.

Default: 100000

Name

Description

fixed

Type: number

Penalty for each case of violation, regardless of the size of the violation.

Default: 1000

minute

Type: number

Penalty for every minute of violation.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied if the order was delivered with a violation of the soft transit time limit

minute

Type: number

Penalty for each minute transit time violation

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, kilograms per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, custom units per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, simultaneously vehicles.

Max value: 1000000000

Name

Description

depth_m*

Type: number

Depth, meters.

Max value: 1000000

height_m*

Type: number

Height, meters.

Max value: 1000000

width_m*

Type: number

Width, meters.

Max value: 1000000

align

Type: string

Defines allowed container alignment for rigid and fixed_bottom types (ignored for bulk containers):

• all_axes — default, all axes of the box must be parallel to vehicle's axes;
• height — the bottom of the box lies on a horizontal surface, but any rotation around the vertical axis (height) is allowed (note that any side can become a bottom for rigid containers). More information

Default: all_axes

Enum: all_axes, height

type

Type: string

Container type:

• bulk — default type, shape can be changed arbitrary to fit the vehicle;
• rigid — container is a box that must fit vehicle dimensions under some orientation;
• fixed_bottom — the bottom of the box must stay the same, but the box can be rotated horizontally (height must fit vehicle's height). More information

Default: bulk

Enum: bulk, rigid, fixed_bottom

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, kilograms per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, custom units per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, simultaneously vehicles.

Max value: 1000000000

Name

Description

custom_value

Type: number

Penalty per each custom_value unit of orders of root-sum-square deviation of a route custom_value unit of orders from an average number of custom_value unit of orders in a balanced group of routes.

hour

Type: number

Penalty per hour of root-sum-square deviation of a route duration from an average duration of a balanced group of routes.

ignore_unused_vehicles

Type: boolean

Ignore unused vehicles for the penalty calculation.

km

Type: number

Penalty per km of root-sum-square deviation of a route distance from an average distance of a balanced group of routes.

served_order

Type: number

Penalty per each missing or extra served order of root-sum-square deviation of a route served order count from an average number of served order in a balanced group of routes.

stop

Type: number

Penalty per each missing or extra stop of root-sum-square deviation of a route stop count from an average number of stops in a balanced group of routes.

unit

Type: number

Penalty per each unit of orders weight of root-sum-square deviation of a route unit of orders weight from an average number of unit of orders weight in a balanced group of routes.

weight_kg

Type: number

Penalty per each kg of orders weight of root-sum-square deviation of a route kg of orders weight from an average number of kg of orders weight in a balanced group of routes.

Name

Description

per_extra_point

Type: number

Penalty for every point where vehicles/couriers arrive more than once.

per_extra_vehicle

Type: number

Penalty for every extra vehicle/courier that arrives at close location group points.

per_extra_visit

Type: number

Penalty for each extra visit to close location group points.

Name

Description

fixed

Type: number

Fixed penalty applied if drop penalty ratio is too high.

Default: 1000

per_percent

Type: number

Penalty for each exceeding percent of drop penalty percentage.

Default: 50

Name

Description

per_extra_point

Type: number

Penalty for every point where vehicles/couriers arrive more than once.

per_extra_vehicle

Type: number

Penalty for every extra vehicle/courier that arrives at multi-order points.

per_extra_visit

Type: number

Penalty for each extra visit to multi-order points.

Name

Description

fixed

Type: number

Fixed penalty applied if split orders ratio is too high.

Default: 1000

per_percent

Type: number

Penalty for each exceeding percent of split orders percentage.

Default: 50

Name

Description

throughput

Type: points_throughputs_penalty_throughput

Penalty components for throughput exceeding.

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

Name

Description

rest_duration_s*

Type: number

Duration of rest, seconds.

Min value: 0.001

Max value: 3153600000

after_last_location

Type: boolean

When true, work break will be put after the last location. If possible it will be merged with the first work break of type listed in merge_with_types field, otherwise it will be put immediately after serving of the last location.

at_rest_place

Type: boolean

When true, the vehicle will break work only in a location with type "rest_place"

before_first_location

Type: boolean

When true, work break will be put before the first location. If possible it will be merged with the last work break of type listed in merge_with_types field, otherwise it will be put immediately before serving of the first location.

continuous_travel_time_range

Type: string

Minimal and maximal duration of continuous travel time before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

driving_time_range

Type: string

Minimal and maximal duration of driving before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

exact_time_range

Type: string

The exact time range when the rest should start, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

merge_with_types

Type: string[]

Types of work breaks this work break can be merged with. This field can only be used with before_first_location or after_last_location fields.

necessary_route_duration_s

Type: number

Minimal duration of route needed to make work break necessary, seconds.

Max value: 3153600000

penalty

Type: breaks_penalty

Penalties applied for violations of work break conditions.

repeatable

Type: boolean

When true, this work break will be repeated until the end of route. Can only be true for the last break in the chain.

route_duration_s

Type: number

Minimal duration of route needed to use work break, seconds.

Max value: 3153600000

travel_time_range

Type: string

Minimal and maximal duration of driving and waiting before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

type

Type: string

Type of work break. Used in merge_with_types field.

work_time_range_from_start

Type: string

Minimal and maximal duration of time from start of route until rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

work_time_range_till_rest

Type: string

Minimal and maximal duration of work before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

Name

Description

units_perc

Type: number

Upper limit of total shipments size in custom units as a percentage of a vehicle capacity.

Default: 100

volume_perc

Type: number

Upper limit of total shipments volume as a percentage of vehicle load bay volume. For container fitting purposes it is assumed that each dimension is multiplied by the cubic root of (0.01 * volume_perc).

Default: 100

weight_perc

Type: number

Upper limit of total shipments weight as a percentage of total weight the vehicle is allowed to carry.

Default: 100

Name

Description

depth_m*

Type: number

Depth, meters.

Default: 1000

Max value: 1000000

height_m*

Type: number

Height, meters.

Default: 1000

Max value: 1000000

width_m*

Type: number

Width, meters.

Default: 1000

Max value: 1000000

Name

Description

penalty

Type: number

Penalty per km exceeding the maximum distance between servicing close locations.

Max value: 1000000000

value

Type: number

The maximum distance traveled between servicing two close locations.

Default: 1000000000

Max value: 1000000000

Name

Description

penalty

Type: number

Penalty per second exceeding the maximum time between servicing close locations.

Max value: 1000000000

value

Type: number

The maximum time between servicing two close locations.

Default: 1000000000

Max value: 1000000000

Name

Description

as_soon_as_possible

Type: boolean

Option for arrive as soon as possible even it includes added wait in route. When using the parameter, it is also recommended to specify a non-zero value of the average_h parameter.

average_h

Type: number

Penalty for average arrived after start of timewindow

Name

Description

fixed

Type: number

Fixed penalty applied if there are empty runs left in the route.

per_run

Type: number

Penalty for every empty run in the route.

Name

Description

fixed

Type: number

Fixed penalty applied if total orders weight is too low.

Default: 1000

kg

Type: number

Penalty for each lacking kg of total orders weight.

Default: 50

Name

Description

id*

Type: integer or string

Reference to a location specified in locations. More information

anchor_mode

Type: string

Default: Undefined

Enum: Decoupling, Rolling, Coupling, Undefined

delivered_orders

Type: (integer or string)[]

List of IDs of orders delivered to the drop_off, depot or crossdock for delivery to the destination.
Reference to a location specified in locations. More information

delivery_in_current_run

Type: boolean

All orders, loaded in this location, have to be delivered in current run.

is_middle_depot

Type: boolean

Location is a middle depot.

loaded_orders

Type: (integer or string)[]

Ids of delivery orders, loaded into the vehicle in garage or depot.

order_ratio

Type: number

Order ratio, included in this part.

parking_mode

Type: string

Default: Undefined

Enum: ParkingBegin, ParkingRefill, ParkingEnd, Undefined

picked_orders

Type: (integer or string)[]

A list of IDs of orders picked up in the crossdock or depot.
Reference to a location specified in locations. More information

shift_id

Type: string

Unique identifier of a shift.

wait_if_early

Name

Description

shift_id*

Type: string

Unique identifier of a shift.

start_time*

Type: string

Shift start time, in[D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z.

Name

Description

work_duration_s*

Type: number

Duration of continuous work before the break, seconds.

Max value: 3153600000

shift_id

Type: string

Unique identifier of a shift.

Name

Description

rest_duration_s*

Type: number

Duration of rest, seconds.

Min value: 0.001

Max value: 3153600000

after_last_location

Type: boolean

When true, work break will be put after the last location. If possible it will be merged with the first work break of type listed in merge_with_types field, otherwise it will be put immediately after serving of the last location.

at_rest_place

Type: boolean

When true, the vehicle will break work only in a location with type "rest_place"

before_first_location

Type: boolean

When true, work break will be put before the first location. If possible it will be merged with the last work break of type listed in merge_with_types field, otherwise it will be put immediately before serving of the first location.

continuous_travel_time_range

Type: string

Minimal and maximal duration of continuous travel time before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

driving_time_range

Type: string

Minimal and maximal duration of driving before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

exact_time_range

Type: string

The exact time range when the rest should start, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

merge_with_types

Type: string[]

Types of work breaks this work break can be merged with. This field can only be used with before_first_location or after_last_location fields.

necessary_route_duration_s

Type: number

Minimal duration of route needed to make work break necessary, seconds.

Max value: 3153600000

penalty

Type: breaks_penalty

Penalties applied for violations of work break conditions.

repeatable

Type: boolean

When true, this work break will be repeated until the end of route. Can only be true for the last break in the chain.

route_duration_s

Type: number

Minimal duration of route needed to use work break, seconds.

Max value: 3153600000

travel_time_range

Type: string

Minimal and maximal duration of driving and waiting before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

type

Type: string

Type of work break. Used in merge_with_types field.

work_time_range_from_start

Type: string

Minimal and maximal duration of time from start of route until rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

work_time_range_till_rest

Type: string

Minimal and maximal duration of work before rest, format: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

Name

Description

early

Type: shifts_penalty_early

Penalty components for shifts started too early (used instead of out_of_time penalty). If the shift was also finished too early, it is applied to the shift finish too.

late

Type: shifts_penalty_late

Penalty components for shifts finished too late (used instead of out_of_time penalty). This penalty is applied for being late to the end of the shift's time window or violating the max_duration_s bound. If both are violated simultaneously, the penalty is applied twice and summed. If the shift was started after the end of the time window, this penalty for the start time point is also added separately. More information

max_mileage

Type: shifts_penalty_max_mileage

Penalties applied for violating shift's max_mileage_km limit.

out_of_time

Type: shifts_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

stop_excess

Type: shifts_penalty_stop_excess

Penalties applied for violating shift's maximal_stops limit.

stop_lack

Type: shifts_penalty_stop_lack

Penalties applied for violating shift's minimal_stops limit.

unique_stop_lack

Type: shifts_penalty_unique_stop_lack

Penalties applied for violating shift's minimal_stops limit.

Name

Description

custom

Type: number

Amount of custom units a trailer is able to carry. Capacities in custom units are defined in format "name": size, where name is a string denoting the name of a unit, and size is a non-negative floating-point number denoting the vehicle capacity with respect to this unit. If the name of a unit is present in objects (locations/vehicles/trailers), but not this, it is assumed that the capacity is unlimited.

limits

Type: trailer_capacity_limits

Trailer load limits.

units

Type: number

Amount of custom units a trailer is able to carry.

Default: 1000000000

volume

Type: trailer_capacity_volume

Trailer dimensions.

volume_cbm

Type: number

Volume a trailer is able to fit, cubic meters.

weight_kg

Type: number

Weight a trailer is able to carry, kilograms.

Default: 1000000000

Name

Description

fixed

Type: number

Cost per fact of trailer use (cost occurred if trailer is used in route).

Default: 3000

hour

Type: number

Cost of using trailer per hour.

Default: 100

km

Type: number

Cost of using trailer per kilometer.

Default: 8

location

Type: number

Cost of using trailer per location (default 0).

run

Type: number

Cost per single vehicle run from depot to locations.

tonne_km

Type: number

Cost of carrying one tonne for one kilometer (default 0).

waiting_hour

Type: number

Cost of waiting per hour. If not defined, the value specified in the hour field is used.

Name

Description

custom

Type: number

A maximum allowable difference in the loaded amount of custom units between the trailer and the head. The difference in custom units are defined in format "name": size, where name is a string denoting the name of a unit, and size is a floating-point number denoting the allowable difference with respect to this unit. If the name of a unit is present in objects (locations/vehicles/trailers), but not this, it is assumed that there is no restriction.

units

Type: number

The maximum allowable difference in the loaded amount of custom units between the trailer and the head.

volume_cbm

Type: number

The maximum allowable difference in the loaded volume between the trailer and the head, cubic meters.

weight_kg

Type: number

The maximum allowable difference in the loaded weight between the trailer and the head, kilograms.

Name

Description

fixed_time_s

Type: number

Fixed time spent each time a trailer is loaded or unloaded, seconds.

Max value: 3153600000

s_per_kg

Type: number

Loading time per kg, seconds.

Max value: 3153600000

s_per_m3

Type: number

Loading time per cubic meter, seconds.

Max value: 3153600000

s_per_unit

Type: number

Loading time per unit, seconds.

Max value: 3153600000

Name

Description

units

Type: number

Amount of custom units a courier is able to carry.

Default: 1000000000

Name

Description

hour

Type: number

Cost per hour of courier walking routes.

km

Type: number

Cost per kilometer walked by courier.

Name

Description

max_parking_duration_s

Type: walking_courier_restrictions_max_parking_duration_s

max_parking_walking_distance_m

Type: walking_courier_restrictions_max_parking_walking_distance_m

max_walking_edge_distance_m

Type: walking_courier_restrictions_max_walking_edge_distance_m

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Depot package throughput, kilograms per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Depot package throughput, units per hour.

Name

Description

fixed

Type: number

Fixed penalty applied if a vehicle starts serving the depot before the start of the time window. The penalty is applied for any early service, including opening the depot, unloading or uploading the vehicle at the depot or closing the depot. It is applied once for each visit of a depot during which the depot was served early.

Default: 1000

minute

Type: number

Penalty for each minute of early service of the depot. Applied in the same cases as the fixed penalty.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied for each visit of the depot after the end of the time window. Starting from a depot is counted for a visit.

Default: 1000

minute

Type: number

Penalty for each minute of lateness for every visit of the depot after the end of the time window.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied if the depot is visited outside of the time window. See the specifications of early and late options for more details in each case.

Default: 1000

minute

Type: number

Penalty for each minute of being outside of the time window of the depot. See the specifications of early and late options for more details in each case.

Default: 17

Name

Description

fixed

Type: number

Fixed penalty applied if throughput is exceeded.

Default: 1000

kg

Type: number

Penalty for each extra kg of throughput exceeding.

Default: 50

unit

Type: number

Penalty for each extra custom unit of throughput exceeding (units field).

Default: 100

Name

Description

fixed

Type: number

Fixed penalty applied if throughput is exceeded.

Default: 1000

kg

Type: number

Penalty for each extra kg of throughput exceeding.

Default: 50

unit

Type: number

Penalty for each extra custom unit of throughput exceeding (units field).

Default: 100

vehicle

Type: number

Penalty for each extra vehicle per hour of throughput exceeding.

Default: 100000

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, kilograms per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, custom units per hour.

Name

Description

time_window

Type: string

The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero.

value

Type: number

Throughput, simultaneously vehicles.

Max value: 1000000000

Name

Description

early

Type: time_windows_loading_penalty_early

Penalty components for early service (used instead of out_of_time penalty).

late

Type: time_windows_loading_penalty_late

Penalty components for late visits (used instead of out_of_time penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option.

out_of_time

Type: time_windows_loading_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

Name

Description

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

Name

Description

early

Type: time_windows_refilling_penalty_early

Penalty components for early service (used instead of out_of_time penalty).

late

Type: time_windows_refilling_penalty_late

Penalty components for late visits (used instead of out_of_time penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option.

out_of_time

Type: time_windows_refilling_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

Name

Description

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information

Name

Description

early

Type: time_windows_unloading_penalty_early

Penalty components for early service (used instead of out_of_time penalty).

late

Type: time_windows_unloading_penalty_late

Penalty components for late visits (used instead of out_of_time penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service option.

out_of_time

Type: time_windows_unloading_penalty_out_of_time

Penalty components for time window failure. Can be used to set the values of early and late options simultaneously, and each value is overridden if the respective option is also defined.

Name

Description

time_window*

Type: string

Allowed time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. More information

hard_time_window

Type: string

Allowed hard time window to visit location, in [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] format or ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Hard time window must include time range defined in corresponding time_window field. Fields hard_time_window and hard_window are mutually exclusive. More information