Подготовка
Заключите договор с платежной системой АТОЛ Онлайн и получите доступ в личный кабинет.
Получите у АТОЛ все необходимые данные для интеграции с биллингом.
Настройка на стороне биллинга
Настройте передачу чеков в АТОЛ на стороне биллинга в разделе "Платежные системы":
- E-mail продавца - email
- Включить отправку челов через АТОЛ-онлайн - Включите для возможности отправки чеков
- ИНН - ИНН организации
- Идентификатор группы ККМ - внутреннее имя кассы в системе АТОЛ
- Логин - логин для авторизации
- Место расчетов - адрес сервера АТОЛ Онлайн для принятия чеков
- Пароль - пароль для авторизации
- Тип налогообложения - тип налогообложения, должен соответствовать выбранному на стороне АТОЛ.
- Тип НДС - объём и тип рассчета НДС, должен соответствовать выбранному на стороне АТОЛ.
Отправка чеков
При проведении любых видов платежей в Carbon Billing 5 можно отправлять чеки в АТОЛ Онлайн, а именно:
- Через веб-кассу (опционально)
- Платежи через платежные системы (во всех случаях для всех платежных систем, автоматический)
- Платежи через выгрузку банка (аналогично платежным системам, всегда)
- Заведение вручную в администраторской панели (опционально)
- API (аналогично платежам в администраторской панели, опционально)
Чеки отправляются только при включении опции "Включить отправку чеков через АТОЛ-онлайн" в настройках интеграции с АТОЛ.
Отправка чеков по платежам через платёжные системы
При включении опции "Включите для возможности отправки чеков" в настройках интеграции с АТОЛ Онлайн, чеки будут автоматический отправляться по всем платежным системам, включая экваиринг и ОСМП (OSMP) и выгрузки банка.
Отправка чеков по платежам в веб-кассе
При заведении платежей в веб-кассе автоматический будет установлен флаг "Создать чек в АТОЛ-онлайн", таким образом чек будет отправлен.
Если опцию отключить, чек по операции не будет отправлен в АТОЛ, отправить его в последствии будет не возможно, в таком случае потребуется отменить операцию прихода в биллинге и завести платеж заново в веб-кассе с отправкой чека.
Отправка чеков по платежам в администраторской панели
При заведении операции прихода денежных средств Вы можете отправлять или не отправлять чек в АТОЛ Онлайн, за это отвечает опция "Не создавать онлайн-чек".
По-умолчанию она включена и чек не отправляется.
Если опцию отключить при заведении операции - чек будет отправлен.
Если создать операцию прихода и потом её отредактировав, сняв опцию - чек отправлен не будет.
Чек отправляется только при создании операции.
Отладка
Результаты обмена данными с АТОЛ Онлайн можно посмотреть в логе:
tail /app/asr_fiscal/var/log/ATOL_Online_v4.log
Возможные ошибки
При ошибках отправки чека Вы увидите подобную страницу.
На странице описано в какой части кода произошла ошибка, суть ошибки - в красном баннере внизу.
Ошибочные поля : PropertyRequired: #/login; PropertyRequired: #/pass
Ошибка АТОЛ-Онлайн: [32] Ошибка валидации входящего чека. Ошибочные поля : PropertyRequired: #/login; PropertyRequired: #/pass
Убедитесь, что "Логин", "Пароль" и "Место расчетов" указаны верные.
Email and Phone empty
Email and Phone empty
Для передачи чека в АТОЛ Онлайн, в карточке абонента должны быть заведены "Email для оповещений" или "Номер SMS для оповещений"