Категории

Сервисы топливных карт полная

Справочник "Сервисы топливных карт" позволяет связать систему мониторинга Fort Monitor и систему топливных карт. Связь осуществляется посредством внесения в справочник необходимой записи для подключения к системе топливных карт.

Получать данные можно из следующих сервисов топливных карт:

  • РН-Карт;
  • ППР - PetrolPlus; *доступно с версии Fort Monitor 3.20.0 (API актуализирован в версии 4.1)
  • Premium Card; *доступно с версии Fort Monitor 3.20.0
  • Ликард; *доступно с версии Fort Monitor 4.1.0
  • Руспетрол. *доступно с версии Fort Monitor 4.1.0

Для открытия справочника нажмите на пиктограмму "Справочники" справа от временной панели и выберите пункт "Сервисы топливных карт".

Описание справочника "Сервисы топливных карт"

На странице справочника отражён список всех ранее внесенных записей с учетными данными от той или иной системы - топливных карт.

В верхней части справочника расположены элементы управления списком, поля поиска по Названию/Типу, кнопки Запрос операций, Добавления, Изменения и Удаления записи.

Список содержит поля с параметрами:

  • Название – имя ранее созданной записи подключения к сервису топливных карт;
  • Тип – тип топливной карты.
  • Дата последнего запроса – дата последнего выполнения запроса данных из сервиса топливных карт.
  • Результат последнего запроса – API ответ результата последнего запроса данных из сервиса топливных карт.
    * Если в данном поле для записи типа "РН-Карт" отражено сообщение "An error has occurred." - необходимо перепроверить введенные учетные данные для подключения к сервису топливных карт.
Добавление карт

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


1. РН-Карт


2. ППР - PetrolPlus


3. Premium Card


4. Ликард


5. Руспетрол

В форме содержит следующие общие поля:

  • Наименование – Имя записи;
  • Примечание – Примечание записи;
  • Период забора данных (часы) – периодичность обращения системы Fort Monitor к системе топливных карт для получения данных;
  • Тип карты – тип топливной карты.

Кнопка "Сохранить" создает новую запись с внесенными учетными данными. Копка "Отмена" отменяет все ранее внесённые изменения и закрывает форму.

1. Карта РН-Карт

  • Код говора – код договора сервиса топливных карт. Можно узнать в личном кабинете в "Дополнительной информации" в левом меню, в разделе "ИНФОРМАЦИЯ О ДОГОВОРЕ". Код представляет собой строку вида "ISS012345".
  • Логин – логин пользователя от сервиса топливных карт.
  • Пароль – пароль пользователя от сервиса топливных карт.

2. Карта ППР - PetrolPlus

Ранее в интеграции ППР использовался API ключ, по которому осуществлялось подключение.
Поскольку ППР изменили и способ получения токена, и метод запроса операций, сервис PetrolPlus не работает на версиях FM ниже 4.1.
Теперь в личном кабинете необходимо подключить услугу "API на чтение", затем сформировать ClientID и ClientSecret:
Ссылка на файл с подробной инструкцией.

  • Client Id.
  • Client Secret.
  • Время поиска для операции возврата (минуты) – период времени, за который будет осуществляться поиск информации о возврате топлива.


3. Карта Premium Card

ВНИМАНИЕ: перед занесением данных о карте, в сервисе Premium Card необходимо в профиле, в личном кабинете, в разделе "Включение ЮЛ в выгрузку", выбрать "Форт телеком" и нажать "Сохранить":

  • Название компании - Наименование юр. лица, указанное в личном кабинете сервиса Premium Card: Вкладка "Реквизиты фирмы", поле "Название юр лица".
  • Время поиска для операции возврата (минуты) – период времени, за который будет осуществляться поиск информации о возврате топлива.


4. Карта Ликард

Через менеджера Ликард нужно запросить следующие данные:

  • Номер контракта - строка вида RU257009999
  • IP-адрес сервера - адрес для подключения к серверу запросов по API
  • Пароль - пароль от сертификата
  • Сертификат - загрузка в виде файла, расширение *.p12

Внимание!

  • Для серверной версии Fort Monitor Vendor на Linux дополнительные настройки не требуются – только обновление до 4.1.
  • На Windows требуется произвести еще 2 манипуляции:
1. Настройка реестра

Так как файл сертификата довольно большой, он не умещается в длину, разрешенную по умолчанию.
В результате сертификат фрагментируется, и из-за ошибок сети выдается итоговая ошибка проверки сертификата.

Чтобы этого избежать, нужно внести изменения в реестр на сервере FM:

  • В реестре найти путь HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\
  • Создать в нем раздел Messaging
  • В разделе создать параметр DWORD с именем MessageLimitClient, задать значение 65535 в десятичном виде.

Это можно сделать или вручную (как описано выше), или применив изменения через файл MessageLimitClient.reg

2. Настройка пула в IIS

При каждом обращении по API необходимо отправлять сертификат.

Чтобы IIS мог это сделать, необходимо ему дать возможность чтения/записи из локального хранилища сертификатов My\CurrentUser
Для этого нужно:

  1. Зайти в список Пулы приложений, выбрать пул WebApi
  2. Зайти в правой панели в Дополнительные параметры
  3. В них найти настройку Удостоверение
  4. Из списка выбрать LocalSystem

5. Карта Руспетрол

Через менеджера Руспетрол нужно запросить следующие данные:

  • Код договора - представляет собой строку вида "f762c4d9-f94b-99e8-9999-00999d999f07"
  • Имя пользователя
  • Пароль

Запрос операций

Кнопка "Запрос операций" отвечает за немедленный запрос данных, за выбранный период времени, по выбранной в списке записи. При нажатии на кнопку откроется следующая форма:

В форме задается начало и конец периода. По нажатию кнопки "Запросить" будет выполнен запрос данных из сервиса топливных карт, и по получению данных произойдет обновление информации в справочнике "Справочник заправок"
Кнопка "Отмена" закрывает форму "Запрос операций".