ОНЛАЙН ЧЕКИ
Данный модуль предназначен для работы онлайн кассами.
Поддерживается работа с сервисом:
При получении онлайн оплаты биллинг передает информацию о платеже в онлайн сервис.
Модуль ничего не делает с платежами, ничего не делает с чеками, с его помощью нельзя увидеть чек. Модуль только передает информацию.
Внимание
Если вы не знаете что такое ККТ - читать дальше бессмысленно.
Что такое ККТ можно узнать тут.
Установка
Включение в config.pl
@MODULES = (
# добавляем в конец списка модуль, не забываем перед предыдущим поставить запятую, если ее нет
'Extreceipt',
);
Модуль чеков
cp Extreceipt.pm /usr/abills/Abills/modules/Extreceipt/db/
Создать таблицы в базе.
mysql --default-character-set=utf8 -D abills < /usr/abills/Abills/modules/Extreceipt/Extreceipt.sql
Скопировать billd плагин.
ln -s /usr/abills/Abills/modules/Extreceipt/extreceipt_payments_reg.pm /usr/abills/libexec/billd.plugins/extreceipt_payments_reg.pm
Скопировать страницу для callback (используется для Atol)
ln -s /usr/abills/Abills/modules/Extreceipt/misc/atol.cgi /usr/abills/cgi-bin/
Заполнить информацию о подключенных онлайн сервисах (API) и ККТ в Настройки>Чеки
ККТ группа используется только для сервиса Atol и Checkbox.
Вид оплаты - платежи с указанным видом оплаты будут отправляться на этот ккт (можно указать несколько видов оплаты через запятую)
Группы - только платежи пользователей из указанных групп будут отправляться на этот ккт.
В примере на скриншоте платежи полученные от пользователей без группы или пользователей группы 10 с типом платежа 100, 21, 99 или 1 будут зарегистрированы на первом ККТ, а платежи полученные от пользователей из группы 5 - на 2м ККТ.
Параметры
| API | Плагин, через который производится настройка |
| Название ККТ | |
| Предоставляет ПРРО компания, если есть для этого необходимость во взаимодействии с API | |
| Чек Header | |
Оплата Интернет Клиент &UID& \n &FIO& \n г. &ADDRESS_DISTRICT&, ул. &ADDRESS_STREET&, г. &ADDRESS_BUILD&, &ADDRESS_FLAT& \n. Также можно использовать: BILL_ID, LOGIN, CONTRACT_ID, PHONE, EMAIL, FIO2, FIO3, ADDRESS_FULL, CITY, TAX_NUMBER, ZIP + Ваши информационные поля | |
| Чек Footer | |
| Администратор | Список администраторов при добавлении платежа происходит отправка в Checkbox По умолчанию поле extreceipts_kkt.admins равно 30, если нужно больше, тогда используется следующая команда ALTER TABLE extreceipts_kkt MODIFY admins VARCHAR(200) NOT NULL DEFAULT ''; |
Запуск отправки платежей в ручном режиме
Для регистрации полученных платежей в системе необходимо выполнить команду:
/usr/abills/libexec/billd extreceipt_payments_reg
Параметры
| PAYMENT_ID=xxx | Отправить только один платеж. Аргумент номер платежа в биллинге |
| START | Инициализация отправки. Делается только один раз |
| CHECK | Проверить платеж с консоли |
| FROM_DATE | Отправлять платежи начиная с даты |
| TO_DATE | Отправлять платежи начиная до даты |
| RESEND | Переотправить платеж |
| CANCEL | Отменить платеж |
| PAGE_ROWS | Количество выбраных платежей за один раз |
| SLEEP | Таймамут отправки в секундах, после каждой отправки платежа. |
| RENEW_SHIFT | обновление смен кассиров. |
OPEN_SHIFT | Только открытие смен кассиров. |
CLOSE_SHIFT | Только закрытие смен кассиров. |
| CASH_COLLECTION | Инкассация всех касс |
Если вы не хотите, чтобы при первом запуске скрипт отправил все существующие платежи, необходимо указать ID платежа с какого нужно начать.
/usr/abills/libexec/billd extreceipt_payments_reg START=12345
Автоматический запуск отправки платежей
Для автоматического запуска плагина, необходимо добавить строку в crontab, не обязательно для checkbox, так как платежи отправляются сразу после добавления.
1 * * * * root /usr/abills/libexec/billd extreceipt_payments_reg
Отчет
В меню Обслуживание>Чеки можно увидеть отчет о отправленных и зарегистрированных чеках.
Параметры
| $conf{EXTRECEIPTS_FAIL_EMAIL}=''; | Email на который отправлять информацию о чеках если у абонента не заполнены поля телефона и e-mail |
$conf{EXTRECEIPTS_USER_CELL_PHONE}='1'; | Выбор телефона с поля Мобильный телефон вместо поля Телефон |
$conf{EXTRECEIPTS_SEND_USER} | Вид отправки чеков через SMS сервис, Viber или Sms |
| $conf{EXTRECEIPTS_DEBUG} | Логирование запросов на сервер |
| $conf{EXTRECEIPTS_AUTO_SEND_USER} | Автоматическая отправка чека SMS сервис, Viber или Sms |
Печать чеков
В данный момент поддерживается только в Checkbox
Когда добавили платеж есть возможность его напечатать.
Чтобы сделать чек на возврат нужно зайти в Обслужывание→Чеки, найти нужный платеж и его отменить.
Когда Вы отменили, есть возможность его напечатать.
