Инструкция по заполнению Excel

Общее описание

Пример заполненного файла Excel содержится тут. Допустимые форматы для загрузки: xls, xlsx, xlsm.

Для корректной загрузки данных для маршрутизации книга Excel должна обязательно содержать следующие листы:

  • Orders — информация о заказах;

  • Vehicles — информация о машинах/курьерах;

  • Depot либо Depots — информация о точке склада/о множестве складов.

Опционально книга Excel может содержать следующие листы:

  • Incompatible_order_types — информация о несовместимых типах заказов;

  • Location_groups — настройки групп заказов;

  • Options — опции маршрутизации;

  • Routes — данные о предопределенных маршрутах (маршруты логиста или маршруты прошлого планирования, которые надо сохранить в текущем планировании).

Книга Excel также может содержать листы с другими наименованиями и дополнительной информацией для пользователя — на загрузке данных это не отражается.

Для корректной загрузки заголовок таблицы на листе (первые несколько строк с названием поля и техническим наименованием атрибута) должен оставаться неизменным. При этом допускается удаление необязательных столбцов (добавление других столбцов с зарезервированными наименованиями), при условии, что не будет возникать пустых столбцов между столбцами с данными.

Примечание

Порядок следования столбцов на листах Excel не важен.

Лист Orders

На этом листе содержится информация о заказах. Строго говоря, каждая строка на данном листе — это не заказ, а пункт (location). Поэтому:

  • если выполняется простая доставка из точки склада, то каждая строка соответствует заказу;

  • если выполняется доставка из точки А в точку B, то этот заказ будет разбит на 2 строки, одна из которых будет соответствовать пункту получения (pickup), а вторая — пункту доставки (delivery);

  • если точка старта или завершения маршрута отличается от точки склада — такая точка будет заведена на листе отдельной строкой.

Примечание

Для листа Orders достаточно заполнить следующий минимум полей (если выполняется доставка со склада):

  • номер заказа;

  • координаты и/или адрес заказа;

  • временное окно заказа;

  • объемно-весовые характеристики заказа (вес и/или объем и/или количество грузовых мест).

В остальных полях можно оставить значения по умолчанию (или оставить их пустыми) — этого будет достаточно для первого запуска задачи на маршрутизацию.

Описание допустимых полей на листе Orders приведено ниже.

Основная информация о заказе

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Номер заказа; дополнительный номер заказа

id; ref

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

Да (одно из полей)

Широта; долгота

point.lat; point.lon

Координаты точки заказа: широта (point.lat), долгота (point.lon). Подробнее

Нет, если указывается адрес заказа (при загрузке через интерфейс можно геокодировать адрес)

Наименование клиента; краткое описание точки заказа; адрес клиента; комментарий к заказу

title; description; address; comments

Информационные поля, которые потом отображаются в интерфейсе планирования. Подробнее

Нет (но если координаты заказа не заполнены, то адрес указывать обязательно)

Телефон клиента

phone

Используется только при экспорте результатов планирования в Мониторинг.

Нет

Тип точки

type

Подробнее

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Штраф за недоставку

penalty.drop

Рекомендуется оставить значение по умолчанию 1 000 000 или пустым (в этом случае будет использовано значение по умолчанию). Подробнее

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Характеристики заказа

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Вес (брутто), кг; количество занимаемых мест; габариты, м (ширина, глубина, высота)

shipment_size.weight_kg; shipment_size.units; shipment_size.volume.width_m; shipment_size.volume.depth_m; shipment_size.volume.height_m

Объемно-весовые характеристики заказа. Подробнее

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Объем заказа, кубометры

shipment_size.volume_cbm

Объем заказа в кубометрах. Подробнее

Нет

Пользовательские единицы измерения: название; количество единиц

shipment_size.custom.N.name; shipment_size.custom.N.size

Пользовательские единицы измерения для заказа. Подробнее

Нет

Тип груза

shipment_size.volume.type

Возможные значения: bulk, rigid, fixed_bottom. Подробнее

Нет

Ориентация

shipment_size.volume.align

Возможные значения: all_axes, height. Подробнее

Нет

Окна доставки

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Временное окно

time_window

Если временное окно относительно (то есть в формате 10:00 – 18:00), то важно учитывать сдвиг этого временного окна относительно даты планирования (которая указывается при запуске задачи на маршрутизацию). Подробнее тут и тут

Да (если не указаны time_windows)

Несколько временных окон

time_windows.N.time_window

Используйте, если окно «разорвано» в течение дня или окна отличаются в разные дни. Нельзя использовать вместе с time_window. Подробнее

Да (если не указано time_window)

Признак жесткого временного окна, TRUE/FALSE

hard_window

TRUE — временное окно не может быть нарушено ни при каких обстоятельствах. FALSE — временное окно может быть нарушено (если это повлияет на более оптимальное использование ресурсов). Поле можно оставить пустым — тогда будет считаться, что временное окно мягкое (то есть его можно нарушить). Подробнее Обратите внимание: поля hard_time_window и hard_window являются взаимоисключающими.

Нет

Жесткое временное окно

hard_time_window

Если основное окно работы склада является мягким, вокруг него можно задать жесткое временное окно. Подробнее Обратите внимание: поля hard_time_window и hard_window являются взаимоисключающими.

Нет

Штрафы: за минуту нарушения окна доставки; за факт нарушения окна доставки; за факт ранней доставки; за каждую минуту ранней доставки; за факт опоздания; за каждую минуту опоздания

penalty.out_of_time.minute; penalty.out_of_time.fixed; penalty.early.fixed; penalty. early.minute; penalty.late.fixed; penalty.late.minute

Штрафы за нарушение временного окна заказа. Рекомендуется оставить значения по умолчанию (fixed = 1000, minute = 17) или пустым (в этом случае будет использовано значение по умолчанию). Изменения данного поля желательно только когда понятно его влияние на маршрутизацию. Изменение может потребоваться для сценариев: опоздания на заказ недопустимы (но возможно приезжать раньше временного окна) или наоборот; нарушение временных окон приемлемо, если это ведет к более оптимальному использованию ресурсов. Подробнее

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Ограничения по времени

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Время доставки pickup на склад

delivery_deadline

Время, до которого pickup-заказ без явно указанного места доставки должен быть доставлен до любого склада. Подробнее

Нет

Штрафы: за факт нарушения времени доставки pickup на склад; за каждую минуту нарушения времени доставки pickup на склад

penalty.delivery_deadline.fixed; penalty.delivery_deadline.minute

