Атол руководство интегратора

Дистрибутивы

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

Вам могут быть интересны:

Frontol 6

Documentation

Frontol 5

Documentation

Frontol 4

Documentation

Подготовка

Заключите договор с платежной системой АТОЛ Онлайн и получите доступ в личный кабинет.
Получите у АТОЛ все необходимые данные для интеграции с биллингом.

Настройка на стороне биллинга

У каждого оператора свои настройки интеграции с АТОЛ, их нужно задать

В биллинге может быть заведено несколько операторов связи, если это разные юридические лица, то данные в налоговую тоже должны идти по разным юридическим лицам.

1. Сначала нужно подготовить настройки для всех операторов меню «Настройки» -> «Настройки фискализации». Нажмите «Добавить»

   

2. Заведите нужные настройки интеграции с АТОЛ Онлайн и сохраните
   • E-Mail чека по умолчанию — адрес почты на который будет создаваться чек для абонентов не указавших контактные данные (телефон или адрес почты)
   • E-mail продавца — email оператора связи
   • ИНН — ИНН организации
   • Идентификатор группы ККМ — внутреннее имя кассы в системе АТОЛ. Получить имя кассы можно из файла Настройки интегратора. Пример имени кассы из файла:

     <access group_code="group_code_777"
     

     В данном случае имя кассы это group_code_777

   • Логин — логин для авторизации
   • Пароль — пароль для авторизации

     Логин и пароль находятся в файле «Настройки интегратора«, его можно получить по кнопке в личном кабинете АТОЛ, в разделе «Мои компании«. Эти данные отличаются от данных доступа к личному кабинету АТОЛ

   • Место расчетов — доменное имя сайта оператора связи, иначе говоря адрес интернет-магазина
   • Тип налогообложения — тип налогообложения, должен соответствовать выбранному на стороне АТОЛ.
   • Тип НДС — объём и тип рассчета НДС, должен соответствовать выбранному на стороне АТОЛ.
   • Использовать тестовый сервер — включите, если используете тестовые настройки

     

3. Добавив все нужные наборы настроек, назначьте их операторам в разделе «Настройки биллинга» -> «Настройки АТОЛ онлайн»

   

А что если по каким-то оператоам не нужно слать чеки?

Если по абонентам кого-то из операторов Вы не хотите отправлять чеки — просто не выбирайте ему ни какие настройки

Еще важные настройки: чеки из Веб-кассы и адрес callback

В интерфейсе настройки интеграции с платёжными системами есть еще две важные настройки. Рассмотрим каждую подробно.

При включении отправки чеков, настройки модуля платежных систем и биллинга синхронизируются не сразу, а в течение 10 минут. Чеки по платежам совершенным в этот промежуток времени не будут отправлены.

В веб-кассе создавать чек по умолчанию

При включении, опция «Создать чек в АТОЛ-Онлайн» будет включена по-умолчанию при добавлении платежа в веб-кассе

Внешний адрес для callback

Внешний адрес для callback — укажите здесь IP-адрес или доменное имя биллинга, по которому он доступен из интернета, АТОЛ будет отправлять биллингу информацию о регистрации чеков именно по этому адресу.

Дайте АТОЛ доступ к адресу callback

По статье «Настройка сети для платежных систем» укажите адреса АТОЛ (их необходимо запросить у самой платёжной системы) в списке разрешенных для доступа к платежным системам.
По-умолчанию мы ожидаем ответа онлайн кассы на порт 1444, но защищенные порты (1443 и 2443) так же будут для неё доступны.

Уведомление для абонентов

Уведомления со ссылками на чеки у ОФД отправляет АТОЛ Онлайн, Carbon Billing 5 только передаёт на сторону онлайн-кассы реквизиты абонента.
Исходя из документации к онлайн кассе, если переданы оба реквизита — уведомление будет отправлено только на почту. Выдержка из документации к описанию протокола АТОЛ, страница №17:

В запросе обязательно должно быть заполнено хотя бы одно из полей: email или phone. Если заполнены оба поля, ОФД отправит электронный чек только на email.