Wialon & ППР (оператор «Передовые платежные решения»)

Внешний отчет «Отчет по ГСМ» это инструмент сверки фактических заправок топлива по данным системы мониторинга Wialon с оплаченными заправками по топливным картам ППР (PetrolPlus / TransitCard). Отчет сопоставляет два независимых источника по госномерам автомобилей за выбранный период и выделяет расхождения, превышающие заданные пороги.

Типичный сценарий использования это контроль сливов и недоливов, проверка корректности списания топлива, выявление авто, по которым есть заправки только в одном из источников.

Что делает отчет

1 Загрузка данных из ППР

• Авторизация по OAuth2 (client_credentials) на idp.petrolplus.ru
• Получение списка активных карт (GET /cards?status=4)
• Загрузка транзакций по каждой карте (GET /cards/{номер}/transactions) с пагинацией
• Извлечение из транзакций: держателя, вида топлива, цены, суммы, литров, госномера, отдела
• Если API не отдает объем, литры вычисляются из суммы и цены
• Фильтрация: только ДТ, исключение АИ-92, отсечение не топливных позиций (штуки, комплекты, услуги), фильтр по отделам, отсечение транзакций вне периода

2 Загрузка данных из Wialon

• Авторизация по токену (token/login)
• Получение списка техники (core/search_items, avl_unit)
• Поиск ресурса и шаблона отчета, в котором есть показатель заправок и/или таблица заправок
• Выполнение отчета по каждому объекту (report/exec_report)
• Извлечение объема заправок из статистики и количества заправок из таблицы заправок
• Завершение сессии и очистка результатов

3 Сверка данных

• Нормализация госномеров (латиница в кириллицу, удаление пробелов, дефисов и мусора)
• Агрегация ППР по авто: сумма, литры, количество заправок, средняя цена, отдел, держатель
• Агрегация Wialon по авто: заправлено литров, количество заправок
• Полное соединение по госномеру, видны авто, которых нет в одном из источников
• Расчет отклонения: Wialon минус ППР (литры)
• Объединение видов топлива по авто (ДТ + АИ-92), чтобы было видно, что учтены все заправки

4 Вывод результата

Отчет строится по макету или программно (если макета нет). Колонки:

| Номер авто | Отдел | Держатель | Вид услуги | Ср. цена | Сумма | Заправлено (ППР) | Запр. (ППР) | Заправлено (Wialon) | Запр. (Wialon) | Отклонение |

Подсветка:

Красный текст всей строки нет данных с одной из сторон при отрицательном отклонении

Оранжевый фон + красное отклонение превышение порога

Порог превышения срабатывает, только если отклонение отрицательное (в баке меньше, чем оплачено) и превышает оба порога одновременно: по литрам (по умолчанию 5 л) и по процентам (по умолчанию 5 % от объема ППР). Положительное отклонение нарушением не считается.

Режим «Только отклонения» скрывает строки без проблем.

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

Возможности

• Гибкие фильтры: только ДТ, исключение АИ-92, фильтр по отделам, режим «только отклонения»
• Настраиваемые пороги подсветки: по литрам и по процентам
• Тестовый режим ППР переключение на mock хост paid-api-mock.transitcard.ru
• Подробный лог сообщения о ходе загрузки, найденных шаблонах, структурах ответов, датах транзакций, вычисленных литрах
• Диагностика Wialon при отсутствии данных выводится краткое описание структуры ответа шаблона
• Печать ландшафтная ориентация, автомасштаб, фиксация шапки, поля, имя параметров печати
• Работа с внешним отчетом и дополнительной обработкой регистрация в «Дополнительных отчетах и обработках»

Настройка

Параметры подключения задаются в модуле объекта, в области НастройкиПодключения:

ТокенWialonИзКода() токен Wialon
PPR_ClientIDИзКода() / PPR_ClientSecretИзКода() учетные данные OAuth2 ППР
PPR_ТестовыйРежимИзКода() тестовый режим ППР
ИмяШаблонаWialonИзКода() подстрока имени шаблона отчета Wialon (если пусто, выбирается автоматически)
ТаймаутHTTPИзКода() таймаут HTTP запросов
ПодробныйЛогИзКода() подробный лог

Пороги подсветки и режим «только отклонения» задаются в НастройкиПоУмолчанию():

ДопОтклонениеЛитров порог по литрам (по умолчанию 5)
ДопОтклонениеПроцентов порог по процентам (по умолчанию 5)
ТолькоОтклонения выводить только проблемные строки

Требования и совместимость

Платформа: 1С:Предприятие 8.3 (используются HTTPСоединение, ЗащищенноеСоединениеOpenSSL, ЧтениеJSON)

Проверено на конфигурации: Управление торговлей, ред. 11.1 (11.1.10.199) на платформе 8.3.27.2214. (Отчет является внешним, поэтому не привязан жестко к конкретной конфигурации и может быть подключен к любой конфигурации на БСП)