Набор данных — самостоятельный набор справочников: точки с их заказами, ТС и склады. Это исходные данные: маршрутов и результатов расчёта в нём нет. Наборы создаются и редактируются на вкладке Данные. Из набора строятся маршруты на вкладке Маршруты и задачи на вкладке Расчёт.
Как создаётся набор
Каждый способ создаёт новый набор. Существующие наборы при этом не изменяются и не объединяются.
Способ
Где
Результат
Вручную
Данные → «Новый набор»
Пустой набор. Записи добавляются на вкладках «Точки», «ТС», «Склады».
Импорт XLSX
Данные → «Импорт XLSX»
Набор с именем файла. Формат файла — в разделе Набор данных XLSX. Там же — «Экспорт XLSX» и «Шаблон XLSX».
Из загруженного маршрута
Маршруты → «Перенести в расчёт»
Набор с именем маршрута. Заполняется из исходных данных загруженного файла.
Из 1С
Данные → «Проверить новые данные»
Окно со списком версий планов, ещё не загруженных: дата, версия, статус. Каждый отмеченный план становится отдельным набором «1С план <дата> vN».
Кнопка «Проверить новые данные» есть только в издании PRO. Остальные способы доступны во всех изданиях. Набор из 1С не становится активным, если в приложении уже были наборы. Уже загруженные планы запоминаются отдельно от наборов: удаление набора вручную не возвращает его план в список новых.
Из чего состоит набор
Один набор активен в каждый момент. Список наборов есть на вкладках «Данные» и «Расчёт», переключение в одном месте действует везде.
Часть набора
Обязательно
Необязательно
Точка
Код точки, широта, долгота, время на точке (подъезд и оформление, не зависит от объёма).
Название, адрес, дополнительное время на короб, окно «с» и «до», признак «Большегруз».
Заказ
Номер накладной, число коробов, вес, кг.
Наименование, номер накладной (если код — GUID), комментарий.
ТС
Гос. номер, вместимость в коробах, вместимость в кг.
Название, гос. номер (если код — GUID), склад, признак «Большегруз».
Склад
Код склада, широта, долгота, время погрузки (в начале смены и при каждой догрузке).
Адрес, окно «с» и «до».
Заказы принадлежат точке. Груз точки — сумма её заказов. Точка без заказов в расчёт не попадает.
Что приходит из 1С
Часть набора
Из 1С
Только вручную
Точка
Код, название, адрес, координаты, время на точке, время на короб, окно.
«Большегруз» и «Заморозка» (из 1С, при отсутствии — «нет»).
Заказ
Номер, коробы, вес, наименование, комментарий.
—
ТС
Код, название, гос. номер, вместимость, склад.
«Большегруз», «Заморозка» и «Наёмный транспорт» (из 1С, при отсутствии — «нет»). Для наёмного ТС предел точек по умолчанию — 16.
Склад
Код, название, координаты.
Время погрузки и окно (из 1С — 0 и пусто).
Не переносятся: часовой пояс склада, тип и смена ТС, маршрутный лист, пропущенные записи.
Что дальше: Маршруты и Расчёт
Набор — общая отправная точка: точки, ТС и склады без маршрутов. Дальше два способа использования, оба работают с одним и тем же набором.
Вкладка
Какой набор
Что происходит
Маршруты → «Собрать из справочника»
Любой набор, выбирается в списке рядом с кнопкой.
Ручное распределение. Создаётся по пустому маршруту на каждое ТС (нужно хотя бы одно). Точки с координатами становятся нераспределёнными и назначаются на ТС вручную. Точки без координат пропускаются, склады без координат отбрасываются.
Расчёт
Только активный набор.
Решатель строит маршруты. В расчёт уходят отмеченные точки, ТС и склады (по умолчанию отмечено всё; при смене набора отметки сбрасываются), а также дата и смены ТС из формы. Нужен хотя бы один склад.
Чем набор не является
Набор — не маршрут и не результат расчёта. И то, и другое строится из набора. Маршруты и результаты расчёта в набор не возвращаются. Ручное распределение работает с копией данных, поэтому правки маршрута и запуск расчёта набор не меняют.
Где хранятся наборы
Наборы хранятся только в локальном хранилище браузера и на сервер не отправляются. Очистка данных браузера удаляет их.
Набор данных XLSX
XLSX
Файл содержит три листа: Точки, ТС, Склады. Пустая необязательная ячейка — умолчание решателя: такое поле в расчёт не уходит. Столбцы со звёздочкой (*) обязательны. Скачать готовый шаблон можно на вкладке Данные → Шаблон XLSX.
Лист «Точки» — одна строка на заказ
Точка создаётся один раз по своему коду, заказы накапливаются на ней. Груз точки расчёт складывает из заказов сам — задавать его отдельно не нужно. Все заказы одной точки едут одним ТС и одним визитом.
Поле
Тип
Описание
Заказ.Номер*
строка
Номер накладной. Уникален в пределах файла.
Точка.Код*
строка
Код точки доставки. Несколько заказов могут ссылаться на один код.
Точка.Адресopt
строка
Текстовый адрес для отображения на карте.
Точка.Широта*
число
Широта (WGS-84), например 61.788544
Точка.Долгота*
число
Долгота (WGS-84), например 34.332719
Точка.Время_сopt
сек
Время на точке одним числом: подъезд, оформление документов и выгрузка. Пусто = 0.
Точка.Окно_сopt
чч:мм
Начало временного окна, например 09:00
Точка.Окно_доopt
чч:мм
Конец временного окна, например 17:00
Заказ.Наименованиеopt
строка
Что за груз — для отчёта.
Заказ.Коробов*
целое
Число коробов в заказе.
Заказ.Вес_кг*
число
Вес заказа, кг.
Заказ.Комментарийopt
строка
Произвольная пометка к заказу.
Точка.Большегрузopt
да / пусто
Точка принимает большегруз. Без признака её обслуживает только обычное ТС, с признаком — любое, но большегруз в приоритете.
Лист «ТС»
Вместимость задаётся двумя величинами, и обе действуют одновременно: маршрут допустим, только если ни вес, ни число коробов на борту не превышают лимит. Какие точки может обслужить ТС, ограничивают зоны и признак «Большегруз». Смена: выезд гибкий — решатель сам выбирает момент выезда внутри окна; пресеты — городская 06:00–20:00 (8/12 ч), длинная 04:00–18:00 (12/14 ч), с ночёвкой 04:00 — 06:00 следующего дня (16/26 ч).
Поле
Тип
Описание
Гос.номер*
строка
Государственный номер или идентификатор ТС.
Названиеopt
строка
Подпись для отчёта. Пусто = гос. номер.
Вместимость_кор*
целое
Максимальное число коробов на борту.
Вместимость_кг*
число
Максимальный вес груза, кг.
Складopt
строка
Код склада отгрузки из листа «Склады». Пустая ячейка — склад из первой строки листа «Склады». В карточке ТС не задаётся: расчёт идёт по одному складу.
Большегрузopt
да / пусто
Большегруз ездит только на точки с признаком «Точка.Большегруз».
Наёмныйopt
да / пусто
Наёмное ТС работает только по городу: в расчёт уходят городские зоны («СПб: …») — все или те из них, что закреплены за ТС. Сам признак идёт в запрос полем hired: по нему решатель понимает, что своих районов у машины нет, и подбирает их сам.
Максимум_точекopt
целое
Сколько точек ТС объедет за смену. С пределом ТС едет одним рейсом, без догрузок на складе. Пусто — без ограничений; у наёмного по умолчанию 16.
Смена_сopt
чч:мм
Выезд не раньше.
Смена_доopt
чч:мм
Финиш не позже.
Смена_до_след_дняopt
да / пусто
«Смена_до» — следующего дня (смена с ночёвкой).
Норма_смены_чopt
часы
Время сверх нормы штрафуется как переработка. Пусто = 8 ч.
Предел_смены_чopt
часы
Жёсткий предел длительности смены от фактического выезда. Пусто = 9 ч.
Зоныopt
строка
Зоны ТС через ; — названия областей набора, выбранного в расчёте (наборы зон живут в «Аналитике», по умолчанию «Зоны развозки»). ТС обслуживает только точки этих зон. Пусто = любые точки.
Старт_складopt
строка
Код склада из листа «Склады», откуда ТС выезжает. Пусто = склад отгрузки. Если это другой склад, ТС сначала едет порожним на склад отгрузки за погрузкой.
Финиш_складopt
строка
Код склада, куда ТС возвращается в конце смены. Пусто = склад отгрузки.
Лист «Склады»
Склад отгрузки — точка, где ТС загружается перед рейсом. Нужен хотя бы один.
Поле
Тип
Описание
Код*
строка
Уникальный код склада. На него ссылается столбец «Склад» листа «ТС».
Адресopt
строка
Текстовый адрес для отображения.
Широта*
число
Широта склада (WGS-84).
Долгота*
число
Долгота склада (WGS-84).
Время_погрузки_сopt
сек
Время погрузки. Тратится в начале смены и при каждой догрузке. Пусто = 1800 с.
Импорт маршрутов и метрик XLSX
XLSX
Файл является одновременно результатом экспорта маршрутов (кнопка «Выгрузить xlsx» на вкладке Маршруты) и может быть повторно загружен для просмотра или редактирования. Каждый лист файла — один маршрут ТС. Лист Метрики при импорте пропускается.
Строка-маркер. Идентификатор ТС, вместимость обеими величинами и дата расчёта. Используется при импорте для восстановления метаданных.
Строка 2
Заголовки
Имена столбцов (см. таблицу ниже).
Строки 3+
Данные
Одна строка на заказ. Несколько заказов одной точки идут подряд с теми же временны́ми полями.
Столбцы данных
Столбец
Заголовок
Описание
A
№
Порядковый номер остановки на маршруте.
B
Код точки
Код точки доставки. Для склада и старта/финиша — пусто.
C
Заказ
Номер накладной. Несколько заказов одной точки — отдельные строки с одинаковым номером остановки.
D
Адрес
Текстовый адрес точки.
E
Широта
Широта (WGS-84), 6 знаков.
F
Долгота
Долгота (WGS-84), 6 знаков.
G
Рейс
Номер рейса внутри смены. Растёт после каждой догрузки на складе.
H
Коробов
Число коробов в заказе.
I
Вес, кг
Вес заказа, кг.
J
Прибытие
Время прибытия на точку, формат ЧЧ:ММ. При импорте пересчитывается в ISO UTC.
K
Убытие
Время отправления с точки, формат ЧЧ:ММ.
L
Вид
Тип строки: старт — выезд, финиш — возврат, погрузка — склад, пусто — точка доставки.
Поведение при импорте
Ситуация
Поведение
Лист без маркера ТС в A1
Лист пропускается с предупреждением.
Лист Метрики
Всегда пропускается.
Строки с одинаковым кодом точки подряд
Группируются в одну остановку; заказы складываются в orders.
Строки старт / финиш
Формируют начало и конец смены.
Строка погрузка
Отмечает возврат на склад за новой партией — начало следующего рейса.
Время в колонках J/K
Конвертируется из местного времени в ISO UTC с использованием даты из маркера A1.
Результат маршрутизации JSON
JSON
Загружается через кнопку на вкладке Маршруты или по Task ID. Корневой объект может содержать поля result или data — они разворачиваются автоматически.
courier_routes — маршруты ТС
Объект вида { "ИД_ТС": [ остановки ] }. Первый элемент — начало смены, последний — её конец (на складе или на стоянке ТС), остальные — точки доставки и погрузки на складе.
Поле остановки
Тип
Описание
id
строка
Идентификатор точки из source.points. Для склада — id из source.depots.
lat / lon
число
Координаты остановки.
address
строка
Текстовый адрес.
time_in
ISO 8601
Время прибытия на точку.
time_out
ISO 8601
Время отправления с точки.
demand_pallets / demand_weight
число
Груз точки: короба и килограммы. Обе величины ограничивают ТС одновременно.
load_pallets / load_weight
число
Остаток на борту после обслуживания точки — по обеим величинам.
trip
целое
Номер рейса внутри смены. Растёт после каждой догрузки на складе.
kind
строка
stop — точка доставки, load — погрузка на складе (в начале смены и догрузки), depot — начало или конец смены.
late_sec
сек
Опоздание относительно окна точки. 0 — приехали вовремя.
code
строка
Код точки в учётной системе.
source — исходные данные задачи (RouterInput)
Ключ
Тип
Описание
source.base_time
ISO 8601
Начало отсчёта времени.
source.points
массив
Точки доставки (подробнее — в таблице ниже).
source.vehicles
массив
ТС: id, name, max_weight, max_boxes, time_window (окно смены, выезд гибкий), depot_id (склад погрузки), start_location / end_location (стоянка; пусто — склад отгрузки), zones (id зон; пусто — любые точки), heavy (большегруз: только точки с heavy), target_shift_time (норма смены, с; по умолчанию 8 ч), max_shift_time (предел смены, с; по умолчанию 9 ч)., hired (наёмное ТС: своих районов нет, домашние зоны ищет решатель), max_stops (предел точек за смену; с ним ТС едет без догрузок)
source.depots
массив
Склады отгрузки: id, location, service_time (время погрузки, по умолчанию 1800 с), limit_boxes (учитывать ли вместимость по коробам для товара склада, по умолчанию true). Нужен хотя бы один.
source.zones
массив
Зоны обслуживания: id, name и ровно одно из bbox{min_lat, min_lon, max_lat, max_lon} и geometry (GeoJSON Polygon / MultiPolygon, [lon, lat]). На них ссылается vehicles[].zones. Симулятор отправляет выбранный на вкладке «Расчёт» набор зон из «Аналитики» целиком; при «Перенести в расчёт» зоны файла становятся набором «Аналитики», если подходящего там ещё нет.
source.tts
число
Бюджет времени решателя, с.
source.points — поля точки
Поле
Тип
Описание
id
строка
Уникальный идентификатор точки доставки.
location
объект
{ lat, lon, address }, координаты WGS-84.
demand
объект
{ weight, pallets }. Можно не задавать — тогда считается суммой заказов.
orders
массив
Заказы на точке: id, demand, name, comment. Все заказы точки едут одним ТС и одним визитом.
time_window
объект
{ since, until } в ISO 8601.
service_time
сек
Время на точке одним числом: подъезд, документы и выгрузка. Ограничено 3,5 ч.
drop_penalty
целое
Штраф за недоставку точки; больше — точку жальче бросить. По умолчанию 1 000 000.
heavy
логическое
Точка принимает большегруз. Без признака её обслуживает только ТС без признака, с признаком — любое, но большегруз в приоритете.
code
строка
Код точки в учётной системе, если отличается от id.
input — параметры расчёта
Поле
Тип
Описание
input.date
строка
Дата расчёта (YYYY-MM-DD), отображается в заголовке.
input.name
строка
Имя расчёта.
input.tts
число
Бюджет времени решателя, с.
input.type
строка
Сценарий расчёта. Симулятор всегда отправляет full_source — полный расчёт.
input.region
строка
Регион — какой OSRM использует решатель. Симулятор пока всегда отправляет spb.
Расчёт: смены и зоны
Вкладка «Расчёт» собирает вход решателя из набора данных и отправляет задачу. Регион и сценарий пока одни: OSRM Петербурга и полный расчёт. Поле, которое не задано, в запрос не уходит — решатель подставляет своё умолчание.
Что включить в расчёт
Вкладка
Описание
Точки
Отмеченные точки. Точка без заказов в расчёт не уходит.
ТС
Отмеченные машины и их смена. Пресет смены выбирается здесь: длина смены зависит от того, по каким зонам ездит ТС, а зоны назначаются на этой же вкладке. В карточке ТС («Данные») смены нет.
Склады
Склады погрузки. Склад каждого отмеченного ТС должен быть отмечен.
Учитывать вместимость по коробам
Галочка в «Параметрах расчёта». Снята — вместимость ТС по коробам не действует, ТС ограничен только весом; короба точек при этом считаются и видны в отчёте как есть.
Зоны
Набор зон и закрепление ТС за зонами — см. ниже.
Смена ТС
Окно смены: выезд не раньше начала, финиш не позже конца. Выезд гибкий — решатель сам выбирает момент выезда внутри окна, чтобы не ждать открытия окон точек. Норма: время сверх неё штрафуется как переработка. Предел: жёсткий потолок длительности смены от фактического выезда. Все четыре величины задаёт пресет — по отдельности они не правятся. «Своя» означает смену из xlsx или загруженного расчёта, которая ни под один пресет не подошла; выбор пресета её перезапишет.
Пресет
Окно
Норма / предел
Городская
06:00 — 20:00
8 ч / 12 ч
Длинная
04:00 — 18:00
12 ч / 14 ч
С ночёвкой
04:00 — 06:00 следующего дня
16 ч / 26 ч; финиш обычно на стоянке
Стоянка — склад, где смена начинается и заканчивается. По умолчанию это склад отгрузки; если выбран другой, ТС сначала едет порожним на склад отгрузки за погрузкой.
Зоны
Зоны живут в «Аналитике»: на вкладке «Зоны» выбирается набор — «Зоны развозки» (тот же, что «Показать зоны» на карте), свой набор или «Без зон». В расчёт уходит весь набор. За зоной закрепляются ТС: раскройте карточку зоны — в ней видно только закреплённые машины, остальные добавляются кнопкой «+ ТС» через список с поиском. Кнопка «Распределить автоматически» подбирает парк и смены по грузу и времени движения. Невостребованные ТС остаются в резерве и снимаются с расчёта. Окна точек проверяются при запуске решателя. ТС с зонами обслуживает только точки своих зон, ТС без зон — любые точки. Большегруз ездит только на точки с признаком «Большегруз».
В карточке зоны
Что значит
точки · кор. · т
Сколько из отмеченных точек лежит в зоне и сколько у них груза. Точка в пересечении зон считается в каждой.
ТС, вместимость
Закреплённые за зоной отмеченные ТС и их суммарная вместимость.
загрузка
Вес груза зоны к суммарной грузоподъёмности её ТС за один рейс, по тоннам. Больше 100% — не ошибка: догрузки на складе решатель ставит сам.
Под большегруз
Груз точек с признаком «Большегруз» — только на них может ехать большегруз — и закреплённые за зоной большегрузы с их загрузкой.
Вне зон
Точки, не попавшие ни в одну зону набора. Их возят только ТС без зон; если таких нет, точки некому везти — решатель их отсеет.
При смене набора закрепления за зонами, которых в новом наборе нет, предлагается снять. «Перенести в расчёт» подбирает набор, в котором есть все зоны файла; если такого нет, зоны файла сохраняются в «Аналитику» новым набором.
Проверки перед отправкой
Те же, что делает решатель, — чтобы не получить отказ после отправки: склад и зоны каждого ТС есть в расчёте, у ТС заданы вместимость по кг и коробам, финиш смены позже выезда (для ночёвки — «на следующий день»), склад стоянки есть в справочнике, предел смены не меньше нормы, у точек и складов есть координаты.
Набор данных
Что включить в расчёт
Параметры расчёта
Отправка задачи…
pending
Удалить запись?
Новый токен
Токен выпущен
Токен показывается один раз. Скопируйте его сейчас — после закрытия окна восстановить его нельзя.
Новые данные из 1С
Новый набор данных
Ошибка расчёта
Недоставленные заказы
Загрузить маршрут
Перетащите файл сюда
или нажмите для выбора Поддерживаются форматы JSON, XLSX
Загрузить по task_id с сервера
Task ID
📁
Отпустите файл
JSON или XLSX дальше выберете действие
Уже загружен набор маршрутов
Что сделать с новым набором?
Мои маршруты
В этой сессии
Сессионные загрузки не являются списком сохранённых на сервере планов.