ОНЛАЙН ЧЕКИ
| Table of Contents |
|---|
Данный модуль предназначен для работы онлайн кассами.
Поддерживается работа с сервисом сервисом ":
" и "Atol".- Atol
- Checkbox
При получении онлайн оплаты биллинг передает информацию о платеже в онлайн сервис.
Модуль ничего не делает с платежами, ничего не делает с чеками, с его помощью нельзя увидеть чек, веб интерфейс отсутствует, любой другой интерфейс тоже отсутствует. Модуль только передает информацию.
Установка
| Warning | ||
|---|---|---|
| ||
Если вы не знаете что такое ККТ - читать дальше бессмысленно. |
Установка
Включение в config.pl
| Code Block |
|---|
@MODULES = (
# добавляем в конец списка модуль, не забываем перед предыдущим поставить запятую, если ее нет
'Extreceipt',
); |
Модуль чеков
| Code Block |
|---|
cp Extreceipt.pm /usr/abills/Abills/modules/Extreceipt/db/ |
Создать таблицы в базе.
| Code Block |
|---|
mysql --default-character-set=utf8 -D abills < /usr/abills/Abills/modules/Extreceipt/Extreceipt.sql |
Скопировать billd плагин.
| Code Block |
|---|
ln -s /usr/abills/Abills/modules/Extreceipt/extreceipt_payments_reg.pm /usr/abills/libexec/billd.plugins/extreceipt_payments_reg.pm |
Скопировать страницу для callback (используется для Atol)
| Code Block |
|---|
ln -s /usr/abills/Abills/modules/Extreceipt/misc/atol.cgi /usr/abills/cgi-bin/ |
Заполнить данные информацию о онлайн кассе:
| Code Block | ||
|---|---|---|
| ||
$conf{EXTRECEIPT_OK_APP_ID} = 'XXXXXXXXXXXX';
$conf{EXTRECEIPT_OK_SECRET} = 'XXXXXXXXXXXX';
$conf{EXTRECEIPT_OK_METHODS} = '21,22,23'; # Типы платежей, которые необходимо регистрировать.
$conf{EXTRECEIPT_OK_GOODS_NAME} = 'Aбонентская плата'; # Название товара, которое будет указано в чеке
$conf{EXTRECEIPT_OK_AUTHOR} = 'Abills paysys'; # Кассир
$conf{EXTRECEIPT_OK_API_URL} = 'https://XXXXXXXXXXXXXX/open-api/v1/';
|
| title | Параметры для работы с Atol |
|---|
подключенных онлайн сервисах (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 ''; |
Запуск отправкиплатежей в ручном режиме
Для регистрации полученных платежей в системе необходимо выполнить команду:
| Code Block |
|---|
/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 | Инкассация всех касс |
| Warning | ||
|---|---|---|
Если вы не хотите, чтобы при первом запуске скрипт отправил все существующие платежи, необходимо указать ID платежа с какого нужно начать.
|
Автоматический запуск отправки платежей
Для автоматического запуска плагина, необходимо добавить строку в crontab, не обязательно для checkbox, так как платежи отправляются сразу после добавления.
| Code Block |
|---|
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
Когда добавили платеж есть возможность его напечатать.
Чтобы сделать чек на возврат нужно зайти в Обслужывание→Чеки, найти нужный платеж и его отменить.
Когда Вы отменили, есть возможность его напечатать.
