Wialon API: интеграция GPS-мониторинга с вашими системами
Через Wialon API ваша ERP, CRM, диспетчерская или мобильное приложение получают координаты, пробеги, топливо и события без ручных выгрузок. Выдаём доступ, помогаем разработчикам на старте и берём интеграцию под ключ, если своей команды нет.
- 09:12 POST /hooks/geofence · въезд «Склад Сумгайыт» · 200 OK
- 09:14 Заказ №4812 → статус «Прибыл на загрузку»
- 10:37 POST /hooks/stop · стоянка 3 мин у клиента · 200 OK
- 11:02 POST /hooks/sos · SOS, Фургон 10-XX-123 · 200 OK
- 11:03 CRM: тревога передана старшему смены
От данных на борту до решения диспетчера
Трекер
Координаты, датчики и события уходят на сервер Wialon, как при обычном мониторинге.
Wialon
Хранит сообщения, считает отчёты и по правилам отправляет HTTP-запросы на ваш адрес.
Токен и запросы
Ваша система забирает объекты, треки и отчёты по токену с ограниченными правами.
ERP, CRM, сайт
Статусы заказов, пробеги в 1С, карта на сайте — без ручных выгрузок и копирования.
Возможности и инструменты
Доступ
- Remote API: объекты, сообщения, отчёты
- Токены доступа и права для интеграций
- Webhooks: HTTP-запрос по событию
- Ретрансляция данных в сторонние системы
Интерфейсы
- SDK для веб- и мобильных приложений
- Карта с транспортом на вашем сайте
Один заказ, который прошёл через API
Условный пример: дистрибьютор, CRM и склад в Сумгайыте. Никто не переносит данные руками.
- Машина въехала в геозону склада вебхук
Wialon отправляет HTTP-запрос в CRM, заказ автоматически получает статус «на загрузке».
- Выезд со склада, клиенту уходит ссылка трекинг
CRM формирует ссылку на карту с машиной, клиент видит, где его заказ, без звонков менеджеру.
- Стоянка у клиента всего 3 минуты проверка
Слишком короткая выгрузка — менеджер видит пометку в CRM и перезванивает клиенту.
- Пробег за день выгружен в 1С по API
Скрипт по расписанию забирает отчёт по пробегу и топливу, бухгалтерия списывает ГСМ по факту.
Когда интерфейса Wialon уже мало
Первые месяцы после внедрения мониторинга большинству компаний хватает веб-интерфейса и отчётов. Потом появляются вопросы другого рода. Бухгалтерия хочет видеть пробег в 1С рядом с путевым листом. Отдел продаж — где сейчас машина с заказом клиента, прямо в карточке CRM. Логисты — чтобы новые рейсы из их системы сами попадали в мониторинг.
Копировать цифры из Excel в Excel можно, но это ежедневная ручная работа и источник ошибок. Правильный путь — дать системам общаться напрямую. Для этого у Wialon есть открытый API, а у нас — опыт подключения его к учётным системам компаний в Азербайджане.
Если вам нужна связка с конкретной программой, а не «API вообще», посмотрите также страницу про интеграцию с ERP и CRM. Здесь — о самих инструментах и о том, как устроено подключение.
Четыре способа забрать данные из мониторинга
Запросы к платформе по HTTP
Основной инструмент. Ваша программа отправляет HTTP-запрос и получает ответ в JSON. Через API доступно почти всё, что пользователь видит в интерфейсе:
- список объектов, их последние координаты, скорость и состояние датчиков
- история сообщений за период — сырые точки трека
- выполнение отчётов из шаблонов и получение результатов таблицами
- геозоны, водители, прицепы, уведомления
- создание и изменение объектов, отправка команд на трекер
Подходит, когда ваша система сама решает, когда спросить данные: раз в 5 минут, раз в сутки или по кнопке пользователя.
Как мы подключаем API
Пять шагов от первого письма до работающей интеграции. Для типовых задач укладываемся в одну-две недели, сложные проекты обсуждаем отдельно.
Порядок работы
1. Разбираем задачу
Какие данные, в какую систему, как часто и кто их будет смотреть. Часто оказывается, что нужен не API, а готовый отчёт по расписанию на почту. Тогда так и скажем.
2. Создаём технического пользователя
Отдельная учётная запись под интеграцию с правами только на нужные объекты. Если интеграция сломается или ключ утечёт, это не затронет доступ ваших диспетчеров.
3. Выдаём токен
Интеграция авторизуется токеном, а не паролем. Токен можно ограничить по сроку и правам и отозвать в любой момент без смены паролей людей.
4. Помогаем разработчикам
Даём примеры запросов под ваши задачи, показываем, где лежат нужные датчики и как называются параметры конкретных трекеров. Это экономит программистам дни на изучение документации.
5. Проверяем на реальных данных
Сверяем цифры из вашей системы с отчётами Wialon на одной-двух машинах за неделю. Только после этого включаем интеграцию на весь парк.
Что обычно строят на API
Пробег в 1С
Ежедневная выгрузка пробега и моточасов по каждой машине в путевые листы. Бухгалтерия перестаёт переписывать одометр вручную.
Статус заказа в CRM
Менеджер видит в карточке сделки, что машина с грузом вышла со склада и будет у клиента примерно через час.
Топливо в ERP
Заправки и расход по датчикам уходят в учёт ГСМ и сверяются с топливными картами. Расхождения видны без ручного сведения.
Табель выездных сотрудников
Время на объектах из отчётов по геозонам становится основой табеля и расчёта сдельной оплаты.
Собственный BI
Данные ежедневно складываются в вашу базу, а аналитики строят дашборды в Power BI или другом привычном инструменте.
Клиентский портал
Крупный заказчик видит свои рейсы в вашем кабинете, а не в чужом интерфейсе. Соседняя задача — публичная ссылка на отслеживание.
Что стоит учесть до начала разработки
Несколько вещей, на которых спотыкаются даже опытные команды.
- Лимиты запросов. У платформы есть ограничения на частоту и объём запросов. Опрашивать 200 машин раз в секунду по одной — плохая идея. Правильнее подписаться на изменения или брать данные пачками.
- Датчики называются по-разному. На Teltonika FMC130 и на Queclink один и тот же параметр топлива приходит под разными именами. Поэтому в интеграции ориентируемся на настроенные в Wialon датчики, а не на сырые параметры.
- Часовые пояса. API отдаёт время в формате Unix, то есть по UTC. Если забыть про смещение для Баку (UTC+4), отчёт в 1С «съедет» на 4 часа, и ночные поездки с полуночи до четырёх утра окажутся в предыдущем дне.
- Переименования объектов. Привязывайте машины по внутреннему идентификатору, а не по госномеру в названии. Номера меняются, а связка не должна ломаться.
Если своих разработчиков нет, интеграцию можно заказать у нас целиком — вместе с поддержкой после запуска в рамках SLA-обслуживания.
Документация, первый запрос и что делать с ошибками
Справочник по Remote API и SDK Gurtam публикует на sdk.wialon.com. Точный адрес сервера, к которому обращается ваша интеграция, зависит от того, где работает учётная запись, — его мы выдаём вместе с токеном, чтобы разработчики не гадали.
Как выглядит начало работы, без привязки к конкретному языку:
- Вход по токену. Запрос к сервису
token/loginс параметромtoken. В ответ приходит JSON с идентификатором сессии (eid) и данными пользователя. Этот идентификатор передаётся в следующих запросах. - Поиск объектов. Сервис
core/search_itemsс типомavl_unitвозвращает список машин, к которым у токена есть доступ, с набором полей по флагам: имя, последнее сообщение, датчики. - Отчёт. Выполнение шаблона отчёта за период и получение строк таблицы. Именно так обычно забирают пробег и топливо в 1С.
Права задаются при выдаче токена: только чтение или управление, какие объекты, срок действия. Для выгрузки в учётную систему хватает чтения. Права на команды трекеру выдаём отдельно и только если это действительно нужно.
Ошибки платформа возвращает в JSON полем error с числовым кодом. Практический минимум обработки, который мы просим заложить:
- недействительная сессия — заново войти по токену и повторить запрос;
- отказ в доступе — не повторять, а сообщить администратору: у токена не хватает прав или объект убрали из группы;
- неверные параметры — записать запрос в лог целиком, это ошибка в коде интеграции;
- таймаут или ответ сервера с ошибкой — повторить с паузой, а не сразу в цикле, иначе интеграция упрётся в лимиты.
Конкретные лимиты на частоту запросов и объём ответа зависят от конфигурации сервера. Их обсуждаем на старте, до того как разработчик напишет опрос каждые пять секунд.
Для кого это имеет смысл
Компании с учётной системой
Если путевые листы, заказы или ГСМ уже ведутся в 1С, SAP или своей ERP, API убирает двойной ввод данных.
Логистические операторы
3PL и экспедиторы, которые отчитываются перед заказчиками о каждом рейсе и хотят делать это автоматически.
Разработчики продуктов
Стартапы доставки, каршеринга и аренды, которым нужна готовая телематика под капотом собственного приложения.
Крупные парки
Когда машин больше сотни, ручные выгрузки начинают занимать целую ставку сотрудника.
Пример связки: дистрибьютор, CRM и склад в Сумгайыте
Покажем, как выглядит типичная интеграция изнутри. Дистрибьютор напитков развозит товар со склада в Сумгайыте по магазинам Баку и Абшерона. Заказы живут в CRM, машины — в Wialon, и раньше эти два мира не пересекались.
Утром CRM через API забирает список машин, которые вышли на линию, и закрепляет за ними маршрутные листы. Когда машина въезжает в геозону магазина, Wialon отправляет webhook, и заказ в CRM получает статус «доставлен, ожидает подтверждения». Если машина уехала из точки быстрее чем за 3 минуты, менеджер видит пометку и перезванивает клиенту: возможно, товар не выгрузили.
Вечером отдельный запрос забирает пробег и время работы каждой машины и кладёт их в учётную систему. Никто ничего не переносит руками.
Сложность здесь не в коде, а в договорённостях: какой статус считать «доставлен», что делать с точками без координат, кто отвечает, если CRM недоступна. Эти вопросы мы проговариваем с вашей командой до начала разработки.
Что ставим на машину
Remote API, вебхуки или ретрансляция
Три способа забрать данные. Выбор зависит от того, кто инициирует обмен и что нужно на выходе.
| Remote API | Вебхуки | Ретрансляция | |
|---|---|---|---|
| Данные по запросу вашей системы | Да | Нет | Нет |
| Мгновенно по событию | Нет, опрос | Да | Да, потоком |
| Готовые отчёты Wialon | Да | Нет | Нет, считаете сами |
| Все сырые сообщения трекера | Да, по запросу | Нет | Да |
Установка и стоимость
Функция доступна после подключения к платформе GPS.az. Стоимость складывается из оборудования, монтажа и ежемесячной абонентской платы, в которую входит трафик SIM-карты, — итог зависит от типа транспорта и набора датчиков. Точный расчёт под ваш парк подготовим бесплатно за 1 рабочий день.
- 1 Заявка и список машин
- 2 Расчёт и согласование графика монтажа
- 3 Установка оборудования на вашей площадке
- 4 Настройка отчётов и уведомлений в Wialon, обучение диспетчера
Вопросы про «Wialon API: интеграция GPS-мониторинга с вашими системами»
Оставить заявку
Специалист перезвонит и подберёт решение под вашу технику и задачу.