Table of Contents |
---|
Возможности
Подписка на отчёты с аккаунта пользователя
Лимиты срабатывания сенсоров отчётов, устанавливаются пользователями самостоятельно
Группирование отчётов в тарифные планы
Возможность взыскания средств за активизацию тарифного плана
Тарификация предоставления услуги (месячная абон. плата, плата за отчёт)
Ведение журнала предоставленных отчётов
Поддержка модулей расширения отчётов
Возможность запретить абонентам управлять отчётами
Предоставление отчётов о:
1 | Оповещение абонента со статусом услуги интернет «Активно» и суммой депозита ниже значения тригера |
---|---|
2 | Депозит + Кредит ниже значения тригера |
3 | Предоплаченный трафик закончился. (Значение тригера не учитывается) отчет обресечивается каждое 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 | ||
---|---|---|
| ||
cd /usr/abills/ mysql -D abills < db/Ureports.sql cp Ureports.pm /usr/abills/Abills/mysql/ |
Code Block | ||||
---|---|---|---|---|
| ||||
cd libexec ln -s ../Abills/modules/Ureports/ureports_sender.pl ureports_sender.pl |
Code Block | ||||
---|---|---|---|---|
| ||||
@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 | ||
---|---|---|
| ||
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%
Правка и список шаблонов отчётов находится в Настройка>Другое>Шаблоны (Работа с шаблонами системы)
Переменные шаблонов
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 | Как стандартное тело отчёта, которое формирует программа отчётов, в некоторых отчётах может не заполняться |
Система плагинов
Добавлена возможность создавать собственный плагины для отчетов. Плагины размещаются в папке modules/Ureports с расширением *.pm
Пример: плагин Report1.pm поздравляет абонентов с днем рождения.