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