**''Документация по модулю Abon и принадлежащим к нему страницам перенесена в Confluence''**
[[http://abills.net.ua:8090/display/AB/Abon]]

=====Abon=====

Модуль снятия дневных, месячных и годовых абон. плат за используемые сервисы или услуги.

====Возможности====
  * Начисления абон. платы  по следующим периодам: день, месяц, квартал, пол года, год
  * Снятие денег с дополнительного счёта при использовании  параметра $conf{EXT_BILL_ACCOUNT}
  * Возможность производить снятия как по фиксированным периодам: начало месяца, начало квартала начало года, так и по произвольным через месяц после последнего снятия, через квартал, через полгода, через год
  * Добавление комментариев при назначении периодических платежей пользователям. Комментарии отображаются при снятии денег по периодическим платежам.
  * Отображение даты следующего периодического платежа
  * Индивидуальная скидка для каждой услуги
  * Выполнение внешних программ для объявленных услуг 





====Установка====
Создать таблицы в базе. 

  # mysql --default-character-set=utf8  -D abills < db/Abon.sql

Подключение модуля.
**abills/libexec/config.pl**
  @MODULES = (
            'Abon'
            );





====Работа с системой====
  * [[abills:docs:manual:admin:abon:abon_tariffs|Создание тарифных планов]]
  * [[abills:docs:manual:admin:abon:abon_user|Включение периодических услуг у абонента]]


====Снятие абон. платы в ручном режиме ====

Для снятия с абонентов абон. платы за определённое число нужно запустить дневной периодик с датой планируемого снятия 

  /usr/abills/libexec/periodic daily MODULES=Abon  DATE=xxxx-xx-xx
  
====Шаблон формирования описания начислений====

В систем предусмотрен шаблон формирования описания начислений, данный параметр задаётся в конфигурационном файле параметром 
  $conf{ABON_FEES_DSC}='  ';

Параметры Шаблона 
^%TP_NAME%| Название услуги | 
^%TP_ID%  | Номер услуги |
^%PERIOD% | Период начисления. Устанавливается только в месячной абон. плате  |
^%EXTRA%  | Дополнительные коментарии. Например, "Распределение абонплаты" |

Шаблон по умолчанию 
  $conf{ABON_FEES_DSC}='$lang{EXT_SERVICES}: %TP_NAME% (%TP_ID%) %EXTRA% %PERIOD%';