Базовый сценарий
Рассмотрим базовый сценарий интеграции и операционной работы с сервисом LSS.Monitor.
Все описанные ниже методы и операции доступны как через API, так и в веб-интерфейсе платформы.
Готовые датасеты волн для проверки отдельных возможностей сервиса собраны в разделе Примеры.
Последовательность действий
Подготовка
Авторизация
Для выполнения любых запросов к сервису необходимо предварительно сгенерировать токен доступа через сервис авторизации.
Создание экипажей
Для авторизации в мобильном приложении необходимо создать экипажи - аккаунт с ограниченными правами доступа.
Для создания экипажей необходимо иметь роль CREWMANAGER.
Экипажи создаются один раз, после чего их можно многократно задействовать в разных волнах планирования.
Вы можете добавить экипажи двумя способами:
Планирование
Перед запуском мониторинга необходимо рассчитать рейсы через сервис Universal.
-
Выполните планирование вашего датасета.
-
Сформируйте датасет из исходных данных для планирования и рейсов для загрузки в Monitor.
Импорт данных
Для импорта датасета выполните следующие шаги:
-
Создайте папку используя метод создания новой папки.
-
Создайте волну внутри этой папки с помощью метода создания файла.
-
Загрузите датасет в созданную волну, используя метод импорта данных.
Пример организации структуры папок и файлов:
├── Ленинградская область
└── Московская область
├── 2026-01
├── 2026-02
├── 2026-03
└── 2026-04
├── 23
│ ├── 08:00
│ ├── 12:00
│ ├── 16:00
│ └── 20:00
├── 24
│ ├── 08:00
│ ├── 12:00
│ ├── 16:00
│ └── 20:00
└── ...
Запуск рейсов
Для запуска рейса выполните следующие шаги:
-
Для назначение экипажа на рейс необходимо создать сделку.
-
После того как экипажи распределены, запустите рейсы в работу. Можно запустить как все рейсы из волны, так и выбирать их точечно.
-
Для автоматической обработки фактов и перепланирования рейсов необходимо включить автопилот.
Выполнение рейсов
Это активная фаза работы, когда экипажи уже находятся на маршрутах. Выполнение рейсов строится на тесном взаимодействии мобильного приложения исполнителя и серверной части Monitor.
Процесс выполнения запущенных рейсов разделен на несколько ключевых этапов:
-
Исполнитель авторизуется в мобильном приложении, после входа ему автоматически становится доступен список назначенных на него активных сделок (рейсов). Все полученные рейсы меняют статус на
TRIP_RECEIVED. -
Исполнитель подтверждает готовность к поездкам, переводя их в статус
TRIP_CONFIRMED(подтвердить готовность можно сразу по нескольким рейсам). Когда водитель непосредственно начинает движение, он берет конкретный рейс в работу, переводя его в статусTRIP_EXECUTING.
Важно: В работе (TRIP_EXECUTING) в один момент времени может находиться только один рейс.
Для активного рейса приложение начинает непрерывно фиксировать факты и отправлять GPS-координаты на сервер Monitor для отслеживания геопозиции.
-
На каждой контрольной точке исполнитель фиксирует события по заказу в приложении, которое отправляет их на сервер Monitor. В систему передаются данные о начале работы, статусе заказа (выполнен/отменен) и приеме оплаты.
-
Работа серверной части Monitor. В процессе работы периодически вызывается автопилот. Он сопоставляет плановые показатели прибытия на точку с фактическими GPS-данными и отметками исполнителя по заказам. После каждого пересчета система обновляет прогнозное время прибытия (ETA) на следующие точки, перестраивает маршрут для минимизации опозданий, передает скорректированные данные обратно в приложение водителю и в веб-интерфейс логисту.
-
Все данные о прохождении маршрута, сохраненные на сервере Monitor, становятся доступны для импорта во внутреннюю учетную систему вашей компании через интеграционный модуль.
Получение результатов работы исполнителей
В процессе выполнения задач система непрерывно аккумулирует фактические данные с мобильных приложений исполнителей.
Они необходимы для загрузки итогов работы во внутреннюю учетную мастер-систему.