Штрафы за позднюю доставку заказа на склад. Рекомендуется оставить значения по умолчанию (fixed = 1000, minute = 17) или пустым (в этом случае будет использовано значение по умолчанию). Изменяйте эти поля, только если это важно для вашей задачи. Подробнее

Нет

Время готовности заказа на складе

depot_ready_time

Время, когда заказ готов к выдаче на складе. Подробнее

Нет

Крайнее время получения заказа на складе

depot_expiring_time

Время, до которого заказ необходимо забрать со склада. Подробнее

Нет

Ограничение времени пребывания заказа в автомобиле

transit_time.limit_s; transit_time.hard_limit_s

Мягкое и жесткое ограничение времени пребывания заказа в автомобиле. Подробнее

Нет

Штрафы: за факт нарушения времени пребывания заказа в автомобиле; за каждую минуту нарушения времени пребывания заказа в автомобиле

penalty.transit_time.fixed; penalty.transit_time.minute

Штрафы за нарушение мягкого ограничения времени пребывания заказа в автомобиле. Подробнее

Нет

Сервисное время

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Время перегрузки заказа в кросс-доке, сек

crossdock_service_duration_s

Указывается для заказов, которые доставляются через кросс-докинг. Подробнее

Нет

Время загрузки заказа на складе

depot_duration_s

Для заказов с типом delivery — это время погрузки заказа на складе. Подробнее

Нет

Время, которое курьер тратит на парковку автомобиля, сек

parking_service_duration_s

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

Нет

Время обслуживания на адрес, сек; время обслуживания на заказ, сек

shared_service_duration_s; service_duration_s

Время, которое машина/курьер проведет на точке заказа (в секундах). Подробнее тут и тут

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Объединение и разделение заказов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Возможность объединения в мультизаказ, TRUE/FALSE

can_be_merged

По умолчанию — TRUE (заказ можно объединять в мультизаказ). Подробнее тут и тут

Нет

Деление заказа на части

can_be_split

Если FALSE (по умолчанию) — заказ можно доставлять только целиком. Если TRUE — заказ можно доставлять частями. Подробнее

Нет

Максимальное количество делимых частей

max_split_parts

Максимальное количество частей, на которые можно разделить заказ. Подробнее

Нет

Делитель, пропорция; делитель, кг; делитель, место; делитель, куб.м

quant; quant.weight_kg; quant.units; quant.volume_cbm

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

Нет

Заполнять машину целиком

split_parts_must_fill_whole_vehicle

Если TRUE — отделяемая от заказа часть должна занимать весь автомобиль. По умолчанию — FALSE. Подробнее

Нет

Фиксированный штраф за недоставку части заказа; штраф, пропорциональный доле недоставленной части заказа

penalty.drop.fixed; penalty.drop.scaled

Если заказ делится на части, можно указывать фиксированную часть штрафа и переменную, которая зависит от размера (доли) нераспределенной части заказа. Подробнее

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Привязка заказа к складу или другим точкам

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Привязка к складу

depot_id

Склады, с которых можно забрать заказ. Для одного заказа может быть указано несколько складов через запятую. Подробнее

Нет

Место назначения (для заказов с типом pickup)

delivery_to

Используется только для сценариев, в которых есть pickup заказы. Поле заполняется только для заказов с типом pickup. В данном поле необходимо указать id связанного заказа c типом delivery. Важный момент — идентификатор, определенный в delivery_to должен быть уникален для каждого pickup заказа. Подробнее

Нет

Отвезти в любую из точек (для заказов с типом pickup)

delivery_to_any

Используется только для сценариев, в которых есть pickup заказы. Поле заполняется только для заказов с типом pickup. В данном поле необходимо указать id связанного заказа c типом drop off. Важный момент — идентификатор, определенный в delivery_to_any может повторяться для разных pickup заказов.

Нет

Забрать из любой из указанных точек

pickup_from_any

Указывается только для заказов с типом delivery. Используется в сценариях, когда груз для доставки можно забрать из любой точки на выбор. Подробнее

Нет

Обязательность доставки pickup на склад в текущем маршруте

pickup_must_reach_depot

Если признак включен, то pickup-заказ должен быть доставлен на склад в текущем маршруте. Подробнее

Нет

Возможность доставлять заказ через кросс-док

crossdock_mode

Может принимать одно из значений: allow (по умолчанию), deny, mandatory. Подробнее

Нет

Возможность оставить заказ в кросс-доке, TRUE/FALSE

may_drop_in_crossdock

Может задаваться только для pickup-заказов. Если равен TRUE (по умолчанию), то заказ можно оставлять в кросс-доке, а если FALSE — только на обычном складе. Подробнее

Нет

Распределение и совместимость заказов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Тип совместимости с другими заказами

load_types

Параметры совместимости заказов между собой. Для одного заказа можно указать несколько значений load_types, значения указываются через запятую. load_typesпредставляют собой любую строку, которая понятным для пользователя образом идентифицируют необходимое свойство заказа. При указании load_types важен регистр символов. Если заполняются значения load_types, то несовместимые типы заказов необходимо заполнить на листе Incompatible_order_types. Несовместимые типы заказов не могут быть назначены при планировании в один рейс одного ТС/курьера. Подробнее

Нет

Необязательные требования к автомобилю: название тега; вес тега

optional_tags.N.tag; optional_tags.N.value

Теги для необязательных требований. Подробнее

Нет

Требования к автомобилю

required_tags

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

Нет

Прочие характеристики заказов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Доступность локации для грузовика с прицепом

allow_trailers

По умолчанию — FALSE. Подробнее

Нет

Очередность приема и доставки

in_lifo_order

По умолчанию — FALSE. Используется для пар заказов pickup/delivery, когда важна последовательность загрузки и выгрузки. Подробнее

Нет

Приоритет выполнения заказа

sequence_order

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

Нет

Компании, которые могут наблюдать за заказом в Мониторинге

shared_with_company_ids

id компаний перечисляются через запятую. Подробнее

Нет

Признак, действуют ли на заказ опции кучности маршрутов, TRUE/FALSE

use_in_proximity

Возможность отключить для заказа опции кучности маршрутов. По умолчанию — TRUE (опции кучности действуют). Подробнее

Нет

Лист Vehicles

На данном листе содержится информация о доступных ресурсах (машинах или курьерах). Необязательно указывать конкретные транспортные средства / ФИО, можно указать абстрактные ресурсы, а назначением конкретных машин/курьеров на полученные маршруты заниматься уже отдельно и вне сервиса оптимального планирования маршрутов.

