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