Краткое описание модуля
Модуль сопряжения с онлайн-кассой "Атол"
Включение модуля
Добавляем таблицы в БД
mysql -D abills </usr/abills/db/Extreceipt.sql
Создать симлинк для callback url
ln -s /usr/abills/ACP/modules/Extreceipt/misc/atol.cgi /usr/abills/cgi-bin/
Включаем модуль в config.pl
our @MODULES = ( ... 'Extreceipt', ... );
Описания настройки в вебинтерфейсе
Для полноценной интеграции с онлай-кассой Атол нужно сделать следжующее:
Настроить параметры сопряжения в меню Настройка → Чеки → API
Где используется следующее:
| Параметр | Пример | Описание |
|---|---|---|
| Название | Приемлемое название онлайн-кассы | Atol |
| API plugin | Название плагина | Atol |
| Логин | Логин от сервиса Atol | acp-kazna-39 (Выдаёт сервис Atol) |
| Пароль | Пароль от сервиса Atol | abrakadabra (Выдаёт сервис Atol) |
| URL | Ссылка на API Atol | https://online.atol.ru/possystem/v4/ - основная касса |
| Callback url | Ссылка на личный кабинет биллинга, именно в таком виде | https://lk.acpkazna39.ru/atol.cgi |
| ИНН | ИНН организации, зарегестрированной в сервисе Атол ИНН Должен совпадать с ИНН в кассе | |
| Адрес | Адрес вашего сайта | https://acpkazna39.ru |
| Дефолтный E-mail, куда будут падать чеки, если у абонента не собственного E-mail | info@acpkazna39.ru | |
| Товар | Описание товара в чеке | Обслуживание абонентской линии |
Договор/Логин/UID | Выбор дополнительного реквизта для чека | Лицевой счёт № - LOGIN абонента Договор № - CONTRACT_ID абонента UID - UID абонента |
| Система налогооблажения | Система налогооблажения используемая у провайдера | «osn» – общая СН; «usn_income» – упрощенная СН (доходы); «usn_income_outcome» – упрощенная СН (доходы минус расходы); «envd» – единый налог на вмененный доход; «esn» – единый сельскохозяйственный налог; «patent» – патентная СН Указывается БЕЗ кавычек |
| Ставка налога компании | Указывается, в зависимости от вашей системы налогооблажения | Тип налоговой ставки. Параметр может принимать следующие значения: |
| Администратор | Выбор администратора для работы с чеками | System (системный пользователь) |
Настроить саму ККТ
Где используется следующее:
| Параметр | Пример | Описание |
|---|---|---|
| API | Выбор API, для работы, из предыдущего меню | Atol |
| ККТ группа | Название группы ККТ (Выдаёт сервис Атол) | acp-kazna39_74758 |
| Вид оплаты | К каким видам оплаты применять кассу | Сбербанк, ЮКасса, Paykeeper |
| Группы | Для каких групп разрешено применять кассу | пустое поле - для всех |
| Администратор | Список администраторов, у которых, при добавлении платежа, происходит отправка чеков | Суперадмин, Полуадмин |
Описания параметров файла config.pl
| Параметр | Пример | Описание |
|---|---|---|
| EXTRECEIPTS_FAIL_EMAIL | $conf{EXTRECEIPTS_FAIL_EMAIL} = 'info@acpkazna39.ru'; | Емайл, куда отсылать чеки, если у абонента отсутствует Email |
| EXTRECEIPTS_USER_CELL_PHONE | $conf{EXTRECEIPTS_USER_CELL_PHONE} = '1'; | Выбор телефона с поля Мобильный телефон вместо поля Телефон |
| EXTRECEIPTS_SEND_USER | $conf{EXTRECEIPTS_SEND_USER} = 'Sms'; | Вид отправки чеков через SMS сервис, Viber или Sms |
| EXTRECEIPTS_DEBUG | $conf{EXTRECEIPTS_DEBUG} = 7; | Логирование запросов на серве, вывод в админке |
| EXTRECEIPTS_AUTO_SEND_USER | $conf{EXTRECEIPTS_AUTO_SEND_USER} = 1; | Автоматическая отправка чека SMS сервис, Viber или Sms |
| EXRECEIPT_ATOL_LOG_FILE | $conf{EXRECEIPT_ATOL_LOG_FILE}='/usr/abills/var/log/atol_request.log'; | Логирование запроса: touch /usr/abills/var/log/atol_request.log chmod 777 /usr/abills/var/log/atol_request.log |
| EXRECEIPT_ATOL_CALLBACK_LOG_FILE | $conf{EXRECEIPT_ATOL_CALLBACK_LOG_FILE}='/usr/abills/var/log/atol_answer.log'; | Логирование ответа: touch /usr/abills/var/log/atol_answer.log chmod 777 /usr/abills/var/log/atol_answer.log |