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