Важно корректно указать все имеющиеся ресурсы на момент планирования:

  • если это собственный транспорт (курьеры), то необходимо перечислить их с учетом плановой недоступности для выполнения маршрутов/времени рабочей смены;

  • если это наемный транспорт (курьеры) и их количество заранее неизвестно, то необходимо указать их в том количестве, в котором обычно привлекается для такого объема заказов. Если есть вариативность по типам, то для каждого типа необходимо указать максимальное количество привлекаемых машин. Например, используются наемные машины 1,5 т и 3 т. Каждый раз может привлекаться до 10 машин, но количество машин каждого типа заранее неизвестно. В этом случае можно указать 10 одинаковых строк для 1,5 т и 10 одинаковых строк для 3 т.

Примечание

Для листа Vehicles достаточно заполнить следующий минимум полей:

  • номер транспортного средства/курьера;

  • вместимость транспортного средства/курьера;

  • время работы.

В остальных полях можно оставить значения по умолчанию (или оставить их пустыми) — этого будет достаточно для первого запуска задачи на маршрутизацию.

Описание допустимых полей на листе Vehicles приведено ниже.

Основная информация о курьере или автомобиле

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Логин курьера; название или номер ТС

id; ref

Рекомендуется указывать номер машины/курьера в ref (id можно не заполнять). Значение id должно быть уникально для всего листа (ref может быть не уникальным). Если id не заполнено, то при загрузке данных из Excel и отправке задачи на маршрутизацию оно заполняется как 0, 1, 2… Поле id также важно для сценария экспорта результатов планирования в мониторинг — оно используется как логин курьера в мобильном приложении. Подробнее

Да (одно из полей)

Номер GPS-трекера

imei

Номер GPS-трекера транспортного средства. Используется только для сценария экспорта результатов планирования в Мониторинге. Подробнее

Нет

Максимальное число рейсов

max_runs

Максимальное количество рейсов, которое может быть выполнено за все указанные смены. По умолчанию 1. Под рейсом в алгоритме подразумевается выезд со склада (depot) и развоз заказов до возврата на склад (при этом, если осуществляется возврат на точку, которая имеет координаты, равные координатам склада, то это не засчитывается за рейс). Подробнее

Нет

Телефон курьера

phone

Телефон используется для связи с курьером в Мониторинге. Подробнее

Нет

Способ передвижения

routing_mode

Заполняется только если ТС/курьеры имеют разный способ передвижения (например автомобиль и общественный транспорт). Если способ передвижения у всех одинаковый, то заполнять данное поле нет необходимости: при запуске задачи на маршрутизацию можно выбрать способ передвижения, который будет использоваться для всех. Подробнее

Нет

Характеристики курьера или автомобиля

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Грузоподъемность, кг; максимальная загрузка, % веса; количество доступных мест; максимальная загрузка, % мест; размер места для груза, м (ширина, глубина, высота); Максимальная загрузка, % объема

capacity.weight_kg; capacity.limits.weight_perc; capacity.units; capacity.limits.units_perc; capacity.volume.width_m; capacity.volume.depth_m; capacity.volume.height_m; capacity.volume_cbm; capacity.limits.volume_perc

Параметры вместимости машины/курьера. capacity.weight_kg — грузоподъемность в кг; capacity.units — грузоподъемность в грузовых единицах; capacity.volume_cbm — вместимость в кубических метрах. Помимо номинальной вместимости желательно указать в параметрах limits — возможные перегрузы или плановые недогрузы транспортных средств (особенно, если это практикуется при построении маршрутов вручную или с помощью других программ). Подробнее

Необходимо заполнить для корректной маршрутизации (формально поле необязательно)

Пользовательские единицы измерения вместимости: название; количество единиц

capacity.custom.N.name; capacity.custom.N.size

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

Нет

Характеристики ТС: ширина, высота, длина, максимальный вес в тоннах, максимальный вес в кг

specs.width; specs.height; specs.length; specs.max_weight; specs.max_weight_kg

Характеристики ТС используются для определения возможности проезда ТС по дорогам с ограничениями. Подробнее

Нет

Минимальный вес заказа для автомобиля

min_stop_weight

Минимальный суммарный вес, который автомобиль может доставлять в одну точку. Подробнее

Нет

Фиксированный штраф за нарушение минимального веса заказа; штраф за каждый кг нарушения минимального веса заказа

penalty.min_stop_weight.fixed; penalty.min_stop_weight.kg

Минимальный вес заказа для автомобиля — мягкое ограничение. Алгоритм учитывает штраф за факт нарушения минимального суммарного веса всех заказов в одной точке (по умолчанию 1000) и штраф за каждый недостающий килограмм в суммарном весе заказов, доставляемых в одну точку (по умолчанию 50). Подробнее

Нет

Привязка к складам

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Возможность посещения разных складов в одном маршруте

allow_different_depots_in_route

FALSE — значение по умолчанию, курьер может посещать только тот склад, с которого начал маршрут. TRUE — курьер может посещать различные склады в одном маршруте. Подробнее

Нет

Возможность посещать кросс-доки

crossdock_mode

Может принимать одно из значений: allow (по умолчанию), deny, mandatory. Подробнее

Нет

Склады, которые может посещать курьер

depot_id

Для одного курьера может быть указано несколько складов через запятую. Подробнее

Нет

Точка старта маршрута; заезд на склад после старта маршрута, TRUE/FALSE

start_at; visit_depot_at_start

Параметры стартовой точки машин/курьеров до начала маршрута. По умолчанию все стартуют с точки склада. Можно указать другую стартовую точку, а также указать необходимость заезда на склад после выезда из стартовой точки. Подробнее

Нет

Возврат на склад в конце смены, TRUE/FALSE; точка завершения маршрута

return_to_depot; finish_at

Параметры возврата машины/курьера после завершения маршрута (1. на склад, 2. в произвольную точку, 3. сначала на склад, потом в произвольную точку). По умолчанию return_to_depot = true (то есть машина возвращается на склад), если поле оставить пустым, то будет использовано значение по умолчанию. Подробнее

Нет

Склады для загрузки

starting_depot_id

Склады, с которых курьер может начинать маршрут. Для одного курьера может быть указано несколько складов через запятую. Подробнее

Нет

Промежуточные склады

middle_depot_id

Склады, которые может посещать курьер во время движения по маршруту для дозагрузки заказов delivery или выгрузки заказов pickup. Для одного курьера может быть указано несколько складов через запятую. Подробнее

Нет

Максимальное количество промежуточных складов

max_middle_depots

Максимальное количество промежуточных складов, которое может посещать курьер на маршруте. Подробнее

Нет

Склады для завершения маршрута

ending_depot_id

Склады, где курьер может завершать маршрут. Для одного курьера может быть указано несколько складов через запятую. Подробнее

Нет

