Подготовка
Заключите договор с АТОЛ Онлайн, и получите доступ в личный кабинет.
Получите у АТОЛ все необходимые данные для интеграции с биллингом.
Настройка на стороне биллинга
Настройка фискализации для интеграции с кассой
- Зайдите в меню "Настройки" -> "Настройки фискализации". Нажмите "Добавить"
- Укажите параметры кассы и нажмите "Сохранить"
Логин и пароль
Логин и пароль находятся в файле "Настройки интегратора", его можно получить по кнопке в личном кабинете АТОЛ, в разделе "Мои компании".
 | Эти данные отличаются от данных доступа к личному кабинету АТОЛ! |
- Логин - логин для авторизации
- Пароль - пароль для авторизации
Параметры ККТ
- Идентификатор группы ККМ - внутреннее имя кассы в системе АТОЛ. Получить имя кассы можно из файла Настройки интегратора. Пример имени кассы из файла:
<access group_code="group_code_777"В данном случае имя кассы это group_code_777
- Место расчетов - доменное имя сайта оператора связи, иначе говоря адрес интернет-магазина
Прочие настройки
- E-Mail чека по умолчанию - адрес почты на который будет создаваться чек для абонентов не указавших контактные данные (телефон или адрес почты)
- E-mail продавца - email оператора связи
- ИНН - ИНН организации
- Тип налогообложения - тип налогообложения, должен соответствовать выбранному на стороне АТОЛ.
- Тип НДС - объём и тип рассчета НДС, должен соответствовать выбранному на стороне АТОЛ.
- Название онлайн-кассы - оставьте пустым
- Адрес сервера онлайн-кассы - оставьте пустым
- Использовать тестовый сервер - включите, если используете тестовые настройки
- Слать чеки по платежам юрлиц - отправлять чеки так же по платежам юридических лиц
Укажите параметры кассы оператору связи
Добавив все нужные наборы настроек, назначьте их операторам в разделе "Настройки биллинга" -> "Настройки Онлайн-кассы"
Еще важные настройки: чеки из Веб-кассы и адрес callback
В интерфейсе настройки интеграции с платёжными системами есть еще две важные настройки. Рассмотрим каждую подробно.
В веб-кассе создавать чек по умолчанию
При включении, опция "Создать чек в АТОЛ-Онлайн" будет включена по-умолчанию при добавлении платежа в веб-кассе
Внешний адрес для callback
Внешний адрес для callback - укажите здесь IP-адрес или доменное имя биллинга, по которому он доступен из интернета, АТОЛ будет отправлять биллингу информацию о регистрации чеков именно по этому адресу.
Дайте кассе доступ к адресу callback
По статье "Настройка сети для платежных систем" укажите адреса онлайн-кассы (их необходимо запросить у техподдержки кассы) в списке разрешенных для доступа к платежным системам.
По-умолчанию мы ожидаем ответы кассы на порт 1444, но защищенные порты (1443 и 2443) так же будут для неё доступны.
Уведомление для абонентов(Информация о чеке)
Уведомления со ссылками на чеки у ОФД отправляет онлайн-касса, Carbon Billing 5 только передаёт на сторону кассы реквизиты чека и абонента, это могут быть EMAIL или номер телефона.
Исходя из документации протокола АТОЛ, если переданы оба реквизита - приоритетным каналом доставки будет считаться email. Если реквизиты отсутствуют в карточке абонента, информация о чеке будет отправлена на "E-Mail чека по умолчанию"
Выдержка из документации к описанию протокола, страница №17:
В запросе обязательно должно быть заполнено хотя бы одно из полей: email или phone. Если заполнены оба поля, ОФД отправит электронный чек только на email.
Отладка
Подробно отладка описана в статье.