ОНЛАЙН ЧЕКИ
| Оглавление |
|---|
Данный модуль предназначен для работы онлайн кассами.
Поддерживается работа с сервисом:
| Отображение дочерних элементов |
|---|
При получении онлайн оплаты биллинг передает информацию о платеже в онлайн сервис.
Модуль ничего не делает с платежами, ничего не делает с чеками, с его помощью нельзя увидеть чек. Модуль только передает информацию.
| Предупреждение | ||
|---|---|---|
| ||
Если вы не знаете что такое ККТ - читать дальше бессмысленно. |
Включение
в config.pl| Блок кода |
|---|
@MODULES = (
# добавляем в конец списка модуль, не забываем перед предыдущим поставить запятую, если ее нет
'Extreceipt',
); |
Модуль чеков
| Блок кода |
|---|
cp Extreceipt.pm /usr/abills/Abills/modules/Extreceipt/db/ |
Создать таблицы в базе.
модуля
Добавляем таблицы в БД
| Блок кода |
|---|
mysql |
| Блок кода |
mysql --default-character-set=utf8 -D abills < /usr/abills/Abills/modules/Extreceiptdb/Extreceipt.sql |
Скопировать billd плагин.
| Блок кода |
|---|
ln -s /usr/abills/Abills/modules/Extreceipt/extreceipt_payments_reg.pm /usr/abills/libexec/billd.plugins/extreceipt_payments_reg.pm |
Создать симлинк для callback url
| Блок кода |
|---|
ln -s /usr/abills/AbillsACP/modules/Extreceipt/misc/atol.cgi /usr/abills/cgi-bin/ |
Заполнить информацию о подключенных онлайн сервисах (API) и ККТ в Настройки>Чеки
Вид оплаты - платежи с указанным видом оплаты будут отправляться на этот ккт (можно указать несколько видов оплаты через запятую)
Группы - только платежи пользователей из указанных групп будут отправляться на этот ккт.
В примере на скриншоте платежи полученные от пользователей без группы или пользователей группы 10 с типом платежа 100, 21, 99 или 1 будут зарегистрированы на первом ККТ, а платежи полученные от пользователей из группы 5 - на 2м ККТ.
Включаем модуль в config.pl
| Блок кода |
|---|
our @MODULES = (
...
'Extreceipt',
...
) |
Параметры
Оплата Интернет Клиент &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 + Ваши информационные поля
Список администраторов при добавлении платежа происходит отправка в 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 платежа с какого нужно начать.
|
Автоматический запуск отправки платежей
Для автоматического запуска плагина, необходимо добавить строку в 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
Чтобы сделать чек на возврат нужно зайти в Обслужывание→Чеки, найти нужный платеж и его отменить.
Когда Вы отменили, есть возможность его напечатать.
