Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

uМодуль является коммерческим

Система оповещения пользователей о состоянии счёта и другим событиям (новостям) системы посредством e-mail (для отправки должен быть настроен локальный MTA), sms (установлен модуль Sms) или факс (через внешние программы) сообщений. 

Для отправки SMS используется модуль Sms.

Table of Contents

Возможности

  • Подписка на отчёты с аккаунта пользователя

  • Лимиты срабатывания сенсоров отчётов, устанавливаются пользователями самостоятельно

  • Группирование отчётов в тарифные планы

  • Возможность взыскания средств за активизацию тарифного плана

  • Тарификация предоставления услуги (месячная абон. плата, плата за отчёт)

  • Ведение журнала предоставленных отчётов

  • Поддержка модулей расширения отчётов

  • Возможность запретить абонентам управлять отчётами

Предоставление отчётов о:

1Оповещение абонента со статусом услуги интернет «Активно» и суммой депозита ниже значения тригера
2Депозит + Кредит ниже значения тригера
3

Предоплаченный трафик закончился. (Значение тригера не учитывается) 
%REST% - осталось трафика в байтах 
%REST_DIMENSION% - осталось трафика приведено в разрядность 
%PREPAID% - предоплачено трафика 
Маркеры с учетом классов трафика %REST_0% %REST_DIMENSION_0% %PREPAID_0%


отчет обресечивается каждое  1 число месяца

4Дневной трафик превысил лимит тригера
5Месячный отчёт: Депозит, кредит, использованный трафик. Рассылается только первого числа (тригер не учитывается)
6Дневной отчёт: Депозит, кредит, использованный трафик. Рассылается только первого числа (тригер не учитывается)
7Оповещение о завершении кредита через указанное в тригере количество дней
8Оповещение об отключенном логине (тригер не учитывается)
9Оповещение о завершении тарифа через указанное количество дней. количество дней до завершения в шаблоне задается опцией %CREDIT_EXPIRE_DAYS%. Дней до завершения предоплаченного периода
10

Недостаточно средств для работы в следующем месяце (Депозит + Кредит)

Отправляются только тем у кого не достаточно средств на следующий учетный период. Отправлять можно в любой момент времени. Обнуляется  при пополнении счета. В данном отчете учитываются все услуги.

Запуск этого отчета желательно делать один раз в месяц в день рассылки предупреждения

Отчет обнуляется каждого 1 числа месяца.

11

Депозит ниже, чем абонплата следующего месяца. По данном отчету абонент может выставить период предупреждения. Например за 5 дней до начала следующего учетного периода (Количество дней предупреждения указывается в поле).

Отчет отправляется только для абонентов с статусом интернет Активно

Отчет обнуляется каждого 1 числа месяца.

12

Оповещение о пополнении счета

Отчет приходит после пополнения счет абонентом. Если используется конвертация сума оплаты передается в параметре AMOUNT и сума после конвертации в параметре SUM.

Отчет информирует о количестве дней оставшихся до завершения сервиса, при расчете количества дней учитывается только средства на депозите клиента.


Оповещать только о платежах определенного типа

$conf{UREPORTS_PAYMENT_METHOD}='2,4';

Если опция не указана оповещение идет о всех платежах

13Оповещение о завершении всех сервисов (Internet, Abon, Iptv, Voip) за несколько дней (количество дней до завершения указывается в тригере). Оповещение отправляется всем абонентам у которых сервис Internet  активен. Если у абонента достаточно средств на счету (рекомендованная сумма пополнения равна нулю) то сообщение не отправляется.
14

Оповещение о начислении абонплаты через период дней указанный в тригере, без учета средств (депозита).

Если у абонента скидка 100%  смс не приходит

15

В услуги интернет изменился статус (тригер не учитывается).

отправляется через программу ureports_sender.pl

обнуляется после пополнения счета

16Предупреждение о начале следующего учётного периода. В тригере указывается количество дней


Работа

Система рассылает сообщения через программу ureports_sender.pl, кроме сообщения о пополнении, оно отправляется моментально после поступления средств. После отправки сообщения система отмечает отчёт как выполненный и больше не отправляет сообщения по нему. 1 числа месячные отчеты(№ 3, 9, 10, 11, 13, 14) обнуляются и становятся готовыми опять для отправки сообщений. Обнуление происходит дневным периодиком (periodic daily).

Для того, чтоб настроить тарифнный план для Ureports необходимо зайти Настройки>Оповещение>Тарифные планы

Нажимаем +

МенюОписание
НазваниеНазвание тарифного плана
Цена сообщенияБудет ли сообщение платным для абонента
Переодические снятияСтоимость для абонента использования услуги
АктивацияСтоимость активации


Отправленные отчеты отмечены датой, дата - это дата отправки отчета.

Поиск абонента

Есть возможность найти абонента по номеру телефона если он подписан на оповещение



Если данные для поиска были верно заполненны и система нашла абонента, тогда искомые данные будут выведены на экране.


Если данные были введены некорректно или искомых данных нет в базе - на экране будет выведено сообщение

Установка

Создать таблицы в базе, скопировать модуль

Code Block
languagebash
cd /usr/abills/
mysql -D abills < db/Ureports.sql
cp Ureports.pm  /usr/abills/Abills/mysql/


Code Block
languagebash
titleУстановка агента рассылки сообщений (сендера)
cd libexec 
ln -s ../Abills/modules/Ureports/ureports_sender.pl  ureports_sender.pl


Code Block
languagebash
titleПодключение модуля. abills/libexec/config.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';

Список доступных типов оповещений для модуля. По умолчанию доступны все типы при регистрации услуги.

Варианты: Sms,Telegram,Mail

$conf{UREPORTS_CUSTOM_FIRST} = 1;

Кастомный шаблон ID: 1 (Депозит ниже допустимого лимита)

Шаблон для редактирования "ureports_sms_message.tpl"


Рассылка сообщений

Рассылкой сообщений занимается программа /usr/abills/libexec/ureports_sender.pl, доступны следующие опции.

DEBUG=0..6Режим отладки
TP_IDS=Список тарифных планов для обработки. Номера тарифных планов разделяются запятыми без пробелов
LOGIN=Список логинов для отправки сообщений. Разделяются запятыми
DATE=Установка даты формирования отчётов. Используется если есть необходимость сформировать отчёт за определённое число
helpПомощь

Данные программы следует поместить в /etc/crontab с параметрами времени рассылки.

Пример: рассылать сообщения каждый день в 10 утра

Code Block
languagebash
1   10  *  *  *  root /usr/abills/libexec/ureports_sender.pl


Шаблоны сообщений


Общие шаблоны

  • ureports_email_message.tpl - шаблон E-mail сообщения

  • ureports_sms_message.tpl - шаблон SMS сообщения

Индивидуальные шаблоны отчётов (для изменения стандартного представления)

  • ureports_reports_1.tpl - шаблон для отчёта 1

  • ureports_reports_%NUM%.tpl - шаблон для отчёта %NUM%

Правка и список шаблонов отчётов находится в Настройка>Другое>Шаблоны (Работа с шаблонами системы

Переменные шаблонов

UIDUID
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Как стандартное тело отчёта, которое формирует программа отчётов, в некоторых отчётах может не заполняться


Система плагинов

Добавлена возможность создавать собственный плагины для отчетов. Плагины размещаются в папке modules/Ureports с расширением *.pm

Пример: плагин Report1.pm поздравляет абонентов с днем рождения.