Краткое описание модуля
Включение модуля
Добавляем таблицы в БД
mysql -D abills </usr/abills/db/Extreceipt.sql
Создать симлинк для callback url
ln -s /usr/abills/ACP/modules/Extreceipt/misc/ferma.cgi /usr/abills/cgi-bin/
Включаем модуль в config.pl
our @MODULES = ( ... 'Extreceipt', ... );
Описания настройки в вебинтерфейсе
Для полноценной интеграции с онлай-кассой Атол нужно сделать следжующее:
Настроить параметры сопряжения в меню Настройка → Чеки → API
Где используется следующее:
| Параметр | Пример | Описание |
|---|---|---|
| Название | Приемлемое название онлайн-кассы | Ферам-Атол |
| API plugin | Название плагина | Ferma |
| Логин | Логин от сервиса Атол | acp-kazna-39 |
| Пароль | Пароль от сервиса Атол | abrakadabra |
| URL | Ссылка на API Атол | https://ferma-test-at.ofd.ru/possystem/v1/ (выдаётся OFD) |
| Callback url | Ссылка на личный кабинет биллинга, именно в таком виде | https://lk.acpkazna39.ru/ |
| ИНН | ИНН организации, зарегестрированной в сервисе Атол ИНН Должен совпадать с ИНН в кассе | |
| Адрес | Адрес вашего сайта | https://acpkazna39.ru |
| Дефолтный E-mail, куда будут падать чеки, если у абонента не собственного E-mail | info@acpkazna39.ru | |
| Товар | Описание товара в чеке | Обслуживание абонентской линии |
| Система налогооблажения | Система налогооблажения используемая у провайдера | «osn» – общая СН; «usn_income» – упрощенная СН (доходы); «usn_income_outcome» – упрощенная СН (доходы минус расходы); «envd» – единый налог на вмененный доход; «esn» – единый сельскохозяйственный налог; «patent» – патентная СН Указывается БЕЗ кавычек |
| Ставка налога компании | Указывается, в зависимости от вашей системы налогооблажения | Тип налоговой ставки. Параметр может принимать следующие значения: |
| Администратор | Выбор администратора для работы с чеками | System (системный пользователь) |
Настроить саму ККТ
Где используется следующее:
| Параметр | Пример | Описание |
|---|---|---|
| API | Выбор API, для работы, из предыдущего меню | Атол |
| ККТ группа | Название группы ККТ (идентификатор группы ККТ, параметр можно посмотреть в ЛКК Ferma® в виджете «Реквизиты доступа») | acp-kazna39_74758 |
| ККТ Лицензия | Лицензия на ККТ (с Атол/Ferma не используется) | |
| Чеки header | ||
| Чек Desc | Также можно использовать: BILL_ID, LOGIN, CONTRACT_ID, PHONE, EMAIL, FIO2, FIO3, ADDRESS_FULL, CITY, TAX_NUMBER, ZIP + Ваши информационные поля | Оплата Интернет Клиент &UID& \n &LOGIN& \n &FIO& \n г. &ADDRESS_DISTRICT&, ул. &ADDRESS_STREET&, г. &ADDRESS_BUILD&, &ADDRESS_FLAT& \n. |
| Чек Footer | Можно прописать данные для чека | |
| Вид оплаты | К каким видам оплаты применять кассу | Сбербанк, ЮКасса, 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} = 'Viber'; | Вид отправки чеков через SMS сервис, Viber или Sms |
| EXTRECEIPTS_DEBUG | $conf{EXTRECEIPTS_DEBUG} = 7; | Логирование запросов на серве, вывод в админке |
| EXTRECEIPTS_AUTO_SEND_USER | $conf{EXTRECEIPTS_AUTO_SEND_USER} = 1; | Автоматическая отправка чека SMS сервис, Viber или Sms |