Возможности
Подписка на отчёты с аккаунта пользователя
Лимиты срабатывания сенсоров отчётов, устанавливаются пользователями самостоятельно
Группирование отчётов в тарифные планы
Возможность взыскания средств за активизацию тарифного плана
Тарификация предоставления услуги (месячная абон. плата, плата за отчёт)
Ведение журнала предоставленных отчётов
Поддержка модулей расширения отчётов
Возможность запретить абонентам управлять отчётами
Предоставление отчётов о:
| 1 | Оповещение абонента со статусом услуги интернет «Активно» и суммой депозита ниже значения тригера |
|---|---|
| 2 | Депозит + Кредит ниже значения тригера |
| 3 | Предоплаченный трафик закончился. (Значение тригера не учитывается) отчет обресечивается каждое 1 число месяца |
| 4 | Дневной трафик превысил лимит тригера |
| 5 | Месячный отчёт: Депозит, кредит, использованный трафик. Рассылается только первого числа (тригер не учитывается) |
| 6 | Дневной отчёт: Депозит, кредит, использованный трафик. Рассылается только первого числа (тригер не учитывается) |
| 7 | Оповещение о завершении кредита через указанное в тригере количество дней |
| 8 | Оповещение об отключенном логине (тригер не учитывается) |
| 9 | Оповещение о завершении тарифа через указанное количество дней. количество дней до завершения в шаблоне задается опцией %CREDIT_EXPIRE_DAYS%. Дней до завершения предоплаченного периода обнуляется 1 числа кажого месяца при положительном депозите абонента |
| 10 | Недостаточно средств для работы в следующем месяце (Депозит + Кредит) Отправляются только тем у кого не достаточно средств на следующий учетный период. Отправлять можно в любой момент времени. В данном отчете учитываются все услуги. Запуск этого отчета желательно делать один раз в месяц в день рассылки предупреждения обнуляется 1 числа кажого месяца при положительном депозите абонента |
| 11 | Депозит ниже, чем абонплата следующего месяца. По данном отчету абонент может выставить период предупреждения. Например за 5 дней до начала следующего учетного периода (Количество дней предупреждения указывается в поле). Отчет отправляется только для абонентов с статусом интернет Активно обнуляется 1 числа кажого месяца при положительном депозите абонента |
| 12 | Оповещение о пополнении счета Отчет приходит после пополнения счет абонентом. Если используется конвертация сума оплаты передается в параметре AMOUNT и сума после конвертации в параметре SUM. Отчет информирует о количестве дней оставшихся до завершения сервиса, при расчете количества дней учитывается только средства на депозите клиента. Оповещать только о платежах определенного типа $conf{UREPORTS_PAYMENT_METHOD}='2,4'; Если опция не указана оповещение идет о всех платежах |
| 13 | Оповещение о завершении всех сервисов (Internet, Abon, Iptv, Voip) за несколько дней (количество дней до завершения указывается в тригере). Оповещение отправляется всем абонентам у которых сервис Internet активен. Если у абонента достаточно средств на счету (рекомендованная сумма пополнения равна нулю) то сообщение не отправляется. обнуляется 1 числа кажого месяца при положительном депозите абонента |
| 14 | Оповещение о начислении абонплаты через период дней указанный в тригере, без учета средств (депозита). Если у абонента скидка 100% смс не приходит обнуляется 1 числа кажого месяца при положительном депозите абонента |
| 15 | В услуги интернет изменился статус (тригер не учитывается). отправляется через программу ureports_sender.pl обнуляется после пополнения счета |
| 16 | Предупреждение о начале следующего учётного периода. В тригере указывается количество дней |
| 17 | Возможность отправлять оповещения в Viber и Telegram. |
Дополнительные отчеты
| Report1 (Happy birthday) | Поздравление абонента с днем рождения |
|---|---|
| Paysys_invoice | Отправка сообщения об оплате в банк клиента, сейчас поддерживается только приватбанк |
Работа
Система рассылает сообщения через программу ureports_sender.pl, кроме сообщения о пополнении, оно отправляется моментально после поступления средств. После отправки сообщения система отмечает отчёт как выполненный и больше не отправляет сообщения по нему. 1 числа месячные отчеты(№ 3, 9, 10, 11, 13, 14) обнуляются и становятся готовыми опять для отправки сообщений. Обнуление происходит дневным периодиком (periodic daily).
Для того, чтоб настроить тарифнный план для Ureports необходимо зайти Настройки>Оповещение>Тарифные планы
Нажимаем +
| Меню | Описание |
|---|---|
| Название | Название тарифного плана |
| Цена сообщения | Будет ли сообщение платным для абонента |
| Переодические снятия | Стоимость для абонента использования услуги |
| Активация | Стоимость активации |
Отправленные отчеты отмечены датой, дата - это дата отправки отчета.
Поиск абонента
Есть возможность найти абонента по номеру телефона если он подписан на оповещение
Если данные для поиска были верно заполненны и система нашла абонента, тогда искомые данные будут выведены на экране.
Если данные были введены некорректно или искомых данных нет в базе - на экране будет выведено сообщение
Поиск по последнему сообщению:
Можно вводить текст последнего отправленного сообщения. Если нужно искать только по части сообщения, можно использовать * в начале или конце текста.
Установка
Создать таблицы в базе, скопировать модуль
cd /usr/abills/ mysql -D abills < db/Ureports.sql cp Ureports.pm /usr/abills/Abills/mysql/
cd libexec ln -s ../Abills/modules/Ureports/ureports_sender.pl ureports_sender.pl
@MODULES = (
'Ureports'
);
Настройка
abills/libexec/config.pl
| $conf{UREPORTS_EXT_SENDER}=«» | Внешняя программа рассылки сообщений. Система передаёт ей следующие параметры DESTINATION - адрес получения MESSAGES - сообщение |
|---|---|
| $conf{UREPORTS_SKIP_ACTIVATE_SMS}=1; | Не отправлять SMS при активации и изменении данных услуги. По умолчанию при активизации или изменении услуги оповещения система отправляет сообщение о действии |
| $conf{UREPORTS_ROUNDING}=1; | Округление рекомендуемой суммы оплаты к целым числам, округление всегда происходит в большую сторону |
| $conf{UREPORTS_ALLOWED_TYPES} = 'Sms'; | Через запятую можно указать куда будут отправляться оповещения пользователю. Возможные значения: Browser, Sms, Viber_bot, Viber, Telegram, Mail, Push, Hyber, XMPP Пример: $conf{UREPORTS_ALLOWED_TYPES} = 'Telegram,Viber_bot'; |
$conf{UREPORTS_CUSTOM_FIRST} = 1; | Кастомный шаблон ID: 1 (Депозит ниже допустимого лимита) Шаблон для редактирования "ureports_sms_message.tpl" |
| $conf{UREPORTS_CREDIT_NOTIFICATION}=1; | Не отправлять 12 отчёт, когда абонент взял кредит |
Работа с системой
Рассылка сообщений
Рассылкой сообщений занимается программа /usr/abills/libexec/ureports_sender.pl, доступны следующие опции.
| DEBUG=0..6 | Режим отладки |
|---|---|
| TP_IDS= | Список тарифных планов для обработки. Номера тарифных планов разделяются запятыми без пробелов |
| LOGIN= | Список логинов для отправки сообщений. Разделяются запятыми |
| DATE= | Установка даты формирования отчётов. Используется если есть необходимость сформировать отчёт за определённое число |
| help | Помощь |
Данные программы следует поместить в /etc/crontab с параметрами времени рассылки.
Пример: рассылать сообщения каждый день в 10 утра
1 10 * * * root /usr/abills/libexec/ureports_sender.pl
Шаблоны сообщений
Общие шаблоны
ureports_email_message.tpl - шаблон E-mail сообщения
ureports_sms_message.tpl - шаблон SMS сообщения
Индивидуальные шаблоны отчётов (для изменения стандартного представления)
ureports_report_1.tpl - шаблон для отчёта 1
ureports_report_%NUM%.tpl - шаблон для отчёта %NUM%
Кастомные отчеты должны быть в папке templates/ в формате Ureports_ureports_report_%NUM%.tpl
Правка и список шаблонов отчётов находится в Настройка>Другое>Шаблоны (Работа с шаблонами системы)
Переменные шаблонов
| UID | UID |
|---|---|
| LOGIN | Логин |
| FIO | Фамилия |
| CONTRACT_ID | Номер контракта |
| CONTRACT_DATE | Дата контракта |
| MESSAGE | Сообщение отчёта |
| DATE | Текущая дата |
| TP_ID | Номер ТП отчёта |
| CREDIT | Кредит абонента |
| DEPOSIT | Депозит абонента |
| EXPIRE_DAYS | Дней до завершения всех услуг |
| EXPIRE_DATE | Дата завершения услуг |
| RECOMMENDED_PAYMENT | Рекомендованная сумма платежей |
| TOTAL_FEES_SUM | Сумма всех месячных начислений |
| TP_MONTH_FEE | Месячная абон. плата |
| MESSAGE | Как стандартное тело отчёта, которое формирует программа отчётов, в некоторых отчётах может не заполняться |
Также предусмотрены отдельные шаблоны для каждого типа сообщений
Например:
ureports_report_sms_10.tpl
ureports_report_email_10.tpl
ureports_report_push_10.tpl
ureports_report_telegram_10.tpl
если система не может найти отдельный шаблон она использует общий шаблон для отчета
ureports_report_10.tpl
Система плагинов
Добавлена возможность создавать собственный плагины для отчетов. Плагины размещаются в папке modules/Ureports с расширением *.pm
Пример: плагин Report1.pm поздравляет абонентов с днем рождения.