Ограничения по времени

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Время погрузки, зависящее от автомобиля, сек

depot_extra_service_duration_s

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

Нет

Время первого посещенного заказа

first_visited_location_started_at

Опционально в поле first_visited_location_started_at можно указать время старта для первого заказа. Используется в случаях допланирования, а также в случаях, когда нужно зафиксировать часть маршрута (или маршрут целиком), причем в нужной последовательности.

Нет

Необходимость начать маршрут как можно раньше; штраф за среднее время приезда после начала временного окна

penalty.arrival_after_start.as_soon_as_possible; penalty.arrival_after_start.average_h

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

Нет

Распределение по зонам и совместимость

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Свойства ТС; несовместимые свойства ТС

tags, excluded_tags

Параметры совместимости заказов и машин. Для одного ТС можно указать несколько тегов, теги указываются через запятую. Тег представляет собой любую строку, которая понятным для пользователя образом идентифицируют необходимое свойство машины/курьера. Для заказа может быть подобрана только машина, содержащая весь набор тегов, указанный на заказе. При указании тегов важен регистр символов. excluded_tags используются для кейса, когда машин/тегов слишком много и проще теги настраивать методом исключения (то есть указывать на машинах свойства, которых у них нет). Подробнее

Нет

Разрешенные геозоны

allowed_zones

Геозоны, в которых ТС/курьер может выполнять заказы. Подробнее

Нет

Запрещенные геозоны

forbidden_zones

Геозоны, в которых ТС/курьер не может выполнять заказы. Подробнее

Нет

Опциональные геозоны

optional_zones.N.zone; optional_zones.N.value

Геозоны, за посещение которых ТС/курьеру начисляется бонус или штраф. Подробнее

Нет

Несовместимые геозоны

incompatible_zones

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

Нет

Стоимость и выплаты

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Стоимость использования ТС: за км пути; за посещение одного заказа; за час работы; за факт использования ТС; за 1 тонно-километр транспортной работы; за 1 рейс

cost.km; cost.location; cost.hour; cost.fixed; cost.tonne_km; cost.run

Стоимость использования ТС/курьера для алгоритма (это не тариф, это именно ориентир для алгоритма при выборе того или иного варианта маршрутизации). Стоимости cost.km и cost.hour не должны быть равны 0. Если неизвестно, как заполнять данные поля, лучше оставить значения по умолчанию (cost.fixed = 3000, cost.hour = 100, cost.km = 8) или оставить пустыми (в этом случае будут использованы значения по умолчанию). Подробнее

Да

Расчет стоимости использования ТС

cost или cost.route, cost.shift, cost.run

Арифметическое выражение для расчета стоимости маршрута для компании. Задается для маршрута в целом или отдельно для маршрута, смены и рейса. Подробнее

Нет

Расчет выплаты курьеру

payout или payout.route, payout.shift, payout.run

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

Нет

Ограничения для пеших курьеров или частей маршрута

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Максимальное количество юнитов, которое может унести курьер при выполнении пешей части маршрута

walking_courier.capacity.units

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

Нет

Стоимость доставки при выполнении пешей части маршрута

walking_courier.cost.km; walking_courier.cost.hour

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

Нет

Максимально допустимое расстояние между двумя точками внутри пеших частей маршрута и штраф за нарушение ограничения

walking_courier.restrictions.max_walking_edge_distance_m.value; walking_courier.restrictions.max_walking_edge_distance_m.penalty

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

Нет

Максимально допустимое расстояние, которое можно пройти в рамках одной парковочной сессии, и штраф за нарушение ограничения

walking_courier.restrictions.max_parking_walking_distance_m.value; walking_courier.restrictions.max_parking_walking_distance_m.penalty

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

Нет

Максимально допустимая длительность одной парковочной сессии и штраф за нарушение ограничения

walking_courier.restrictions.max_parking_duration_s.value; walking_courier.restrictions.max_parking_duration_s.penalty

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

Нет

Сцепки

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Вместимость прицепа, кг

trailer.capacity.weight_kg

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

Нет

Вместимость прицепа, кол-во мест

trailer.capacity.units

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

Нет

Максимальная разница в загрузке прицепа и грузовика, кол-во мест

trailer.max_capacity_difference.units

На сколько единиц товаров может быть в прицепе больше, чем в грузовике. Подробнее

Нет

Максимальная разница в загрузке прицепа и грузовика, кг

trailer.max_capacity_difference.weight_kg

На сколько килограмм загрузка прицепа может быть больше, чем загрузка грузовика. Подробнее

Нет

Фиксированная стоимость прицепа

trailer.cost.fixed

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

Нет

Время отсоединения прицепа, сек

trailer.decoupling_time_s

Время отсоединения прицепа в секундах. Подробнее

Нет

Время присоединения прицепа, сек

trailer.coupling_time_s

Время присоединения прицепа в секундах. Подробнее

Нет

Время перекатки, сек

trailer.rolling_time.fixed_time_s

Фиксированное время перекатки груза из прицепа в грузовик в секундах. Подробнее

Нет

Прочие характеристики курьеров или автомобилей

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Необходимость оставить запланированный маршрут без изменений

fixed_planned_route

Необходимость оставить без изменений маршрут из planned_route. По умолчанию — FALSE. Подробнее

Нет

Коэффициент сервисного времени

service_duration_multiplier; shared_service_duration_multiplier

Коэффициент ускорения/замедления ТС/курьеров относительно сервисного времени. Рекомендуется не использовать на начальных запусках маршрутизации, а по мере получения определенного опыта использования сервиса. Подробнее

Нет

Коэффициент скорости передвижения

travel_time_multiplier

Коэффициент ускорения/замедления ТС/курьеров относительно рассчитанной скорости по статистике. Рекомендуется не использовать на начальных запусках маршрутизации, а по мере получения определенного опыта использования сервиса. Подробнее

Нет

Смены

Для одного транспортного средства/курьера может быть указано несколько смен. Все они заполняются в одну строку по следующему принципу – сначала указывается группа полей с префиксом shifts.0, затем shifts.1, shifts.2 и так далее. Данный номер служит идентификатором смены для сервиса планирования маршрутов.

Примечание

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

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Время начала и конца смены; жесткое временное окно смены

shifts.N.time_window; shifts.N.hard_time_window

Время доступности водителей для планирования маршрутов. Если машины/курьеры обычно работают, например, с 9 до 17 (но небольшие переработки иногда случаются), то лучше сразу указать доступное время работы, например, с 9 до 17:30). При простановке временного окна смены важно учитывать время в начале маршрута / время в конце маршрута, поскольку алгоритм считает, что это время входит во время работы машины/курьера. Также, если машина/курьер возвращается на склад, это время также учитывается во времени работы машины/курьера (и должно быть отражено в окне смены). Подробнее. Обратите внимание: поля hard_time_window и hard_window являются взаимоисключающими.

