Добавляет задачу

Создает новую MVRP-задачу. Используйте "GET /api/v1/vrs/result/mvrp/<task_id>", чтобы получить статус задачи.

Request

POST

https://courier.yandex.ru/api/v1/vrs/add/mvrp

Query parameters

Name	Description
company_id	Type: integer Идентификатор компании, к которой относится задача.
lang	Type: string Локаль ответа в формате RFC-3066.
parent_task_id	Type: string Идентификатор родительской задачи.
taxi_types	Type: string<list_of_taxi_types> Список типов такси, использующихся для маршрутизации, через запятую (напр. `van,lcv_m`). Доступные типы такси: `van`, `lcv_m`, `lcv_l`, `express`, `courier`.

Body

application/json

{
    "depot": {
        "id": 0,
        "preset_id": "string",
        "ref": "string",
        "point": {
            "lat": 0,
            "lon": 0
        },
        "service_duration_s": 0,
        "hard_window": false,
        "title": "string",
        "description": "string",
        "address": "string",
        "time_window": "string",
        "hard_time_window": "string",
        "time_windows": [
            {
                "time_window": "string",
                "hard_time_window": "string"
            }
        ],
        "type": "depot",
        "flexible_start_time": false,
        "crossdock_safety_waiting_duration_s": 3600,
        "finish_service_duration_s": 0,
        "preliminary_service_duration_s": 0,
        "time_windows_loading": {
            "time_window": "string",
            "hard_time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ]
        },
        "time_windows_refilling": {
            "time_window": "string",
            "hard_time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ]
        },
        "time_windows_unloading": {
            "time_window": "string",
            "hard_time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ]
        },
        "package_throughput": {
            "kg_per_hour": 0,
            "units_per_hour": 0
        },
        "throughput": {
            "kg_per_hour": 0,
            "units_per_hour": 0,
            "vehicle_count": [
                {
                    "time_window": "string",
                    "value": 0
                }
            ]
        },
        "penalty": {
            "package_throughput": {
                "fixed": 1000,
                "kg": 50,
                "unit": 100
            },
            "throughput": {
                "fixed": 1000,
                "kg": 50,
                "unit": 100,
                "vehicle": 100000
            },
            "late": {
                "fixed": 1000,
                "minute": 17
            },
            "early": {
                "fixed": 1000,
                "minute": 17
            },
            "out_of_time": {
                "fixed": 1000,
                "minute": 17
            }
        }
    },
    "locations": [
        {
            "id": 0,
            "ref": "string",
            "preset_id": "string",
            "point": {
                "lat": 0,
                "lon": 0
            },
            "service_duration_s": 0,
            "hard_window": false,
            "title": "string",
            "description": "string",
            "address": "string",
            "time_window": "string",
            "hard_time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ],
            "shared_service_duration_s": 0,
            "client_service_duration_s": 0,
            "parking_service_duration_s": 0,
            "depot_duration_s": 0,
            "crossdock_service_duration_s": 0,
            "required_tags": [
                "string"
            ],
            "optional_tags": [
                {
                    "tag": "string",
                    "value": 0
                }
            ],
            "load_types": [
                "string"
            ],
            "type": "depot",
            "crossdock_mode": "deny",
            "may_drop_in_crossdock": true,
            "client_id": 0,
            "delivery_to": 0,
            "delivery_to_any": [
                0,
                "string"
            ],
            "phone": "string",
            "shared_with_company_ids": [
                0
            ],
            "depot_ready_time": "string",
            "depot_expiring_time": "string",
            "delivery_deadline": "string",
            "comments": "string",
            "use_in_proximity": true,
            "allow_trailers": false,
            "max_total_vehicles": 0,
            "sequence_order": 0,
            "in_lifo_order": false,
            "pickup_from_any": false,
            "depot_id": [
                0,
                "string"
            ],
            "custom_value": 0,
            "transit_time": {
                "hard_limit_s": 0,
                "limit_s": 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
            },
            "penalty": {
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                }
            }
        }
    ],
    "zones": [
        {
            "id": "string",
            "geometry": {
                "coordinates": [
                    [
                        [
                            0
                        ]
                    ]
                ],
                "type": "string"
            }
        }
    ],
    "options": {
        "preset_id": "string",
        "quality": "low",
        "date": "string",
        "time_zone": 0,
        "absolute_time": false,
        "routing_mode": "driving",
        "weighted_drop_penalty": false,
        "restart_on_drop": false,
        "minimize_lateness_risk": false,
        "penalize_late_service": false,
        "ignore_min_stops_for_unused": false,
        "ignore_zones": false,
        "post_optimization": false,
        "load_when_ready": false,
        "critical_lateness_risk_probability": 20,
        "matrix_router": "main",
        "incompatible_load_types": [
            [
                "string"
            ]
        ],
        "incompatible_zones": [
            [
                "string"
            ]
        ],
        "proximity_factor": 0,
        "global_proximity_factor": 0,
        "max_drop_penalty_percentage": 100,
        "merge_multiorders": false,
        "wait_in_multiorders": true,
        "balanced_groups": [
            {
                "id": "string",
                "penalty": {
                    "late": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "early": {
                        "fixed": 1000,
                        "minute": 17
                    }
                }
            }
        ],
        "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
                        }
                    ]
                },
                "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
                    }
                },
                "point": {
                    "lat": 0,
                    "lon": 0
                }
            }
        ],
        "location_groups": [
            {
                "location_ids": [
                    0,
                    "string"
                ],
                "title": "string",
                "solid": false,
                "dependent": false
            }
        ],
        "avoid_tolls": false,
        "fix_planned_shifts": false,
        "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"
            }
        ],
        "enable_vehicle_classes": true,
        "close_locations_during_post_optimization_only": false,
        "penalty": {
            "multiorders": {
                "per_extra_point": 0,
                "per_extra_vehicle": 0,
                "per_extra_visit": 0
            },
            "drop_penalty_percentage": {
                "fixed": 1000,
                "per_percent": 50
            }
        }
    },
    "vehicles": [
        {
            "id": 0,
            "preset_id": "string",
            "depot_id": [
                0,
                "string"
            ],
            "starting_depot_id": [
                0,
                "string"
            ],
            "ending_depot_id": [
                0,
                "string"
            ],
            "middle_depot_id": [
                0,
                "string"
            ],
            "cost": {
                "fixed": 3000,
                "hour": 100,
                "km": 8,
                "location": 0,
                "run": 0,
                "tonne_km": 0,
                "waiting_hour": 0
            },
            "ref": "string",
            "visited_locations": [
                {
                    "id": 0,
                    "shift_id": "string",
                    "wait_if_early": true,
                    "delivered_orders": [
                        0,
                        "string"
                    ],
                    "picked_orders": [
                        0,
                        "string"
                    ],
                    "is_middle_depot": false,
                    "anchor_mode": "Decoupling",
                    "time": "string"
                }
            ],
            "fixed_work_breaks": [
                {
                    "work_duration_s": 0,
                    "shift_id": "string"
                }
            ],
            "tags": [
                "string"
            ],
            "excluded_tags": [
                "string"
            ],
            "allowed_zones": [
                "string"
            ],
            "forbidden_zones": [
                "string"
            ],
            "incompatible_load_types": [
                [
                    "string"
                ]
            ],
            "crossdock_mode": "deny",
            "visit_depot_at_start": true,
            "allow_different_depots_in_route": false,
            "return_to_depot": true,
            "start_at": 0,
            "finish_at": 0,
            "global_proximity_attraction_point": 0,
            "shifts": [
                {
                    "id": "string",
                    "preset_id": "string",
                    "balanced_group_id": "string",
                    "time_window": "string",
                    "hard_time_window": "string",
                    "max_duration_s": 172800,
                    "hard_max_duration_s": 2592000,
                    "max_mileage_km": 0,
                    "hard_window": false,
                    "service_duration_s": 0,
                    "minimal_stops": 0,
                    "minimal_unique_stops": 0,
                    "maximal_stops": 0,
                    "max_runs": 1,
                    "penalty": {
                        "late": {
                            "fixed": 1000,
                            "minute": 17
                        },
                        "early": {
                            "fixed": 1000,
                            "minute": 17
                        }
                    }
                }
            ],
            "travel_time_multiplier": 1,
            "service_duration_multiplier": 1,
            "shared_service_duration_multiplier": 1,
            "depot_extra_service_duration_s": 0,
            "max_runs": 1,
            "max_middle_depots": 1,
            "routing_mode": "driving",
            "imei": 0,
            "phone": "string",
            "rest_schedule_id": "string",
            "fixed_planned_route": false,
            "min_stop_weight": 0,
            "close_locations": [
                {
                    "routing_mode": "driving",
                    "search_radius_m": 0,
                    "soft_search_radius_m": 0,
                    "duration_till_service_s": {
                        "value": 1000000000,
                        "penalty": 0
                    },
                    "distance_till_service_m": {
                        "value": 1000000000,
                        "penalty": 0
                    }
                }
            ],
            "walking_courier": {
                "restrictions": {
                    "max_walking_edge_distance_m": {
                        "value": 1000000000,
                        "penalty": 0
                    }
                },
                "cost": {
                    "hour": 0,
                    "km": 0
                },
                "capacity": {
                    "units": 1000000000
                }
            },
            "penalty": {
                "throughput": {
                    "fixed": 1000,
                    "kg": 50,
                    "unit": 100,
                    "vehicle": 100000
                }
            },
            "trailer": {
                "decoupling_time_s": 0,
                "coupling_time_s": 0,
                "rolling_cost": 0,
                "rolling_time": {
                    "fixed_time_s": 0,
                    "s_per_kg": 0,
                    "s_per_m3": 0,
                    "s_per_unit": 0
                },
                "cost": {
                    "fixed": 3000,
                    "hour": 100,
                    "km": 8,
                    "location": 0,
                    "run": 0,
                    "tonne_km": 0,
                    "waiting_hour": 0
                },
                "max_capacity_difference": {
                    "units": 0,
                    "volume_cbm": 0,
                    "weight_kg": 0,
                    "custom": 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
                }
            },
            "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
                            }
                        }
                    }
                ]
            },
            "specs": {
                "height": 0,
                "width": 0,
                "length": 0,
                "max_weight": 0,
                "max_weight_kg": 0
            },
            "planned_route": {
                "start_time": "string",
                "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
                    }
                ],
                "work_breaks": [
                    {
                        "shift_id": "string",
                        "work_duration_s": 0
                    }
                ],
                "planned_runs_first": false
            },
            "capacity": {
                "weight_kg": 1000000000,
                "units": 1000000000,
                "custom": 0,
                "volume": {
                    "depth_m": 1000,
                    "height_m": 1000,
                    "width_m": 1000
                },
                "limits": {
                    "units_perc": 100,
                    "volume_perc": 100,
                    "weight_perc": 100
                }
            }
        }
    ],
    "depots": [
        {
            "id": 0,
            "preset_id": "string",
            "ref": "string",
            "point": {
                "lat": 0,
                "lon": 0
            },
            "service_duration_s": 0,
            "hard_window": false,
            "title": "string",
            "description": "string",
            "address": "string",
            "time_window": "string",
            "hard_time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ],
            "type": "depot",
            "flexible_start_time": false,
            "crossdock_safety_waiting_duration_s": 3600,
            "finish_service_duration_s": 0,
            "preliminary_service_duration_s": 0,
            "time_windows_loading": {
                "time_window": "string",
                "hard_time_window": "string",
                "time_windows": [
                    {
                        "hard_time_window": "string",
                        "time_window": "string"
                    }
                ]
            },
            "time_windows_refilling": {
                "time_window": "string",
                "hard_time_window": "string",
                "time_windows": [
                    {
                        "hard_time_window": "string",
                        "time_window": "string"
                    }
                ]
            },
            "time_windows_unloading": {
                "time_window": "string",
                "hard_time_window": "string",
                "time_windows": [
                    {
                        "hard_time_window": "string",
                        "time_window": "string"
                    }
                ]
            },
            "package_throughput": {
                "kg_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "units_per_hour": [
                    {
                        "time_window": "string",
                        "value": 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
                    }
                ]
            },
            "penalty": {
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                }
            }
        }
    ]
}

