|
Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.
|
Изменения (37)
просмотр истории страницы{toc:maxLevel=3} |
|
h12. Подготовка |
|
Заключите договор с платежной системой [АТОЛ Онлайн|http://www.online.atol.ru] Онлайн|https://online.atol.ru], и получите доступ в личный кабинет. |
Получите у АТОЛ все необходимые данные для интеграции с биллингом. |
h12. Настройка на стороне биллинга |
|
Настройте передачу чеков в АТОЛ на стороне биллинга в разделе "[Платежные системы|asrdocnew:Платежные системы, web-касса, карты оплаты, API, 1С, интернет банки]": * *E-mail продавца* \- email * *Включить отправку челов через АТОЛ-онлайн* \- Включите для возможности отправки чеков * *ИНН* \- ИНН организации * *Идентификатор группы ККМ* \- внутреннее имя кассы в системе АТОЛ |
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 оператора связи * *ИНН* \- ИНН организации |
* *Тип налогообложения* \- тип налогообложения, должен соответствовать выбранному на стороне АТОЛ. * *Тип НДС* \- объём и тип рассчета НДС, должен соответствовать выбранному на стороне АТОЛ. |
* *Название онлайн-кассы* \- оставьте пустым * *Адрес сервера онлайн-кассы* \- оставьте пустым * *Использовать тестовый сервер* \- включите, если используете тестовые настройки * *Слать чеки по платежам юрлиц* - отправлять чеки так же по платежам юридических лиц |
|
!atol_online_settings.png|border=1,width=900! |
h3. Укажите параметры кассы оператору связи |
|
h1. Отправка чеков |
Добавив все нужные наборы настроек, назначьте их операторам в разделе "Настройки биллинга" \-> "Настройки Онлайн-кассы" |
|
h2. Отправка чеков по платежам через [платёжные системы|CarbonBilling:Платёжные системы] |
!https://docs.carbonsoft.ru/download/attachments/186287928/Настройки+онлайн-кассы+оператора+связи.png|border=0,width=700! |
|
При включении опции "*Включите для возможности отправки чеков*" в настройках интеграции с АТОЛ Онлайн, чеки будут автоматический отправляться по всем платежным системам, включая экваиринг и ОСМП (OSMP). |
h2. Еще важные настройки: чеки из Веб-кассы и адрес callback |
|
h2. Отправка чеков по платежам в [веб-кассе|CarbonBilling:Веб-интерфейс кассира] |
В интерфейсе настройки интеграции с [платёжными системами|https://docs.carbonsoft.ru/49087105] есть еще две важные настройки. Рассмотрим каждую подробно. |
|
При заведении платежей в веб-кассе автоматический будет установлен флаг "*Создать чек в АТОЛ-онлайн*", таким образом чек будет отправлен. |
!Настройки фискализации, asr_fiscal, общие.png|border=0,width=700! |
|
!atol_online_webcash.png|border=1,width=500! |
h3. В веб-кассе создавать чек по умолчанию |
|
Если опцию отключить, чек по операции не будет отправлен в АТОЛ, отправить его в последствии будет не возможно, в таком случае потребуется отменить операцию прихода в биллинге и завести платеж заново в веб-кассе с отправкой чека. |
При включении, опция "Создать чек в АТОЛ-Онлайн" будет включена по-умолчанию при добавлении платежа в веб-кассе |
|
h1. Отладка |
h3. Внешний адрес для callback |
|
Результаты обмена данными с АТОЛ Онлайн можно посмотреть в логе: {code}tail /app/asr_fiscal/var/log/ATOL_Online_v4.log{code} |
*Внешний адрес для callback* \- укажите здесь IP-адрес или доменное имя биллинга, по которому он доступен из интернета, АТОЛ будет отправлять биллингу информацию о регистрации чеков именно по этому адресу. |
|
h2. Возможные ошибки При ошибках отправки чека Вы увидите подобную страницу. На странице описано в какой части кода произошла ошибка, *суть ошибки - в красном баннере внизу*. |
h2. Дайте кассе доступ к адресу callback |
|
!atol_online_error.png|border=1,width=600! |
По статье "[CarbonBilling:Настройка сети для платежных систем]" укажите адреса онлайн-кассы (их необходимо запросить у техподдержки кассы) в списке разрешенных для доступа к платежным системам. По-умолчанию мы ожидаем ответы кассы на порт +1444+, но защищенные порты (1443 и 2443) так же будут для неё доступны. |
|
h3. Ошибочные поля : PropertyRequired: #/login; PropertyRequired: #/pass {code}Ошибка АТОЛ-Онлайн: [32] Ошибка валидации входящего чека. Ошибочные поля : PropertyRequired: #/login; PropertyRequired: #/pass{code} Убедитесь, что "*Логин*", "*Пароль*" и "*Место расчетов*" указаны верные. |
h2. Уведомление для абонентов(Информация о чеке) |
|
h3. Email and Phone empty {code}Email and Phone empty{code} Для передачи чека в АТОЛ Онлайн, в карточке абонента должны быть заведены "*Email для оповещений*" или "*Номер SMS для оповещений*" |
Уведомления со ссылками на чеки у ОФД отправляет онлайн-касса, 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. Отладка Подробно отладка описана в [статье|Общая информация по настройке онлайн-касс#Отладка]. |