Да

Жесткое временное окно, TRUE/FALSE

shifts.N.hard_window

TRUE — временное окно смены не может быть нарушено ни при каких обстоятельствах. FALSE — временное окно смены может быть нарушено (если это повлияет на более оптимальное использование ресурсов). Поле можно оставить пустым, тогда будет считаться, что временное окно мягкое (то есть его можно нарушить). Подробнее. Обратите внимание: поля hard_time_window и hard_window являются взаимоисключающими.

Нет

Максимальное число рейсов за смену

shifts.N.max_runs

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

Нет

Время между сменами, сек

shifts.N.service_duration_s

Данное время имеет смысл ставить только в случае нескольких последовательных смен машины, даже с пересекающимися временными окнам (например, смена 1 — с 9 до 14 часов, смена 2 — с 13 до 18, то есть смена 1 может закончиться раньше 14, но точно не позже, также смена 2 — может начаться не раньше 13, но может и позже). Если необходимо задействовать обе смены при планировании маршрутов, то данный параметр добавляется дополнительно между двумя этими сменами. Подробнее

Нет

Штрафы: за минуту нарушения окна смены; за факт нарушения окна смены; за минуту раннего начала смены; за факт раннего начала смены; за минуту позднего завершения смены; за факт позднего завершения смены

shifts.N.penalty.out_of_time.minute; shifts.N.penalty.out_of_time.fixed; shifts.N.penalty.early.minute; shifts.N.penalty.early.fixed; shifts.N.penalty.late.minute; shifts.N.penalty.late.fixed

Штрафы за нарушение временного окна заказа. Рекомендуется оставить значения по умолчанию (fixed = 1000, minute = 17) или пустым (в этом случае будет использовано значение по умолчанию). Изменения данного поля желательно только когда понятно его влияние на маршрутизацию. Изменение может потребоваться для сценариев: раннее начало смены недопустимо (но возможно завершать смену позднее) или наоборот; нарушение временного окна смены приемлемо, если это ведет к более оптимальному использованию ресурсов; используется жесткое окно смены и параметр Максимальная продолжительность смены. Подробнее

Нет

Максимальная продолжительность смены, сек: мягкое ограничение, жесткое ограничение

shifts.N.max_duration_s; shifts.N.hard_max_duration_s

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

Нет

Минимальное количество остановок за смену; штраф за каждую недостающую остановку меньше минимального количества; штраф за факт недостижения минимального количества остановок

shifts.N.minimal_stops; shifts.N.penalty.stop_lack.per_stop; shifts.N.penalty.stop_lack.fixed

Рекомендуется не использовать на начальных запусках маршрутизации (оставить пустым). В дальнейшем можно использовать для обязательного использования собственного транспорта. Подробнее

Нет

Максимальное количество остановок за смену; штраф за каждую дополнительную остановку сверх максимального количества; штраф за факт превышения максимального количества остановок

shifts.N.maximal_stops; shifts.N.penalty.stop_excess.per_stop; shifts.N.penalty.stop_excess.fixed

Рекомендуется не использовать на начальных запусках маршрутизации (оставить пустым). В дальнейшем можно использовать для ограничения количества точек в маршруте: для большегрузных машин (если это нельзя ограничить другими средствами, например, сервисным временем на заказах); для установки практического ограничения количества точек на маршруте (если, например, проверено на практике, что маршрут больше определенного количества точек курьер не выполнит без нарушений из-за возникновения тех или иных непредвиденных обстоятельств). Подробнее

Нет

Максимальный пробег за смену, км; штраф за факт пробега больше максимального; штраф за каждый км пробега больше максимального

shifts.N.max_mileage_km, shifts.N.penalty.max_mileage.fixed; shifts.N.penalty.max_mileage.km

Не используйте на начальных запусках маршрутизации (оставить пустым). В дальнейшем можно использовать для ограничения пробега машин/курьеров за смену. Подробнее

Нет

ID группы балансировки

shifts.N.balanced_group_id

Рекомендуется не использовать на начальных запусках маршрутизации (оставить пустым).Если возникнет потребность получать более равномерные маршруты, то можно заполнить группы балансировки на листе Options и в данном поле указать идентификатор группы балансировки. Подробнее

Нет

Посещенные заказы

shifts.N.visited_locations

В поле shifts.N.visited_locations можно перечислить id тех заказов, которые уже были назначены на данное ТС. При перечислении важна последовательность.

Нет

Перерывы для отдыха

Для одного транспортного средства/курьера можно указать несколько перерывов. Они описываются в одной строке: сначала группа полей с префиксом rest_schedule.breaks.0, затем с rest_schedule.breaks.1, rest_schedule.breaks.2 и т. д.

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Длительность перерыва, сек

rest_schedule.breaks.N.rest_duration_s

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

Нет

Штраф: за факт начала перерыва раньше; за минуту начала перерыва раньше; за факт начала перерыва позже; за минуту начала перерыва позже

rest_schedule.breaks.N.penalty.early.fixed; rest_schedule.breaks.N.penalty.early.minute; rest_schedule.breaks.N.penalty.late.fixed; rest_schedule.breaks.N.penalty.late.minute

Перерыв — мягкое ограничение: в некоторых случаях он может начинаться раньше или позже диапазона, определенного в поле work_time_range_till_rest. Алгоритм учитывает штрафы: early — для начала перерыва раньше срока; late — для начала перерыва позже срока. Чем больше значения штрафов, тем менее предпочтительно нарушение ограничения. Рекомендуется использовать значения по умолчанию (fixed = 1000, minute = 17) или пустые (тогда будут использованы значения по умолчанию). Подробнее

Нет

Время работы от начала маршрута

rest_schedule.breaks.N.work_time_range_from_start

Минимальная и максимальная продолжительность работы от начала маршрута. Учитывается время движения, ожидания и сервисное время на заказах и складах. Задается как диапазон времени в относительном формате. Подробнее

Нет

Время работы от последнего перерыва

rest_schedule.breaks.N.work_time_range_till_rest

Минимальная и максимальная продолжительность работы от последнего перерыва (или от начала маршрута, если это первый перерыв). Учитывается время движения, ожидания и сервисное время на заказах и складах. Задается как диапазон времени в относительном формате. Подробнее

Нет

Время движения и ожидания от начала маршрута

rest_schedule.breaks.N.travel_time_range

