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

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

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

Переход на АТОЛ v5

С 6 августа 2021 года ввели новый формат фискальных документов — ФФД 1.2. На него должны перейти те, кто продаёт обязательные к маркировке товары, которые учитываются в системе «Честный ЗНАК». Подробнее об АТОЛ v5 (ФФД 1.2) см. на сайте atol.

BILLmanager 6 имеет модуль интеграции для работы с АТОЛ v5 (ФФД 1.2), но не поддерживает маркировку товаров и выписывает чеки только на немаркированные товары. АТОЛ v5 (ФФД 1.2) поддерживает регистрацию чеков по немаркированным товарам.

Если вы обновляете имеющуюся кассу до ФФД 1.2, то на время обновления рекомендуем в BILLmanager отключить методы оплаты, которые используют эту кассу. После обновления кассы:

Установите и настройте модуль интеграции с АТОЛ Онлайн v5 согласно инструкции.
Измените для методов оплаты кассу АТОЛ Онлайн v4 на АТОЛ Онлайн v5.
Включите методы оплаты.

Подключение онлайн-кассы АТОЛ

Чтобы подключить кассу АТОЛ, перейдите в раздел Финансы → Онлайн-кассы → кнопка Создать.

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

Логирование

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

/usr/local/mgr5/var/cratolv4.log — лог-файл модуля АТОЛ Онлайн v4;
/usr/local/mgr5/var/cratolv5.log — лог-файл модуля АТОЛ Онлайн v5.