| Информация | ||
|---|---|---|
| ||
| Модуль сопряжения с онлайн-кассой Ferma - https://ofd.ru/tarify/ferma |
| Оглавление | ||
|---|---|---|
|
| Отображение дочерних элементов |
|---|
Включение модуля
Добавляем таблицы в БД
| Блок кода |
|---|
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 | ||
| Логин | Логин от сервиса Ferma | acp-kazna-39 (параметр можно посмотреть в ЛКК Ferma® в виджете «Реквизиты доступа») | ||
| Пароль | Пароль от сервиса Ferma | abrakadabra (параметр можно посмотреть в ЛКК Ferma® в виджете «Реквизиты доступа») | ||
| URL | Ссылка на API Ferma | https://ferma-test-at.ofd.ru/possystem/v1/ - тестовая касса https://ferma-at.ofd.ru/possystem/v1/ - основная касса | ||
| Callback url | Ссылка на личный кабинет биллинга, именно в таком виде | https://lk.acpkazna39.ru/ferma.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, для работы, из предыдущего меню | Атол | ||
| ККТ группа | Название группы ККТ (идентификатор группы/магазина ККТ, параметр можно посмотреть в ЛКК Ferma® в виджете «Реквизиты доступа») | acp-kazna39_74758 | ККТ Лицензия | Лицензия на ККТ (с Атол/Ferma не используется) |
| Чеки header | Оплата Интернет Клиент &UID& \n &LOGIN& \n &FIO& \n г. &ADDRESS_DISTRICT&, ул. &ADDRESS_STREET&, г. &ADDRESS_BUILD&, &ADDRESS_FLAT& \n. | |||
| Чек 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 | Можно прописать данные для чека | Оплата Интернет Клиент &UID& \n &LOGIN& \n &FIO& \n г. &ADDRESS_DISTRICT&, ул. &ADDRESS_STREET&, г. &ADDRESS_BUILD&, &ADDRESS_FLAT& \n. | ||
| Вид оплаты | К каким видам оплаты применять кассу | Сбербанк, ЮКасса, 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 | |||||
| EXRECEIPT_FERMA_LOG_FILE | $conf{EXRECEIPT_FERMA_LOG_FILE}='/usr/abills/var/log/ferma_request.log'; | Логирование запроса:
| |||||
| EXRECEIPT_FERMA_CALLBACK_LOG_FILE | $conf{EXRECEIPT_FERMA_CALLBACK_LOG_FILE}='/usr/abills/var/log/ferma_answer.log'; | Логирование ответа:
|
Дополнительная информация
| Предупреждение |
|---|
| Временно не работает печать чеков на термопринтер |