Минимальная и максимальная продолжительность движения и ожидания от начала маршрута. Сервисное время не учитывается. Задается как диапазон времени в относительном формате. Подробнее

Нет

Время движения и ожидания от предыдущего заказа

rest_schedule.breaks.N.continuous_travel_time_range

Минимальная и максимальная продолжительность движения и ожидания от момента завершения предыдущего заказа. Сервисное время не учитывается. Задается как диапазон времени в относительном формате. Подробнее

Нет

Использовать специальное место отдыха

rest_schedule.breaks.N.at_rest_place

Возможность отдохнуть в точке с типом rest_place. Подробнее

Нет

Лист Depot или Depots

На листе Depot содержится информация о складе, с которого будет производиться отгрузка. На данном листе заполняется только одна строка.

Если используется несколько складов, то необходим лист Depots, на котором указывается любое количество складов.

Как минимум одна строка склада обязательна для заполнения. Если машины/курьеры стартуют не со склада и не возвращаются на склад в конце маршрута (то есть нет никакой точки, к которой они были бы как-то привязаны), то в качестве склада можно указать координаты любой точки, например, координаты офиса или координаты центра города.

Depot и Depots — взаимоисключающие листы, допускается только один из них.

Примечание

Для листа Depot/Depots достаточно заполнить следующий минимум полей:

  • название склада (можно просто «Склад»);

  • координаты или адрес склада;

  • время работы склада (можно поставить максимально широко: 00:00-23:59 на текущие сутки планирования или 00:00-1.23:59 на текущие и следующие сутки планирования).

В остальных полях можно оставить значения по умолчанию (или оставить их пустыми) — этого будет достаточно для первого запуска задачи на маршрутизацию.

Описание допустимых полей на листах Depot/Depots приведено в таблице ниже.

Основная информация о складе

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Номер склада

id

id склада не должно повторять ни один из id заказов (то есть id заказов и склада должны быть уникальны). Если id не заполнено, то при загрузке данных из Excel и отправке задачи на маршрутизацию оно заполняется как 0. Подробнее

Да

Дополнительный идентификатор склада; название склада; описание склада

ref; title; description

Числовой или строковый идентификатор склада, который будет отображаться в интерфейсе Планирования; название склада; описание склада. Подробнее

Нет

Широта; долгота

point.lat; point.lon

Координаты точки склада: широта (point.lat), долгота (point.lon). Подробнее

Нет, если указывается адрес склада (при загрузке через интерфейс можно геокодировать адрес)

Адрес склада

address

Адрес для геокодирования. Подробнее

Нет (но если координаты склада не заполнены, то адрес указывать обязательно)

Временные окна склада

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Время работы склада

time_window

Если нет каких-то специальных требований ко времени возврата машин на склад / пропускной способности склада, то рекомендуется указывать максимально широкое время работы склада (например, 00:00-23:59 для планирования только в рамках одного дня или 00:00-1.23:59 в рамках 2-х суток). Подробнее

Да (если не указаны time_windows)

Несколько временных окон

time_windows.N.time_window

Используйте, если окно «разорвано» в течение дня или окна отличаются в разные дни. Нельзя использовать вместе с time_window. Подробнее

Да (если не указано time_window)

Жесткое временное окно работы склада

hard_time_window

Если основное окно работы склада является мягким, вокруг него можно задать жесткое временное окно. Подробнее. Обратите внимание: поля hard_time_window и hard_window являются взаимоисключающими.

Нет

Жесткое временное окно, TRUE/FALSE

hard_window

TRUE — временное окно склада не может быть нарушено ни при каких обстоятельствах. FALSE — временное окно склада может быть нарушено (если это повлияет на более оптимальное использование ресурсов). Поле можно оставить пустым, тогда будет считаться, что временное окно мягкое (то есть его можно нарушить). Подробнее. Обратите внимание: поля hard_time_window и hard_window являются взаимоисключающими.

Нет

Временные окна (мягкие и жесткие) для загрузки, дозагрузки или разгрузки заказов на складе

time_windows_loading.time_window; time_windows_loading.hard_time_window; time_windows_refilling.time_window; time_windows_refilling.hard_time_window; time_windows_unloading.time_window; time_windows_unloading.hard_time_window

Для каждого типа окон может задаваться одно окно или массив окон. Если окно какого-то типа не задано, для соответствующей операции используется общее временное окно склада. Подробнее

Нет

Время перед началом каждого рейса до готовности заказа на складе, сек

preliminary_service_duration_s

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

Нет

Штрафы за нарушение окон склада: за минуту нарушения окна склада; за факт нарушения окна склада; за факт нарушения окна склада (раньше); за минуту нарушения окна склада (раньше); за факт нарушения окна склада (позже); за минуту нарушения окна склада (позже)

penalty.out_of_time.minute; penalty.out_of_time.fixed; penalty.early.fixed; penalty.early.minute; penalty.late.fixed; penalty.late.minute

Штрафы за нарушение временного окна заказа. Оставьте значения по умолчанию (fixed = 1000, minute = 17) или пустым (в этом случае будет использовано значение по умолчанию). Изменяйте эти поля, только если это важно для вашей задачи. Подробнее

Нет

Сервисное время на складе

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Время обслуживания в начале рейса, сек; время обслуживания в конце рейса, сек

service_duration_s; finish_service_duration_s

Необходимо заполнять с учетом временного окна смены. Например, если нужно заполнить только время, которое должно добавляться только между рейсами, то можно поступить следующим образом: 1. Использовать только service_duration_s. 2. Время начала первой смены сделать раньше на значение service_duration_s. Например, водители работают с 9:00 до 17:00. Между рейсами необходимо выделить 30 минут на загрузку. В начале маршрута машины уже загружены. Если курьеры выезжают в 9:00, необходимо поставить смену с 8:30 до 17:00, а параметр service_duration_s сделать равным 1800 (тогда алгоритм будет считать, что работа начинается в 8:30, полчаса уходит на загрузку — то есть выезд возможен в 9:00. А в дальнейшем между рейсами будет добавляться эти полчаса). Подробнее

Нет

Время с момента разгрузки заказа на кросс-доке до последующей загрузки, сек

crossdock_safety_waiting_duration_s

Запас по времени при перегрузке через кросс-док: минимальный интервал времени, который должен пройти с момента разгрузки заказа на кросс-доке, прежде чем этот заказ можно будет забрать для доставки клиенту. Подробнее

Нет

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

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Пропускная способность по погрузке: кг/час; мест/час

throughput.kg_per_hour; throughput.units_per_hour

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

Нет

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

throughput.vehicle_count или throughput.vehicle_count.N.value; throughput.vehicle_count.N.time_window

