{toc:maxLevel=2}
h1. Подготовка
Заключите договор с [АТОЛ Онлайн|http://www.online.atol.ru] и получите доступ в личный кабинет.
Получите у АТОЛ все необходимые данные для интеграции с биллингом.
h1. Настройка на стороне биллинга
h2. Настройка фискализации для интеграции с кассой
!atol_asr_billing_isp_settings_edit.png|border=0,width=550!
h3. Логин и пароль
* *Логин* \- логин для авторизации
* *Пароль* \- пароль для авторизации
{note}* *Логин* и *пароль* находятся в файле "_Настройки интегратора_", его можно получить по кнопке в личном кабинете АТОЛ, в разделе "_Мои компании_". Эти данные отличаются от данных доступа к личному кабинету АТОЛ{note}
h3. Параметры ККТ
* *Идентификатор группы ККМ* \- внутреннее имя кассы в системе АТОЛ. Получить имя кассы можно из файла *Настройки интегратора*. Пример имени кассы из файла:
{code}
<access group_code="group_code_777"
{code}
В данном случае имя кассы это *group_code_777* \\ \\
* *Место расчетов* \- доменное имя сайта оператора связи, иначе говоря адрес интернет-магазина
h3. Прочие настройки
* *E-Mail чека по умолчанию* \- адрес почты на который будет создаваться чек для абонентов не указавших контактные данные (телефон или адрес почты)
* *E-mail продавца* \- email оператора связи
* *ИНН* \- ИНН организации
* *Тип налогообложения* \- тип налогообложения, должен соответствовать выбранному на стороне АТОЛ.
* *Тип НДС* \- объём и тип рассчета НДС, должен соответствовать выбранному на стороне АТОЛ.
* *Название онлайн-кассы* - оставьте пустым
* *Адрес сервера онлайн-кассы* - оставьте пустым
* *Использовать тестовый сервер* \- включите, если используете тестовые настройки
h2. Еще важные настройки: чеки из Веб-кассы и адрес callback
В интерфейсе настройки интеграции с [платёжными системами|https://docs.carbonsoft.ru/49087105] есть еще две важные настройки. Рассмотрим каждую подробно.
!atol_asr_fiscal_config.png|border=0,width=700!
При включении отправки чеков, настройки модуля платежных систем и биллинга синхронизируются не сразу, а в течение 10 минут. Чеки по платежам совершенным в этот промежуток времени не будут отправлены.
h3. В веб-кассе создавать чек по умолчанию
При включении, опция "Создать чек в АТОЛ-Онлайн" будет включена по-умолчанию при добавлении платежа в веб-кассе
h3. Внешний адрес для callback
*Внешний адрес для callback* \- укажите здесь IP-адрес или доменное имя биллинга, по которому он доступен из интернета, АТОЛ будет отправлять биллингу информацию о регистрации чеков именно по этому адресу.
h2. Дайте АТОЛ доступ к адресу callback
По статье "[CarbonBilling:Настройка сети для платежных систем]" укажите адреса АТОЛ (их необходимо запросить у самой платёжной системы) в списке разрешенных для доступа к платежным системам.
По-умолчанию мы ожидаем ответа онлайн кассы на порт +1444+, но защищенные порты (1443 и 2443) так же будут для неё доступны.
h2. Уведомление для абонентов
Уведомления со ссылками на чеки у ОФД отправляет АТОЛ Онлайн, Carbon Billing 5 только передаёт на сторону онлайн-кассы реквизиты абонента.
Исходя из документации к онлайн кассе, если переданы оба реквизита - уведомление будет отправлено только на почту. Выдержка из [документации к описанию протокола АТОЛ|https://online.atol.ru/files/API_servisa_ATOLOnline_v4.10.pdf], страница №17:
{quote}В запросе обязательно должно быть заполнено хотя бы одно из полей: email или phone. Если заполнены оба поля, ОФД отправит электронный чек только на email.{quote}
h1. Подготовка
Заключите договор с [АТОЛ Онлайн|http://www.online.atol.ru] и получите доступ в личный кабинет.
Получите у АТОЛ все необходимые данные для интеграции с биллингом.
h1. Настройка на стороне биллинга
h2. Настройка фискализации для интеграции с кассой
!atol_asr_billing_isp_settings_edit.png|border=0,width=550!
h3. Логин и пароль
* *Логин* \- логин для авторизации
* *Пароль* \- пароль для авторизации
{note}* *Логин* и *пароль* находятся в файле "_Настройки интегратора_", его можно получить по кнопке в личном кабинете АТОЛ, в разделе "_Мои компании_". Эти данные отличаются от данных доступа к личному кабинету АТОЛ{note}
h3. Параметры ККТ
* *Идентификатор группы ККМ* \- внутреннее имя кассы в системе АТОЛ. Получить имя кассы можно из файла *Настройки интегратора*. Пример имени кассы из файла:
{code}
<access group_code="group_code_777"
{code}
В данном случае имя кассы это *group_code_777* \\ \\
* *Место расчетов* \- доменное имя сайта оператора связи, иначе говоря адрес интернет-магазина
h3. Прочие настройки
* *E-Mail чека по умолчанию* \- адрес почты на который будет создаваться чек для абонентов не указавших контактные данные (телефон или адрес почты)
* *E-mail продавца* \- email оператора связи
* *ИНН* \- ИНН организации
* *Тип налогообложения* \- тип налогообложения, должен соответствовать выбранному на стороне АТОЛ.
* *Тип НДС* \- объём и тип рассчета НДС, должен соответствовать выбранному на стороне АТОЛ.
* *Название онлайн-кассы* - оставьте пустым
* *Адрес сервера онлайн-кассы* - оставьте пустым
* *Использовать тестовый сервер* \- включите, если используете тестовые настройки
h2. Еще важные настройки: чеки из Веб-кассы и адрес callback
В интерфейсе настройки интеграции с [платёжными системами|https://docs.carbonsoft.ru/49087105] есть еще две важные настройки. Рассмотрим каждую подробно.
!atol_asr_fiscal_config.png|border=0,width=700!
При включении отправки чеков, настройки модуля платежных систем и биллинга синхронизируются не сразу, а в течение 10 минут. Чеки по платежам совершенным в этот промежуток времени не будут отправлены.
h3. В веб-кассе создавать чек по умолчанию
При включении, опция "Создать чек в АТОЛ-Онлайн" будет включена по-умолчанию при добавлении платежа в веб-кассе
h3. Внешний адрес для callback
*Внешний адрес для callback* \- укажите здесь IP-адрес или доменное имя биллинга, по которому он доступен из интернета, АТОЛ будет отправлять биллингу информацию о регистрации чеков именно по этому адресу.
h2. Дайте АТОЛ доступ к адресу callback
По статье "[CarbonBilling:Настройка сети для платежных систем]" укажите адреса АТОЛ (их необходимо запросить у самой платёжной системы) в списке разрешенных для доступа к платежным системам.
По-умолчанию мы ожидаем ответа онлайн кассы на порт +1444+, но защищенные порты (1443 и 2443) так же будут для неё доступны.
h2. Уведомление для абонентов
Уведомления со ссылками на чеки у ОФД отправляет АТОЛ Онлайн, Carbon Billing 5 только передаёт на сторону онлайн-кассы реквизиты абонента.
Исходя из документации к онлайн кассе, если переданы оба реквизита - уведомление будет отправлено только на почту. Выдержка из [документации к описанию протокола АТОЛ|https://online.atol.ru/files/API_servisa_ATOLOnline_v4.10.pdf], страница №17:
{quote}В запросе обязательно должно быть заполнено хотя бы одно из полей: email или phone. Если заполнены оба поля, ОФД отправит электронный чек только на email.{quote}