Name	Description
locations*	Type: mvrp_request_locations_item[] Список пунктов назначения. Пункт назначения заказа, отправляемого со склада. Min items: `1`
options*	Type: solver_options_mvrp Параметры Сервиса планирования маршрутов. Запрещается указывать параметры, отсутствующие в списке.
vehicles*	Type: mvrp_request_vehicles_item[] Список транспортных средств, доступных для планирования маршрута. Спецификация транспортного средства. Min items: `1`
depot	Type: depot_location По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.
depots	Type: mvrp_request_depots_item[] Список складов. Поля `depot` и `depots` — взаимоисключающие. Подробнее По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.
zones	Type: mvrp_request_zones_item[]

mvrp_request_locations_item

Пункт назначения заказа, отправляемого со склада.

Name	Description
point*	Type: coordinate Координаты пункта назначения в формате WGS84. Подробнее
address	Type: string Адрес локации.
allow_trailers	Type: boolean При значении `true` автомобили с прицепами смогут посещать этот пункт назначения. Иначе они будут должны оставить прицеп на якорной локации перед тем, как обслуживать эту. [Подробнее](https://yandex.ru/routing/doc/vrp/concepts/properties-of-vehicles.html?lang=ru#coupling
client_id	Type: integer or string Определяет идентификатор (id) клиента, к которому относится локация.
client_service_duration_s	Type: number Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место. Max value: `3153600000`
comments	Type: string Комментарии.
crossdock_mode	Type: string Определяет, разрешено ли доставлять этот заказ через кросс-док склад. `deny` — запрещено, можно доставлять только из обычного склада; `allow` — разрешено, можно доставлять как напрямую из обычного склада, так и через кросс-док склад; `mandatory` — обязательно, можно доставлять только через кросс-док склад. Default: `allow` Enum: `deny`, `allow`, `mandatory`
crossdock_service_duration_s	Type: number Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее Max value: `3153600000`
custom_value	Type: number Дополнительный числовой атрибут локации (Например, вознаграждение курьера за посещение этой локации). Может быть использовано как компонент в расчёте стоимости маршрута.
delivery_deadline	Type: string Время, до которого заказ из места погрузки (`pickup`) без указанного поля `delivery_to` должен быть доставлен до любого склада, в формате `[D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00`, `2018-09-06T10:15:00Z`. Подробнее
delivery_to	Type: integer or string Определяет идентификатор (id) пункта назначения. Подробнее
delivery_to_any	Type: (integer or string)[] Список идентификаторов пунктов выдачи (`drop_off`). Из заданного места погрузки (`pickup`) отправление должно быть доставлено в любой из этих пунктов выдачи. Подробнее Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
depot_duration_s	Type: number Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее Max value: `3153600000`
depot_expiring_time	Type: string Время, не позднее которого заказ необходимо забрать со склада, в формате `[D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00`, `2018-09-06T10:15:00Z`
depot_id	Type: integer or string or array
depot_ready_time	Type: string Время, начиная с которого заказ можно будет забрать с любого склада, в формате `[D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00`, `2018-09-06T10:15:00Z`. Подробнее
description	Type: string Описание пункта назначения.
hard_time_window	Type: string Разрешенное жесткое окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Жесткое окно должно включать в себя соответствующий временной промежуток из поля `time_window`. Поля `hard_time_window` и `hard_window` — взаимоисключающие. Подробнее
hard_window	Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. Если пункт не может быть посещен в указанное временное окно, он будет исключен из маршрута и добавлен в поле ответа `dropped_orders`. Это поле полезно для моделирования заказов, которые не могут быть выполнены без нарушения временного окна, например, из-за конфликта с другими заказами. Подробнее
id	Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее
in_lifo_order	Type: boolean Заказы, у которых это поле имеет значение `true`, не могут быть переставлены внутри машины и должны быть доставлены в порядке, обратном порядку загрузки. Пункты назначения, у которых это поле имеет значение `false`, могут быть в любом месте маршрута. Это поле влияет только на маршруты, в которых присутствуют заказы типов `pickup` и `delivery` одновременно. Подробнее
load_types	Type: string[] Определяет типы грузов в данном пункте назначения. Недопустимы для локаций с типом `garage`. Тип груза.
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 Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения `walking` или `transit` данное время не будет затрачиваться. Если локация была выбрана в качестве парковки для пешеходной части, то данное время будет единожды затрачено перед началом части. Max value: `3153600000`
penalty	Type: items_penalty_7 Штрафы, применяемые за нарушения условий перерывов в работе.
phone	Type: string Номер телефона получателя при доставке.
pickup_from_any	Type: boolean Delivery-заказы, у которых это поле имеет значение `true`, должны иметь несколько связанных с ним pickup-заказов. Для доставки может быть выбран любой один из этих pickup-заказов, а остальные будут проигнорированы. Выбор среди вариантов осуществляется с учетом оптимизации стоимости маршрута. Подробнее
preset_id	Type: string Идентификатор пресета (preset.number из reference-book) для свойств пункта назначения.
ref	Type: string Сноска с информацией о месте.
required_tags	Type: string[] Список тегов, которые должны быть у автомобиля, обслуживающего данный пункт назначения. Подробнее Произвольный тег.
sequence_order	Type: integer Все локации в маршруте транспортного средства, у которых указана данная опция, должны быть посещены в порядке неубывания ее значений. Подробнее
service_duration_s	Type: number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее Max value: `3153600000`
shared_service_duration_s	Type: number Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее Max value: `3153600000`
shared_with_company_ids	Type: integer[] ID компаний, которые могут получить доступ к информации о заказе.
shipment_size	Type: items_shipment_size Размер отправления (метрические размеры и/или вес). Подробнее
time_window	Type: string Разрешенное окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Подробнее
time_windows	Type: items_time_windows_item_1[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля `time_window` и `time_windows` — взаимоисключающие. Соответствующее дочернее поле `hard_time_window` должно быть определено для всех `time_window`, либо ни для одного из них. Подробнее
title	Type: string Название места.
transit_time	Type: items_transit_time Ограничение на время нахождения заказа на борту
type	Type: string Определяет тип обслуживания в пункте назначения: `delivery`, `pickup` или `drop_off`. `delivery` — осуществляется доставка в пункт назначения. `pickup` — осуществляется погрузка для доставки в другой пункт назначения (если указано `delivery_to`) или в `depot`. `drop_off` — груз из `pickup` может быть доставлен в любую из точек `drop_off` (см. `delivery_to_any`). `garage` — место, которое может быть указано как начальная или конечная точка маршрута с помощью свойств `start_at` и `finish_at` у `vehicle`. `anchor` — якорная локация, на которой можно оставить прицеп и перенести груз в голову. `parking` — место, где можно оставить прицеп, чтобы посетить одну другую локацию. На этих локациях нельзя разгружать прицепы. Подробнее Default: `delivery` Enum: `depot`, `crossdock`, `delivery`, `pickup`, `drop_off`, `garage`, `anchor`, `parking`
use_in_proximity	Type: boolean При значении `false` этот пункт назначения не будет учитываться при подсчете proximity и global proximity. Подробнее Default:

solver_options_mvrp

Параметры Сервиса планирования маршрутов. Запрещается указывать параметры, отсутствующие в списке.

Name	Description
time_zone*	Type: number or string
absolute_time	Type: boolean Использование формата ISO 8601 (YYYY-MM-DDTHH: MM:SS+HH: MM) для отображения параметра `time_window` в результате.
avoid_tolls	Type: boolean Не использовать платные дороги, если это возможно (только для режимов `driving` и `truck`). Подробнее
balanced_groups	Type: solver_options_mvrp_balanced_groups_item[] Каждый элемент в этом массиве определяет группу балансировки маршрутов. Каждый маршрут в группе соответствует одной смене транспортного средства. Смены связаны с группами полем `balanced_group_id`. Маршруты сбалансированы по метрикам `total_duration_s` и/или `total_stops` в зависимости от установленных штрафов. Подробнее Группа сбалансированных маршрутов.
close_locations_during_post_optimization_only	Type: boolean Применять штрафы, определенные в поле `close_locations`, только в процессе дооптимизации. При значении `true` дооптимизация должна быть включена.
critical_lateness_risk_probability	Type: number Если вероятность опоздания в пункт назначения больше или равна указанному значению, то пункт назначения учитывается в параметре `lateness_risk_locations_count`. Вероятность задается в процентах. Default: `20` Min value: `1` Max value: `50`
date	Type: string Начальная дата для всех маршрутов (в формате `ГГГГ-ММ-ДД`), по умолчанию равна текущей дате. Подробнее
enable_vehicle_classes	Type: boolean При значении `true` солвер будет классифицировать транспортные средства на основе их характеристик, чтобы использовать более точные расстояния между локациями. Можно выставить поле в `false` для уменьшения размера задачи при ошибке "The task is too big". Default:
fix_planned_shifts	Type: boolean Фиксировать смены локаций из запланированных маршрутов.
global_proximity_factor	Type: number Степень влияния близости пунктов назначения на маршруты транспортных средств. Рекомендуемый диапазон значений: от `0.0` до `1.0`. При использовании этой опции локации будут ближе к последней локации в маршруте. При использовании `proximity_factor` и `global_proximity_factor` маршруты будут более устойчивы к переносам заказов в конец маршрута. Обратите внимание, что использование фактора близости снизит оптимальность вычисляемых маршрутов с точки зрения затрат и штрафов. Подробнее Max value: `10`
ignore_min_stops_for_unused	Type: boolean Не учитывать опцию `minimal_stops` для неиспользуемых машин. Подробнее
ignore_zones	Type: boolean Не учитывать опции, связанные с зонами, в машинах и заказах. Подробнее
incompatible_load_types	Type: string[][] Каждый элемент в этом массиве определяет список типов грузов, которые не должны попадать в один рейс транспортного средства. Подробнее Список типов грузов. Тип груза.
incompatible_zones	Type: string[][] Каждый элемент в этом массиве определяет список зон, которые не должны посещаться в одном рейсе транспортного средства. Подробнее Список зон. Номер зоны.
load_when_ready	Type: boolean Начинать погрузку заказов на склад по мере готовности (в порядке `depot_ready_time`). Подробнее
location_groups	Type: solver_options_mvrp_location_groups_item[] Каждый элемент этого массива определяет группу точек доставки, которая должна быть назначена в одну смену. Некоторые локации из группы могут быть отброшены. Пункт назначения может входить только в одну группу. Подробнее Группа точек доставки, которая должна быть назначена в одну смену.
matrix_router	Type: string Матричный роутер, использующийся для планирования маршрута `main` — рекомендуется использовать для России, СНГ и Турции. `global` — для остальных стран. `geodesic` — расстояния считаются напрямую без учета пробок. `auto` — автоматический выбор роутера на основе локации склада. Default: `main` Enum: `main`, `geodesic`, `global`, `auto`
max_drop_penalty_percentage	Type: number Максимальная доля штрафов за недоставку заказов от суммы шрафов по всем заказам. Подробнее Default: `100` Max value: `100`
merge_multiorders	Type: boolean По возможности объединять заказы, имеющие одинаковые координаты и обслуживать их одним транспортным средством. Подробнее
minimize_lateness_risk	Type: boolean Минимизировать вероятности опозданий, т.е. избегать таких маршрутов, где предполагаемое время прибытия близко к концу временного окна. Подробнее
penalize_late_service	Type: boolean Эта опция определяет, нужно ли штрафовать за позднее прибытие на объект или позднее окончание обслуживания. При значении `false` штрафы начисляются при позднем прибытии на объект или позднем старте со склада (т.е. после окончания выбранного временного окна). При обслуживании мультизаказов для каждого подзаказа учитывается начало обслуживания всего мультизаказа, а не этого подзаказа. При значении `true` штрафы начисляются при позднем завершении обслуживания объекта, склада или смены (т.е. после окончания выбранного временного окна). В большинстве случаев включение этой опции эквивалентно сокращению всех временных окон складов, объектов и смен на соответствующее время обслуживания. Тем не менее, механика меняется в случае,если время обслуживания в точке не определено наперёд: например, в случае мультизаказов или разгрузке нескольких заказов на складе. Рекомендуется включать эту опцию в случае, если для мультизаказов важнее вовремя обслужить каждый подзаказ, чем вовремя прибыть на точку мультизаказа. Подробнее
penalty	Type: solver_options_mvrp_penalty Штрафы за несоблюдение ограничений на все решение.
points_throughputs	Type: solver_options_mvrp_points_throughputs_item[] Каждый элемент этого массива определяет пропускную способность. точки Пропускная способность точки.
post_optimization	Type: boolean Использовать дооптимизацию: перезапустить алгоритм на последних 10% итераций без учета global proximity и балансировок. Подробнее
preset_id	Type: string Идентификатор пресета (preset.number из reference-book) для опций задачи.
proximity_factor	Type: number Степень влияния близости пунктов назначения на маршруты транспортных средств. Рекомендуемый диапазон значений: от `0.0` до `1.0`. При использовании этой опции маршруты будут более устойчивы к пропускам заказов. Обратите внимание, что использование фактора близости снизит оптимальность вычисляемых маршрутов с точки зрения затрат и штрафов. Подробнее Max value: `10`
quality	Type: string Качество решения: `low` — отладочный режим для разработки и проверки ограничений, небольшое время выполнения; `normal` — базовое качество решения, среднее время выполнения; `high` — максимально возможное качество, большое время выполнения. Обязательное поле. Default: `normal` Enum: `low`, `normal`, `high`
restart_on_drop	Type: boolean Перезапуск задачи для выполнения оптимизации только среди не отброшенных заказов в случае, если решения без отбрасывания заказов найти не удалось. Данный параметр следует активировать в том случае, если отказ от заказов допустим и приемлем для вашего бизнес-сценария.
routing_mode	Type: string Способ передвижения. Подробнее `driving` — режим по умолчанию, маршрутизация с профилем автомобиля; `truck` — маршрутизация с профилем грузовика; `walking` — маршрут с пешеходным профилем, только на дорогах, разрешенных для пешеходного движения.; `transit` — маршрут с пешеходным профилем в сочетании с общественным транспортом; `bicycle` - маршрут с профилем велосипеда. Подробнее Default: `driving` Enum: `driving`, `truck`, `walking`, `transit`, `bicycle`
template_rest_schedules	Type: solver_options_mvrp_template_rest_schedules_item[] Список шаблонов расписания перерывов. Подробнее Шаблон расписания перерывов на отдых.
wait_in_multiorders	Type: boolean Разрешает ожидание в мультизаказах. Подробнее Default:
weighted_drop_penalty	Type: boolean Вычисление штрафа за отказ от доставки заказа в зависимости от веса и объема груза. Это бывает полезно для оптимизации при высокой загрузке транспортных средств. Прописанные штрафы за отказ от точек доставки в таком случае игнорируются. Подробнее

mvrp_request_vehicles_item

Спецификация транспортного средства.

Name	Description
id*	Type: integer or string Идентификатор транспортного средства. Все идентификаторы транспортных средств в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее
allow_different_depots_in_route	Type: boolean Транспортное средство может посещать несколько складов с различными идентификаторами в пределах одного маршрута
allowed_zones	Type: string[] Список зон, которые может посещать траспортное средство. Подробнее Номер зоны.
capacity	Type: items_capacity Вместимость транспортного средства. Подробнее
close_locations	Type: items_close_locations_item[]
cost	Type: cost_0 or string
crossdock_mode	Type: string Определяет, разрешено ли этой машине доставлять заказы до кросс-док склада. Подробнее `deny` — запрещено, может доставлять только до локаций; `allow` — разрешено, может доставлять как напрямую до локаций, так и до кросс-док склада; `mandatory` — обязательно, может доставлять только до кросс-док склада. Default: `allow` Enum: `deny`, `allow`, `mandatory`
depot_extra_service_duration_s	Type: number Дополнительное время, необходимое для загрузки данного а/м на складе. Max value: `3153600000`
depot_id	Type: integer or string or array
ending_depot_id	Type: integer or string or array
excluded_tags	Type: string[] Список тегов транспортного средства, несовместимых с тегами пункта назначения (используются регулярные выражения расширенного POSIX стандарта). Подробнее Произвольный тег или регулярное выражение расширенного POSIX стандарта.
finish_at	Type: integer or string Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
fixed_planned_route	Type: boolean Если установлено в `true`, то маршрут, указанный в поле `planned_route` будет использован без изменений. Подробнее
fixed_work_breaks	Type: items_fixed_work_breaks_item[] Данный список устанавливает продолжительность работы перед каждым перерывом на отдых для нескольких первых перерывов в каждой смене (или во всём маршруте, если смены отсутствуют). Если для транспортного средства предусмотрен список смен (см. параметр `shifts`), то необходимо указать допустимое значение `shift_id` для каждого указанного перерыва на отдых. В первую очередь эта опция предусмотрена для комбинирования с `visited_locations`, поскольку с её помощью можно описывать длительности перерывов между пунктами назначения, зафиксированными в начале пути или смены; однако эти две опции могут использоваться независимо друг от друга.
forbidden_zones	Type: string[] Список зон, которые не может посещать траспортное средство. Подробнее Номер зоны.
global_proximity_attraction_point	Type: integer or string Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
imei	Type: integer Номер GPS-трекера.
incompatible_load_types	Type: string[][] Каждый элемент в этом массиве определяет список типов грузов, которые не должны попадать в один рейс транспортного средства (перезаписывает значение `incompatible_load_types`, указанное в `options`). Подробнее Список типов грузов. Тип груза.
max_middle_depots	Type: integer Максимальное количество промежуточных (не заканчивающих заезд) складов в маршруте Default: `1`
max_runs	Type: integer Максимальное количество рейсов транспортного средства во всех сменах за день. Подробнее Default: `1`
middle_depot_id	Type: integer or string or array
min_stop_weight	Type: number Минимальный суммарный вес всех заказов в одной точке. Подробнее
penalty	Type: items_penalty_4
phone	Type: string Номер телефона курьера.
planned_route	Type: items_planned_route Заранее запланированные пункты назначения для данного транспортного средства. Эти пункты назначения не будут отброшены даже при нарушении строгих ограничений и будут обслужены в любом случае. Указанный в этом параметре порядок пунктов назначения, может быть изменен для оптимизации окончательного маршрута. По умолчанию смены, назначенные запланированным локациям тоже могут измениться. Они могут быть зафиксированны с помощью опции солвера `fix_planned_shifts`. Подробнее
preset_id	Type: string Идентификатор пресета (preset.number из reference-book) для свойств транспортного средства.
ref	Type: string Референсный номер автомобиля.
rest_schedule	Type: items_rest_schedule Расписание перерывов на отдых. Подробнее
rest_schedule_id	Type: string Идентификатор шаблона расписания перерывов, использующегося этим автомобилем.
return_to_depot	Type: boolean Если установлено в `true`, то транспортное средство вернется на склад после последнего пункта назначения. Когда этот параметр установлен в `false` и не указан параметр `finish_at`, последний рейс и смена заканчиваются в последнем пункте назначения маршрута. Когда установлен в `true` и использовван параметр `finish_at`, последний рейс проходит через склад в конце маршрута и завершается вместе со сменой в гараже, указанном в параметре `finish_at`. Default:
routing_mode	Type: string Способ передвижения. Если присутствует, переопределяет `routing_mode`, указанный в параметрах запроса. Подробнее `driving` — режим по умолчанию, маршрутизация с профилем автомобиля; `truck` — маршрутизация с профилем грузовика; `walking` — маршрут с пешеходным профилем, только на дорогах, разрешенных для пешеходного движения.; `transit` - маршрут с пешеходным профилем в сочетании с общественным транспортом; `bicycle` - маршрут с профилем велосипеда. Enum: `driving`, `truck`, `walking`, `transit`, `bicycle`
service_duration_multiplier	Type: number Коэффициент корректировки времени обслуживания для медленных или быстрых рабочих. Подробнее Default: `1` Min value: `0.001`
shared_service_duration_multiplier	Type: number Коэффициент корректировки общего времени обслуживания для медленных или быстрых рабочих. Подробнее Default: `1` Min value: `0.001`
shifts	Type: items_shifts_item[] Список транспортных смен. Подробнее Транспортная смена.
specs	Type: items_specs Характеристики транспортного средства. Подробнее
start_at	Type: integer or string Определяет `id` местоположения с типом `garage`, в котором транспортное средство начнет свой первый рейс и смену. Подробнее
starting_depot_id	Type: integer or string or array
tags	Type: string[] Список тегов транспортного средства, совместимых с тегами пункта назначения (используются регулярные выражения расширенного POSIX стандарта). Подробнее Произвольный тег или регулярное выражение расширенного POSIX стандарта.
trailer	Type: items_trailer Спецификация прицепа. Подробнее
travel_time_multiplier	Type: number Коэффициент корректировки времени поездки, используется для быстрых или медленных транспортных средств. Подробнее Default: `1` Min value: `0.001`
visit_depot_at_start	Type: boolean Если установлено в `true`, то первый маршрут транспортного средства обязательно проходит через склад в начале рейса. Может быть установлено в `false` только в случае, если у этой же машины использован параметр `start_at`, который определяет начальную точку маршрута, отличную от склада. Подробнее Возможны четыре варианта указать начало первого маршрута машины используя опции `start_at` и `visit_depot_at_start`: `start_at` указана, `visit_depot_at_start`=`true`: `garage` -> `depot` -> location; `start_at` указана, `visit_depot_at_start`=`false`: `garage` -> locations; `start_at` не задана, `visit_depot_at_start`=`true`: `depot` -> locations; `start_at` не задана, `visit_depot_at_start`=`false`: locations. Default:
visited_locations	Type: items_visited_locations_item[] Список пунктов назначения, которые должны быть посещены транспортным средством в строго определенном порядке. Это фиксированная часть маршрута без учета оптимизации, при этом дополнительно может указываться время отправления из некоторых пунктов назначения. Если необходимо также указать точное расписание перерывов на отдых во время посещения этих пунктов назначения, используйте параметр транспортного средства `fixed_work_breaks`.Подробнее
walking_courier	Type: items_walking_courier Описание курьера-пешехода.

depot_location

По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.

Name	Description
point*	Type: coordinate Координаты пункта назначения в формате WGS84. Подробнее
address	Type: string Адрес локации.
crossdock_safety_waiting_duration_s	Type: number Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы. Default: `3600` Max value: `3153600000`
description	Type: string Описание пункта назначения.
finish_service_duration_s	Type: number Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее Max value: `3153600000`
flexible_start_time	Type: boolean По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в `true`, транспортное средство может начать работу раньше или позже времени по умолчанию. В этом случае будет выбрано такое время начала работы транспортного средства, которое будет оптимальным с точки зрения минимизации затрат. Подробнее Кроме того, при использовании параметра `flexible_start_time` могут сформироваться маршруты, в которых время прибытия практически совпадет с окончанием временного окна. Такого рода маршруты, как правило, нежелательны из-за риска опоздания в пункт назначения. Во избежание таких маршрутов рекомендуется использовать параметр `minimize_lateness_risk` и/или `penalize_late_service` совместно с `flexible_start_time`.
hard_time_window	Type: string Разрешенное жесткое окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Жесткое окно должно включать в себя соответствующий временной промежуток из поля `time_window`. Поля `hard_time_window` и `hard_window` — взаимоисключающие. Подробнее
hard_window	Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее
id	Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее
package_throughput	Type: depot_location_package_throughput Ограничение на скорость упаковки заказов на складе.
penalty	Type: depot_location_penalty Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее
preliminary_service_duration_s	Type: number Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления `depot_ready_time` грузов, погруженных на этот автомобиль. Подробнее Max value: `3153600000`
preset_id	Type: string Идентификатор пресета (preset.number из reference-book) для свойств склада.
ref	Type: string Сноска с информацией о месте.
service_duration_s	Type: number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее Max value: `3153600000`
throughput	Type: depot_location_throughput Пропускная способность склада. Подробнее
time_window	Type: string Разрешенное окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Подробнее
time_windows	Type: depot_location_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля `time_window` и `time_windows` — взаимоисключающие. Соответствующее дочернее поле `hard_time_window` должно быть определено для всех `time_window`, либо ни для одного из них. Подробнее
time_windows_loading	Type: any Временные окна, в которые машина может выехать со склада на первый заезд
time_windows_refilling	Type: any Временные окна, в которые машина может заехать на склад (или промежуточный склад) для дозагрузки
time_windows_unloading	Type: any Временные окна, в которые машина может вернуться на склад после последнего заезда
title	Type: string Название места.
type	Type: string Определяет тип склада: `depot` или `crossdock`. `depot` — основной склад, на котором хранятся заказы. `crossdock` — дополнительный склад, на котором изначально заказов нет. Чтобы доставлять заказы с этого склада, другая машина должна сначала привезти их из основного склада, на котором они хранятся. Default: `depot` Enum: `depot`, `crossdock`

mvrp_request_depots_item

По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.

Name	Description
point*	Type: coordinate Координаты пункта назначения в формате WGS84. Подробнее
address	Type: string Адрес локации.
crossdock_safety_waiting_duration_s	Type: number Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы. Default: `3600` Max value: `3153600000`
description	Type: string Описание пункта назначения.
finish_service_duration_s	Type: number Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее Max value: `3153600000`
flexible_start_time	Type: boolean По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в `true`, транспортное средство может начать работу раньше или позже времени по умолчанию. В этом случае будет выбрано такое время начала работы транспортного средства, которое будет оптимальным с точки зрения минимизации затрат. Подробнее Кроме того, при использовании параметра `flexible_start_time` могут сформироваться маршруты, в которых время прибытия практически совпадет с окончанием временного окна. Такого рода маршруты, как правило, нежелательны из-за риска опоздания в пункт назначения. Во избежание таких маршрутов рекомендуется использовать параметр `minimize_lateness_risk` и/или `penalize_late_service` совместно с `flexible_start_time`.
hard_time_window	Type: string Разрешенное жесткое окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Жесткое окно должно включать в себя соответствующий временной промежуток из поля `time_window`. Поля `hard_time_window` и `hard_window` — взаимоисключающие. Подробнее
hard_window	Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее
id	Type: integer or string Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее
package_throughput	Type: items_package_throughput Ограничение на скорость упаковки заказов на складе.
penalty	Type: items_penalty_3 Штрафы, применяемые за нарушения условий перерывов в работе.
preliminary_service_duration_s	Type: number Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления `depot_ready_time` грузов, погруженных на этот автомобиль. Подробнее Max value: `3153600000`
preset_id	Type: string Идентификатор пресета (preset.number из reference-book) для свойств склада.
ref	Type: string Сноска с информацией о месте.
service_duration_s	Type: number Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее Max value: `3153600000`
throughput	Type: items_throughput_1 Пропускная способность склада. Подробнее
time_window	Type: string Разрешенное окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Подробнее
time_windows	Type: items_time_windows_item[] Список разрешенных временных окон. Временные окна не могут пересекаться. Поля `time_window` и `time_windows` — взаимоисключающие. Соответствующее дочернее поле `hard_time_window` должно быть определено для всех `time_window`, либо ни для одного из них. Подробнее
time_windows_loading	Type: any Временные окна, в которые машина может выехать со склада на первый заезд
time_windows_refilling	Type: any Временные окна, в которые машина может заехать на склад (или промежуточный склад) для дозагрузки
time_windows_unloading	Type: any Временные окна, в которые машина может вернуться на склад после последнего заезда
title	Type: string Название места.
type	Type: string Определяет тип склада: `depot` или `crossdock`. `depot` — основной склад, на котором хранятся заказы. `crossdock` — дополнительный склад, на котором изначально заказов нет. Чтобы доставлять заказы с этого склада, другая машина должна сначала привезти их из основного склада, на котором они хранятся. Default: `depot` Enum: `depot`, `crossdock`

mvrp_request_zones_item

Name

Description

geometry*

Type: items_geometry_1

id*

Type: string

Номер зоны

coordinate

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

items_optional_tags_item

Необязательный тег с бонусом или штрафом.

Name

Description

tag*

Type: string

Произвольный тег.

value*

Type: number

Значение тега. Если заказ доставлен автомобилем с соответствующим тегом в поле tags, то это значение будет вычтено из стоимости маршрута. Если соответствующий тег находится в поле excluded_tags, то это значение будет прибавлено к стоимости.

items_penalty_7

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_13

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_13

Составляющие штрафа за поздний перерыв в работе.

items_shipment_size

Размер отправления (метрические размеры и/или вес). Подробнее

Name	Description
custom	Type: number Размер отправления в пользовательских единицах измерения. Размеры в пользовательских единицах задаются в формате `"name": size`, где `name` — строка, обозначающая название единицы, а `size` — неотрицательное вещественное число, обозначающее количество соответствующих единиц в отправлении. Если название единицы присутствует в других объектах (локациях/транспортных средствах/прицепах), но не в этом, то количество этих единиц в отправлении полагается равным нулю. Подробнее
units	Type: number Размер отправления в пользовательских единицах измерения. Max value: `1000000000`
volume	Type: shipment_size_volume Метрические размеры отправления.
volume_cbm	Type: number Явно заданный объем, кубические метры. По умолчанию берется значение из "volume", если тут ничего не указать.
weight_kg	Type: number Вес отправления, кг. Max value: `1000000000`

items_time_windows_item_1

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

items_transit_time

Ограничение на время нахождения заказа на борту

Name

Description

hard_limit_s

Type: number

Жёсткое ограничение, не может быть превышено

Max value: 1000000000

limit_s

Type: number

Мягкое ограничение, превышение допустимо, но ведёт к штрафам

Max value: 1000000000

solver_options_mvrp_balanced_groups_item

Группа сбалансированных маршрутов.

Name

Description

id*

Type: string

Уникальный идентификатор группы балансировки маршрутов.

penalty

Type: items_penalty_2

Штрафы, применяемые за нарушения условий перерывов в работе.

solver_options_mvrp_location_groups_item

Группа точек доставки, которая должна быть назначена в одну смену.

Name	Description
location_ids*	Type: (integer or string)[] Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
dependent	Type: boolean При значении `true` будут обслужены либо все локации из группы, либо ни одна из них.
solid	Type: boolean При значении true все назначенные локации в группе будут обслужены подряд, но их порядок не зафиксирован.
title	Type: string

solver_options_mvrp_penalty

Штрафы за несоблюдение ограничений на все решение.

Name

Description

drop_penalty_percentage

Type: penalty_drop_penalty_percentage

Составляющие штрафа за нарушение max_drop_penalty_percentage.

multiorders

Type: penalty_multiorders

Составляющие штрафа за лишние посешения точек мультизаказов.

solver_options_mvrp_points_throughputs_item

Пропускная способность точки.

Name	Description
penalty	Type: items_penalty_1 Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее
point	Type: items_point Координаты пункта назначения в формате WGS84. Подробнее
throughput	Type: items_throughput Пропускная способность заказа (поддерживается для разделяемых заказов).

solver_options_mvrp_template_rest_schedules_item

Шаблон расписания перерывов на отдых.

Name

Description

breaks*

Type: array

id*

Type: string

Уникальный идентификатор шаблона.

items_capacity

Вместимость транспортного средства. Подробнее

Name	Description
custom	Type: number Количество пользовательских единиц измерения, которое может перевозить транспортное средство. Вместимости в пользовательских единицах задаются в формате `"name": size`, где `name` - строка, обозначающая название единицы, а `size` - неотрицательное вещественное число, обозначающее вместимость автомобиля в соответствующих единицах. Если название единицы присутствует в объектах (локациях/транспортных средствах/прицепах), но не в этом, то вместимость полагается неограниченной.
limits	Type: capacity_limits_1 Пределы загрузки транспортного средства.
units	Type: number Количество пользовательских единиц измерения, которое может перевозить транспортное средство. Default: `1000000000`
volume	Type: capacity_volume_1 Метрические размеры автомобиля.
weight_kg	Type: number Грузоподъемность транспортного средства в килограммах. Default: `1000000000`

items_close_locations_item

Name	Description
distance_till_service_m	Type: any
duration_till_service_s	Type: any
routing_mode	Type: string Способ передвижения для определения близости локаций. Данный параметр допустимо использовать только если в а/м определено свойство walking_courer. В этом случае допустимы значения `walking` и значение основного способа передвижения а/м. Enum: `driving`, `truck`, `walking`, `transit`, `bicycle`
search_radius_m	Type: number Максимальное расстояние между двумя локациями на которые накладывается данное ограничение. Max value: `1000000000`
soft_search_radius_m	Type: number При использовании значении данного параметра больше соответствующего значения параметра `search_radius_m` для локаций на расстояниях от `search_radius_m` до `soft_search_radius_m` значение штрафа линейно снижается вплоть до 0. Max value: `1000000000`

cost_0

Стоимость использования транспортного средства. Подробнее

Name	Description
fixed	Type: number Стоимость за факт использования транспортного средства (стоимость считается затраченной, если транспортное средство поставлено на маршрут). Default: `3000`
hour	Type: number Стоимость за час использования транспортного средства. Данная стоимость не должна быть нулевой или слишком низкой — в противном случае могут быть проложены маршруты, не оптимальные по времени. Default: `100`
km	Type: number Стоимость за километр использования транспортного средства. Данная стоимость не должна быть нулевой или слишком низкой — в противном случае могут быть проложены маршруты, не оптимальные по расстоянию. Default: `8`
location	Type: number Стоимость использования транспортного средства в расчете на один пункт назначения (по умолчанию — 0).
run	Type: number Стоимость за один рейс со склада до пункта назначения.
tonne_km	Type: number Стоимость перевозки одной тонны на один километр (по умолчанию — 0).
waiting_hour	Type: number Стоимость часа ожидания с использованием транспортного средства. Если не указана, то используется значение, заданное в поле `hour`.

items_fixed_work_breaks_item

Name

Description

work_duration_s*

Type: number

Продолжительность непрерывной работы до следующего перерыва на отдых, в секундах.

Max value: 3153600000

shift_id

Type: string

Уникальный идентификатор смены.

items_penalty_4

Name

Description

throughput

Type: penalty_throughput_4

Составляющие штрафа за превышение пропускной способности.

items_planned_route

Заранее запланированные пункты назначения для данного транспортного средства. Эти пункты назначения не будут отброшены даже при нарушении строгих ограничений и будут обслужены в любом случае. Указанный в этом параметре порядок пунктов назначения, может быть изменен для оптимизации окончательного маршрута. По умолчанию смены, назначенные запланированным локациям тоже могут измениться. Они могут быть зафиксированны с помощью опции солвера fix_planned_shifts. Подробнее

Name	Description
locations*	Type: planned_route_locations_item[] Плановый порядок точек доставки в маршруте транспортного средства, включая все смены и доставку в несколько рейсов. Если для транспортного средства предусмотрен список смен (см. параметр `shifts`), то необходимо указать допустимое значение `shift_id` для каждого пункта назначения на маршруте.
planned_runs_first	Type: boolean Необходимо посетить все указанные в `planned_route` склады перед тем, как совершать незапланированные рейсы.
start_time	Type: string Время начала маршрута в формате `[D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00`, `2018-09-06T10:15:00Z`.
work_breaks	Type: planned_route_work_breaks_item[] Спланированные перерывы на отдых в маршруте транспортного средства, включающем все смены и рейсы. Если для транспортного средства предусмотрен список смен (см. параметр `shifts`), то необходимо указать допустимое значение `shift_id` для каждого запланированного перерыва на отдых. Если присутствует список фиксированных перерывов (параметр `fixed_work_break`) и данный список, то при ограничении на любую смену один из них должен быть префиксом другого. Таким образом, переписать фиксированные перерывы спланированными невозможно.

items_rest_schedule

Расписание перерывов на отдых. Подробнее

Name	Description
breaks*	Type: array

items_shifts_item

Транспортная смена.

Name	Description
id*	Type: string Уникальный идентификатор смены.
time_window*	Type: string Разрешенное окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Подробнее
balanced_group_id	Type: string Идентификатор соответствующей группы балансировки маршрутов (см. опцию `balanced_groups`).
hard_max_duration_s	Type: number Жесткое ограничение на максимальную продолжительность смены в секундах. Если заданы оба поля `max_duration_s` и `hard_max_duration_s`, то запрещено использовать значение меньше, чем в соответствующем `max_duration_s`. Default: `2592000` Max value: `3153600000`
hard_time_window	Type: string Разрешенное жесткое окно посещения пункта назначения, в формате `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00`, `2018-09-06T10:15:00Z/2018-09-06T12:45:00Z`. Жесткое окно должно включать в себя соответствующий временной промежуток из поля `time_window`. Поля `hard_time_window` и `hard_window` — взаимоисключающие. Подробнее
hard_window	Type: boolean Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается завершить смену только в пределах указанного временного окна. Подробнее
max_duration_s	Type: number Максимальная продолжительность смены в секундах. Если спланированная продолжительность смены больше, чем указано, применяются штрафы за превышение графика смены. Default: `172800` Max value: `3153600000`
max_mileage_km	Type: number Максимальный пробег машины за смену в километрах. Если спланированный пробег больше, чем данное значение, то применяются штрафы из параметра смены `penalty.max_mileage`. Подробнее
max_runs	Type: integer Максимальное количество рейсов транспортного средства в смене. Default: `1`
maximal_stops	Type: integer Максимальное количество остановок в смене. Если итоговое количество остановок больше этого значения, применяется штраф `stop_excess`.Подробнее
minimal_stops	Type: integer Минимальное количество остановок в смене. Если итоговое количество остановок меньше этого значения, применяется штраф `stop_lack`. Подробнее
minimal_unique_stops	Type: integer Минимальное количество остановок с различными координатами в смене. Если итоговое количество остановок меньше этого значения, применяется штраф `unique_stop_lack`.
penalty	Type: items_penalty_6 Штрафы, применяемые за нарушения условий перерывов в работе.
preset_id	Type: string Идентификатор пресета (preset.number из reference-book) для свойств смены транспортного средства.
service_duration_s	Type: number Длительность обслуживания при передаче смен (в секундах). Может включать в себя любые операции, необходимые для завершения смены, например, пересменка водителей, обмен бумагами и т. д. (по умолчанию: 0). Max value: `3153600000`

items_specs

Характеристики транспортного средства. Подробнее

Name	Description
height	Type: number Высота транспортного средства в метрах.
length	Type: number Длина транспортного средства в метрах.
max_weight	Type: number Максимальный вес транспортного средства в тоннах.
max_weight_kg	Type: number Максимальный вес транспортного средства в килограммах. При решении задачи характеристика будет округляться вверх до тонн. Если заданы обе характеристики `max_weight` и `max_weight_kg`, будет использована `max_weight`.
width	Type: number Ширина транспортного средства в метрах.

items_trailer

Спецификация прицепа. Подробнее

Name	Description
capacity	Type: trailer_capacity Вместимость прицепа.
cost	Type: trailer_cost Стоимость использования прицепа.
coupling_time_s	Type: number Дополнительное время на присоединение прицепа, в секундах. Max value: `3153600000`
decoupling_time_s	Type: number Дополнительное время на отсоединение прицепа, в секундах. Max value: `3153600000`
max_capacity_difference	Type: trailer_max_capacity_difference Максимальная разница загрузки прицепа и тягоча.
rolling_cost	Type: number Штраф за каждую перекатку грузов из прицепа в тягач.
rolling_time	Type: trailer_rolling_time Время на перекладку грузов из прицепа в голову. Если указано несколько типов времени, используется тот, который затрачивает больше всего времени. Если ни один тип не указан, используется только фиксированое время перекладки.

items_visited_locations_item

Name	Description
id*	Type: integer or string Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
anchor_mode	Type: string Default: `Undefined` Enum: `Decoupling`, `Rolling`, `Coupling`, `Undefined`
delivered_orders	Type: (integer or string)[] Список идентификаторов заказов, доставленных в кросс-док для доставки в пункт назначения. Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
is_middle_depot	Type: boolean Локация является промежуточным складом.
picked_orders	Type: (integer or string)[] Список идентификаторов pickup-заказов, забираемых в кросс-доке. Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
shift_id	Type: string Уникальный идентификатор смены.
time	Type: string Время отправления из пункта назначения, в формате `[D.]HH[:MM[:SS]]` или ISO 8601 `2018-09-06T10:15:00+03:00`, `2018-09-06T10:15:00Z`.
wait_if_early	Type: boolean Этот параметр определяет, что происходит, если автомобиль приезжает в пункт назначения слишком рано. При значении `true` автомобиль будет ждать начала временного окна пункта назначения, прежде чем обслужить его. При значении `false` он приступит к обслуживанию точки назначения сразу по прибытии. В случае строгого временного окна значение параметра должно быть `true`. Default:

items_walking_courier

Описание курьера-пешехода.

Name	Description
capacity	Type: walking_courier_capacity Грузоподъемность курьера.
cost	Type: walking_courier_cost Стоимость работы курьера-пешехода.
restrictions	Type: any

depot_location_package_throughput

Ограничение на скорость упаковки заказов на складе.

Name

Description

kg_per_hour

Type: number

Пропускная способность упаковки на складе, кг/ч.

units_per_hour

Type: number

Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час.

depot_location_penalty

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

Name	Description
early	Type: penalty_early_1 Составляющие штрафа за раннее обслуживание (используются вместо штрафа `out_of_time`).
late	Type: penalty_late_1 Составляющие штрафа за позднее посещение (используются вместо штрафа `out_of_time`). Опция `penalize_late_service` определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
out_of_time	Type: penalty_out_of_time Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов `early` и `late`, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
package_throughput	Type: penalty_package_throughput Составляющие штрафа за превышение пропускной способности упаковки заказов.
throughput	Type: penalty_throughput_1 Составляющие штрафа за превышение пропускной способности.

depot_location_throughput

Пропускная способность склада. Подробнее

Name	Description
kg_per_hour	Type: number Пропускная способность склада, кг/ч.
units_per_hour	Type: number Пропускная способность склада, измеряемая в пользовательских единицах измерения в час.
vehicle_count	Type: array or number

depot_location_time_windows_item

Name

Description

time_window*

Type: string

hard_time_window

Type: string

items_package_throughput

Ограничение на скорость упаковки заказов на складе.

Name	Description
kg_per_hour	Type: array or number
units_per_hour	Type: array or number

items_penalty_3

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_11

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_11

Составляющие штрафа за поздний перерыв в работе.

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

Name

Description

time_window*

Type: string

hard_time_window

Type: string

items_geometry_1

Name

Description

coordinates

Type: number[][][]

Всегда содержит два элемента: долгота и широта

type

Type: string

Всегда равен Polygon

penalty_early_13

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 17

penalty_late_13

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 17

shipment_size_volume

Метрические размеры отправления.

Name	Description
depth_m*	Type: number Глубина, в метрах. Max value: `1000000`
height_m*	Type: number Высота, в метрах. Max value: `1000000`
width_m*	Type: number Ширина, в метрах. Max value: `1000000`
align	Type: string Выравнивание отправления по осям (не имеет эффекта для типа `bulk`): `all_axes` — полное выравнивание (по умолчаниию), груз должен быть размещен параллельно осям транспортного средства; `height` — выравнивание по высоте, разрешены произвольные вращения в двух других размерностях (для типа `rigid` в качестве высоты можно выбрать любую из размерностей). Подробнее Default: `all_axes` Enum: `all_axes`, `height`
type	Type: string Тип отправления: `bulk` — сыпучий (по умолчанию), может произвольно изменять форму; `rigid` — жесткий, можно крутить, но нельзя изменять форму; `fixed_bottom` — жесткий с фиксированным дном, крутить можно только в двух измерениях (фиксированное измерение — `height`). Подробнее Default: `bulk` Enum: `bulk`, `rigid`, `fixed_bottom`

items_penalty_2

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_10

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_10

Составляющие штрафа за поздний перерыв в работе.

penalty_drop_penalty_percentage

Составляющие штрафа за нарушение max_drop_penalty_percentage.

Name

Description

fixed

Type: number

Фиксированный штраф в случае, если суммарный штраф за недоставку слишком велик.

Default: 1000

per_percent

Type: number

Штраф за каждый лишний процент штрафа за недоставку заказов.

Default: 50

penalty_multiorders

Составляющие штрафа за лишние посешения точек мультизаказов.

Name	Description
per_extra_point	Type: number Штраф за каждую точку в которую машины/курьеры приезжают больше одного раза.
per_extra_vehicle	Type: number Штраф за каждую лишнюю машину/курьера, которые приезжают в точки мультизаказов.
per_extra_visit	Type: number Штраф за каждое лишнее посещение точкек мультизаказов.

items_penalty_1

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

Name	Description
early	Type: penalty_early_8 Составляющие штрафа за раннее обслуживание (используются вместо штрафа `out_of_time`).
late	Type: penalty_late_8 Составляющие штрафа за позднее посещение (используются вместо штрафа `out_of_time`). Опция `penalize_late_service` определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.
out_of_time	Type: penalty_out_of_time_8 Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов `early` и `late`, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.
package_throughput	Type: penalty_package_throughput_1 Составляющие штрафа за превышение пропускной способности упаковки заказов.
throughput	Type: penalty_throughput_2 Составляющие штрафа за превышение пропускной способности.

items_point

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

items_throughput

Пропускная способность заказа (поддерживается для разделяемых заказов).

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

Перерыв в работе.

Name	Description
rest_duration_s*	Type: number Продолжительность отдыха, в секундах. Min value: `0.001` Max value: `3153600000`
after_last_location	Type: boolean При значении `true` перерыв будет находиться после последнего пункта назначения. Если возможно, он будет объединен с первым перерывом одного из типов, указанных в поле `merge_with_types`, иначе он будет непосредственно после обслуживания последнего пункта назначения.
at_rest_place	Type: boolean При значении `true` машина будет заезжать на отдых в локацию с типом "rest_place"
before_first_location	Type: boolean При значении `true` перерыв будет находиться перед первым пунктом назначения. Если возможно, он будет объединен с последним перерывом одного из типов, указанных в поле `merge_with_types`, иначе он будет непосредственно перед обслуживанием первого пункта назначения.
continuous_travel_time_range	Type: string Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
driving_time_range	Type: string Минимальная и максимальная продолжительность движения до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
exact_time_range	Type: string Точный диапазон времени, когда должен начаться отдых, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
merge_with_types	Type: string[] Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями `before_first_location` и `after_last_location`.
necessary_route_duration_s	Type: number Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах. Max value: `3153600000`
penalty	Type: items_penalty_3 Штрафы, применяемые за нарушения условий перерывов в работе.
repeatable	Type: boolean При значении `true` перерыв будет повторяться до конца маршрута. Можно указывать `true` только для последнего перерыва в цепочке.
route_duration_s	Type: number Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах. Max value: `3153600000`
travel_time_range	Type: string Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
type	Type: string Тип перерыва. Используется в поле `merge_with_types`.
work_time_range_from_start	Type: string Минимальное и максимальное время от начала маршрута до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
work_time_range_till_rest	Type: string Минимальная и максимальная продолжительность работы до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").

capacity_limits_1

Пределы загрузки транспортного средства.

Name	Description
units_perc	Type: number Максимальный объем отправлений в пользовательских единицах измерения, выраженный в процентах от вместимости транспортного средства. Default: `100`
volume_perc	Type: number Максимальный объем отправлений в процентах от объема грузового отсека транспортного средства. Для размещения жёстких контейнеров предполагается, что стороны грузового отсека умножены на кубический корень из `(0.01 * volume_perc)`. Default: `100`
weight_perc	Type: number Максимальный объем отправлений в процентах от максимально допустимого общего веса груза, перевозимого транспортным средством. Default: `100`

capacity_volume_1

Метрические размеры автомобиля.

Name	Description
depth_m*	Type: number Глубина, в метрах. Default: `1000` Max value: `1000000`
height_m*	Type: number Высота, в метрах. Default: `1000` Max value: `1000000`
width_m*	Type: number Ширина, в метрах. Default: `1000` Max value: `1000000`

penalty_throughput_4

Составляющие штрафа за превышение пропускной способности.

Name	Description
fixed	Type: number Фиксированный штраф в случае превышения пропускной способности. Default: `1000`
kg	Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: `50`
unit	Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле `units`). Default: `100`
vehicle	Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: `100000`

planned_route_locations_item

Name	Description
id*	Type: integer or string Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
anchor_mode	Type: string Default: `Undefined` Enum: `Decoupling`, `Rolling`, `Coupling`, `Undefined`
delivered_orders	Type: (integer or string)[] Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения. Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
delivery_in_current_run	Type: boolean Все заказы, загруженные в данной локации, должны быть доставлены в этом же рейсе.
is_middle_depot	Type: boolean Локация является промежуточным складом.
loaded_orders	Type: (integer or string)[] Идентификаторы заказов типа `delivery`, загружаемых в машину на складе или гараже.
order_ratio	Type: number Доля заказа, входящая в данную часть.
parking_mode	Type: string Default: `Undefined` Enum: `ParkingBegin`, `ParkingRefill`, `ParkingEnd`, `Undefined`
picked_orders	Type: (integer or string)[] Список идентификаторов заказов, забираемых в кросс-доке или складе. Ссылка на пункт назначения, указанный в параметре `locations`. Подробнее
shift_id	Type: string Уникальный идентификатор смены.
wait_if_early	Type: boolean Этот параметр определяет, что происходит, если автомобиль приезжает в пункт назначения слишком рано. При значении `true` автомобиль будет ждать начала временного окна пункта назначения, прежде чем обслужить его. При значении `false` он приступит к обслуживанию точки назначения сразу по прибытии. В случае строгого временного окна значение параметра должно быть `true`. Default:

planned_route_work_breaks_item

Name

Description

work_duration_s*

Type: number

Продолжительность непрерывной работы до следующего перерыва на отдых, в секундах.

Max value: 3153600000

shift_id

Type: string

Уникальный идентификатор смены.

breaks_0_item_1

Перерыв в работе.

Name	Description
rest_duration_s*	Type: number Продолжительность отдыха, в секундах. Min value: `0.001` Max value: `3153600000`
after_last_location	Type: boolean При значении `true` перерыв будет находиться после последнего пункта назначения. Если возможно, он будет объединен с первым перерывом одного из типов, указанных в поле `merge_with_types`, иначе он будет непосредственно после обслуживания последнего пункта назначения.
at_rest_place	Type: boolean При значении `true` машина будет заезжать на отдых в локацию с типом "rest_place"
before_first_location	Type: boolean При значении `true` перерыв будет находиться перед первым пунктом назначения. Если возможно, он будет объединен с последним перерывом одного из типов, указанных в поле `merge_with_types`, иначе он будет непосредственно перед обслуживанием первого пункта назначения.
continuous_travel_time_range	Type: string Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
driving_time_range	Type: string Минимальная и максимальная продолжительность движения до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
exact_time_range	Type: string Точный диапазон времени, когда должен начаться отдых, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
merge_with_types	Type: string[] Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями `before_first_location` и `after_last_location`.
necessary_route_duration_s	Type: number Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах. Max value: `3153600000`
penalty	Type: items_penalty_7 Штрафы, применяемые за нарушения условий перерывов в работе.
repeatable	Type: boolean При значении `true` перерыв будет повторяться до конца маршрута. Можно указывать `true` только для последнего перерыва в цепочке.
route_duration_s	Type: number Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах. Max value: `3153600000`
travel_time_range	Type: string Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
type	Type: string Тип перерыва. Используется в поле `merge_with_types`.
work_time_range_from_start	Type: string Минимальное и максимальное время от начала маршрута до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").
work_time_range_till_rest	Type: string Минимальная и максимальная продолжительность работы до отдыха, формат: `[D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]]` ("04:00 - 05:30").

items_penalty_6

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_12

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_12

Составляющие штрафа за поздний перерыв в работе.

trailer_capacity

Вместимость прицепа.

Name	Description
custom	Type: number Количество пользовательских единиц измерения, которое можно перевозить в прицепе. Вместимости в пользовательских единицах задаются в формате `"name": size`, где `name` - строка, обозначающая название единицы, а `size` - неотрицательное вещественное число, обозначающее вместимость автомобиля в соответствующих единицах. Если название единицы присутствует в объектах (локациях/транспортных средствах/прицепах), но не в этом, то вместимость полагается неограниченной.
limits	Type: capacity_limits Пределы загрузки прицепа.
units	Type: number Количество пользовательских единиц измерения, которое можно перевозить в прицепе. Default: `1000000000`
volume	Type: capacity_volume Метрические размеры прицепа.
volume_cbm	Type: number Вместимость прицепа в кубических метрах.
weight_kg	Type: number Грузоподъемность прицепа в килограммах. Default: `1000000000`

trailer_cost

Стоимость использования прицепа.

Name	Description
fixed	Type: number Стоимость за факт использования прицепа (стоимость считается затраченной, если прицеп использовался в маршруте). Default: `3000`
hour	Type: number Стоимость за час использования прицепа. Default: `100`
km	Type: number Стоимость за километр использования прицепа. Default: `8`
location	Type: number Стоимость использования прицепа в расчете на один пункт назначения (по умолчанию — 0).
run	Type: number Стоимость за один рейс со склада до пункта назначения.
tonne_km	Type: number Стоимость перевозки одной тонны на один километр (по умолчанию — 0).
waiting_hour	Type: number Стоимость часа ожидания с использованием транспортного средства. Если не указана, то используется значение, заданное в поле `hour`.

trailer_max_capacity_difference

Максимальная разница загрузки прицепа и тягоча.

Name	Description
custom	Type: number Максимально допустимая разница в загруженном количестве пользовательских единиц измерения у прицепа и тягача. Допустимая разница в пользовательских единицах задаются в формате `"name": size`, где `name` - строка, обозначающая название единицы, а `size` - вещественное число, обозначающее максимально допустимую разницу в загрузке между прицепом и тягачом в соответствующих единицах. Если название единицы присутствует в объектах (локациях/транспортных средствах/прицепах), но не в этом, то ограничение отсутствует.
units	Type: number Максимально допустимая разница в загруженном количестве пользовательских единиц измерения у прицепа и тягача.
volume_cbm	Type: number Максимально допустимая разница в загруженном объеме у прицепа и тягача в кубических метрах.
weight_kg	Type: number Максимально допустимая разница в загруженной массе у прицепа и тягача в килограммах.

trailer_rolling_time

Время на перекладку грузов из прицепа в голову. Если указано несколько типов времени, используется тот, который затрачивает больше всего времени. Если ни один тип не указан, используется только фиксированое время перекладки.

Name	Description
fixed_time_s	Type: number Фиксированное время, затраченное каждый раз, когда прицеп загружается или разгружается, в секундах. Max value: `3153600000`
s_per_kg	Type: number Время разгрузки на килограм груза, в секундах. Max value: `3153600000`
s_per_m3	Type: number Время разгрузки на кубометр груза, в секундах. Max value: `3153600000`
s_per_unit	Type: number Время разгрузки на единицу груза, в секундах. Max value: `3153600000`

walking_courier_capacity

Грузоподъемность курьера.

Name

Description

units

Type: number

Количество пользовательских единиц измерения, которое может переносить курьер.

Default: 1000000000

walking_courier_cost

Стоимость работы курьера-пешехода.

Name

Description

hour

Type: number

Стоимость за час пеших маршрутов курьера.

Type: number

Стоимость за километр пройденный курьером.

penalty_early_1

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф за обслуживание объекта, начатое раньше выбранного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего прибытия, если обслуживание объекта было начато раньше выбранного временного окна.

Default: 17

penalty_late_1

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения пункта назначения после окончания заданного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания, когда место посещается после окончания временного окна.

Default: 17

penalty_out_of_time

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения пункта назначения вне заданного временного окна. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания или раннего прибытия при посещении объекта за пределами временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_package_throughput

Составляющие штрафа за превышение пропускной способности упаковки заказов.

Name	Description
fixed	Type: number Фиксированный штраф в случае превышения пропускной способности. Default: `1000`
kg	Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: `50`
unit	Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле `units`). Default: `100`