Позволяет учитывать количество свободных мест для загрузки или разгрузки на складе throughput.vehicle_count. Если количество свободных мест зависит от времени, можно задавать разное значение параметра throughput.vehicle_count.N.value для временных окон throughput.vehicle_count.N.time_window. Подробнее

Нет

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

penalty.throughput.fixed; penalty.throughput.kg; penalty.throughput.unit; penalty.throughput.vehicle

Для начальных запусков маршрутизации рекомендуется оставить эти поля пустыми. Далее можно использовать значения по умолчанию (penalty.throughput.fixed = 1000, penalty.throughput.kg = 50, penalty.throughput.unit = 100, penalty.throughput.vehicle = 100000) и корректировать их, исходя из получаемых результатов. Подробнее

Нет

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

package_throughput.kg_per_hour или package_throughput.kg_per_hour.N.value; package_throughput.kg_per_hour.N.time_window

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

Нет

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

package_throughput.unit_per_hour или package_throughput.unit_per_hour.N.value; package_throughput.unit_per_hour.N.time_window

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

Нет

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

penalty.package_throughput.fixed; penalty.package_throughput.kg; penalty.package_throughput.unit

Для начальных запусков маршрутизации рекомендуется оставить эти поля пустыми. Далее можно использовать значения по умолчанию (penalty.package_throughput.fixed = 1000, penalty.package_throughput.kg = 50, penalty.package_throughput.unit = 100) и корректировать их, исходя из получаемых результатов.

Нет

Прочие настройки склада

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Гибкое время старта, TRUE/FALSE

flexible_start_time

Если важно получать от сервиса требуемое время старта машины/курьера, то нужно использовать данный параметр. Если время работы курьера отсчитывается от времени начала смены, то включать данный параметр нет необходимости. Подробнее

Нет

Признак, действуют ли на склад опции кучности маршрутов, TRUE/FALSE

use_in_proximity

Учет склада при построении кучных маршрутов. Подробнее

Нет

Лист Incompatible_order_types

На данном листе содержатся настройки несовместимых типов заказов. Если несовместимость заказов не используется (поле load_types), то данный лист можно не заполнять.

На данном листе всего 2 столбца: в столбце type необходимо указать одно значение load_types, а в столбце incompatible_load_types перечислить через запятую значения несовместимых с ним load_types. Каждую пару несовместимых load_types достаточно указать только один раз.

Например, если несовместимы типы 1, 2, 3 и 4, то достаточно указать такие строки:

type

incompatible_load_types

1

2,3,4

2

3,4

3

4

Лист Location_groups

На данном листе содержатся настройки групп заказов. Если группы заказов не используются (поле options.location_groups), то лист можно не заполнять.

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Название группы заказов

title

Наименование группы. Не влияет на планирование, только для удобства использования нескольких групп

Нет

Идентификаторы заказов

location_ids

Список id заказов, входящих в группу. Разделяются запятыми. Один заказ может входить только в одну группу

Да

Неразрывная группа

solid

По умолчанию — FALSE. Значение TRUE указывает, что группа неразрывная: заказы в ней должны выполняться без других заказов между ними. Порядок заказов в группе не фиксируется. Подробнее

Нет

Неделимая группа

dependent

По умолчанию — FALSE. Значение TRUE определяет, что группа неделимая: все ее заказы должны быть или выполнены, или (если невозможно доставить хотя бы один) сброшены в нераспределенные вместе. Подробнее

Нет

Лист Options

На данном листе содержатся опции маршрутизации. Опции заполняются в одну строку. Для первого запуска маршрутизации значения на данном листе можно не заполнять и оставить пустыми.

Описание допустимых полей на листе Options приведено в таблице ниже.

Для опозданий и нераспределенных заказов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Максимально допустимая доля нераспределенных заказов

max_drop_penalty_percentage

По умолчанию — 100. Подробнее

Нет

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

penalty.drop_penalty_percentage.fixed; penalty.drop_penalty_percentage.per_percent

Штрафы назначаются только при использовании параметра max_drop_penalty_percentage. Подробнее

Нет

Штраф за недоставку пропорционален весу/объему заказов

weighted_drop_penalty

По умолчанию — FALSE. Значение TRUE рекомендуется применять в сценариях, когда у заказов существенно различается вес/объем и используются ТС разного тоннажа (при этом количество ТС такое, что для развоза всех заказов их утилизация должна быть высокой)

Нет

Штрафовать за сервис позднее временного окна

penalize_late_service

По умолчанию — FALSE. Значение TRUE рекомендуется для увеличения попаданий сервисного времени в окна заказов. Подробнее

Нет

Для мультизаказов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Объединять заказы в мультизаказы?

merge_multiorders

Рекомендуется ставить TRUE — в большинстве случаев это ожидаемый сценарий. Подробнее

Нет

Признак объединения времени на обслуживание клиента в точке мультизаказа

wait_in_multiorders

Если FALSE, то время client_service_duration_s учитывается отдельно для каждого заказа в мультизаказе. Если TRUE, то учитывается максимальное значение параметра client_service_duration_s из всех заказов в мультизаказе. По умолчанию — TRUE. Подробнее

Нет

Штраф за каждый адрес мультизаказа, на который пришлось приезжать повторно; за каждый повторный приезд на адрес мультизаказа; за каждого курьера, который дополнительно посещает адрес мультизаказа

penalty.multiorders.per_extra_point; penalty.multiorders.per_extra_visit; penalty.multiorders.per_extra_vehicle

Штрафы за повторные посещения точек мультизаказов. Подробнее

Нет

Для заказов, разделенных на части

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Максимальная доля разделенных заказов, %

max_split_orders_percentage

Ограничение максимальной доли заказов, которые могут быть разделены. Может принимать значение от 0 до 100 (по умолчанию 100). Подробнее

Нет

Штрафы: за нарушение максимальной доли разделенных заказов; за каждый лишний процент в доле разделенных заказов

penalty.split_orders_percentage.fixed; penalty.split_orders_percentage.per_percent

Штрафы назначаются только при использовании параметра max_split_orders_percentage. Подробнее

Нет

Для складов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Погрузка по мере готовности

load_when_ready

Определяет сценарий погрузки заказов на складе. По умолчанию — FALSE, погрузка после готовности всех заказов. Если курьер должен начинать погрузку по мере готовности заказов, то указывается значение TRUE и определяется время готовности location.depot_ready_time и время на загрузку location.depot_duration_s. Подробнее

Нет

Для прочих точек

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Координаты точки, для которой задается пропускная способность

points_throughputs.N.point.lat; points_throughputs.N.point.lon

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

Нет

