Операции по картам Роснефти

Регистрация карт

В Process Insight в таблицу “Карты Роснефти” заносится информация по всем картам Роснефти:

• Номер карты
• Пароль
• Источик данных – задаёт привязку карты к личному кабинету Роснефти
• Водитель (в поле “Водитель” можно поставить водителя, закреплённого за картой, либо можно оставить поле пустым, и тогда водитель будет выбран при активации карты водителем)
• Активирована (поле недоступно для редактирования, заполняется системой)
• Описание
• Информация (только для чтения) – в этом поле выводятся при необходимости системные сообщения

При заведении новой карты система удаляет лимит(ы) по ней, используя API Роснефти. Если удалить лимиты не удалось, строка с новой картой не будет сохранена; напротив строки будет выведено сообщение об ошибке. – на этапе тестовой эксплуатации эта функция не настроена, чтобы не удалить лимиты по выданным картам

Проверяется уникальность номера карты.

Выдача карты водителю/ активация карты

При выдаче водителю на руки карты Роснефти диспетчер не заносит информацию ни в Битрикс, ни в Process Insight. При этом, если карта заведена в таблицу “Карты Роснефти” и не активирована, на ней нет лимитов.

Водитель, получив карту, должен её активировать в боте. Для этого выбирается пункт “Карта РН/ Активировать карту РН” (кнопка “Активировать карту РН” выводится только если у водителя нет активированной карты; другие пункты в разделе “Карта РН” не выводятся). Система выводит сообщение: “Введите номер карты Роснефти” и кнопку “Отменить” (возвращает в главное меню).

При вводе номера карты система:

1. Проверяет наличие этой карты в таблице “Карты Роснефти”. При этом:
   • если карты с таким номером нет, выдаётся сообщение “Неверный номер карты. Введите номер повторно.”;
   • если карта привязана к другому водителю, система выдаёт сообщение об ошибке.
2. Проверяет наличие закрепления за водителем карты. Если найдена карта, закреплённая за водителем, и номер карты отличается от введённого, выдаётся сообщение: “Введён неверный номер карты. За вами закреплена карта с номером XXX”.
3. Закрепляет карту за водителем (заполняется поле “Водитель” в таблице; для записи в таблице сохраняется история изменения).
4. Удаляет лимиты по карте (если они есть).
5. Проверяет баланс водителя по разделу “Роснефть”. Если имеется ненулевая кредиторская задолженность, на карту устанавливается лимит на эту сумму.
6. Карта считается активированной (ставится галочка “Активирована”) после того как будут удалены лимиты и установлен новый лимит исходя из баланса.
7. Выводится сообщение в бот: “Карта активирована. Пин-код: XXX – вводите его при заправке по карте на терминалах ввода PIN-кода.”.
8. Выводится главное меню бота.

Если по карте не завершена деактивация, то повторная активация невозможна до момента завершения задания по деактивации (см. далее). Выводится сообщение: “По карте не завершена деактивация. Повторите активацию через 24 часа.”.

Деактивация карты

Деактивация карты может быть выволнена диспетчером или водителем.

Деактивация карты диспетчером

Для деактивации карты диспетчер должен найти соответствующую запись в таблице “Карты Роснефти” и удалить привязку к водителю (очистить поле “Водитель” и сохранить таблицу).

Если требуется вывести карту из оборота и гарантировать, что никто не сможет её активировать повторно, следует также изменить номер карты. Рекомендуется к номеру добавить “ выведена из оборота”.

Деактивация карты водителем

Для деактивации карты водитель должен выбрать в меню бота “Карта РН/ Отвязать карту”. Система выводит сообщение: “Для подтверждения открепления карты Роснефти введите ДА”. Если водитель вводит “Да”, то Система удаляет привязку карты и водителя.

Общие действия при деактивации

При деактивации проверяется соответствие остатка на лимите карты по данным Роснефти (проверяется по API) и остатка кредиторской задолженности перед водителем по разделу “Роснефть”. Если остатки не соответсвуют (такое может быть, если водитель использовал карту для оплаты топлива и сразу же её деактивировал; обновление данных по операциям доступно по API через пару часов после совершения оплаты) или API недоступно, система регистрирует внутреннее задание на корректировку баланса по карте водителя. Задание будет повторяться до момента, когда API будет доступно. При этом задание будет завершено успешно, если будет получена информация по операциям водителя (которые будут отражены в балансе водителя), выводящим баланс по разделу “Роснефть” в равенство с информацией по балансу из лимита. Если равенство не будет достугнуто по истечении 24 часов с момента запуска задания, задание завершается, а в карточку карты в поле “Информация” заносится соответвующее сообщение.

При деактивации карты Система удаляет по API Роснефти лимиты (если при удалении возникнет ошибка, система сохраняет запись, но информацию о том, что лимит по карте не удалось удалить, сохраняется и выводится в поле “Информация”).

Вывод средств на карту

Вывод средств возможен только с активированных карт. Для вывода средств на карту Роснефти водитель в боте должен выбрать пункт “Вывести средства/ На карту РН”. Система предложит: “Баланс Яндекс.Таксометр: XXX руб. Введите сумму для пополнения карты Роснефти (комиссия XX%)”.

Система проверяет доступность средств на балансе Яндекс.Таксометр. Если средств недостаточно, выводится сообщение: “Недостаточно средств для пополнения карты. Доступно средств на балансе Яндекс.Таксометр: XXX руб. Введите сумму для пополнея карты.”.

При вводе достаточной суммы система:

• создаёт балансовую проводку по кредиту раздела “Роснефть”
• запускает задание на списание суммы с баланса Яндекс.Таксометр
• запускает задание на увеличение лимита по карте Роснефти

При успешном завершении задания на увеличение лимита по карте Роснефти водителю в бот выводится сообщение “Баланс по карте Роснефти пополнен на сумму XXX руб.”.

Запросы на вывод сохраняются в системе и доступны из таблицы “Карты Роснефти” для каждой карты.

Запрос лимита

Доступный лимит по карте выводится в боте из меню “Карта РН/ Лимит”. Система обращается по API к данным Роснефти и выводит доступный лимит. Если API недоступно, выводится “Информация о лимите временно недоступна. Повторите операцию позже.”.

Запрос операций по карте Роснефти

Водитель может проверить операции по карте Роснефти за последнюю неделю. Для этого в боте выбирается пункт “Карта РН/ Последние операции”. Система выводит: “Нет информации по операциям за последнюю неделю” или “Операции за последнюю неделю: “ и перечень операций.

Контроль операций

Для обеспечения целостности данных система один раз в 6 часов импортирует последние операции по всем картам Роснефти. Для каждой операции создаётся соответствующая балансовая проводка по дебету раздела “Роснефть”.

Кредитовый баланс водителя по разделу “Роснефть” должен совпадать с доступным лимитом по карте.