penalty_throughput_1

Составляющие штрафа за превышение пропускной способности.

Name	Description
fixed	Type: number Фиксированный штраф в случае превышения пропускной способности. Default: `1000`
kg	Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: `50`
unit	Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле `units`). Default: `100`
vehicle	Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: `100000`

vehicle_count_0_item_1

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

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_11

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Default: 1000

minute

Type: number

Default: 17

penalty_late_11

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Default: 1000

minute

Type: number

Default: 17

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: 1000000000

penalty_early_10

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Default: 1000

minute

Type: number

Default: 17

penalty_late_10

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Default: 1000

minute

Type: number

Default: 17

penalty_early_8

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле fixed.

Default: 17

penalty_late_8

Name

Description

fixed

Type: number

Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна.

Default: 17

penalty_out_of_time_8

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_package_throughput_1

Составляющие штрафа за превышение пропускной способности упаковки заказов.

Name	Description
fixed	Type: number Фиксированный штраф в случае превышения пропускной способности. Default: `1000`
kg	Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: `50`
unit	Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле `units`). Default: `100`

penalty_throughput_2

Составляющие штрафа за превышение пропускной способности.

Name	Description
fixed	Type: number Фиксированный штраф в случае превышения пропускной способности. Default: `1000`
kg	Type: number Штраф за каждый лишний килограмм превышения пропускной способности. Default: `50`
unit	Type: number Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле `units`). Default: `100`
vehicle	Type: number Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м. Default: `100000`

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

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