Пропускная способность точки: кг/час; мест/час; автомобилей/час

points_throughputs.N.throughput.kg_per_hour; points_throughputs.N.throughput.unit_per_hour; points_throughputs.N.throughput.vehicle_count

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

Нет

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

points_throughputs.N.penalty.throughput.fixed; points_throughputs.N.penalty.throughput.kg; points_throughputs.N.penalty.throughput.unit; points_throughputs.N.penalty.throughput.vehicle

Для начальных запусков маршрутизации рекомендуется оставить эти поля пустыми. Далее можно использовать значения по умолчанию (penalty.throughput.fixed = 1000, penalty.throughput.kg = 50, penalty.throughput.unit = 100, penalty.throughput.vehicle = 100000) и корректировать их, исходя из получаемых результатов. Подробнее

Нет

Для курьеров и автомобилей

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Признак учета характеристик грузовых автомобилей по классам

enable_vehicle_classes

Если включено, то для расчета вместимости грузовых автомобилей используются спецификации 21 класса. По умолчанию — TRUE. Подробнее

Нет

Зафиксировать смены

fix_planned_shifts

Используется при необходимости зафиксировать смены курьера, которые заданы в planned_route. По умолчанию — FALSE. Подробнее

Нет

Учет минимального количества остановок только для используемых курьеров

ignore_min_stops_for_unused

Используется при необходимости оптимизировать количество автомобилей на маршруте и при наличии требования минимального количества остановок. По умолчанию — FALSE. Подробнее

Нет

Несовместимые геозоны

incompatible_zones.N

Зоны, которые ТС или курьер не может посещать в одном рейсе. Подробнее

Нет

Способ передвижения, единый для всех курьеров

routing_mode

Заполняется только если все ТС/курьеры используют одинаковый способ передвижения. Если способы передвижения различаются, задается аналогичный параметр отдельно для каждого ТС. Подробнее

Нет

Для маршрутов

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Идентификатор группы; штраф за отклонение от среднего по времени; штраф за отклонение от среднего по остановкам (заказам); штраф за отклонение от среднего по custom_value маршрута; штраф за км отклонения от среднего по расстоянию маршрута; штраф за отклонение от среднего количества заказов; штраф за отклонение от среднего количества мест на маршруте;штраф за кг отклонения от среднего по массе маршрута; игнорировать неиспользуемые а/м при расчетах штрафа

balanced_groups.N.penalty.hour; balanced_groups.N.penalty.stop; balanced_groups.N.penalty.custom_value; balanced_groups.N.penalty.km; balanced_groups.N.penalty.served_order; balanced_groups.N.penalty.unit; balanced_groups.N.penalty.weight_kg; balanced_groups.N.penalty.ignore_unused_vehicles

Рекомендуется оставить значения по умолчанию и не использовать на начальных запусках маршрутизации. Если возникнет необходимость получать более равномерные маршруты, то можно заполнить группы балансировки и для начала использовать значения по умолчанию. Затем можно постепенно менять эти настройки, исходя уже из получаемых результатов. Может быть указано несколько групп балансировки. Все они заполняются в одну строку по следующему принципу: сначала указывается группа полей с префиксом balanced_groups.0, затем balanced_groups.1, balanced_groups.2 и так далее. Подробнее

Нет

Минимизация риска опозданий

minimize_lateness_risk

Рекомендуется оставить FALSE (это значение по умолчанию) и не использовать на начальных запусках маршрутизации. Подробнее

Нет

Глобальный фактор кучности маршрута

global_proximity_factor

Рекомендуется оставить 0 (это значение по умолчанию) и не использовать на начальных запусках маршрутизации. Диапазон значений: от 0 до 10. Чем больше значение, тем выше кучность маршрутов. Подробнее

Нет

Фактор близости местоположения заказов

proximity_factor

Рекомендуется оставить 0 (это значение по умолчанию) и не использовать на начальных запусках маршрутизации. Если возникнет потребность получать более сгруппированные маршруты, то данное значение можно постепенно повышать с небольшим шагом (например, 0.1). Если география точек по определению имеет большой разброс (например, город и область), то не рекомендуется использовать большие значения (больше 0,5). Подробнее

Нет

Прочие опции

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

Избегать платные дороги

avoid_tolls

Если нет специальных требований по использованию платных дорог, то рекомендуется оставить FALSE (это значение по умолчанию) и не использовать на начальных запусках маршрутизации. Подробнее

Нет

Матричный роутер

matrix_router

Определяет алгоритм, который используется для планирования маршрута. По умолчанию — main, используется для России, Турции и стран СНГ. Для остальных стран указывается значение global. Для расчета расстояния напрямую, без учета пробок — geodesic.

Нет

Дооптимизация последовательности

post_optimization

По умолчанию — FALSE. Значение TRUE рекомендуется применять в сценариях, когда используется балансировка с большими штрафами или географическая группировка с большими значениями global_proximity_factor. Подробнее

Нет

Перезапуск задачи для оптимизации маршрутов

restart_on_drop

Повторный запуск задачи планирования, если большое число заказов остались нераспределенными. По умолчанию — FALSE. Подробнее

Нет

Лист Routes

Данный лист заполняется в следующих ситуациях:

  • когда нужно учесть в планировании результаты предыдущего планирования (Подробнее см. Допланирование), данный лист повторяет ситуацию с допланированием, когда машины еще не выехали со склада;

  • когда необходимо смоделировать уже готовое планирование, например, планирование логиста, или рассчитать метрики такого планирования. Обратите внимание, что по умолчанию алгоритм будет оптимизировать последовательность развоза заказов, указанных для этого ID машины.

Если необходимо учесть порядок заказов, то используйте опцию vehicle.fixed_planned_route = true (см. в разделе Запланированный маршрут). Тогда будет важен порядок строк — для этого ID машины будет считаться, что заказы развозятся в том порядке, в котором они перечислены: сверху вниз.

Группа полей Excel

Атрибуты

Комментарий к заполнению

Обязательное поле

ID машины

vehicle_id

Идентификатор машины/курьера, для которого определен набор назначенных заказов.

Да (если используется лист Routes)

Смена

shift_index

Номер смены, используемый в шаблоне Excel (0, 1, 2…)

Да (если используется лист Routes)

Номер заказа

location_id

Идентификатор заказа, который был назначен на данную машину/курьеру.

Да (если используется лист Routes)

Время старта

start_time

Заполняется только для первого заказа. Время старта, которое необходимо использовать для данного маршрута. Можно не заполнять, тогда время будет выбрано исходя из остальных параметров планирования.

Нет

Написать в службу поддержки
В этой статье: