- Request
- Query parameters
- Body
- mvrp_request_1_locations_item
- solver_options_mvrp_2
- vehicle
- depot_location_1
- mvrp_request_1_depots_item
- mvrp_request_1_initial_routes_item
- mvrp_request_1_zones_item
- coordinate_2
- client_service_duration_0
- crossdock_service_duration_0
- depot_duration_0
- items_optional_tags_item
- items_penalty
- quant_0
- items_rolling_throughput
- service_duration_2_0
- service_durations
- shared_service_duration_0
- items_shipment_size
- items_throughput
- items_time_windows_item
- items_transit_time
- solver_options_mvrp_2_balanced_groups_item
- solver_options_mvrp_2_location_groups_item
- solver_options_mvrp_2_penalty
- solver_options_mvrp_2_points_throughputs_item
- solver_options_mvrp_2_template_rest_schedules_item
- vehicle_capacity
- vehicle_close_locations_item
- cost_0
- cost_1
- vehicle_fixed_work_breaks_item
- vehicle_optional_zones_item
- payout_0
- vehicle_penalty
- vehicle_planned_route
- vehicle_rest_schedule
- vehicle_shifts_item
- vehicle_specs
- vehicle_trailer
- vehicle_visited_locations_item
- vehicle_walking_courier
- depot_location_1_package_throughput
- depot_location_1_penalty
- depot_location_1_throughput
- depot_location_1_time_windows_item
- depot_location_1_time_windows_loading
- depot_location_1_time_windows_refilling
- depot_location_1_time_windows_unloading
- items_package_throughput
- items_penalty_1
- items_throughput_1
- items_time_windows_item_1
- items_time_windows_loading
- items_time_windows_refilling
- items_time_windows_unloading
- initial_routes_route_element_1
- items_shift
- items_geometry
- penalty_delivery_deadline
- penalty_depot_expiring_time
- penalty_depot_ready_time
- drop_0
- penalty_early_4
- penalty_late_4
- penalty_out_of_time_4
- penalty_rolling_throughput
- penalty_throughput_1
- penalty_time_between_visits
- kg_per_hour_0_item_3
- units_per_hour_0_item_3
- vehicle_count_0_item_2
- shipment_size_volume
- kg_per_hour_0_item_2
- units_per_hour_0_item_2
- vehicle_count_0_item_1
- items_penalty_9
- penalty_close_location_groups_1
- penalty_drop_penalty_percentage_1
- penalty_multiorders_1
- penalty_split_orders_percentage_1
- items_penalty_8
- items_point_1
- items_throughput_3
- breaks_0_item_1
- capacity_limits_1
- capacity_volume_1
- penalty_arrival_after_start
- penalty_empty_runs
- penalty_min_stop_weight
- planned_route_locations_item
- start_time_0_item
- planned_route_work_breaks_item
- breaks_0_item_2
- items_penalty_10
- trailer_capacity
- trailer_cost
- trailer_max_capacity_difference
- trailer_rolling_time
- walking_courier_capacity
- walking_courier_cost
- kg_per_hour_0_item_1
- units_per_hour_0_item_1
- penalty_early_3
- penalty_late_3
- penalty_out_of_time_3
- penalty_package_throughput
- penalty_throughput
- kg_per_hour_0_item
- units_per_hour_0_item
- vehicle_count_0_item
- time_windows_loading_time_windows_item
- time_windows_refilling_time_windows_item
- time_windows_unloading_time_windows_item
- kg_per_hour_0_item_5
- units_per_hour_0_item_5
- penalty_early_8
- penalty_late_8
- penalty_out_of_time_8
- penalty_package_throughput_1
- penalty_throughput_2
- kg_per_hour_0_item_4
- units_per_hour_0_item_4
- vehicle_count_0_item_3
- time_windows_loading_time_windows_item_1
- time_windows_refilling_time_windows_item_1
- time_windows_unloading_time_windows_item_1
- initial_route_node_depot
- initial_route_node_location_1
- initial_route_node_work_break
- initial_route_node_courier_position
- shift_end
- shift_start
- penalty_throughput_5
- kg_per_hour_0_item_9
- units_per_hour_0_item_9
- vehicle_count_0_item_7
- items_penalty_7
- items_penalty_12
- penalty_early_14
- penalty_late_14
- penalty_max_mileage
- penalty_out_of_time_10
- penalty_stop_excess
- penalty_stop_lack
- penalty_unique_stop_lack
- capacity_limits
- capacity_volume
- initial_route_node_depot_value
- initial_route_node_location_1_value
- initial_route_node_work_break_value
- initial_route_node_courier_position_value
- route_node_depot
- route_node_location_1
- route_node_work_break
- route_node_courier_position
- end_failed_time_window
- end_overtime
- end_probably_failed_time_window
- items_0_2
- items_1_2
- start_failed_time_window
- start_overtime
- start_probably_failed_time_window
- items_0_1
- items_1_1
- penalty_early_13
- penalty_late_13
- penalty_early_16
- penalty_late_16
- value_split_info_1
- items_0_12
- items_1_12
- items_2_3
- items_3_2
- items_4_2
- items_5_2
- items_6_2
- items_7_2
- items_8_2
- items_9_2
- value_split_info
- items_0
- items_1
- items_2
- items_3
- items_4
- items_5
- items_6
- items_7
- items_8
- items_9
- route_depot_location
- route_node_depot_used_projection
- route_location_1
- route_node_location_1_used_projection
- route_work_break
- route_node_work_break_used_projection
- route_courier_position
- route_node_courier_position_used_projection
- _incompatibilities_item_5
- _incompatibilities_item_4
- _incompatibilities_item_1
- _incompatibilities_item
- route_depot_location_package_throughput
- route_depot_location_penalty
- route_depot_location_throughput
- route_depot_location_time_windows_item
- route_depot_location_time_windows_loading
- route_depot_location_time_windows_refilling
- route_depot_location_time_windows_unloading
- items_0_9
- items_1_9
- items_2_2
- route_location_1_optional_tags_item
- route_location_1_penalty
- quant_0_1
- route_location_1_rolling_throughput
- route_location_1_shipment_size
- route_location_1_split_info
- route_location_1_throughput
- route_location_1_time_windows_item
- route_location_1_transit_time
- items_0_4
- items_1_4
- items_2_1
- items_3_1
- items_4_1
- items_5_1
- items_6_1
- items_7_1
- items_8_1
- items_9_1
- route_work_break_penalty
- items_types_item_2
- items_zones_item_2
- items_types_item
- items_zones_item
- kg_per_hour_0_item_20
- units_per_hour_0_item_20
- penalty_early_30
- penalty_late_30
- penalty_out_of_time_21
- penalty_package_throughput_3
- penalty_throughput_11
- kg_per_hour_0_item_19
- units_per_hour_0_item_19
- vehicle_count_0_item_16
- time_windows_loading_time_windows_item_3
- time_windows_refilling_time_windows_item_3
- time_windows_unloading_time_windows_item_3
- penalty_delivery_deadline_1
- penalty_depot_expiring_time_1
- penalty_depot_ready_time_1
- drop_0_1
- penalty_early_9
- penalty_late_9
- penalty_out_of_time_9
- penalty_rolling_throughput_1
- penalty_throughput_3
- penalty_time_between_visits_1
- kg_per_hour_0_item_7
- units_per_hour_0_item_7
- vehicle_count_0_item_5
- shipment_size_volume_1
- kg_per_hour_0_item_6
- units_per_hour_0_item_6
- vehicle_count_0_item_4
- _incompatibilities_item_3
- _incompatibilities_item_2
- penalty_early_26
- penalty_late_26
- items_types_item_1
- items_zones_item_1
- Responses
- 202 Accepted
- 400 Bad Request
- 401 Unauthorized
- 429 Too Many Requests
- 500 Internal Server Error
- 503 Service Unavailable
Добавить задачу
Поставить MVRP-задачу в очередь на обработку.
Request
POST
https://courier.yandex.ru/vrs/api/v1/add/mvrp
Query parameters
Name |
Description |
apikey* |
Type: string Ключ доступа к API. |
parent_task_id |
Type: string Идентификатор родительской задачи. |
Body
application/json
{
"depot": {
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"description": "string",
"finish_service_duration_s": 0,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"type": "depot",
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
},
"depots": [
{
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"description": "string",
"finish_service_duration_s": 0,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"type": "depot",
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
}
],
"initial_routes": [
{
"fixed_order": false,
"immutable": false,
"route": [
{
"actual_arrival_time_s": 0,
"actual_departure_time_s": 0,
"actual_service_start_time_s": 0,
"arrival_time_s": 0,
"departure_time_s": 0,
"load_to_head": [
0,
"string"
],
"load_to_trailer": [
0,
"string"
],
"multi_order": false,
"waiting_duration_s": 0,
"node": {
"type": "depot",
"value": {
"actual_total_service_duration_s": 0,
"added_shared_service_duration_s": 0,
"anchor_mode": "Decoupling",
"delivered_orders": [
0,
"string"
],
"delivery_deadline": "string",
"fixed_position": false,
"fixed_run": false,
"fixed_shift": false,
"fixed_vehicle": false,
"id": 0,
"keep_in_vehicle": false,
"loaded_orders": [
0,
"string"
],
"parking_mode": "ParkingBegin",
"parking_type": "trailer",
"picked_orders": [
0,
"string"
],
"pickup_id": 0,
"pickup_ids": [
0,
"string"
],
"service_waiting_duration_s": 0,
"total_service_duration_s": 0,
"trailer_decoupled": false,
"trailer_used": false,
"undroppable": false,
"unfeasible_reasons": [
{
"custom_type": "string",
"overload": 0,
"text": "string",
"type": "OVERLOAD_WEIGHT"
},
{
"late_duration_s": 0,
"text": "string",
"type": "FAILED_HARD_TIME_WINDOW"
},
{
"tags": [
"string"
],
"text": "string",
"type": "REQUIRED_TAGS_VIOLATION"
},
{
"tags": [
"string"
],
"text": "string",
"type": "EXCLUDED_TAGS_VIOLATION"
},
{
"overrun_s": 0,
"text": "string",
"type": "TRANSIT_TIME_VIOLATION"
},
{
"incompatibilities": [
{
"incompatible_order_id": 0,
"types": [
{
"other_type": "string",
"self_type": "string"
}
]
}
],
"text": "string",
"type": "INCOMPATIBLE_LOAD_TYPES_VIOLATION"
},
{
"incompatibilities": [
{
"incompatible_order_id": 0,
"zones": [
{
"other_zone": "string",
"self_zone": "string"
}
]
}
],
"text": "string",
"type": "INCOMPATIBLE_ZONES_VIOLATION"
},
{
"tags": [
"string"
],
"text": "string",
"type": "ALLOWED_ZONES_VIOLATION"
},
{
"tags": [
"string"
],
"text": "string",
"type": "FORBIDDEN_ZONES_VIOLATION"
},
{
"text": "string",
"type": "OTHER"
}
],
"zones": [
"string"
],
"split_info": {
"order_ratio": 0,
"part_id": 0,
"parts_count": 0,
"units": 0,
"volume_cbm": 0,
"weight_kg": 0
}
}
}
}
],
"vehicle_id": 0,
"shift": {
"balanced_group_id": "string",
"id": "string",
"start": {
"actual_arrival_time_s": 0,
"actual_departure_time_s": 0,
"actual_service_start_time_s": 0,
"actual_waiting_duration_s": 0,
"arrival_time_s": 0,
"departure_time_s": 0,
"load_to_head": [
0,
"string"
],
"load_to_trailer": [
0,
"string"
],
"multi_order": false,
"stop_sequence_number": 0,
"transit_distance_m": 0,
"transit_duration_s": 0,
"violations": [
{
"pickup_id": 0,
"type": "FAILED_DELIVERY_DEADLINE"
},
{
"high_risk": false,
"pickup_id": 0,
"probability": 0,
"type": "FAILED_DELIVERY_DEADLINE"
}
],
"waiting_duration_s": 0,
"probably_failed_time_window": {
"duration_s": 0,
"high_risk": false,
"how": "EARLY",
"probability": 0
},
"overtime": {
"duration_s": 0
},
"node": {
"type": "depot",
"used_hard_time_window": "string",
"used_time_window": "string",
"value": {
"actual_total_service_duration_s": 0,
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"delivered_orders": [
0,
"string"
],
"description": "string",
"finish_service_duration_s": 0,
"fixed_position": false,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"loaded_orders": [
0,
"string"
],
"picked_orders": [
0,
"string"
],
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"routing_mode": "driving",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"total_service_duration_s": 0,
"trailer_decoupled": false,
"trailer_used": false,
"type": "depot",
"unfeasible_reasons": [
{
"late_duration_s": 0,
"text": "string",
"type": "FAILED_HARD_TIME_WINDOW"
},
{
"overrun_s": 0,
"text": "string",
"type": "TRANSIT_TIME_VIOLATION"
},
{
"text": "string",
"type": "OTHER"
}
],
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
},
"used_projection": {
"lat": 0,
"lon": 0
}
},
"failed_time_window": {
"duration_s": 0,
"how": "EARLY"
}
},
"end": {
"actual_arrival_time_s": 0,
"actual_departure_time_s": 0,
"actual_service_start_time_s": 0,
"actual_waiting_duration_s": 0,
"arrival_time_s": 0,
"departure_time_s": 0,
"load_to_head": [
0,
"string"
],
"load_to_trailer": [
0,
"string"
],
"multi_order": false,
"stop_sequence_number": 0,
"transit_distance_m": 0,
"transit_duration_s": 0,
"violations": [
{
"pickup_id": 0,
"type": "FAILED_DELIVERY_DEADLINE"
},
{
"high_risk": false,
"pickup_id": 0,
"probability": 0,
"type": "FAILED_DELIVERY_DEADLINE"
}
],
"waiting_duration_s": 0,
"probably_failed_time_window": {
"duration_s": 0,
"high_risk": false,
"how": "EARLY",
"probability": 0
},
"overtime": {
"duration_s": 0
},
"node": {
"type": "depot",
"used_hard_time_window": "string",
"used_time_window": "string",
"value": {
"actual_total_service_duration_s": 0,
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"delivered_orders": [
0,
"string"
],
"description": "string",
"finish_service_duration_s": 0,
"fixed_position": false,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"loaded_orders": [
0,
"string"
],
"picked_orders": [
0,
"string"
],
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"routing_mode": "driving",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"total_service_duration_s": 0,
"trailer_decoupled": false,
"trailer_used": false,
"type": "depot",
"unfeasible_reasons": [
{
"late_duration_s": 0,
"text": "string",
"type": "FAILED_HARD_TIME_WINDOW"
},
{
"overrun_s": 0,
"text": "string",
"type": "TRANSIT_TIME_VIOLATION"
},
{
"text": "string",
"type": "OTHER"
}
],
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
]
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
},
"used_projection": {
"lat": 0,
"lon": 0
}
},
"failed_time_window": {
"duration_s": 0,
"how": "EARLY"
}
}
}
}
],
"locations": [
{
"address": "string",
"allow_trailers": false,
"can_be_merged": true,
"can_be_split": false,
"client_id": 0,
"client_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"comments": "string",
"crossdock_mode": "deny",
"crossdock_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"custom_value": 0,
"delivery_deadline": "string",
"delivery_to": 0,
"delivery_to_any": [
0,
"string"
],
"depot_duration_s": {
"fixed": 0,
"scaled": 0
},
"depot_expiring_time": "string",
"depot_id": [
0,
"string"
],
"depot_ready_time": "string",
"description": "string",
"dropped_ratio": 0,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"ignore_zones_compatibility": false,
"in_lifo_order": false,
"load_types": [
"string"
],
"max_split_parts": 10,
"max_total_vehicles": 0,
"may_drop_in_crossdock": true,
"optional_tags": [
{
"tag": "string",
"value": 0
}
],
"parking_service_duration_s": 0,
"phone": "string",
"pickup_from_any": false,
"pickup_must_reach_depot": false,
"point": {
"lat": 0,
"lon": 0
},
"preset_id": "string",
"quant": 0,
"ref": "string",
"required_tags": [
"string"
],
"sequence_order": 0,
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"service_durations": {
"client": {
"fixed": 0,
"scaled": 0
},
"crossdock": {
"fixed": 0,
"scaled": 0
},
"depot": {
"fixed": 0,
"scaled": 0
},
"location": {
"fixed": 0,
"scaled": 0
},
"parking": 0,
"stop": {
"fixed": 0,
"scaled": 0
}
},
"shared_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"shared_with_company_ids": [
0
],
"soft_depot_expiring_time": "string",
"soft_depot_ready_time": "string",
"split_parts_must_fill_whole_vehicle": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"type": "depot",
"use_in_proximity": true,
"transit_time": {
"hard_limit_s": 0,
"limit_s": 0
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"shipment_size": {
"units": 0,
"volume_cbm": 0,
"weight_kg": 0,
"volume": {
"align": "all_axes",
"depth_m": 0,
"height_m": 0,
"type": "bulk",
"width_m": 0
},
"custom": 0
},
"rolling_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"drop": {
"fixed": 0,
"scaled": 1000000
},
"transit_time": {},
"time_between_visits": {
"fixed": 1000,
"minute": 17
},
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"rolling_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
},
"depot_ready_time": {
"fixed": 1000,
"minute": 17
},
"depot_expiring_time": {
"fixed": 1000,
"minute": 17
},
"delivery_deadline": {
"fixed": 1000,
"minute": 17
}
}
}
],
"options": {
"absolute_time": false,
"avoid_tolls": false,
"avoid_zones": [
"string"
],
"balanced_groups": [
{
"id": "string",
"penalty": {
"custom_value": 0,
"hour": 0,
"ignore_unused_vehicles": false,
"km": 0,
"served_order": 0,
"stop": 0,
"unit": 0,
"weight_kg": 0
}
}
],
"close_location_groups_radius_m": 0,
"close_locations_during_post_optimization_only": false,
"critical_lateness_risk_probability": 20,
"date": "string",
"enable_vehicle_classes": true,
"fix_planned_shifts": false,
"force_merge_multiorders": false,
"global_proximity_factor": 0,
"ignore_min_stops_for_unused": false,
"ignore_zones": false,
"immutable": false,
"incompatible_load_types": [
[
"string"
]
],
"incompatible_zones": [
[
"string"
]
],
"load_when_ready": false,
"location_groups": [
{
"dependent": false,
"location_ids": [
0,
"string"
],
"solid": false,
"title": "string"
}
],
"matrix_router": "main",
"max_distance_to_projection_m": 1000000000,
"max_drop_penalty_percentage": 100,
"max_split_orders_percentage": 100,
"merge_multiorders": false,
"merge_multiorders_of_different_clients": true,
"minimize_lateness_risk": false,
"multiorder_radius_m": 1,
"penalize_late_service": false,
"points_throughputs": [
{
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"point": {
"lat": 0,
"lon": 0
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
}
}
}
],
"post_optimization": false,
"preset_id": "string",
"proximity_factor": 0,
"quality": "low",
"restart_on_drop": false,
"routing_mode": "driving",
"template_rest_schedules": [
{
"breaks": [
{
"after_last_location": false,
"at_rest_place": false,
"before_first_location": false,
"continuous_travel_time_range": "string",
"driving_time_range": "string",
"exact_time_range": "string",
"merge_with_types": [
"string"
],
"necessary_route_duration_s": 0,
"repeatable": false,
"rest_duration_s": 0,
"route_duration_s": 0,
"travel_time_range": "string",
"type": "string",
"work_time_range_from_start": "string",
"work_time_range_till_rest": "string",
"penalty": {
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
}
],
"id": "string"
}
],
"time_zone": 0,
"wait_in_multiorders": true,
"weighted_drop_penalty": false,
"penalty": {
"split_orders_percentage": {
"fixed": 1000,
"per_percent": 50
},
"multiorders": {
"per_extra_point": 0,
"per_extra_vehicle": 0,
"per_extra_visit": 0
},
"drop_penalty_percentage": {
"fixed": 1000,
"per_percent": 50
},
"close_location_groups": {
"per_extra_point": 0,
"per_extra_vehicle": 0,
"per_extra_visit": 0
}
}
},
"vehicles": [
{
"allow_different_depots_in_route": false,
"allowed_zones": [
"string"
],
"can_change_depot_between_runs": false,
"close_locations": [
{
"distance_till_service_m": {
"penalty": 0,
"value": 1000000000
},
"duration_till_service_s": {
"penalty": 0,
"value": 1000000000
},
"routing_mode": "driving",
"search_radius_m": 0,
"soft_search_radius_m": 0
}
],
"cost": {
"fixed": 3000,
"hour": 100,
"km": 8,
"location": 0,
"run": 0,
"tonne_km": 0,
"waiting_hour": 0
},
"crossdock_mode": "deny",
"depot_extra_service_duration_s": 0,
"depot_id": [
0,
"string"
],
"depots_only_at_run_beginning": false,
"ending_depot_id": [
0,
"string"
],
"excluded_tags": [
"string"
],
"finish_at": 0,
"finish_route_in_starting_depot": false,
"finish_run_in_starting_depot": false,
"first_edges_penalty_factor": 0,
"fixed_planned_route": false,
"fixed_work_breaks": [
{
"shift_id": "string",
"work_duration_s": 0
}
],
"forbidden_zones": [
"string"
],
"global_proximity_attraction_point": 0,
"id": 0,
"imei": 0,
"immutable": false,
"incompatible_load_types": [
[
"string"
]
],
"incompatible_zones": [
[
"string"
]
],
"last_edges_penalty_factor": 0,
"max_middle_depots": 0,
"max_runs": 1,
"middle_depot_id": [
0,
"string"
],
"min_stop_weight": 0,
"onboard_incompatible_load_types": false,
"optional_zones": [
{
"value": 0,
"zone": "string"
}
],
"payout": "string",
"phone": "string",
"preset_id": "string",
"ref": "string",
"rest_schedule_id": "string",
"return_to_depot": true,
"routing_mode": "driving",
"service_duration_multiplier": 1,
"shared_service_duration_multiplier": 1,
"shifts": [
{
"balanced_group_id": "string",
"hard_max_duration_s": 2592000,
"hard_time_window": "string",
"hard_window": false,
"id": "string",
"immutable": false,
"max_duration_s": 172800,
"max_mileage_km": 0,
"max_runs": 1,
"maximal_stops": 0,
"minimal_stops": 0,
"minimal_unique_stops": 0,
"preset_id": "string",
"service_duration_s": 0,
"time_window": "string",
"penalty": {
"unique_stop_lack": {
"fixed": 0,
"per_stop": 0
},
"stop_lack": {
"fixed": 0,
"per_stop": 0
},
"stop_excess": {
"fixed": 0,
"per_stop": 0
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"max_mileage": {
"fixed": 1000,
"km": 100
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
}
],
"start_at": 0,
"starting_depot_id": [
0,
"string"
],
"tags": [
"string"
],
"travel_time_multiplier": 1,
"visit_depot_at_start": true,
"visited_locations": [
{
"delivered_orders": [
0,
"string"
],
"id": 0,
"order_ratio": 0,
"shift_id": "string",
"time": "string",
"wait_if_early": true
}
],
"walking_courier": {
"restrictions": {
"max_parking_duration_s": {
"penalty": 0,
"value": 1000000000
},
"max_parking_walking_distance_m": {
"penalty": 0,
"value": 1000000000
},
"max_walking_edge_distance_m": {
"penalty": 0,
"value": 1000000000
}
},
"cost": {
"hour": 0,
"km": 0
},
"capacity": {
"units": 1000000000
}
},
"trailer": {
"coupling_time_s": 0,
"decoupling_time_s": 0,
"rolling_cost": 0,
"rolling_time": {
"fixed_time_s": 0,
"s_per_kg": 0,
"s_per_m3": 0,
"s_per_unit": 0
},
"max_capacity_difference": {
"units": 0,
"volume_cbm": 0,
"weight_kg": 0,
"custom": 0
},
"cost": {
"fixed": 3000,
"hour": 100,
"km": 8,
"location": 0,
"run": 0,
"tonne_km": 0,
"waiting_hour": 0
},
"capacity": {
"units": 1000000000,
"volume_cbm": 0,
"weight_kg": 1000000000,
"volume": {
"depth_m": 1000,
"height_m": 1000,
"width_m": 1000
},
"limits": {
"units_perc": 100,
"volume_perc": 100,
"weight_perc": 100
},
"custom": 0
}
},
"specs": {
"height": 0,
"length": 0,
"max_weight": 0,
"max_weight_kg": 0,
"width": 0
},
"rest_schedule": {
"breaks": [
{
"after_last_location": false,
"at_rest_place": false,
"before_first_location": false,
"continuous_travel_time_range": "string",
"driving_time_range": "string",
"exact_time_range": "string",
"merge_with_types": [
"string"
],
"necessary_route_duration_s": 0,
"repeatable": false,
"rest_duration_s": 0,
"route_duration_s": 0,
"travel_time_range": "string",
"type": "string",
"work_time_range_from_start": "string",
"work_time_range_till_rest": "string",
"penalty": {
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
}
]
},
"planned_route": {
"locations": [
{
"anchor_mode": "Decoupling",
"delivered_orders": [
0,
"string"
],
"delivery_in_current_run": false,
"id": 0,
"is_middle_depot": false,
"loaded_orders": [
0,
"string"
],
"order_ratio": 0,
"parking_mode": "ParkingBegin",
"picked_orders": [
0,
"string"
],
"shift_id": "string",
"wait_if_early": true
}
],
"planned_runs_first": false,
"start_time": "string",
"work_breaks": [
{
"shift_id": "string",
"work_duration_s": 0
}
]
},
"penalty": {
"min_stop_weight": {
"fixed": 1000,
"kg": 50
},
"empty_runs": {
"fixed": 0,
"per_run": 0
},
"arrival_after_start": {
"as_soon_as_possible": false,
"average_h": 0
}
},
"capacity": {
"units": 1000000000,
"volume_cbm": 0,
"weight_kg": 1000000000,
"volume": {
"depth_m": 1000,
"height_m": 1000,
"width_m": 1000
},
"limits": {
"units_perc": 100,
"volume_perc": 100,
"weight_perc": 100
},
"custom": 0
}
}
],
"zones": [
{
"id": "string",
"geometry": {
"coordinates": [
[
[
0
]
]
],
"type": "string"
}
}
]
}
Name |
Description |
locations* |
Type: mvrp_request_1_locations_item[] Список пунктов назначения. Min items: |
options* |
Type: solver_options_mvrp_2 Параметры Сервиса планирования маршрутов. Запрещается указывать параметры, отсутствующие в списке. |
vehicles* |
Type: vehicle[] Список транспортных средств, доступных для планирования маршрута. Min items: |
depot |
Type: depot_location_1 По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте. |
depots |
Type: mvrp_request_1_depots_item[] Список складов. Поля |
initial_routes |
Type: mvrp_request_1_initial_routes_item[] Описание маршрутов в старом решении, которое требуется загрузить в солвер |
zones |
Type: mvrp_request_1_zones_item[] |
mvrp_request_1_locations_item
Пункт назначения заказа, отправляемого со склада.
Name |
Description |
id* |
Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
point* |
Type: coordinate_2 Координаты пункта назначения в формате WGS84. Подробнее |
address |
Type: string Адрес локации. |
allow_trailers |
Type: boolean При значении |
can_be_merged |
Type: boolean Заказ может являться частью мультизаказа Default: |
can_be_split |
Type: boolean Заказ может быть разделен на части между разными машинами. |
client_id |
Type: integer or string Определяет идентификатор (id) клиента, к которому относится локация. |
client_service_duration_s |
Type: client_service_duration_0 or number Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место. |
comments |
Type: string Комментарии. |
crossdock_mode |
Type: string Определяет, разрешено ли доставлять этот заказ через кросс-док склад.
Default: Enum: |
crossdock_service_duration_s |
Type: crossdock_service_duration_0 or number Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее |
custom_value |
Type: number Дополнительный числовой атрибут локации (Например, вознаграждение курьера за посещение этой локации). Может быть использовано как компонент в расчёте стоимости маршрута. |
delivery_deadline |
Type: string Время, до которого заказ из места погрузки ( |
delivery_to |
Type: integer or string Определяет идентификатор (id) пункта назначения. Подробнее |
delivery_to_any |
Type: (integer or string)[] Список идентификаторов пунктов выдачи ( |
depot_duration_s |
Type: depot_duration_0 or number Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее |
depot_expiring_time |
Type: string Время, не позднее которого заказ необходимо забрать со склада, в формате |
depot_id |
Type: integer or string or array |
depot_ready_time |
Type: string Время, начиная с которого заказ можно будет забрать с любого склада, в формате |
description |
Type: string Описание пункта назначения. |
dropped_ratio |
Type: number Доля заказа, которая не должна быть развезена Max value: |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. Если пункт не может быть посещен в указанное временное окно, он будет исключен из маршрута и добавлен в поле ответа |
ignore_zones_compatibility |
Type: boolean Игнорировать эффекты вызываемые свойствами |
in_lifo_order |
Type: boolean Заказы, у которых это поле имеет значение |
load_types |
Type: string[] Определяет типы грузов в данном пункте назначения.
Недопустимы для локаций с типом |
max_split_parts |
Type: integer Максимальное количество частей, на которые может быть разбит заказ Default: Min value: |
max_total_vehicles |
Type: integer Максимальное число автомобилей, которые может обслужить якорная локация. По умолчанию не ограничено. Подробнее |
may_drop_in_crossdock |
Type: boolean Можно ли оставить пикап в кросс-док складе Default: |
optional_tags |
Type: items_optional_tags_item[] Список тегов, которые не обязаны быть у автомобиля, обслуживающего данный пункт назначения. Эти теги могут уменьшить или увеличить стоимость маршрута, если их удовлетворить. Подробнее |
parking_service_duration_s |
Type: number Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения Max value: |
penalty |
Type: items_penalty Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее |
phone |
Type: string Номер телефона получателя при доставке. |
pickup_from_any |
Type: boolean Delivery-заказы, у которых это поле имеет значение |
pickup_must_reach_depot |
Type: boolean Данное поле определяет считать ли pickup-локацию обслуженной, если она не доставлена на склад. Запрещено указывать для локаций типов отличных от pickup. Запрещено использовать совместно с полями |
preset_id |
Type: string Номер пресета для свойств пункта назначения. |
quant |
Type: number or quant_0 |
ref |
Type: string Сноска с информацией о месте. |
required_tags |
Type: string[] Список тегов, которые должны быть у автомобиля, обслуживающего данный пункт назначения. Подробнее |
rolling_throughput |
Type: items_rolling_throughput Пропускная способность перекатки (поддерживается для якорных точек). |
sequence_order |
Type: integer Все локации в маршруте транспортного средства, у которых указана данная опция, должны быть посещены в порядке неубывания ее значений. Подробнее |
service_duration_s |
Type: service_duration_2_0 or number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее |
service_durations |
Type: service_durations Структура, в которой задаются времена обслуживания для локации. |
shared_service_duration_s |
Type: shared_service_duration_0 or number Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее |
shared_with_company_ids |
Type: integer[] ID компаний, которые могут получить доступ к информации о заказе. |
shipment_size |
Type: items_shipment_size Размер отправления (метрические размеры и/или вес). Подробнее |
soft_depot_expiring_time |
Type: string Время, не позднее которого заказ необходимо забрать со склада, в формате |
soft_depot_ready_time |
Type: string Время, начиная с которого заказ можно будет забрать с любого склада, в формате |
split_parts_must_fill_whole_vehicle |
Type: boolean Части, отделяемые от разделяемого заказа, должны заполнять машину целиком. |
throughput |
Type: items_throughput Пропускная способность заказа (поддерживается для разделяемых заказов). |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: items_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
title |
Type: string Название места. |
transit_time |
Type: items_transit_time Ограничение на время нахождения заказа на борту |
type |
Type: string Определяет тип обслуживания в пункте назначения:
Default: Enum: |
use_in_proximity |
Type: boolean При значении Default: |
solver_options_mvrp_2
Параметры Сервиса планирования маршрутов. Запрещается указывать параметры, отсутствующие в списке.
Name |
Description |
time_zone* |
Type: number or string |
absolute_time |
Type: boolean Использование формата ISO 8601 (YYYY-MM-DDTHH: MM:SS+HH: MM) для отображения параметра |
avoid_tolls |
Type: boolean Не использовать платные дороги, если это возможно (только для режимов |
avoid_zones |
Type: string[] Список зон, через которые не может проходить маршрут. Данные зоны будут объезжаться, даже если кратчайший путь лежит через них. Суммарное число углов в полигонах зон должно быть не более 300. Max items: |
balanced_groups |
Type: solver_options_mvrp_2_balanced_groups_item[] Каждый элемент в этом массиве определяет группу балансировки маршрутов. Каждый маршрут в группе соответствует одной смене транспортного средства. Смены связаны с группами полем |
close_location_groups_radius_m |
Type: number Расстояние между заказами, при котором они объединяются в одну группу близких локаций Max value: |
close_locations_during_post_optimization_only |
Type: boolean Применять штрафы, определенные в поле |
critical_lateness_risk_probability |
Type: number Если вероятность опоздания в пункт назначения больше или равна указанному значению, то пункт назначения учитывается в параметре Default: Min value: Max value: |
date |
Type: string Начальная дата для всех маршрутов (в формате |
enable_vehicle_classes |
Type: boolean При значении Default: |
fix_planned_shifts |
Type: boolean Фиксировать смены локаций из запланированных маршрутов. |
force_merge_multiorders |
Type: boolean Меняет поведение при включенной опции |
global_proximity_factor |
Type: number Степень влияния близости пунктов назначения на маршруты транспортных средств. Рекомендуемый диапазон значений: от Max value: |
ignore_min_stops_for_unused |
Type: boolean Не учитывать опцию |
ignore_zones |
Type: boolean Не учитывать опции, связанные с зонами, в машинах и заказах. Подробнее |
immutable |
Type: boolean Все заезды, заданные в initial_routes, используются без изменений, новые машины и заезды не добавляются. |
incompatible_load_types |
Type: string[][] Каждый элемент в этом массиве определяет список типов грузов, которые не должны попадать в один рейс транспортного средства. Подробнее |
incompatible_zones |
Type: string[][] Каждый элемент в этом массиве определяет список зон, которые не должны посещаться в одном рейсе транспортного средства. Подробнее |
load_when_ready |
Type: boolean Начинать погрузку заказов на склад по мере готовности (в порядке |
location_groups |
Type: solver_options_mvrp_2_location_groups_item[] Каждый элемент этого массива определяет группу точек доставки, которая должна быть назначена в одну смену. Некоторые локации из группы могут быть отброшены. Пункт назначения может входить только в одну группу. Подробнее |
matrix_router |
Type: string Матричный роутер, использующийся для планирования маршрута
Default: Enum: |
max_distance_to_projection_m |
Type: number Ограничение на максимальное расстояние до точки проекции. Будет проигнорировано, если у заказа нет подходящих проекций Default: Max value: |
max_drop_penalty_percentage |
Type: number Максимальная доля штрафов за недоставку заказов от суммы шрафов по всем заказам. Подробнее Default: Max value: |
max_split_orders_percentage |
Type: number Максимальная доля заказов, которые могут быть разбиты на части Default: Max value: |
merge_multiorders |
Type: boolean По возможности объединять заказы, имеющие одинаковые координаты и обслуживать их одним транспортным средством. Подробнее |
merge_multiorders_of_different_clients |
Type: boolean Если эта опция сброшена, то заказы с разным client_id но общей координатой будут образоывать отдельные остановки. Подробнее Default: |
minimize_lateness_risk |
Type: boolean Минимизировать вероятности опозданий, т.е. избегать таких маршрутов, где предполагаемое время прибытия близко к концу временного окна. Подробнее |
multiorder_radius_m |
Type: number Расстояние между заказами, при котором они склеиваются в один мультизаказ Default: Max value: |
penalize_late_service |
Type: boolean Эта опция определяет, нужно ли штрафовать за позднее прибытие на объект или позднее окончание обслуживания.
При значении |
penalty |
Type: solver_options_mvrp_2_penalty Штрафы за несоблюдение ограничений на все решение. |
points_throughputs |
Type: solver_options_mvrp_2_points_throughputs_item[] Каждый элемент этого массива определяет пропускную способность точки. |
post_optimization |
Type: boolean Использовать дооптимизацию: перезапустить алгоритм на последних 10% итераций без учета global proximity и балансировок. Подробнее |
preset_id |
Type: string Номер пресета для опций задачи. |
proximity_factor |
Type: number Степень влияния близости пунктов назначения на маршруты транспортных средств. Рекомендуемый диапазон значений: от Max value: |
quality |
Type: string Качество решения:
Default: Enum: |
restart_on_drop |
Type: boolean Перезапуск задачи для выполнения оптимизации только среди не отброшенных заказов в случае, если решения без отбрасывания заказов найти не удалось. Данный параметр следует активировать в том случае, если отказ от заказов допустим и приемлем для вашего бизнес-сценария. |
routing_mode |
Type: string Способ передвижения. Подробнее
Default: Enum: |
template_rest_schedules |
Type: solver_options_mvrp_2_template_rest_schedules_item[] Список шаблонов расписания перерывов. Подробнее |
wait_in_multiorders |
Type: boolean Разрешает ожидание в мультизаказах. Подробнее Default: |
weighted_drop_penalty |
Type: boolean Вычисление штрафа за отказ от доставки заказа в зависимости от веса и объема груза. Это бывает полезно для оптимизации при высокой загрузке транспортных средств. Прописанные штрафы за отказ от точек доставки в таком случае игнорируются. Подробнее |
vehicle
Спецификация транспортного средства.
Name |
Description |
id* |
Type: integer or string Идентификатор транспортного средства. Все идентификаторы транспортных средств в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
allow_different_depots_in_route |
Type: boolean Транспортное средство может посещать несколько складов с различными идентификаторами в пределах одного маршрута |
allowed_zones |
Type: string[] Список зон, которые может посещать траспортное средство. Подробнее |
can_change_depot_between_runs |
Type: boolean Транспортное средство может начинать заезд не на том складе, на котором завершился предыдущий заезд |
capacity |
Type: vehicle_capacity Вместимость транспортного средства. Подробнее |
close_locations |
Type: vehicle_close_locations_item[] |
cost |
|
crossdock_mode |
Type: string Определяет, разрешено ли этой машине доставлять заказы до кросс-док склада. Подробнее
Default: Enum: |
depot_extra_service_duration_s |
Type: number Дополнительное время, необходимое для загрузки данного а/м на складе. Max value: |
depot_id |
Type: integer or string or array |
depots_only_at_run_beginning |
Type: boolean Промежуточные склады допустимы только до обслуживания первого заказа. |
ending_depot_id |
Type: integer or string or array |
excluded_tags |
Type: string[] Список тегов транспортного средства, несовместимых с тегами пункта назначения (используются регулярные выражения расширенного POSIX стандарта). Подробнее |
finish_at |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
finish_route_in_starting_depot |
Type: boolean Обязательно завершать маршрут на том же складе, на котором его начали. |
finish_run_in_starting_depot |
Type: boolean Обязательно завершать заезды на том же складе, на котором его начали. |
first_edges_penalty_factor |
Type: number Коэффициент, дающий штраф/бонус за первое ребро каждого заезда.При положительных значениях солвер старается начать обслуживание заказов с ближайших к складу, при отрицательных значениях - с наиболее отдалённых от склада |
fixed_planned_route |
Type: boolean Если установлено в |
fixed_work_breaks |
Type: vehicle_fixed_work_breaks_item[] Данный список устанавливает продолжительность работы перед каждым перерывом на отдых для нескольких первых перерывов в каждой смене (или во всём маршруте, если смены отсутствуют). Если для транспортного средства предусмотрен список смен (см. параметр |
forbidden_zones |
Type: string[] Список зон, которые не может посещать траспортное средство. Подробнее |
global_proximity_attraction_point |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
imei |
Type: integer Номер GPS-трекера. |
immutable |
Type: boolean Заезды данной машины, заданные в initial_routes, используются без изменений, новые заезды не добавляются. |
incompatible_load_types |
Type: string[][] Каждый элемент в этом массиве определяет список типов грузов, которые не должны попадать в один рейс транспортного средства (перезаписывает значение |
incompatible_zones |
Type: string[][] Каждый элемент в этом массиве определяет список зон, которые не должны посещаться в одном рейсе транспортного средства. (перезаписывает значение |
last_edges_penalty_factor |
Type: number Коэффициент, дающий штраф/бонус за последнее ребро каждого заезда.При положительных значениях солвер старается закончить обслуживание заказов ближе к складу, при отрицательных значениях дальше от склада |
max_middle_depots |
Type: integer Максимальное количество промежуточных (не заканчивающих заезд) складов в маршруте |
max_runs |
Type: integer Максимальное количество рейсов транспортного средства во всех сменах за день. Подробнее Default: |
middle_depot_id |
Type: integer or string or array |
min_stop_weight |
Type: number Минимальный суммарный вес всех заказов в одной точке. Подробнее |
onboard_incompatible_load_types |
Type: boolean Рассчитывать несовместимость по типам грузов только относительно находящихся на борту заказов. |
optional_zones |
Type: vehicle_optional_zones_item[] Список необязательных зон с бонусом |
payout |
Type: string or payout_0 |
penalty |
Type: vehicle_penalty Штрафы за несоблюдение ограничений на транспортное средство. |
phone |
Type: string Номер телефона курьера. |
planned_route |
Type: vehicle_planned_route Заранее запланированные пункты назначения для данного транспортного средства. Эти пункты назначения не будут отброшены даже при нарушении строгих ограничений и будут обслужены в любом случае. Указанный в этом параметре порядок пунктов назначения, может быть изменен для оптимизации окончательного маршрута. По умолчанию смены, назначенные запланированным локациям тоже могут измениться. Они могут быть зафиксированны с помощью опции солвера |
preset_id |
Type: string Номер пресета для свойств транспортного средства. |
ref |
Type: string Референсный номер автомобиля. |
rest_schedule |
Type: vehicle_rest_schedule Расписание перерывов на отдых. Подробнее |
rest_schedule_id |
Type: string Идентификатор шаблона расписания перерывов, использующегося этим автомобилем. |
return_to_depot |
Type: boolean Если установлено в Default: |
routing_mode |
Type: string Способ передвижения. Если присутствует, переопределяет
Enum: |
service_duration_multiplier |
Type: number Коэффициент корректировки времени обслуживания для медленных или быстрых рабочих. Подробнее Default: Min value: |
shared_service_duration_multiplier |
Type: number Коэффициент корректировки общего времени обслуживания для медленных или быстрых рабочих. Подробнее Default: Min value: |
shifts |
Type: vehicle_shifts_item[] Список транспортных смен. Подробнее |
specs |
Type: vehicle_specs Характеристики транспортного средства. Подробнее |
start_at |
Type: integer or string Определяет |
starting_depot_id |
Type: integer or string or array |
tags |
Type: string[] Список тегов транспортного средства, совместимых с тегами пункта назначения (используются регулярные выражения расширенного POSIX стандарта). Подробнее |
trailer |
Type: vehicle_trailer Спецификация прицепа. Использование прицепа с пешим курьером (walking_courier) невозможно.Подробнее |
travel_time_multiplier |
Type: number Коэффициент корректировки времени поездки, используется для быстрых или медленных транспортных средств. Подробнее Default: Min value: |
visit_depot_at_start |
Type: boolean Если установлено в
Default: |
visited_locations |
Type: vehicle_visited_locations_item[] Список пунктов назначения, которые должны быть посещены транспортным средством в строго определенном порядке. Это фиксированная часть маршрута без учета оптимизации, при этом дополнительно может указываться время отправления из некоторых пунктов назначения. Если необходимо также указать точное расписание перерывов на отдых во время посещения этих пунктов назначения, используйте параметр транспортного средства |
walking_courier |
Type: vehicle_walking_courier Описание курьера-пешехода. Использование пешего курьера в а/м с прицепом невозможно. |
depot_location_1
По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.
Name |
Description |
point* |
Type: coordinate_2 Координаты пункта назначения в формате WGS84. Подробнее |
address |
Type: string Адрес локации. |
crossdock_safety_waiting_duration_s |
Type: number Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы. Default: Max value: |
description |
Type: string Описание пункта назначения. |
finish_service_duration_s |
Type: number Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее Max value: |
flexible_start_time |
Type: boolean По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее |
id |
Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
load_service_duration_s |
Type: number Дополнительное время на загрузку в машину delivery заказов, добавляемое только если на данном складе загружается хотя бы один delivery заказ. |
package_throughput |
Type: depot_location_1_package_throughput Ограничение на скорость упаковки заказов на складе. |
penalty |
Type: depot_location_1_penalty Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее |
preliminary_service_duration_s |
Type: number Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления Max value: |
preset_id |
Type: string Номер пресета для свойств склада. |
ref |
Type: string Сноска с информацией о месте. |
service_duration_s |
Type: service_duration_2_0 or number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее |
throughput |
Type: depot_location_1_throughput Пропускная способность склада. Подробнее |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: depot_location_1_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
time_windows_loading |
Type: depot_location_1_time_windows_loading Временные окна, в которые машина может выехать со склада на первый заезд |
time_windows_refilling |
Type: depot_location_1_time_windows_refilling Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки |
time_windows_unloading |
Type: depot_location_1_time_windows_unloading Временные окна, в которые машина может вернуться на склад после последнего заезда |
title |
Type: string Название места. |
type |
Type: string Определяет тип склада:
Default: Enum: |
unload_service_duration_s |
Type: number Дополнительное время на выгрузку из машины pickup заказов, добавляемое только если на данный склад доставляется хотя бы один pickup заказ. |
use_in_proximity |
Type: boolean При значении |
mvrp_request_1_depots_item
По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.
Name |
Description |
point* |
Type: coordinate_2 Координаты пункта назначения в формате WGS84. Подробнее |
address |
Type: string Адрес локации. |
crossdock_safety_waiting_duration_s |
Type: number Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы. Default: Max value: |
description |
Type: string Описание пункта назначения. |
finish_service_duration_s |
Type: number Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее Max value: |
flexible_start_time |
Type: boolean По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее |
id |
Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
load_service_duration_s |
Type: number Дополнительное время на загрузку в машину delivery заказов, добавляемое только если на данном складе загружается хотя бы один delivery заказ. |
package_throughput |
Type: items_package_throughput Ограничение на скорость упаковки заказов на складе. |
penalty |
Type: items_penalty_1 Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее |
preliminary_service_duration_s |
Type: number Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления Max value: |
preset_id |
Type: string Номер пресета для свойств склада. |
ref |
Type: string Сноска с информацией о месте. |
service_duration_s |
Type: service_duration_2_0 or number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее |
throughput |
Type: items_throughput_1 Пропускная способность склада. Подробнее |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: items_time_windows_item_1[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
time_windows_loading |
Type: items_time_windows_loading Временные окна, в которые машина может выехать со склада на первый заезд |
time_windows_refilling |
Type: items_time_windows_refilling Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки |
time_windows_unloading |
Type: items_time_windows_unloading Временные окна, в которые машина может вернуться на склад после последнего заезда |
title |
Type: string Название места. |
type |
Type: string Определяет тип склада:
Default: Enum: |
unload_service_duration_s |
Type: number Дополнительное время на выгрузку из машины pickup заказов, добавляемое только если на данный склад доставляется хотя бы один pickup заказ. |
use_in_proximity |
Type: boolean При значении |
mvrp_request_1_initial_routes_item
Name |
Description |
route* |
Type: initial_routes_route_element_1[] Последовательность узлов, составляющих маршрут. |
vehicle_id* |
Type: integer or string Идентификатор транспортного средства. Все идентификаторы транспортных средств в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
fixed_order |
Type: boolean Локации, заданные в initial_routes, не могут быть переупорядочены |
immutable |
Type: boolean Заезд, заданный в initial_routes, используется без изменений. |
shift |
Type: items_shift |
mvrp_request_1_zones_item
Name |
Description |
geometry* |
Type: items_geometry |
id* |
Type: string Номер зоны |
coordinate_2
Координаты пункта назначения в формате WGS84. Подробнее
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
client_service_duration_0
Name |
Description |
fixed |
Type: number Фиксированное время обслуживания для любой части заказа. Max value: |
scaled |
Type: number Время обслуживания части заказа, умножаемое на ее долю от основного заказа. Max value: |
crossdock_service_duration_0
Name |
Description |
fixed |
Type: number Фиксированное время обслуживания для любой части заказа. Max value: |
scaled |
Type: number Время обслуживания части заказа, умножаемое на ее долю от основного заказа. Max value: |
depot_duration_0
Name |
Description |
fixed |
Type: number Фиксированное время обслуживания для любой части заказа. Max value: |
scaled |
Type: number Время обслуживания части заказа, умножаемое на ее долю от основного заказа. Max value: |
items_optional_tags_item
Необязательный тег с бонусом или штрафом.
Name |
Description |
tag* |
Type: string Произвольный тег. |
value* |
Type: number Значение тега. Если заказ доставлен автомобилем с соответствующим тегом в поле |
items_penalty
Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее
Name |
Description |
delivery_deadline |
Type: penalty_delivery_deadline Составляющие штрафа за позднюю доставку заказа типа |
depot_expiring_time |
Type: penalty_depot_expiring_time Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо. |
depot_ready_time |
Type: penalty_depot_ready_time Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо. |
drop |
Type: drop_0 or number Штраф за невыполнение заказа. Подробнее |
early |
Type: penalty_early_4 Составляющие штрафа за раннее обслуживание (используются вместо штрафа |
late |
Type: penalty_late_4 Составляющие штрафа за позднее посещение (используются вместо штрафа |
out_of_time |
Type: penalty_out_of_time_4 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов |
rolling_throughput |
Type: penalty_rolling_throughput Составляющие штрафа за превышение пропускной способности. |
throughput |
Type: penalty_throughput_1 Составляющие штрафа за превышение пропускной способности. |
time_between_visits |
Type: penalty_time_between_visits Составляющие штрафа за превышение допустимого времени между посещениями частей заказа. |
transit_time |
Type: any Составляющие штрафа за превышение времени нахождения заказа на борту |
quant_0
Размер минимальной части, которая может быть отделена от заказа, в одной из единиц измерения
Name |
Description |
units |
Type: number Размер минимальной части в пользовательских единицах измерения. |
volume_cbm |
Type: number Объем минимальной части, кубические метры. |
weight_kg |
Type: number Вес минимальной части, кг. |
items_rolling_throughput
Пропускная способность перекатки (поддерживается для якорных точек).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
service_duration_2_0
Name |
Description |
fixed |
Type: number Фиксированное время обслуживания для любой части заказа. Max value: |
scaled |
Type: number Время обслуживания части заказа, умножаемое на ее долю от основного заказа. Max value: |
service_durations
Структура, в которой задаются времена обслуживания для локации.
Name |
Description |
client |
Type: client_service_duration_0 or number Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место. |
crossdock |
Type: crossdock_service_duration_0 or number Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее |
depot |
Type: depot_duration_0 or number Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее |
location |
Type: service_duration_2_0 or number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее |
parking |
Type: number Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения Max value: |
stop |
Type: shared_service_duration_0 or number Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее |
shared_service_duration_0
Name |
Description |
fixed |
Type: number Фиксированное время обслуживания для любой части заказа. Max value: |
scaled |
Type: number Время обслуживания части заказа, умножаемое на ее долю от основного заказа. Max value: |
items_shipment_size
Размер отправления (метрические размеры и/или вес). Подробнее
Name |
Description |
custom |
Type: number Размер отправления в пользовательских единицах измерения. Размеры в пользовательских единицах задаются в формате |
units |
Type: number Размер отправления в пользовательских единицах измерения. Max value: |
volume |
Type: shipment_size_volume Метрические размеры отправления. |
volume_cbm |
Type: number Явно заданный объем, кубические метры. По умолчанию берется значение из "volume", если тут ничего не указать. |
weight_kg |
Type: number Вес отправления, кг. Max value: |
items_throughput
Пропускная способность заказа (поддерживается для разделяемых заказов).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
items_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
items_transit_time
Ограничение на время нахождения заказа на борту
Name |
Description |
hard_limit_s |
Type: number Жёсткое ограничение, не может быть превышено Max value: |
limit_s |
Type: number Мягкое ограничение, превышение допустимо, но ведёт к штрафам Max value: |
solver_options_mvrp_2_balanced_groups_item
Группа сбалансированных маршрутов. В случае, если поле penalty
не задано, то для обратной совместимости используется штраф {stop
: 100, hour
: 200}.
Name |
Description |
id* |
Type: string Уникальный идентификатор группы балансировки маршрутов. |
penalty |
Type: items_penalty_9 Штрафы за несбалансированность маршрутов. |
solver_options_mvrp_2_location_groups_item
Группа точек доставки, которая должна быть назначена в одну смену.
Name |
Description |
location_ids* |
Type: (integer or string)[] Ссылка на пункт назначения, указанный в параметре |
dependent |
Type: boolean При значении |
solid |
Type: boolean При значении true все назначенные локации в группе будут обслужены подряд, но их порядок не зафиксирован. |
title |
Type: string |
solver_options_mvrp_2_penalty
Штрафы за несоблюдение ограничений на все решение.
Name |
Description |
close_location_groups |
Type: penalty_close_location_groups_1 Составляющие штрафа за лишние посешения точек внутри одной группы близких локаций. |
drop_penalty_percentage |
Type: penalty_drop_penalty_percentage_1 Составляющие штрафа за нарушение |
multiorders |
Type: penalty_multiorders_1 Составляющие штрафа за лишние посешения точек мультизаказов. |
split_orders_percentage |
Type: penalty_split_orders_percentage_1 Составляющие штрафа за нарушение |
solver_options_mvrp_2_points_throughputs_item
Пропускная способность точки
Name |
Description |
penalty |
Type: items_penalty_8 |
point |
Type: items_point_1 Координаты пункта назначения в формате WGS84. Подробнее |
throughput |
Type: items_throughput_3 Пропускная способность точки. |
solver_options_mvrp_2_template_rest_schedules_item
Шаблон расписания перерывов на отдых.
Name |
Description |
breaks* |
Type: array |
id* |
Type: string Уникальный идентификатор шаблона. |
vehicle_capacity
Вместимость транспортного средства. Подробнее
Name |
Description |
custom |
Type: number Количество пользовательских единиц измерения, которое может перевозить транспортное средство. Вместимости в пользовательских единицах задаются в формате |
limits |
Type: capacity_limits_1 Пределы загрузки транспортного средства. |
units |
Type: number Количество пользовательских единиц измерения, которое может перевозить транспортное средство. Default: |
volume |
Type: capacity_volume_1 Метрические размеры автомобиля. |
volume_cbm |
Type: number Вместимость транспортного средства в кубических метрах. |
weight_kg |
Type: number Грузоподъемность транспортного средства в килограммах. Default: |
vehicle_close_locations_item
Name |
Description |
distance_till_service_m |
Type: any |
duration_till_service_s |
Type: any |
routing_mode |
Type: string Способ передвижения для определения близости локаций. Данный параметр допустимо использовать только если в а/м определено свойство walking_courer. В этом случае допустимы значения Enum: |
search_radius_m |
Type: number Максимальное расстояние между двумя локациями на которые накладывается данное ограничение. Max value: |
soft_search_radius_m |
Type: number При использовании значении данного параметра больше соответствующего значения параметра Max value: |
cost_0
Стоимость использования транспортного средства. Подробнее
Name |
Description |
fixed |
Type: number Стоимость за факт использования транспортного средства (стоимость считается затраченной, если транспортное средство поставлено на маршрут). Default: |
hour |
Type: number Стоимость за час использования транспортного средства. Данная стоимость не должна быть нулевой или слишком низкой — в противном случае могут быть проложены маршруты, не оптимальные по времени. Default: |
km |
Type: number Стоимость за километр использования транспортного средства. Данная стоимость не должна быть нулевой или слишком низкой — в противном случае могут быть проложены маршруты, не оптимальные по расстоянию. Default: |
location |
Type: number Стоимость использования транспортного средства в расчете на один пункт назначения (по умолчанию — 0). |
run |
Type: number Стоимость за один рейс со склада до пункта назначения. |
tonne_km |
Type: number Стоимость перевозки одной тонны на один километр (по умолчанию — 0). |
waiting_hour |
Type: number Стоимость часа ожидания с использованием транспортного средства. Если не указана, то используется значение, заданное в поле |
cost_1
Описание стоимости использования а/м с возможностью задания арифметических выражений для отдельных частей маршрута. В случае, если заданы выражения для нескольких частей, то итоговая стоимость будет получена как сумма по всем заданным выражениям для всех входящих в маршрут частей.
Name |
Description |
route |
Type: string Арифметическое выражение, задающее стоимость маршрута. |
run |
Type: string Арифметическое выражение, задающее стоимость заезда. |
shift |
Type: string Арифметическое выажение, задающее стоимость смены. |
vehicle_fixed_work_breaks_item
Name |
Description |
work_duration_s* |
Type: number Продолжительность непрерывной работы до следующего перерыва на отдых, в секундах. Max value: |
shift_id |
Type: string Уникальный идентификатор смены. |
vehicle_optional_zones_item
Необязательные зоны с бонусом.
Name |
Description |
value* |
Type: number Значение зоны. За доставку заказа с соответствующей зоной это значение будет вычтено из стоимости маршрута. При наличии у заказа нескольких подходящих зон будет использован максимальный бонус. |
zone* |
Type: string Номер зоны. |
payout_0
Описание выплаты курьера за выполнение маршрута с возможностью задания арифметических выражений для отдельных частей маршрута. В случае, если заданы выражения для нескольких частей, то итоговая выплата будет получена как сумма по всем заданым выражениям для всех входящих в маршрут частей.
Name |
Description |
route |
Type: string Арифметическое выражение, задающее стоимость маршрута. |
run |
Type: string Арифметическое выражение, задающее стоимость заезда. |
shift |
Type: string Арифметическое выажение, задающее стоимость смены. |
vehicle_penalty
Штрафы за несоблюдение ограничений на транспортное средство.
Name |
Description |
arrival_after_start |
Type: penalty_arrival_after_start Составляющие штрафа за прибытие позже начала окна |
empty_runs |
Type: penalty_empty_runs Составляющие штрафа за пустые заезды, которые не могут быть пропущены из-за указания реальных времен помещения. |
min_stop_weight |
Type: penalty_min_stop_weight Составляющие штрафа за недостаточный суммарный вес заказов в точке. |
vehicle_planned_route
Заранее запланированные пункты назначения для данного транспортного средства. Эти пункты назначения не будут отброшены даже при нарушении строгих ограничений и будут обслужены в любом случае. Указанный в этом параметре порядок пунктов назначения, может быть изменен для оптимизации окончательного маршрута. По умолчанию смены, назначенные запланированным локациям тоже могут измениться. Они могут быть зафиксированны с помощью опции солвера fix_planned_shifts
. Подробнее
Name |
Description |
locations* |
Type: planned_route_locations_item[] Плановый порядок точек доставки в маршруте транспортного средства, включая все смены и доставку в несколько рейсов. Если для транспортного средства предусмотрен список смен (см. параметр |
planned_runs_first |
Type: boolean Необходимо посетить все указанные в |
start_time |
Type: string or array |
work_breaks |
Type: planned_route_work_breaks_item[] Спланированные перерывы на отдых в маршруте транспортного средства, включающем все смены и рейсы. Если для транспортного средства предусмотрен список смен (см. параметр |
vehicle_shifts_item
Транспортная смена.
Name |
Description |
id* |
Type: string Уникальный идентификатор смены. |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
balanced_group_id |
Type: string Идентификатор соответствующей группы балансировки маршрутов (см. опцию |
hard_max_duration_s |
Type: number Жесткое ограничение на максимальную продолжительность смены в секундах. Если заданы оба поля Default: Max value: |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается завершить смену только в пределах указанного временного окна. Подробнее |
immutable |
Type: boolean Заезды в данной смене, заданные в initial_routes, используются без изменений, новые заезды не добавляются. |
max_duration_s |
Type: number Максимальная продолжительность смены в секундах. Если спланированная продолжительность смены больше, чем указано, применяются штрафы за превышение графика смены. Default: Max value: |
max_mileage_km |
Type: number Максимальный пробег машины за смену в километрах. Если спланированный пробег больше, чем данное значение, то применяются штрафы из параметра смены |
max_runs |
Type: integer Максимальное количество рейсов транспортного средства в смене. Default: |
maximal_stops |
Type: integer Максимальное количество остановок в смене. Если итоговое количество остановок больше этого значения, применяется штраф |
minimal_stops |
Type: integer Минимальное количество остановок в смене. Если итоговое количество остановок меньше этого значения, применяется штраф |
minimal_unique_stops |
Type: integer Минимальное количество остановок с различными координатами в смене. Если итоговое количество остановок меньше этого значения, применяется штраф |
penalty |
Type: items_penalty_10 Штрафы за нарушение регламента смены. |
preset_id |
Type: string Номер пресета для транспортной смены. |
service_duration_s |
Type: number Длительность обслуживания при передаче смен (в секундах). Может включать в себя любые операции, необходимые для завершения смены, например, пересменка водителей, обмен бумагами и т. д. (по умолчанию: 0). Max value: |
vehicle_specs
Характеристики транспортного средства. Подробнее
Name |
Description |
height |
Type: number Высота транспортного средства в метрах. |
length |
Type: number Длина транспортного средства в метрах. |
max_weight |
Type: number Максимальный вес транспортного средства в тоннах. |
max_weight_kg |
Type: number Максимальный вес транспортного средства в килограммах. При решении задачи характеристика будет округляться вверх до тонн. Если заданы обе характеристики |
width |
Type: number Ширина транспортного средства в метрах. |
vehicle_trailer
Спецификация прицепа. Использование прицепа с пешим курьером (walking_courier) невозможно.Подробнее
Name |
Description |
capacity |
Type: trailer_capacity Вместимость прицепа. |
cost |
Type: trailer_cost Стоимость использования прицепа. |
coupling_time_s |
Type: number Дополнительное время на присоединение прицепа, в секундах. Max value: |
decoupling_time_s |
Type: number Дополнительное время на отсоединение прицепа, в секундах. Max value: |
max_capacity_difference |
Type: trailer_max_capacity_difference Максимальная разница загрузки прицепа и тягоча. |
rolling_cost |
Type: number Штраф за каждую перекатку грузов из прицепа в тягач. |
rolling_time |
Type: trailer_rolling_time Время на перекладку грузов из прицепа в голову. Если указано несколько типов времени, используется тот, который затрачивает больше всего времени. Если ни один тип не указан, используется только фиксированое время перекладки. |
vehicle_visited_locations_item
Name |
Description |
id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
delivered_orders |
Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. |
order_ratio |
Type: number Доля заказа, входящая в данную часть. |
shift_id |
Type: string Уникальный идентификатор смены. |
time |
Type: string Время отправления из пункта назначения, в формате |
wait_if_early |
Type: boolean Этот параметр определяет, что происходит, если автомобиль приезжает в пункт назначения слишком рано. При значении Default: |
vehicle_walking_courier
Описание курьера-пешехода. Использование пешего курьера в а/м с прицепом невозможно.
Name |
Description |
capacity |
Type: walking_courier_capacity Грузоподъемность курьера. |
cost |
Type: walking_courier_cost Стоимость работы курьера-пешехода. |
restrictions |
Type: any |
depot_location_1_package_throughput
Ограничение на скорость упаковки заказов на складе.
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
depot_location_1_penalty
Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее
Name |
Description |
early |
Type: penalty_early_3 Составляющие штрафа за раннее обслуживание (используются вместо штрафа |
late |
Type: penalty_late_3 Составляющие штрафа за позднее посещение (используются вместо штрафа |
out_of_time |
Type: penalty_out_of_time_3 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов |
package_throughput |
Type: penalty_package_throughput Составляющие штрафа за превышение пропускной способности упаковки заказов. |
throughput |
Type: penalty_throughput Составляющие штрафа за превышение пропускной способности. |
depot_location_1_throughput
Пропускная способность склада. Подробнее
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
depot_location_1_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
depot_location_1_time_windows_loading
Временные окна, в которые машина может выехать со склада на первый заезд
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_loading_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
depot_location_1_time_windows_refilling
Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_refilling_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
depot_location_1_time_windows_unloading
Временные окна, в которые машина может вернуться на склад после последнего заезда
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_unloading_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
items_package_throughput
Ограничение на скорость упаковки заказов на складе.
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
items_penalty_1
Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее
Name |
Description |
early |
Type: penalty_early_8 Составляющие штрафа за раннее обслуживание (используются вместо штрафа |
late |
Type: penalty_late_8 Составляющие штрафа за позднее посещение (используются вместо штрафа |
out_of_time |
Type: penalty_out_of_time_8 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов |
package_throughput |
Type: penalty_package_throughput_1 Составляющие штрафа за превышение пропускной способности упаковки заказов. |
throughput |
Type: penalty_throughput_2 Составляющие штрафа за превышение пропускной способности. |
items_throughput_1
Пропускная способность склада. Подробнее
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
items_time_windows_item_1
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
items_time_windows_loading
Временные окна, в которые машина может выехать со склада на первый заезд
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_loading_time_windows_item_1[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
items_time_windows_refilling
Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_refilling_time_windows_item_1[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
items_time_windows_unloading
Временные окна, в которые машина может вернуться на склад после последнего заезда
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_unloading_time_windows_item_1[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
initial_routes_route_element_1
Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.
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 Элемент маршрута. |
actual_arrival_time_s |
Type: number or string Реальное время прибытия в пункт назначения. |
actual_departure_time_s |
Type: number or string Реальное время отправления из пункта назначения. |
actual_service_start_time_s |
Type: number or string Реальное время начала обслуживания заказа. |
arrival_time_s |
Type: number or string Время прибытия в пункт назначения. Прибытие произошло до начала временного окна, поэтому будет прибавлено ко времени ожидания. |
departure_time_s |
Type: number or string Время отправления из пункта назначения. |
load_to_head |
Type: (integer or string)[] Список заказов, которые должны быть загружены в голову автомобиля на складе или якорной локации, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания. |
load_to_trailer |
Type: (integer or string)[] Список заказов, которые должны быть загружены в прицеп автомобиля на складе, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания. |
multi_order |
Type: boolean Несколько заказов доставляются в один и тот же пункт назначения вместе. Время прибытия для всех заказов в группе совпадает. Кроме того, на уровне каждого заказа может быть указан параметр |
waiting_duration_s |
Type: number Продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала временного окна, секунды. |
items_shift
Name |
Description |
id* |
Type: string Уникальный идентификатор смены. |
balanced_group_id |
Type: string Идентификатор соответствующей группы балансировки маршрутов (см. опцию |
end |
Type: shift_end Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия. |
start |
Type: shift_start Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия. |
items_geometry
Name |
Description |
coordinates |
Type: number[][][] Всегда содержит два элемента: долгота и широта |
type |
Type: string Всегда равен |
penalty_delivery_deadline
Составляющие штрафа за позднюю доставку заказа типа pickup
на склад. Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания. Подробнее
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае посещения склада после дедлайна. Default: |
minute |
Type: number Штраф за каждую минуту опоздания, когда склад посещается после дедлайна. Default: |
penalty_depot_expiring_time
Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения. Default: |
minute |
Type: number Штраф за каждую минуту нарушения. Default: |
penalty_depot_ready_time
Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения. Default: |
minute |
Type: number Штраф за каждую минуту нарушения. Default: |
drop_0
Name |
Description |
fixed |
Type: number Фиксированный штраф за невыполнение любой части заказа. |
scaled |
Type: number Штраф за недоставленную долю заказа. Default: |
penalty_early_4
Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time
).
Name |
Description |
fixed |
Type: number Фиксированный штраф за обслуживание объекта, начатое раньше выбранного временного окна. Default: |
minute |
Type: number Штраф за каждую минуту раннего прибытия, если обслуживание объекта было начато раньше выбранного временного окна. Default: |
penalty_late_4
Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time
). Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае посещения пункта назначения после окончания заданного временного окна. Default: |
minute |
Type: number Штраф за каждую минуту опоздания, когда место посещается после окончания временного окна. Default: |
penalty_out_of_time_4
Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early
и late
, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае посещения пункта назначения вне заданного временного окна. См. спецификации штрафов Default: |
minute |
Type: number Штраф за каждую минуту опоздания или раннего прибытия при посещении объекта за пределами временного окна.См. спецификации штрафов Default: |
penalty_rolling_throughput
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
penalty_throughput_1
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
penalty_time_between_visits
Составляющие штрафа за превышение допустимого времени между посещениями частей заказа.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый за каждый случай нарушения вне зависимости от размера нарушения. Default: |
minute |
Type: number Штраф за каждую минуту нарушения. Default: |
kg_per_hour_0_item_3
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_3
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_2
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
shipment_size_volume
Метрические размеры отправления.
Name |
Description |
depth_m* |
Type: number Глубина, в метрах. Max value: |
height_m* |
Type: number Высота, в метрах. Max value: |
width_m* |
Type: number Ширина, в метрах. Max value: |
align |
Type: string Выравнивание отправления по осям (не имеет эффекта для типа
Default: Enum: |
type |
Type: string Тип отправления:
Default: Enum: |
kg_per_hour_0_item_2
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_2
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_1
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
items_penalty_9
Штрафы за несбалансированность маршрутов.
Name |
Description |
custom_value |
Type: number Штраф за каждую единицу отклонения |
hour |
Type: number Штраф за каждый час корня из суммы квадратов отклонения длительности маршрута от средней длительности группы балансировки маршрутов. |
ignore_unused_vehicles |
Type: boolean Игнорировать неиспользуемые а/м при расчетах штрафа. |
km |
Type: number Штраф за каждый км корня из суммы квадратов отклонения расстояния маршрута от среднего расстояния группы балансировки маршрутов. |
served_order |
Type: number Штраф за каждую пропущенный или дополнительный заказ, рассчитываемый по корню из суммы квадратов отклонений числа заказов маршрута от среднего числа заказов в группе балансировки маршрутов. |
stop |
Type: number Штраф за каждую пропущенную или дополнительную остановку, рассчитываемую по корню из суммы квадратов отклонений числа остановок маршрута от среднего числа остановок в группе балансировки маршрутов. |
unit |
Type: number Штраф за каждую единицу отклонения массы заказов в единицах груза, рассчитываемый по корню из суммы квадратов отклонений массы заказов в единицах груза маршрута от среднего числа массы заказов в единицах груза в группе балансировки маршрутов. |
weight_kg |
Type: number Штраф за каждую единицу отклонения массы заказов в кг, рассчитываемый по корню из суммы квадратов отклонений массы заказов в кг маршрута от среднего числа массы заказов в кг в группе балансировки маршрутов. |
penalty_close_location_groups_1
Составляющие штрафа за лишние посешения точек внутри одной группы близких локаций.
Name |
Description |
per_extra_point |
Type: number Штраф за каждую точку в которую машины/курьеры приезжают больше одного раза. |
per_extra_vehicle |
Type: number Штраф за каждую лишнюю машину/курьера, которые приезжают в точки близких локаций. |
per_extra_visit |
Type: number Штраф за каждое лишнее посещение точкек близких локаций. |
penalty_drop_penalty_percentage_1
Составляющие штрафа за нарушение max_drop_penalty_percentage
.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае, если суммарный штраф за недоставку слишком велик. Default: |
per_percent |
Type: number Штраф за каждый лишний процент штрафа за недоставку заказов. Default: |
penalty_multiorders_1
Составляющие штрафа за лишние посешения точек мультизаказов.
Name |
Description |
per_extra_point |
Type: number Штраф за каждую точку в которую машины/курьеры приезжают больше одного раза. |
per_extra_vehicle |
Type: number Штраф за каждую лишнюю машину/курьера, которые приезжают в точки мультизаказов. |
per_extra_visit |
Type: number Штраф за каждое лишнее посещение точкек мультизаказов. |
penalty_split_orders_percentage_1
Составляющие штрафа за нарушение max_split_orders_percentage
.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае, если доля разделенных заказов слишком велика. Default: |
per_percent |
Type: number Штраф за каждый лишний процент в доле разделенных заказов. Default: |
items_penalty_8
Name |
Description |
throughput |
Type: penalty_throughput_5 Составляющие штрафа за превышение пропускной способности. |
items_point_1
Координаты пункта назначения в формате WGS84. Подробнее
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
items_throughput_3
Пропускная способность точки.
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
breaks_0_item_1
Перерыв в работе.
Name |
Description |
rest_duration_s* |
Type: number Продолжительность отдыха, в секундах. Min value: Max value: |
after_last_location |
Type: boolean При значении |
at_rest_place |
Type: boolean При значении |
before_first_location |
Type: boolean При значении |
continuous_travel_time_range |
Type: string Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: |
driving_time_range |
Type: string Минимальная и максимальная продолжительность движения до отдыха, формат: |
exact_time_range |
Type: string Точный диапазон времени, когда должен начаться отдых, формат: |
merge_with_types |
Type: string[] Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями |
necessary_route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах. Max value: |
penalty |
Type: items_penalty_7 Штрафы, применяемые за нарушения условий перерывов в работе. |
repeatable |
Type: boolean При значении |
route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах. Max value: |
travel_time_range |
Type: string Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: |
type |
Type: string Тип перерыва. Используется в поле |
work_time_range_from_start |
Type: string Минимальное и максимальное время от начала маршрута до отдыха, формат: |
work_time_range_till_rest |
Type: string Минимальная и максимальная продолжительность работы до отдыха, формат: |
capacity_limits_1
Пределы загрузки транспортного средства.
Name |
Description |
units_perc |
Type: number Максимальный объем отправлений в пользовательских единицах измерения, выраженный в процентах от вместимости транспортного средства. Default: |
volume_perc |
Type: number Максимальный объем отправлений в процентах от объема грузового отсека транспортного средства. Для размещения жёстких контейнеров предполагается, что стороны грузового отсека умножены на кубический корень из Default: |
weight_perc |
Type: number Максимальный объем отправлений в процентах от максимально допустимого общего веса груза, перевозимого транспортным средством. Default: |
capacity_volume_1
Метрические размеры автомобиля.
Name |
Description |
depth_m* |
Type: number Глубина, в метрах. Default: Max value: |
height_m* |
Type: number Высота, в метрах. Default: Max value: |
width_m* |
Type: number Ширина, в метрах. Default: Max value: |
penalty_arrival_after_start
Составляющие штрафа за прибытие позже начала окна
Name |
Description |
as_soon_as_possible |
Type: boolean Опция для прибытия максимально рано, даже если это влечет дополнительное ожидание. При использовании параметра рекомендуется также указывать ненулевое значение параметра |
average_h |
Type: number Штраф за среднее время приезда после начала окна |
penalty_empty_runs
Составляющие штрафа за пустые заезды, которые не могут быть пропущены из-за указания реальных времен помещения.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае, если в маршруте остаются пустые заезды. |
per_run |
Type: number Штраф за каждый пустой заезд в маршруте. |
penalty_min_stop_weight
Составляющие штрафа за недостаточный суммарный вес заказов в точке.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае, если суммарный вес заказов в точке недостаточно велик. Default: |
kg |
Type: number Штраф за каждый недостающий килограмм в суммарном весе заказов. Default: |
planned_route_locations_item
Name |
Description |
id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
anchor_mode |
Type: string Default: Enum: |
delivered_orders |
Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. |
delivery_in_current_run |
Type: boolean Все заказы, загруженные в данной локации, должны быть доставлены в этом же рейсе. |
is_middle_depot |
Type: boolean Локация является промежуточным складом. |
loaded_orders |
Type: (integer or string)[] Идентификаторы заказов типа |
order_ratio |
Type: number Доля заказа, входящая в данную часть. |
parking_mode |
Type: string Default: Enum: |
picked_orders |
Type: (integer or string)[] Список идентификаторов заказов, забираемых в кросс-доке или складе. |
shift_id |
Type: string Уникальный идентификатор смены. |
wait_if_early |
Type: boolean Этот параметр определяет, что происходит, если автомобиль приезжает в пункт назначения слишком рано. При значении Default: |
start_time_0_item
Name |
Description |
shift_id* |
Type: string Уникальный идентификатор смены. |
start_time* |
Type: string Время начала смены в формате |
planned_route_work_breaks_item
Name |
Description |
work_duration_s* |
Type: number Продолжительность непрерывной работы до следующего перерыва на отдых, в секундах. Max value: |
shift_id |
Type: string Уникальный идентификатор смены. |
breaks_0_item_2
Перерыв в работе.
Name |
Description |
rest_duration_s* |
Type: number Продолжительность отдыха, в секундах. Min value: Max value: |
after_last_location |
Type: boolean При значении |
at_rest_place |
Type: boolean При значении |
before_first_location |
Type: boolean При значении |
continuous_travel_time_range |
Type: string Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: |
driving_time_range |
Type: string Минимальная и максимальная продолжительность движения до отдыха, формат: |
exact_time_range |
Type: string Точный диапазон времени, когда должен начаться отдых, формат: |
merge_with_types |
Type: string[] Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями |
necessary_route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах. Max value: |
penalty |
Type: items_penalty_12 Штрафы, применяемые за нарушения условий перерывов в работе. |
repeatable |
Type: boolean При значении |
route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах. Max value: |
travel_time_range |
Type: string Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: |
type |
Type: string Тип перерыва. Используется в поле |
work_time_range_from_start |
Type: string Минимальное и максимальное время от начала маршрута до отдыха, формат: |
work_time_range_till_rest |
Type: string Минимальная и максимальная продолжительность работы до отдыха, формат: |
items_penalty_10
Штрафы за нарушение регламента смены.
Name |
Description |
early |
Type: penalty_early_14 Составляющие штрафа за смены, начатые слишком рано. (используются вместо штрафа |
late |
Type: penalty_late_14 Составляющие штрафа за смены, завершённые слишком поздно (используются вместо штрафа |
max_mileage |
Type: penalty_max_mileage Штрафы, применяемые за нарушение ограничения на пробег транспортного средства за смену (параметр смены |
out_of_time |
Type: penalty_out_of_time_10 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов |
stop_excess |
Type: penalty_stop_excess Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство |
stop_lack |
Type: penalty_stop_lack Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство |
unique_stop_lack |
Type: penalty_unique_stop_lack Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство |
trailer_capacity
Вместимость прицепа.
Name |
Description |
custom |
Type: number Количество пользовательских единиц измерения, которое можно перевозить в прицепе. Вместимости в пользовательских единицах задаются в формате |
limits |
Type: capacity_limits Пределы загрузки прицепа. |
units |
Type: number Количество пользовательских единиц измерения, которое можно перевозить в прицепе. Default: |
volume |
Type: capacity_volume Метрические размеры прицепа. |
volume_cbm |
Type: number Вместимость прицепа в кубических метрах. |
weight_kg |
Type: number Грузоподъемность прицепа в килограммах. Default: |
trailer_cost
Стоимость использования прицепа.
Name |
Description |
fixed |
Type: number Стоимость за факт использования прицепа (стоимость считается затраченной, если прицеп использовался в маршруте). Default: |
hour |
Type: number Стоимость за час использования прицепа. Default: |
km |
Type: number Стоимость за километр использования прицепа. Default: |
location |
Type: number Стоимость использования прицепа в расчете на один пункт назначения (по умолчанию — 0). |
run |
Type: number Стоимость за один рейс со склада до пункта назначения. |
tonne_km |
Type: number Стоимость перевозки одной тонны на один километр (по умолчанию — 0). |
waiting_hour |
Type: number Стоимость часа ожидания с использованием транспортного средства. Если не указана, то используется значение, заданное в поле |
trailer_max_capacity_difference
Максимальная разница загрузки прицепа и тягоча.
Name |
Description |
custom |
Type: number Максимально допустимая разница в загруженном количестве пользовательских единиц измерения у прицепа и тягача. Допустимая разница в пользовательских единицах задаются в формате |
units |
Type: number Максимально допустимая разница в загруженном количестве пользовательских единиц измерения у прицепа и тягача. |
volume_cbm |
Type: number Максимально допустимая разница в загруженном объеме у прицепа и тягача в кубических метрах. |
weight_kg |
Type: number Максимально допустимая разница в загруженной массе у прицепа и тягача в килограммах. |
trailer_rolling_time
Время на перекладку грузов из прицепа в голову. Если указано несколько типов времени, используется тот, который затрачивает больше всего времени. Если ни один тип не указан, используется только фиксированое время перекладки.
Name |
Description |
fixed_time_s |
Type: number Фиксированное время, затраченное каждый раз, когда прицеп загружается или разгружается, в секундах. Max value: |
s_per_kg |
Type: number Время разгрузки на килограм груза, в секундах. Max value: |
s_per_m3 |
Type: number Время разгрузки на кубометр груза, в секундах. Max value: |
s_per_unit |
Type: number Время разгрузки на единицу груза, в секундах. Max value: |
walking_courier_capacity
Грузоподъемность курьера.
Name |
Description |
units |
Type: number Количество пользовательских единиц измерения, которое может переносить курьер. Default: |
walking_courier_cost
Стоимость работы курьера-пешехода.
Name |
Description |
hour |
Type: number Стоимость за час пеших маршрутов курьера. |
km |
Type: number Стоимость за километр пройденный курьером. |
kg_per_hour_0_item_1
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность упаковки на складе, кг/ч. |
units_per_hour_0_item_1
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час. |
penalty_early_3
Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение. Default: |
minute |
Type: number Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле Default: |
penalty_late_3
Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time
). Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
Name |
Description |
fixed |
Type: number Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением. Default: |
minute |
Type: number Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна. Default: |
penalty_out_of_time_3
Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early
и late
, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов Default: |
minute |
Type: number Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов Default: |
penalty_package_throughput
Составляющие штрафа за превышение пропускной способности упаковки заказов.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
penalty_throughput
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
kg_per_hour_0_item
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
time_windows_loading_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
time_windows_refilling_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
time_windows_unloading_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
kg_per_hour_0_item_5
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность упаковки на складе, кг/ч. |
units_per_hour_0_item_5
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час. |
penalty_early_8
Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение. Default: |
minute |
Type: number Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле Default: |
penalty_late_8
Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time
). Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
Name |
Description |
fixed |
Type: number Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением. Default: |
minute |
Type: number Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна. Default: |
penalty_out_of_time_8
Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early
и late
, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов Default: |
minute |
Type: number Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов Default: |
penalty_package_throughput_1
Составляющие штрафа за превышение пропускной способности упаковки заказов.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
penalty_throughput_2
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
kg_per_hour_0_item_4
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_4
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_3
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
time_windows_loading_time_windows_item_1
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
time_windows_refilling_time_windows_item_1
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
time_windows_unloading_time_windows_item_1
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
initial_route_node_depot
Представление склада в initial_routes
Name |
Description |
value* |
Type: initial_route_node_depot_value Представление локации в initial_routes |
type |
Type: string Тип элемента маршрута. Enum: |
initial_route_node_location_1
Представление локации в initial_routes
Name |
Description |
value* |
Type: initial_route_node_location_1_value Представление локации в initial_routes |
type |
Type: string Тип элемента маршрута. Enum: |
initial_route_node_work_break
Представление перерыва в initial_routes
Name |
Description |
value* |
Type: initial_route_node_work_break_value Представление перерыва в initial_routes |
type |
Type: string Тип элемента маршрута. Enum: |
initial_route_node_courier_position
Представление позиции курьера в initial_routes
Name |
Description |
value* |
|
type |
Type: string Тип элемента маршрута. Enum: |
shift_end
Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.
Name |
Description |
arrival_time_s* |
Type: number Плановое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования. Прибытие произошло до начала временного окна, поэтому будет прибавлено ко времени ожидания. |
node* |
Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position Элемент маршрута. |
transit_distance_m* |
Type: number Расстояние до пункта назначения, в метрах.Если параметр |
transit_duration_s* |
Type: number Время поездки до пункта назначения, в секундах. |
actual_arrival_time_s |
Type: number Фактическое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования. |
actual_departure_time_s |
Type: number Фактическое время отправления из пункта назначения, в секундах. Считается от начала суток планирования. |
actual_service_start_time_s |
Type: number Реальное время начала обслуживания заказа. |
actual_waiting_duration_s |
Type: number Реальная продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала обслуживания согласно actual_arrival_time_s и actual_service_start_time_s, секунды. |
departure_time_s |
Type: number Плановое время отправления из пункта назначения, в секундах. Считается от начала суток планирования. |
failed_time_window |
Type: end_failed_time_window |
load_to_head |
Type: (integer or string)[] Список заказов, которые должны быть загружены в голову автомобиля на складе или якорной локации, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания. |
load_to_trailer |
Type: (integer or string)[] Список заказов, которые должны быть загружены в прицеп автомобиля на складе, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания. |
multi_order |
Type: boolean Несколько заказов доставляются в один и тот же пункт назначения вместе. Время прибытия для всех заказов в группе совпадает. Кроме того, на уровне каждого заказа может быть указан параметр |
overtime |
Type: end_overtime |
probably_failed_time_window |
|
stop_sequence_number |
Type: integer Порядковый номер остановки (среди delivery, pickup и drop_off локаций) |
violations |
Type: (items_0_2 or items_1_2)[] Список нарушений. |
waiting_duration_s |
Type: number Продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала временного окна, секунды. |
shift_start
Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.
Name |
Description |
arrival_time_s* |
Type: number Плановое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования. Прибытие произошло до начала временного окна, поэтому будет прибавлено ко времени ожидания. |
node* |
Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position Элемент маршрута. |
transit_distance_m* |
Type: number Расстояние до пункта назначения, в метрах.Если параметр |
transit_duration_s* |
Type: number Время поездки до пункта назначения, в секундах. |
actual_arrival_time_s |
Type: number Фактическое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования. |
actual_departure_time_s |
Type: number Фактическое время отправления из пункта назначения, в секундах. Считается от начала суток планирования. |
actual_service_start_time_s |
Type: number Реальное время начала обслуживания заказа. |
actual_waiting_duration_s |
Type: number Реальная продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала обслуживания согласно actual_arrival_time_s и actual_service_start_time_s, секунды. |
departure_time_s |
Type: number Плановое время отправления из пункта назначения, в секундах. Считается от начала суток планирования. |
failed_time_window |
Type: start_failed_time_window |
load_to_head |
Type: (integer or string)[] Список заказов, которые должны быть загружены в голову автомобиля на складе или якорной локации, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания. |
load_to_trailer |
Type: (integer or string)[] Список заказов, которые должны быть загружены в прицеп автомобиля на складе, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания. |
multi_order |
Type: boolean Несколько заказов доставляются в один и тот же пункт назначения вместе. Время прибытия для всех заказов в группе совпадает. Кроме того, на уровне каждого заказа может быть указан параметр |
overtime |
Type: start_overtime |
probably_failed_time_window |
|
stop_sequence_number |
Type: integer Порядковый номер остановки (среди delivery, pickup и drop_off локаций) |
violations |
Type: (items_0_1 or items_1_1)[] Список нарушений. |
waiting_duration_s |
Type: number Продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала временного окна, секунды. |
penalty_throughput_5
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
kg_per_hour_0_item_9
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_9
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_7
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
items_penalty_7
Штрафы, применяемые за нарушения условий перерывов в работе.
Name |
Description |
early |
Type: penalty_early_13 Составляющие штрафа за ранний перерыв в работе. |
late |
Type: penalty_late_13 Составляющие штрафа за поздний перерыв в работе. |
items_penalty_12
Штрафы, применяемые за нарушения условий перерывов в работе.
Name |
Description |
early |
Type: penalty_early_16 Составляющие штрафа за ранний перерыв в работе. |
late |
Type: penalty_late_16 Составляющие штрафа за поздний перерыв в работе. |
penalty_early_14
Составляющие штрафа за смены, начатые слишком рано. (используются вместо штрафа out_of_time
). Если смены была завершена слишком рано, то штраф также начисляется за завершение.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортная смена была начата или завершена до начала выбранного временного окна. Default: |
minute |
Type: number Штраф за каждую минуту раннего начала или окончания смены, когда транспортное средство начинает или заканчивает смену до начала временного окна. Default: |
penalty_late_14
Составляющие штрафа за смены, завершённые слишком поздно (используются вместо штрафа out_of_time
). Этот штраф применяется как за опоздание к концу временного окна, так и за превышение максимальной продолжительности смены (max_duration_s
). Если и то, и другое нарушено одновременно, штраф применяется к обоим нарушениям и суммируется. Также, если смена была начата после окончания временного окна, штраф дополнительно начисляется за точку начала смены. Подробнее
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если смена начата или завершена после конца выбранного временного окна, а также за превышение максимальной продолжительности смены (параметра Default: |
minute |
Type: number Штраф за каждую минуту позднего начала или окончания смены в случае непопадания в рамки временного окна или нарушения максимальной продолжительности смены (параметра Default: |
penalty_max_mileage
Штрафы, применяемые за нарушение ограничения на пробег транспортного средства за смену (параметр смены max_mileage_km
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если пробег за смену больше, чем указано в параметре смены Default: |
km |
Type: number Штраф за каждый дополнительный километр в случае, если пробег за смену больше, чем указанный в параметре смены Default: |
penalty_out_of_time_10
Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early
и late
, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если смена начата или закончена вне заданного временного окна. См. спецификации штрафов Default: |
minute |
Type: number Штраф за каждую минуту нахождения вне временного окна смены. См. спецификации штрафов Default: |
penalty_stop_excess
Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство maximal_stops
параметра shifts
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортная смена имеет больше остановок, чем указано в свойстве |
per_stop |
Type: number Штраф за каждую дополнительную остановку в случае, если транспортная смена имеет больше остановок, чем указано в свойстве |
penalty_stop_lack
Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство minimal_stops
параметра shifts
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве |
per_stop |
Type: number Штраф за каждую недостающую остановку в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве |
penalty_unique_stop_lack
Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство minimal_stops
параметра shifts
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве |
per_stop |
Type: number Штраф за каждую недостающую остановку в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве |
capacity_limits
Пределы загрузки прицепа.
Name |
Description |
units_perc |
Type: number Максимальный объем отправлений в пользовательских единицах измерения, выраженный в процентах от вместимости прицепа. Default: |
volume_perc |
Type: number Максимальный объем отправлений в процентах от объема прицепа. Для размещения жёстких контейнеров предполагается, что стороны грузового отсека умножены на кубический корень из Default: |
weight_perc |
Type: number Максимальный объем отправлений в процентах от максимально допустимого общего веса груза, перевозимого в прицепе. Default: |
capacity_volume
Метрические размеры прицепа.
Name |
Description |
depth_m* |
Type: number Глубина, в метрах. Default: Max value: |
height_m* |
Type: number Высота, в метрах. Default: Max value: |
width_m* |
Type: number Ширина, в метрах. Default: Max value: |
initial_route_node_depot_value
Представление локации в initial_routes
Name |
Description |
id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
actual_total_service_duration_s |
Type: number Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s). |
added_shared_service_duration_s |
Type: number Дополнительное время обслуживание адреса, для первого заказа в мультизаказе равняется shared_service_duration_sДля остальных заказов в мультизаказе может быть не 0, если shared_service_duration_s текущего заказа больше, чем у предыдущих Max value: |
anchor_mode |
Type: string Default: Enum: |
delivered_orders |
Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. |
delivery_deadline |
Type: string Время, до которого заказ из места погрузки ( |
fixed_position |
Type: boolean Локацию нельзя перемещать и вставлять перед ней другие локации |
fixed_run |
Type: boolean Заказ может быть доставлен только в том заезде, в котором он был запланирован |
fixed_shift |
Type: boolean Заказ может быть доставлен только в той смене, в которой он был запланирован |
fixed_vehicle |
Type: boolean Заказ может быть доставлен только той машиной, в которой он был запланирован |
keep_in_vehicle |
Type: boolean При удалении заказа из маршрута, он продолжает занимать место в машине |
loaded_orders |
Type: (integer or string)[] Идентификаторы заказов типа |
parking_mode |
Type: string Default: Enum: |
parking_type |
Type: string Enum: |
picked_orders |
Type: (integer or string)[] Список идентификаторов заказов, забираемых в кросс-доке или складе. |
pickup_id |
Type: integer or string Идентификатор пункта назначения типа |
pickup_ids |
Type: (integer or string)[] Список идентификаторов пунктов назначения типа |
service_waiting_duration_s |
Type: number Продолжительность ожидания обслуживания в пункте назначения. Она может быть ненулевой, когда, например, заказ входит в состав мультизаказа. В этом случае длительность ожидания включает в себя длительность обслуживания других заказов из мультизаказа. Max value: |
split_info |
Type: value_split_info_1 Информация об отдельной части заказа (в случае, если заказ был разделен на части) |
total_service_duration_s |
Type: number Общая длительность обслуживания в пункте назначения, включающая Max value: |
trailer_decoupled |
Type: boolean |
trailer_used |
Type: boolean |
undroppable |
Type: boolean Локацию нельзя удалять из маршрута |
unfeasible_reasons |
Type: (items_0_12 or items_1_12 or items_2_3 or items_3_2 or items_4_2 or items_5_2 or items_6_2 or items_7_2 or items_8_2 or items_9_2)[] Список причин невозможности выполнения заказа в пункт назначения. |
zones |
Type: string[] Список зон |
initial_route_node_location_1_value
Представление локации в initial_routes
Name |
Description |
id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
actual_total_service_duration_s |
Type: number Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s). |
added_shared_service_duration_s |
Type: number Дополнительное время обслуживание адреса, для первого заказа в мультизаказе равняется shared_service_duration_sДля остальных заказов в мультизаказе может быть не 0, если shared_service_duration_s текущего заказа больше, чем у предыдущих Max value: |
anchor_mode |
Type: string Default: Enum: |
delivered_orders |
Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. |
delivery_deadline |
Type: string Время, до которого заказ из места погрузки ( |
fixed_position |
Type: boolean Локацию нельзя перемещать и вставлять перед ней другие локации |
fixed_run |
Type: boolean Заказ может быть доставлен только в том заезде, в котором он был запланирован |
fixed_shift |
Type: boolean Заказ может быть доставлен только в той смене, в которой он был запланирован |
fixed_vehicle |
Type: boolean Заказ может быть доставлен только той машиной, в которой он был запланирован |
keep_in_vehicle |
Type: boolean При удалении заказа из маршрута, он продолжает занимать место в машине |
loaded_orders |
Type: (integer or string)[] Идентификаторы заказов типа |
parking_mode |
Type: string Default: Enum: |
parking_type |
Type: string Enum: |
picked_orders |
Type: (integer or string)[] Список идентификаторов заказов, забираемых в кросс-доке или складе. |
pickup_id |
Type: integer or string Идентификатор пункта назначения типа |
pickup_ids |
Type: (integer or string)[] Список идентификаторов пунктов назначения типа |
service_waiting_duration_s |
Type: number Продолжительность ожидания обслуживания в пункте назначения. Она может быть ненулевой, когда, например, заказ входит в состав мультизаказа. В этом случае длительность ожидания включает в себя длительность обслуживания других заказов из мультизаказа. Max value: |
split_info |
Type: value_split_info Информация об отдельной части заказа (в случае, если заказ был разделен на части) |
total_service_duration_s |
Type: number Общая длительность обслуживания в пункте назначения, включающая Max value: |
trailer_decoupled |
Type: boolean |
trailer_used |
Type: boolean |
undroppable |
Type: boolean Локацию нельзя удалять из маршрута |
unfeasible_reasons |
Type: (items_0 or items_1 or items_2 or items_3 or items_4 or items_5 or items_6 or items_7 or items_8 or items_9)[] Список причин невозможности выполнения заказа в пункт назначения. |
zones |
Type: string[] Список зон |
initial_route_node_work_break_value
Представление перерыва в initial_routes
Name |
Description |
after_last_location |
Type: boolean При значении |
at_rest_place |
Type: boolean При значении |
before_first_location |
Type: boolean При значении |
chain_number |
Type: integer Порядковый номер цепочки, к которой относится перерыв. |
continuous_travel_time_range |
Type: string Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: |
driving_time_range |
Type: string Минимальная и максимальная продолжительность движения до отдыха, формат: |
exact_time_range |
Type: string Точный диапазон времени, когда должен начаться отдых, формат: |
fixed_position |
Type: boolean Локацию нельзя перемещать и вставлять перед ней другие локации |
fixed_run |
Type: boolean Заказ может быть доставлен только в том заезде, в котором он был запланирован |
fixed_shift |
Type: boolean Заказ может быть доставлен только в той смене, в которой он был запланирован |
fixed_vehicle |
Type: boolean Заказ может быть доставлен только той машиной, в которой он был запланирован |
keep_in_vehicle |
Type: boolean При удалении заказа из маршрута, он продолжает занимать место в машине |
merge_with_types |
Type: string[] Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями |
necessary_route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах. Max value: |
repeatable |
Type: boolean При значении |
rest_duration_s |
Type: number Продолжительность отдыха, в секундах. Min value: Max value: |
route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах. Max value: |
travel_time_range |
Type: string Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: |
undroppable |
Type: boolean Локацию нельзя удалять из маршрута |
work_duration_s |
Type: number Продолжительность непрерывной работы до перерыва на отдых, в секундах. Max value: |
work_time_range_from_start |
Type: string Минимальное и максимальное время от начала маршрута до отдыха, формат: |
work_time_range_till_rest |
Type: string Минимальная и максимальная продолжительность работы до отдыха, формат: |
initial_route_node_courier_position_value
Name |
Description |
location_id* |
Type: string Идентефикатор текущей локации |
passed_time_s |
Type: number Время прошедшее после посещения курьером текущей локации. Считается что в следующую локацию за это время курьер еще не приехал. |
route_node_depot
Элемент маршрута.
Name |
Description |
type* |
Type: string Тип элемента маршрута. Enum: |
value* |
Type: route_depot_location Описание пункта назначения. |
used_hard_time_window |
Type: string Жесткое окно, выбранное для посещения пункта назначения или склада, в формате |
used_projection |
Type: route_node_depot_used_projection Координаты пункта назначения в формате WGS84. Подробнее |
used_time_window |
Type: string Окно, выбранное для посещения пункта назначения или склада, в формате |
route_node_location_1
Элемент маршрута.
Name |
Description |
type* |
Type: string Тип элемента маршрута. Enum: |
value* |
Type: route_location_1 Описание пункта назначения. |
used_hard_time_window |
Type: string Жесткое окно, выбранное для посещения пункта назначения или склада, в формате |
used_projection |
Type: route_node_location_1_used_projection Координаты пункта назначения в формате WGS84. Подробнее |
used_time_window |
Type: string Окно, выбранное для посещения пункта назначения или склада, в формате |
route_node_work_break
Элемент маршрута.
Name |
Description |
type* |
Type: string Тип элемента маршрута. Enum: |
value* |
Type: route_work_break Описание перерыва. |
used_hard_time_window |
Type: string Жесткое окно, выбранное для посещения пункта назначения или склада, в формате |
used_projection |
Type: route_node_work_break_used_projection Координаты пункта назначения в формате WGS84. Подробнее |
used_time_window |
Type: string Окно, выбранное для посещения пункта назначения или склада, в формате |
route_node_courier_position
Элемент маршрута.
Name |
Description |
type* |
Type: string Тип элемента маршрута. Enum: |
value* |
Type: route_courier_position |
used_hard_time_window |
Type: string Жесткое окно, выбранное для посещения пункта назначения или склада, в формате |
used_projection |
Type: route_node_courier_position_used_projection Координаты пункта назначения в формате WGS84. Подробнее |
used_time_window |
Type: string Окно, выбранное для посещения пункта назначения или склада, в формате |
end_failed_time_window
Name |
Description |
duration_s* |
Type: number Когда пункт назначения посещён вне временного окна, показывает расстояние во времени (в секундах) между временем начала или конца обслуживания (в зависимости от значения |
how* |
Type: string Когда пункт назначения посещён вне временного окна, показывает тип нарушения:
Enum: |
end_overtime
Name |
Description |
duration_s* |
Type: number Сверхурочное время транспортной смены, в секундах. |
end_probably_failed_time_window
Name |
Description |
duration_s* |
Type: number Ожидаемая разница между временем прибытия и нарушенным временным окном, в секундах. |
how* |
Type: string Когда пункт назначения посещён вне временного окна, показывает тип нарушения:
Enum: |
probability* |
Type: number Вероятность оказаться за пределами временного окна, в процентах. |
high_risk |
Type: boolean Если true, то вероятность опоздания в пункте назначения больше или равна |
items_0_2
Name |
Description |
duration_s* |
Type: any Ожидаемая разница между временем прибытия и дедлайном, в секундах. |
pickup_id* |
Type: integer or string Определяет идентификатор (id) пункта назначения типа |
type* |
Type: string Возможные причины:
Enum: |
items_1_2
Name |
Description |
duration_s* |
Type: any Ожидаемая разница между временем прибытия и дедлайном, в секундах. |
high_risk* |
Type: boolean Если true, то вероятность опоздания в пункте назначения больше или равна |
pickup_id* |
Type: integer or string Определяет идентификатор (id) пункта назначения типа |
probability* |
Type: number Вероятность опоздать, в процентах. |
type* |
Type: string Возможные причины:
Enum: |
start_failed_time_window
Name |
Description |
duration_s* |
Type: number Когда пункт назначения посещён вне временного окна, показывает расстояние во времени (в секундах) между временем начала или конца обслуживания (в зависимости от значения |
how* |
Type: string Когда пункт назначения посещён вне временного окна, показывает тип нарушения:
Enum: |
start_overtime
Name |
Description |
duration_s* |
Type: number Сверхурочное время транспортной смены, в секундах. |
start_probably_failed_time_window
Name |
Description |
duration_s* |
Type: number Ожидаемая разница между временем прибытия и нарушенным временным окном, в секундах. |
how* |
Type: string Когда пункт назначения посещён вне временного окна, показывает тип нарушения:
Enum: |
probability* |
Type: number Вероятность оказаться за пределами временного окна, в процентах. |
high_risk |
Type: boolean Если true, то вероятность опоздания в пункте назначения больше или равна |
items_0_1
Name |
Description |
duration_s* |
Type: any Ожидаемая разница между временем прибытия и дедлайном, в секундах. |
pickup_id* |
Type: integer or string Определяет идентификатор (id) пункта назначения типа |
type* |
Type: string Возможные причины:
Enum: |
items_1_1
Name |
Description |
duration_s* |
Type: any Ожидаемая разница между временем прибытия и дедлайном, в секундах. |
high_risk* |
Type: boolean Если true, то вероятность опоздания в пункте назначения больше или равна |
pickup_id* |
Type: integer or string Определяет идентификатор (id) пункта назначения типа |
probability* |
Type: number Вероятность опоздать, в процентах. |
type* |
Type: string Возможные причины:
Enum: |
penalty_early_13
Составляющие штрафа за ранний перерыв в работе.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы. Default: |
minute |
Type: number Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы. Default: |
penalty_late_13
Составляющие штрафа за поздний перерыв в работе.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы. Default: |
minute |
Type: number Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы. Default: |
penalty_early_16
Составляющие штрафа за ранний перерыв в работе.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы. Default: |
minute |
Type: number Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы. Default: |
penalty_late_16
Составляющие штрафа за поздний перерыв в работе.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы. Default: |
minute |
Type: number Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы. Default: |
value_split_info_1
Информация об отдельной части заказа (в случае, если заказ был разделен на части)
Name |
Description |
order_ratio |
Type: number Доля заказа, входящая в данную часть. |
part_id |
Type: integer Номер данной части заказа. |
parts_count |
Type: integer Количество частей, на которые был разбит заказ. |
units |
Type: number Вес данной части в пользовательских единицах измерения (при условии, что для заказа был задан соотвествующий квант). |
volume_cbm |
Type: number Объем данной части, кубические метры (при условии, что для заказа был задан соотвествующий квант). |
weight_kg |
Type: number Вес данной части части, кг (при условии, что для заказа был указан соотвествующий квант). |
items_0_12
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overload* |
Type: number Значение перегруза. Единица измерения зависит от типа перегруза:
|
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
custom_type |
Type: string Тип пользовательских единиц, вызвавших перегруз, в случае OVERLOAD_CUSTOM. |
items_1_12
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
late_duration_s* |
Type: number Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_2_3
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список отсутствующих необходимых тегов. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_3_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список указанных запрещенных тегов. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Possible reasons:
Enum: |
items_4_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overrun_s* |
Type: number Величина превышения лимита на время нахождения на борту, в секундах |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_5_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
incompatibilities* |
Type: _incompatibilities_item_5[] Список всех несовместимых пар типов грузов |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_6_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
incompatibilities* |
Type: _incompatibilities_item_4[] Список всех несовместимых пар зон заказов |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_7_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список зон, которые разрешается посещать автомобилю. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_8_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список указанных запрещенных зон. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Possible reasons:
Enum: |
items_9_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
value_split_info
Информация об отдельной части заказа (в случае, если заказ был разделен на части)
Name |
Description |
order_ratio |
Type: number Доля заказа, входящая в данную часть. |
part_id |
Type: integer Номер данной части заказа. |
parts_count |
Type: integer Количество частей, на которые был разбит заказ. |
units |
Type: number Вес данной части в пользовательских единицах измерения (при условии, что для заказа был задан соотвествующий квант). |
volume_cbm |
Type: number Объем данной части, кубические метры (при условии, что для заказа был задан соотвествующий квант). |
weight_kg |
Type: number Вес данной части части, кг (при условии, что для заказа был указан соотвествующий квант). |
items_0
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overload* |
Type: number Значение перегруза. Единица измерения зависит от типа перегруза:
|
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
custom_type |
Type: string Тип пользовательских единиц, вызвавших перегруз, в случае OVERLOAD_CUSTOM. |
items_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
late_duration_s* |
Type: number Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список отсутствующих необходимых тегов. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_3
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список указанных запрещенных тегов. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Possible reasons:
Enum: |
items_4
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overrun_s* |
Type: number Величина превышения лимита на время нахождения на борту, в секундах |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_5
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
incompatibilities* |
Type: _incompatibilities_item_1[] Список всех несовместимых пар типов грузов |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_6
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
incompatibilities* |
Type: _incompatibilities_item[] Список всех несовместимых пар зон заказов |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_7
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список зон, которые разрешается посещать автомобилю. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_8
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список указанных запрещенных зон. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Possible reasons:
Enum: |
items_9
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
route_depot_location
Описание пункта назначения.
Name |
Description |
id* |
Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
actual_total_service_duration_s |
Type: number Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s). |
address |
Type: string Адрес локации. |
crossdock_safety_waiting_duration_s |
Type: number Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы. Default: Max value: |
delivered_orders |
Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. |
description |
Type: string Описание пункта назначения. |
finish_service_duration_s |
Type: number Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее Max value: |
fixed_position |
Type: boolean Локацию нельзя перемещать и вставлять перед ней другие локации |
flexible_start_time |
Type: boolean По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее |
load_service_duration_s |
Type: number Дополнительное время на загрузку в машину delivery заказов, добавляемое только если на данном складе загружается хотя бы один delivery заказ. |
loaded_orders |
Type: (integer or string)[] Идентификаторы заказов типа |
package_throughput |
Type: route_depot_location_package_throughput Ограничение на скорость упаковки заказов на складе. |
penalty |
Type: route_depot_location_penalty Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее |
picked_orders |
Type: (integer or string)[] Список идентификаторов заказов, забираемых в кросс-доке или складе. |
point |
Type: coordinate_2 Координаты пункта назначения в формате WGS84. Подробнее |
preliminary_service_duration_s |
Type: number Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления Max value: |
preset_id |
Type: string Номер пресета для свойств склада. |
ref |
Type: string Сноска с информацией о месте. |
routing_mode |
Type: string Способ передвижения, использованный для достижения данной локации. Enum: |
service_duration_s |
Type: service_duration_2_0 or number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее |
throughput |
Type: route_depot_location_throughput Пропускная способность склада. Подробнее |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: route_depot_location_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
time_windows_loading |
Type: route_depot_location_time_windows_loading Временные окна, в которые машина может выехать со склада на первый заезд |
time_windows_refilling |
Type: route_depot_location_time_windows_refilling Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки |
time_windows_unloading |
Type: route_depot_location_time_windows_unloading Временные окна, в которые машина может вернуться на склад после последнего заезда |
title |
Type: string Название места. |
total_service_duration_s |
Type: number Общая длительность обслуживания на складе (равна по величине параметру Max value: |
trailer_decoupled |
Type: boolean |
trailer_used |
Type: boolean |
type |
Type: string Определяет тип склада:
Default: Enum: |
unfeasible_reasons |
Type: (items_0_9 or items_1_9 or items_2_2)[] Список причин невозможности выполнения заказа в пункт назначения. |
unload_service_duration_s |
Type: number Дополнительное время на выгрузку из машины pickup заказов, добавляемое только если на данный склад доставляется хотя бы один pickup заказ. |
use_in_proximity |
Type: boolean При значении |
route_node_depot_used_projection
Координаты пункта назначения в формате WGS84. Подробнее
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
route_location_1
Описание пункта назначения.
Name |
Description |
id* |
Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее |
actual_total_service_duration_s |
Type: number Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s). |
added_shared_service_duration_s |
Type: number Дополнительное время обслуживание адреса, для первого заказа в мультизаказе равняется shared_service_duration_sДля остальных заказов в мультизаказе может быть не 0, если shared_service_duration_s текущего заказа больше, чем у предыдущих Max value: |
address |
Type: string Адрес локации. |
allow_trailers |
Type: boolean При значении |
anchor_mode |
Type: string Default: Enum: |
can_be_merged |
Type: boolean Заказ может являться частью мультизаказа Default: |
can_be_split |
Type: boolean Заказ может быть разделен на части между разными машинами. |
client_id |
Type: integer or string Определяет идентификатор (id) клиента, к которому относится локация. |
client_service_duration_s |
Type: client_service_duration_0 or number Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место. |
comments |
Type: string Комментарии. |
crossdock_mode |
Type: string Определяет, разрешено ли доставлять этот заказ через кросс-док склад.
Default: Enum: |
crossdock_service_duration_s |
Type: crossdock_service_duration_0 or number Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее |
custom_value |
Type: number Дополнительный числовой атрибут локации (Например, вознаграждение курьера за посещение этой локации). Может быть использовано как компонент в расчёте стоимости маршрута. |
delivered_orders |
Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. |
delivery_deadline |
Type: string Время, до которого заказ из места погрузки ( |
delivery_to |
Type: integer or string Определяет идентификатор (id) пункта назначения. Подробнее |
delivery_to_any |
Type: (integer or string)[] Список идентификаторов пунктов выдачи ( |
depot_duration_s |
Type: depot_duration_0 or number Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее |
depot_expiring_time |
Type: string Время, не позднее которого заказ необходимо забрать со склада, в формате |
depot_id |
Type: integer or string or array |
depot_ready_time |
Type: string Время, начиная с которого заказ можно будет забрать с любого склада, в формате |
description |
Type: string Описание пункта назначения. |
drop_reason |
Type: string Объяснение причины удаления пункта назначения из маршрута. |
dropped_ratio |
Type: number Доля заказа, которая не должна быть развезена Max value: |
fixed_position |
Type: boolean Локацию нельзя перемещать и вставлять перед ней другие локации |
fixed_run |
Type: boolean Заказ может быть доставлен только в том заезде, в котором он был запланирован |
fixed_shift |
Type: boolean Заказ может быть доставлен только в той смене, в которой он был запланирован |
fixed_vehicle |
Type: boolean Заказ может быть доставлен только той машиной, в которой он был запланирован |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. Если пункт не может быть посещен в указанное временное окно, он будет исключен из маршрута и добавлен в поле ответа |
ignore_zones_compatibility |
Type: boolean Игнорировать эффекты вызываемые свойствами |
in_lifo_order |
Type: boolean Заказы, у которых это поле имеет значение |
keep_in_vehicle |
Type: boolean При удалении заказа из маршрута, он продолжает занимать место в машине |
load_types |
Type: string[] Определяет типы грузов в данном пункте назначения.
Недопустимы для локаций с типом |
loaded_orders |
Type: (integer or string)[] Идентификаторы заказов типа |
max_split_parts |
Type: integer Максимальное количество частей, на которые может быть разбит заказ Default: Min value: |
max_total_vehicles |
Type: integer Максимальное число автомобилей, которые может обслужить якорная локация. По умолчанию не ограничено. Подробнее |
may_drop_in_crossdock |
Type: boolean Можно ли оставить пикап в кросс-док складе Default: |
optional_tags |
Type: route_location_1_optional_tags_item[] Список тегов, которые не обязаны быть у автомобиля, обслуживающего данный пункт назначения. Эти теги могут уменьшить или увеличить стоимость маршрута, если их удовлетворить. Подробнее |
parking_mode |
Type: string Тип парковки Enum: |
parking_service_duration_s |
Type: number Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения Max value: |
parking_type |
Type: string Enum: |
penalty |
Type: route_location_1_penalty Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее |
phone |
Type: string Номер телефона получателя при доставке. |
picked_orders |
Type: (integer or string)[] Список идентификаторов заказов, забираемых в кросс-доке или складе. |
pickup_from_any |
Type: boolean Delivery-заказы, у которых это поле имеет значение |
pickup_id |
Type: integer or string Идентификатор пункта назначения типа |
pickup_ids |
Type: (integer or string)[] Список идентификаторов пунктов назначения типа |
pickup_must_reach_depot |
Type: boolean Данное поле определяет считать ли pickup-локацию обслуженной, если она не доставлена на склад. Запрещено указывать для локаций типов отличных от pickup. Запрещено использовать совместно с полями |
point |
Type: coordinate_2 Координаты пункта назначения в формате WGS84. Подробнее |
preset_id |
Type: string Номер пресета для свойств пункта назначения. |
quant |
Type: number or quant_0_1 |
ref |
Type: string Сноска с информацией о месте. |
required_tags |
Type: string[] Список тегов, которые должны быть у автомобиля, обслуживающего данный пункт назначения. Подробнее |
rolling_throughput |
Type: route_location_1_rolling_throughput Пропускная способность перекатки (поддерживается для якорных точек). |
routing_mode |
Type: string Способ передвижения, использованный для достижения данной локации. Enum: |
sequence_order |
Type: integer Все локации в маршруте транспортного средства, у которых указана данная опция, должны быть посещены в порядке неубывания ее значений. Подробнее |
service_duration_s |
Type: service_duration_2_0 or number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее |
service_durations |
Type: service_durations Структура, в которой задаются времена обслуживания для локации. |
service_waiting_duration_s |
Type: number Продолжительность ожидания обслуживания в пункте назначения. Она может быть ненулевой, когда, например, заказ входит в состав мультизаказа. В этом случае длительность ожидания включает в себя длительность обслуживания других заказов из мультизаказа. Max value: |
shared_service_duration_s |
Type: shared_service_duration_0 or number Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее |
shared_with_company_ids |
Type: integer[] ID компаний, которые могут получить доступ к информации о заказе. |
shipment_size |
Type: route_location_1_shipment_size Размер отправления (метрические размеры и/или вес). Подробнее |
soft_depot_expiring_time |
Type: string Время, не позднее которого заказ необходимо забрать со склада, в формате |
soft_depot_ready_time |
Type: string Время, начиная с которого заказ можно будет забрать с любого склада, в формате |
split_info |
Type: route_location_1_split_info Информация об отдельной части заказа (в случае, если заказ был разделен на части) |
split_parts_must_fill_whole_vehicle |
Type: boolean Части, отделяемые от разделяемого заказа, должны заполнять машину целиком. |
throughput |
Type: route_location_1_throughput Пропускная способность заказа (поддерживается для разделяемых заказов). |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: route_location_1_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
title |
Type: string Название места. |
total_service_duration_s |
Type: number Общая длительность обслуживания в пункте назначения, включающая Max value: |
trailer_decoupled |
Type: boolean |
trailer_used |
Type: boolean |
transit_time |
Type: route_location_1_transit_time Ограничение на время нахождения заказа на борту |
type |
Type: string Определяет тип обслуживания в пункте назначения:
Default: Enum: |
undroppable |
Type: boolean Локацию нельзя удалять из маршрута |
unfeasible_reasons |
Type: (items_0_4 or items_1_4 or items_2_1 or items_3_1 or items_4_1 or items_5_1 or items_6_1 or items_7_1 or items_8_1 or items_9_1)[] Список причин невозможности выполнения заказа в пункт назначения. |
use_in_proximity |
Type: boolean При значении Default: |
route_node_location_1_used_projection
Координаты пункта назначения в формате WGS84. Подробнее
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
route_work_break
Описание перерыва.
Name |
Description |
rest_duration_s* |
Type: number Продолжительность отдыха, в секундах. Min value: Max value: |
after_last_location |
Type: boolean При значении |
at_rest_place |
Type: boolean При значении |
before_first_location |
Type: boolean При значении |
chain_number |
Type: integer Порядковый номер цепочки, к которой относится перерыв. |
continuous_travel_time_range |
Type: string Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: |
driving_time_range |
Type: string Минимальная и максимальная продолжительность движения до отдыха, формат: |
exact_time_range |
Type: string Точный диапазон времени, когда должен начаться отдых, формат: |
fixed_position |
Type: boolean Локацию нельзя перемещать и вставлять перед ней другие локации |
merge_with_types |
Type: string[] Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями |
necessary_route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах. Max value: |
penalty |
Type: route_work_break_penalty Штрафы, применяемые за нарушения условий перерывов в работе. |
repeatable |
Type: boolean При значении |
route_duration_s |
Type: number Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах. Max value: |
travel_time_range |
Type: string Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: |
type |
Type: string Тип перерыва. Используется в поле |
work_duration_s |
Type: number Продолжительность непрерывной работы до перерыва на отдых, в секундах. Max value: |
work_time_range_from_start |
Type: string Минимальное и максимальное время от начала маршрута до отдыха, формат: |
work_time_range_till_rest |
Type: string Минимальная и максимальная продолжительность работы до отдыха, формат: |
route_node_work_break_used_projection
Координаты пункта назначения в формате WGS84. Подробнее
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
route_courier_position
Name |
Description |
location_id* |
Type: string Идентефикатор текущей локации |
passed_time_s |
Type: number Время прошедшее после посещения курьером текущей локации. Считается что в следующую локацию за это время курьер еще не приехал. |
route_node_courier_position_used_projection
Координаты пункта назначения в формате WGS84. Подробнее
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
_incompatibilities_item_5
Список всех пар типов грузов, несовместимых с заказом.
Name |
Description |
incompatible_order_id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
types* |
Type: items_types_item_2[] |
_incompatibilities_item_4
Список всех пар зон заказов, несовместимых с заказом.
Name |
Description |
incompatible_order_id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
zones* |
Type: items_zones_item_2[] |
_incompatibilities_item_1
Список всех пар типов грузов, несовместимых с заказом.
Name |
Description |
incompatible_order_id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
types* |
Type: items_types_item[] |
_incompatibilities_item
Список всех пар зон заказов, несовместимых с заказом.
Name |
Description |
incompatible_order_id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
zones* |
Type: items_zones_item[] |
route_depot_location_package_throughput
Ограничение на скорость упаковки заказов на складе.
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
route_depot_location_penalty
Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее
Name |
Description |
early |
Type: penalty_early_30 Составляющие штрафа за раннее обслуживание (используются вместо штрафа |
late |
Type: penalty_late_30 Составляющие штрафа за позднее посещение (используются вместо штрафа |
out_of_time |
Type: penalty_out_of_time_21 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов |
package_throughput |
Type: penalty_package_throughput_3 Составляющие штрафа за превышение пропускной способности упаковки заказов. |
throughput |
Type: penalty_throughput_11 Составляющие штрафа за превышение пропускной способности. |
route_depot_location_throughput
Пропускная способность склада. Подробнее
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
route_depot_location_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
route_depot_location_time_windows_loading
Временные окна, в которые машина может выехать со склада на первый заезд
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_loading_time_windows_item_3[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
route_depot_location_time_windows_refilling
Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_refilling_time_windows_item_3[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
route_depot_location_time_windows_unloading
Временные окна, в которые машина может вернуться на склад после последнего заезда
Name |
Description |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
hard_window |
Type: boolean Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window". |
penalty |
Type: any |
time_window |
Type: string Разрешенное окно посещения пункта назначения, в формате |
time_windows |
Type: time_windows_unloading_time_windows_item_3[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля |
items_0_9
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
late_duration_s* |
Type: number Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_1_9
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overrun_s* |
Type: number Величина превышения лимита на время нахождения на борту, в секундах |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_2_2
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
route_location_1_optional_tags_item
Необязательный тег с бонусом или штрафом.
Name |
Description |
tag* |
Type: string Произвольный тег. |
value* |
Type: number Значение тега. Если заказ доставлен автомобилем с соответствующим тегом в поле |
route_location_1_penalty
Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее
Name |
Description |
delivery_deadline |
Type: penalty_delivery_deadline_1 Составляющие штрафа за позднюю доставку заказа типа |
depot_expiring_time |
Type: penalty_depot_expiring_time_1 Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо. |
depot_ready_time |
Type: penalty_depot_ready_time_1 Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо. |
drop |
Type: drop_0_1 or number Штраф за невыполнение заказа. Подробнее |
early |
Type: penalty_early_9 Составляющие штрафа за раннее обслуживание (используются вместо штрафа |
late |
Type: penalty_late_9 Составляющие штрафа за позднее посещение (используются вместо штрафа |
out_of_time |
Type: penalty_out_of_time_9 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов |
rolling_throughput |
Type: penalty_rolling_throughput_1 Составляющие штрафа за превышение пропускной способности. |
throughput |
Type: penalty_throughput_3 Составляющие штрафа за превышение пропускной способности. |
time_between_visits |
Type: penalty_time_between_visits_1 Составляющие штрафа за превышение допустимого времени между посещениями частей заказа. |
transit_time |
Type: any Составляющие штрафа за превышение времени нахождения заказа на борту |
quant_0_1
Размер минимальной части, которая может быть отделена от заказа, в одной из единиц измерения
Name |
Description |
units |
Type: number Размер минимальной части в пользовательских единицах измерения. |
volume_cbm |
Type: number Объем минимальной части, кубические метры. |
weight_kg |
Type: number Вес минимальной части, кг. |
route_location_1_rolling_throughput
Пропускная способность перекатки (поддерживается для якорных точек).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
route_location_1_shipment_size
Размер отправления (метрические размеры и/или вес). Подробнее
Name |
Description |
custom |
Type: number Размер отправления в пользовательских единицах измерения. Размеры в пользовательских единицах задаются в формате |
units |
Type: number Размер отправления в пользовательских единицах измерения. Max value: |
volume |
Type: shipment_size_volume_1 Метрические размеры отправления. |
volume_cbm |
Type: number Явно заданный объем, кубические метры. По умолчанию берется значение из "volume", если тут ничего не указать. |
weight_kg |
Type: number Вес отправления, кг. Max value: |
route_location_1_split_info
Информация об отдельной части заказа (в случае, если заказ был разделен на части)
Name |
Description |
order_ratio |
Type: number Доля заказа, входящая в данную часть. |
part_id |
Type: integer Номер данной части заказа. |
parts_count |
Type: integer Количество частей, на которые был разбит заказ. |
units |
Type: number Вес данной части в пользовательских единицах измерения (при условии, что для заказа был задан соотвествующий квант). |
volume_cbm |
Type: number Объем данной части, кубические метры (при условии, что для заказа был задан соотвествующий квант). |
weight_kg |
Type: number Вес данной части части, кг (при условии, что для заказа был указан соотвествующий квант). |
route_location_1_throughput
Пропускная способность заказа (поддерживается для разделяемых заказов).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
route_location_1_time_windows_item
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
route_location_1_transit_time
Ограничение на время нахождения заказа на борту
Name |
Description |
hard_limit_s |
Type: number Жёсткое ограничение, не может быть превышено Max value: |
limit_s |
Type: number Мягкое ограничение, превышение допустимо, но ведёт к штрафам Max value: |
items_0_4
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overload* |
Type: number Значение перегруза. Единица измерения зависит от типа перегруза:
|
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
custom_type |
Type: string Тип пользовательских единиц, вызвавших перегруз, в случае OVERLOAD_CUSTOM. |
items_1_4
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
late_duration_s* |
Type: number Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_2_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список отсутствующих необходимых тегов. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_3_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список указанных запрещенных тегов. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Possible reasons:
Enum: |
items_4_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
overrun_s* |
Type: number Величина превышения лимита на время нахождения на борту, в секундах |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_5_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
incompatibilities* |
Type: _incompatibilities_item_3[] Список всех несовместимых пар типов грузов |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_6_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
incompatibilities* |
Type: _incompatibilities_item_2[] Список всех несовместимых пар зон заказов |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_7_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список зон, которые разрешается посещать автомобилю. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
items_8_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
tags* |
Type: string[] Список указанных запрещенных зон. |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Possible reasons:
Enum: |
items_9_1
Причина невозможности выполнения заказа в пункт назначения.
Name |
Description |
text* |
Type: string Объяснение причины невозможности выполнения заказа. |
type* |
Type: string Возможные причины:
Enum: |
route_work_break_penalty
Штрафы, применяемые за нарушения условий перерывов в работе.
Name |
Description |
early |
Type: penalty_early_26 Составляющие штрафа за ранний перерыв в работе. |
late |
Type: penalty_late_26 Составляющие штрафа за поздний перерыв в работе. |
items_types_item_2
Name |
Description |
other_type* |
Type: string Тип груза в несовместимом заказе. |
self_type* |
Type: string Тип груза в текущем заказе. |
items_zones_item_2
Name |
Description |
other_zone* |
Type: string Зона несовместимого заказа. |
self_zone* |
Type: string Зона текущего заказа. |
items_types_item
Name |
Description |
other_type* |
Type: string Тип груза в несовместимом заказе. |
self_type* |
Type: string Тип груза в текущем заказе. |
items_zones_item
Name |
Description |
other_zone* |
Type: string Зона несовместимого заказа. |
self_zone* |
Type: string Зона текущего заказа. |
kg_per_hour_0_item_20
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность упаковки на складе, кг/ч. |
units_per_hour_0_item_20
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час. |
penalty_early_30
Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time
).
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение. Default: |
minute |
Type: number Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле Default: |
penalty_late_30
Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time
). Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
Name |
Description |
fixed |
Type: number Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением. Default: |
minute |
Type: number Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна. Default: |
penalty_out_of_time_21
Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early
и late
, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов Default: |
minute |
Type: number Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов Default: |
penalty_package_throughput_3
Составляющие штрафа за превышение пропускной способности упаковки заказов.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
penalty_throughput_11
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
kg_per_hour_0_item_19
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_19
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_16
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
time_windows_loading_time_windows_item_3
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
time_windows_refilling_time_windows_item_3
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
time_windows_unloading_time_windows_item_3
Name |
Description |
time_window* |
Type: string Разрешенное окно посещения пункта назначения, в формате |
hard_time_window |
Type: string Разрешенное жесткое окно посещения пункта назначения, в формате |
penalty_delivery_deadline_1
Составляющие штрафа за позднюю доставку заказа типа pickup
на склад. Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания. Подробнее
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае посещения склада после дедлайна. Default: |
minute |
Type: number Штраф за каждую минуту опоздания, когда склад посещается после дедлайна. Default: |
penalty_depot_expiring_time_1
Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения. Default: |
minute |
Type: number Штраф за каждую минуту нарушения. Default: |
penalty_depot_ready_time_1
Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения. Default: |
minute |
Type: number Штраф за каждую минуту нарушения. Default: |
drop_0_1
Name |
Description |
fixed |
Type: number Фиксированный штраф за невыполнение любой части заказа. |
scaled |
Type: number Штраф за недоставленную долю заказа. Default: |
penalty_early_9
Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time
).
Name |
Description |
fixed |
Type: number Фиксированный штраф за обслуживание объекта, начатое раньше выбранного временного окна. Default: |
minute |
Type: number Штраф за каждую минуту раннего прибытия, если обслуживание объекта было начато раньше выбранного временного окна. Default: |
penalty_late_9
Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time
). Опция penalize_late_service
определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае посещения пункта назначения после окончания заданного временного окна. Default: |
minute |
Type: number Штраф за каждую минуту опоздания, когда место посещается после окончания временного окна. Default: |
penalty_out_of_time_9
Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early
и late
, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае посещения пункта назначения вне заданного временного окна. См. спецификации штрафов Default: |
minute |
Type: number Штраф за каждую минуту опоздания или раннего прибытия при посещении объекта за пределами временного окна.См. спецификации штрафов Default: |
penalty_rolling_throughput_1
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
penalty_throughput_3
Составляющие штрафа за превышение пропускной способности.
Name |
Description |
fixed |
Type: number Фиксированный штраф в случае превышения пропускной способности. Default: |
kg |
Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: |
unit |
Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле Default: |
vehicle |
Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: |
penalty_time_between_visits_1
Составляющие штрафа за превышение допустимого времени между посещениями частей заказа.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый за каждый случай нарушения вне зависимости от размера нарушения. Default: |
minute |
Type: number Штраф за каждую минуту нарушения. Default: |
kg_per_hour_0_item_7
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_7
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_5
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
shipment_size_volume_1
Метрические размеры отправления.
Name |
Description |
depth_m* |
Type: number Глубина, в метрах. Max value: |
height_m* |
Type: number Высота, в метрах. Max value: |
width_m* |
Type: number Ширина, в метрах. Max value: |
align |
Type: string Выравнивание отправления по осям (не имеет эффекта для типа
Default: Enum: |
type |
Type: string Тип отправления:
Default: Enum: |
kg_per_hour_0_item_6
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, кг/ч. |
units_per_hour_0_item_6
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, измеряемая в пользовательских единицах измерения в час. |
vehicle_count_0_item_4
Name |
Description |
time_window |
Type: string Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю. |
value |
Type: number Пропускная способность, одновременно находящиеся а/м. Max value: |
_incompatibilities_item_3
Список всех пар типов грузов, несовместимых с заказом.
Name |
Description |
incompatible_order_id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
types* |
Type: items_types_item_1[] |
_incompatibilities_item_2
Список всех пар зон заказов, несовместимых с заказом.
Name |
Description |
incompatible_order_id* |
Type: integer or string Ссылка на пункт назначения, указанный в параметре |
zones* |
Type: items_zones_item_1[] |
penalty_early_26
Составляющие штрафа за ранний перерыв в работе.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы. Default: |
minute |
Type: number Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы. Default: |
penalty_late_26
Составляющие штрафа за поздний перерыв в работе.
Name |
Description |
fixed |
Type: number Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы. Default: |
minute |
Type: number Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы. Default: |
items_types_item_1
Name |
Description |
other_type* |
Type: string Тип груза в несовместимом заказе. |
self_type* |
Type: string Тип груза в текущем заказе. |
items_zones_item_1
Name |
Description |
other_zone* |
Type: string Зона несовместимого заказа. |
self_zone* |
Type: string Зона текущего заказа. |
Responses
202 Accepted
Задача поставлена в очередь на выполнение.
Body
application/json
{
"id": "string",
"message": "string",
"status": {
"cancelled": 0,
"completed": 0,
"estimate": 0,
"queued": 0,
"started": 0
}
}
Name |
Description |
id* |
Type: string Уникальный id задачи. |
status* |
Type: task_info_1_status Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp. Возможные изменения статусов:
|
message |
Type: string Описание состояния задачи. |
task_info_1_status
Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.
Возможные изменения статусов:
queued
-> started
-> (completed
или cancelled
)
Name |
Description |
queued* |
Type: number Задача поставлена в очередь на выполнение. |
cancelled |
Type: number Выполнение задачи отменено пользователем или системой в связи с ошибкой или истечением времени ожидания. |
completed |
Type: number Выполнение задачи закончено успешно или с ошибкой. |
estimate |
Type: number Оценочное время решения задачи. Оценка может меняться в процессе решения. Оценка верна примерно в 75% случаев (задачи решаются за 5-15 секунд до estimate). Для некоторых задач фактическое время решения может быть больше, чем указано в estimate (обычно, не более чем на 1 минуту). |
started |
Type: number Началось выполнение задачи. |
400 Bad Request
Недопустимый или пустой JSON в теле POST-запроса.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Описание ошибки. |
error_2_error
Описание ошибки.
Name |
Description |
message* |
Type: string Сообщение с описанием ошибки. |
incident_id |
Type: string Уникальный идентификатор инцидента c ошибкой. При ошибке API этот идентификатор может использоваться при анализе проблем. |
401 Unauthorized
Отсутствует API-ключ.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Описание ошибки. |
429 Too Many Requests
Слишком много запросов.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Описание ошибки. |
500 Internal Server Error
Ошибка сервера при обработке запроса.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Описание ошибки. |
503 Service Unavailable
Недостаточно ресурсов для выполнения задачи.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Описание ошибки. |