penalty_early_12

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Default: 1000

minute

Type: number

Default: 17

penalty_late_12

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Default: 1000

minute

Type: number

Default: 17

capacity_limits

Пределы загрузки прицепа.

Name	Description
units_perc	Type: number Максимальный объем отправлений в пользовательских единицах измерения, выраженный в процентах от вместимости прицепа. Default: `100`
volume_perc	Type: number Максимальный объем отправлений в процентах от объема прицепа. Для размещения жёстких контейнеров предполагается, что стороны грузового отсека умножены на кубический корень из `(0.01 * volume_perc)`. Default: `100`
weight_perc	Type: number Максимальный объем отправлений в процентах от максимально допустимого общего веса груза, перевозимого в прицепе. Default: `100`

capacity_volume

Метрические размеры прицепа.

Name	Description
depth_m*	Type: number Глубина, в метрах. Default: `1000` Max value: `1000000`
height_m*	Type: number Высота, в метрах. Default: `1000` Max value: `1000000`
width_m*	Type: number Ширина, в метрах. Default: `1000` Max value: `1000000`

Responses

202 Accepted

Задача поставлена в очередь на выполнение.

Body

application/json

{
    "id": "string",
    "message": "string",
    "status": {
        "queued": 0,
        "started": 0,
        "completed": 0,
        "cancelled": 0,
        "estimate": 0
    }
}

Name	Description
id*	Type: string Уникальный id задачи.
status*	Type: task_info_status Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp. Возможные изменения статусов: `queued` -> `started` -> (`completed` или `cancelled`)
message	Type: string Описание состояния задачи.

task_info_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": {
        "message": "string",
        "incident_id": "string"
    }
}

Name

Description

error*

Type: error_error

Описание ошибки.

error_error

Описание ошибки.

Name

Description

message*

Type: string

Сообщение с описанием ошибки.

incident_id

Type: string

Уникальный идентификатор инцидента c ошибкой. При ошибке API этот идентификатор может использоваться при анализе проблем.

Body

text/html

{}

403 Forbidden

У вас нет разрешения на добавление MVRP-задач.

500 Internal Server Error

Ошибка сервера при обработке запроса.

Body

application/json

{
    "error": {
        "message": "string",
        "incident_id": "string"
    }
}

Name

Description

error*

Type: error_error

Описание ошибки.

Body

text/html

{}

503 Service Unavailable

Недостаточно ресурсов для выполнения задачи.

Body

application/json

{
    "error": {
        "message": "string",
        "incident_id": "string"
    }
}

Name

Description

error*

Type: error_error

Описание ошибки.

Body

text/html

{}