Документация BILLmanager

Интеграция с АТОЛ

Интеграция биллинговой системы с онлайн-кассой подходит для провайдеров, которые принимают оплату услуг через множество различных платежных систем. Информация об отправленных чеках будет храниться в BILLmanager, раздел Финансы → Чеки. Подробнее см. в статье Чеки

Обратите внимание!

Перед настройкой перейдите в Интеграция → Модули и установите Онлайн-кассы. Подробнее см. в статье Онлайн-кассы

Как подключить онлайн-кассу АТОЛ


Форма настройки подключения

  1. Перейдите в Финансы → Онлайн-кассы → Создать
  2. Выберите модуль интеграции:
    • АТОЛ Онлайн — неактуальный протокол для пользователей АТОЛ Онлайн, которые были зарегистрированы до появления нового протокола подключения; 
    • АТОЛ Онлайн v4 — актуальный протокол для новых пользователей АТОЛ Онлайн. Отправляет чеки в формате фискальных данных (ФФД) версии 1.05.
  3. Укажите Наименование кассы. 
  4. Если настраиваете тестовую интеграцию, то введите в API URL "https://testonline.atol.possystem/v4/". Чтобы создать действующую интеграцию, оставьте поле пустым. 
  5. Укажите Логин и Пароль для доступа к АТОЛ Онлайн. 
  6. Введите Код группы ККТ, полученный в личном кабинете АТОЛ Онлайн.
  7. Укажите Email отправителя чека. 
  8. Введите ИНН организации, на которую зарегистрирована ККТ. 
  9. Укажите Адрес расчётов (сайта), который был указан при регистрации ККТ в ФНС. 
  10. Укажите Наименование услуги. Оно будет использовано в чеках по авансовым платежам и при выводе средств с лицевого счёта. 
  11. Включите опцию Регистрация чеков по оказанным услугам, чтобы формировать вторые чеки (чеки реализации) на основе расходов. Если опция отключена, то второй чек формироваться не будет. 

    Обратите внимание!

     BILLmanager начинает формировать вторые чеки по расходам, созданным после включения Регистрации чеков по оказанным услугам

  12. Включите опцию Ручная отправка чеков по оказанным услугам, чтобы запретить автоматическую отправку чеков. Для отправки чеков вручную нажмите Отправить чеки в Финансы → Онлайн-кассы
  13. Включите опцию Регистрация чеков возврата для платежей без чеков прихода, чтобы формировать чеки возврата по платежам, для которых нет чека прихода. 
  14. Нажмите Завершить, чтобы сохранить интеграцию. 
  15. Перейдите в Провайдер → Методы оплаты → Изменить → блок Отправка чеков онлайн
  16. В Способ отправки чеков выберите "Отправка через онлайн-кассу". 
  17. Выберите Онлайн-кассу, через которую будет выполняться отправка чеков. 
  18. Нажмите Ok, чтобы сохранить настройки. 

Логирование


Журнал взаимодействия BILLmanager с онлайн-кассами хранится в файлах:

  • Файл-лог модуля АТОЛ Онлайн: /usr/local/mgr5/var/cratol.log;
  • Файл-лог модуля АТОЛ Онлайн v4: /usr/local/mgr5/var/cratolv4.log

Переход на API v4


Чтобы перейти на APIv4, создайте в BILLmanager новую интеграцию с онлайн-кассой через модуль "АТОЛ Онлайн v4" и измените настройки в личном кабинете АТОЛ. Подробнее про настройки личного кабинета см. в Инструкции по изменению версии ФФД

Обратите внимание!

При работе с протоколом АТОЛ Онлайн API v4 стоимость услуги в чеке отображается в рублях. Если платёж выполнен в другой валюте, то сумма будет переведена в рубли по текущему курсу.