Интеграция с топливным процессингом загружает в Waliot транзакции по топливным картам (объем, сумма, АЗС, карта, водитель, ТС), чтобы сверять их с расходом по данным мониторинга. По этой инструкции администратор подключает процессинг к организации и привязывает топливные карты к объектам.
¶ Настройка топливной интеграции
Топливную интеграцию с внешним процессингом подключают в панели администратора Waliot: в боковой панели выбранной организации на вкладке «Интеграции». Все ранее созданные подключения отображаются в списке, а добавление новой интеграции выполняется через кнопку в нижней части панели. Добавлять, изменять и удалять интеграции может пользователь с правом «Расширенный доступ администратора» — это право выдается роли «Расширенный администратор»: у роли «Администратор» кнопки «Добавить интеграцию», «Сохранить изменения» и удаления неактивны. WALIOT.Навигатор показывает транзакции по интеграциям той организации, к которой относится пользователь, поэтому интеграцию подключайте именно в ней, а не в вышестоящей организации.
Разные процессинги используют разные способы авторизации, поэтому в окне добавления или редактирования перечислены поля, нужные для выбранного процессинга; набор полей по каждому типу приведен в таблице ниже. Например, для ГАРВЕКС заполняют поля «Пользователь» и «Пароль»; для них рекомендуем использовать отдельную интеграционную учетную запись. Ниже на этой странице приведены отдельные инструкции по получению данных доступа для каждого поддерживаемого процессинга.
После создания топливной интеграции и сохранения корректных авторизационных данных пользователи выбранной организации смогут просматривать топливные транзакции в WALIOT.Навигаторе за произвольный интервал времени в модуле «Топливные карты и штрафы»: процессинг выбирают слева, столбцы таблицы транзакций — справа.
¶ Поля форм по процессингам
В меню «Добавить интеграцию» семь типов интеграций: шесть топливных процессингов и УСС ГАРВЕКС. Набор полей формы зависит от типа:
| Тип интеграции | Поля формы |
|---|---|
| Интеграция с Гарвекс | «Пользователь», «Пароль» |
| Интеграция с Петрол Плюс (Вездеход) | «Идентификатор клиента» и «Секрет клиента» — блок «Актуальная интеграция»; «Токен» — блок «Устаревшая интеграция». Заполняют либо идентификатор и секрет клиента, либо только токен |
| Интеграция с E100 (E1 Card) | «Пользователь», «Пароль» |
| Интеграция с OnlineOil | «Email», «Пароль» |
| Интеграция с Роснефть (РН-Карт) | «Код контракта», «Пользователь», «Пароль» |
| Интеграция с Газпромнефть (Опти 24) | «Логин», «Пароль» |
| Интеграция с Лукойл (Ликард) | «Номер договора», «Файл сертификата» (файл в формате .p12), «Пароль от сертификата» |
У ППР при другом сочетании заполненных полей форма показывает подсказку «Заполните либо идентификатор и секрет клиента, либо только токен интеграции», а пробелы в начале и в конце значений при сохранении обрезаются автоматически. У остальных типов значения с пробелами в начале или в конце не принимаются: кнопка «Сохранить изменения» остается неактивной.
¶ Проверка данных, обновление и удаление интеграции
При сохранении интеграции учетные данные не проверяются: корректность видна при формировании данных в разделе «Топливные карты и штрафы», где при ошибке получения данных, в том числе из-за неверных учетных данных, появляется сообщение «Не удалось построить отчет». В этом случае проверьте в личном кабинете процессинга логин и пароль, срок их действия и доступ к API (для ЛИКАРД — файл сертификата и пароль от сертификата). Описание раздела — на странице «Топливные карты и штрафы».
Процессинги не синхронизируются заранее: данные запрашиваются у процессинга при каждом нажатии «Сформировать» и «Перезагрузка» в WALIOT.Навигаторе. Интеграцию удаляют значком удаления в строке списка после подтверждения «Вы уверены, что хотите удалить данную интеграцию?»; после удаления при повторном открытии раздела «Топливные карты и штрафы» для этого процессинга снова показывается предложение подключить интеграцию.
¶ Настройки топливной карты
Топливные карты процессинга привязывают к объектам мониторинга Waliot, чтобы транзакции сопоставлялись с объектами и работала сверка «транзакции процессинга — фактическое топливо по ДУТ/CAN». Привязка топливных карт выполняется в правой панели объекта мониторинга на вкладке «Топливные карты» в панели администратора: процессинг выбирают из списка, затем карту добавляют кнопкой под ним.
При привязке топливной карты к объекту используемый идентификатор зависит от процессинга: в одних системах это внутренний ID карты/учетной записи (например, в ГАРВЕКС — числовой идентификатор из «АЗС-Онлайн»), в других — стандартный номер топливной карты, указанный на самой карте или в личном кабинете процессинга.
После добавления топливной карты к объекту мониторинга Waliot будет автоматически подставлять этот объект в соответствующие топливные транзакции в WALIOT.Навигаторе. Транзакция относится к объекту по номеру карты, когда карта привязана ровно к одному объекту; от настройки топливной аналитики сопоставление не зависит. Для транзакций ГАРВЕКС, ППР, OnlineOil и Роснефти без привязанной карты платформа дополнительно ищет объект по регномеру из данных транзакции и относит транзакцию к нему, когда регномер совпадает ровно с одним объектом.
Сравнение выданного по транзакциям топлива с фактически полученным выполняется для объектов с настроенной топливной аналитикой по ДУТ/CAN: у объекта есть датчик зажигания, датчик уровня топлива и анализ топлива, к которому ДУТ привязан полем «ID привязанного анализа топлива». Условия описаны в разделе Что нужно для расчета топлива страницы анализа топлива.
¶ Отображение топливных транзакций
Просмотр топливных транзакций из подключенных процессингов доступен в WALIOT.Навигаторе в модуле «Топливные карты и штрафы». Если для объектов настроены топливные карты и включена топливная аналитика Waliot (ДУТ/CAN), система автоматически связывает транзакции с нужными объектами и дополняет их расчетами для сверки выдачи и фактического расхода.
¶ Поддерживаемые топливные процессинги
¶ ГАРВЕКС
ГАРВЕКС подключается как интеграция с оборудованием АЗС: данные о выдаче топлива через устройства съема сигнала ГАРВЕКС поступают из сервиса «АЗС-Онлайн», доступного по адресу https://azs-online.ru. В меню «Добавить интеграцию» она называется «Интеграция с Гарвекс», в списке созданных — «Интеграция с Гарвекс. Оборудование для АЗС»; в форме заполните «Пользователь» и «Пароль». При использовании оборудования ГАРВЕКС вам предоставляют учетную запись в этом сервисе: в личном кабинете вы можете найти числовые идентификаторы топливных карт, а также создать отдельную интеграционную учетную запись для подключения к Waliot.
¶ ППР (Передовые Платежные Решения)
Топливный процессинг ППР доступен в личном кабинете по адресу https://online.petrolplus.ru и используется, в том числе, для обслуживания топливных карт «Вездеход». Для подключения ППР в Waliot сначала оформите API-доступ на чтение в личном кабинете ППР (инструкция доступна по ссылке). API-доступ на чтение — отдельная услуга ППР со своей стоимостью: условия указаны в личном кабинете, в разделе о стоимости услуги API на чтение. Запросы Waliot к ППР выполняются от имени вашего API-доступа и учитываются ППР по его условиям.
Затем в панели администратора создайте интеграцию «Интеграция с Петрол Плюс (Вездеход)»; после сохранения она отображается в списке как «Интеграция с Петрол Плюс (Вездеход). Топливные карты и штрафы». В форме два блока: в блоке «Актуальная интеграция» заполните поля «Идентификатор клиента» и «Секрет клиента» значениями Client ID и Client Secret из кабинета ППР, а поле «Токен» в блоке «Устаревшая интеграция» оставьте пустым: заполняют либо идентификатор и секрет клиента, либо только токен интеграции. «Токен» предназначен для ключа прежней версии API ППР: если он заполнен, Waliot обращается к прежней версии, а она не работает с 1 июля 2026 года. Копируйте значения из кабинета целиком; пробелы в начале и в конце при сохранении обрезаются автоматически.
В личном кабинете ППР проверьте номера топливных карт «Вездеход» и привяжите карты к объектам мониторинга на вкладке «Топливные карты» как карты «Петрол Плюс (Вездеход)», указав номер полностью, как в кабинете ППР. Тогда транзакции сопоставляются с объектами по номеру карты и работает сверка топлива. Одну карту не привязывайте к нескольким объектам: транзакции по ней не будут отнесены ни к одному из них.
¶ Интеграция с E100 (E1 Card)
Топливный процессинг E100 (E1 CARD) доступен в личном кабинете по адресу https://clients.e1-card.ru. Для подключения E100 в Waliot получите учетные данные или доступ для интеграций в кабинете E1 CARD, затем укажите их при создании интеграции в панели администратора: в полях «Пользователь» и «Пароль». В этом же кабинете проверьте номера топливных карт E100 и привяжите их к объектам мониторинга в Waliot, чтобы транзакции сопоставлялись корректно и была доступна сверка топлива.
¶ Интеграция с OnlineOil
Топливный процессинг OnlineOil доступен в личном кабинете по адресу https://lk.oilonline.ru. Для подключения OnlineOil в Waliot получите учетные данные или доступ для интеграций в личном кабинете, затем укажите их при создании интеграции в панели администратора: в полях «Email» и «Пароль». В этом же кабинете проверьте номера топливных карт и привяжите их к объектам мониторинга в Waliot, чтобы транзакции сопоставлялись корректно и была доступна сверка топлива.
¶ Интеграция с Роснефть (РН-Карт)
Топливные карты Роснефти обслуживаются через процессинг РН-Карт и доступны в личном кабинете по адресу https://lk.rn-card.ru. Для подключения РН-Карт в Waliot получите в кабинете учетные данные или доступ для интеграций, затем укажите их при создании интеграции в панели администратора: в полях «Код контракта», «Пользователь» и «Пароль». После подключения проверьте номера топливных карт в кабинете РН-Карт и привяжите их к объектам мониторинга в Waliot, чтобы транзакции сопоставлялись корректно и была доступна сверка топлива.
¶ Интеграция с Газпромнефть (Опти 24)
Топливные карты ОПТИ24 (Газпромнефть) обслуживаются через процессинг МЕГАКАРТА и доступны в личном кабинете по адресу https://cabinet.mega-karta.ru. Для подключения ОПТИ24 в Waliot получите в кабинете МЕГАКАРТА учетные данные или доступ для интеграций, затем укажите их при создании интеграции в панели администратора: в полях «Логин» и «Пароль». После подключения проверьте номера карт ОПТИ24 в кабинете и привяжите их к объектам мониторинга в Waliot, чтобы транзакции сопоставлялись корректно и была доступна сверка топлива.
¶ Интеграция с Лукойл (Ликард)
Топливный процессинг ЛИКАРД (ЛУКОЙЛ) доступен в личном кабинете по адресу https://lk.licard.com. Для подключения ЛИКАРД в Waliot потребуется не только учетная запись в личном кабинете, но и файл клиентского сертификата, который используется для авторизации в интеграции. Получите сертификат и сопутствующие данные доступа в ЛИКАРД, затем при создании интеграции в панели администратора кнопкой «Выбрать файл» загрузите файл сертификата в формате .p12 (после выбора показывается имя файла, а при повторном открытии сохраненной интеграции — «Файл сертификата прикреплен») и заполните поля «Номер договора» и «Пароль от сертификата». После этого проверьте номера топливных карт в кабинете ЛИКАРД и привяжите их к объектам мониторинга в Waliot, чтобы транзакции сопоставлялись корректно и была доступна сверка топлива.
¶ Что дальше
- Топливные карты и штрафы — интеграция сохранена: откройте транзакции и убедитесь, что они подтянулись за выбранный период.
- Отчет «Выдача топлива по картам» — карты привязаны к объектам: сверьте выданное топливо с фактической заправкой по ДУТ.
¶ Связанные возможности