====== Акции / Бонусы (Бонус тип 1) ======

<alert type="info">Минимальная версия: 3.13.16</alert>

===== Бонус тип 1 =====
При пополнении счета, абоненту будет начислен бонус в зависимости от настроек и суммы пополнения.

==== Настройка ====
Активировать **бонус тип 1** в системных опциях.\\
{{:billing:howto:bonus_type1_enable.jpg?500&nolink|}}

\\
\\

Создать файл настроек по пути: /var/www/mikbill/modules/bonus/bonus_1.json

<tabs>
  * [[#tab-centos|CentOS]]
  * [[#tab-debian|Debian]]
 
<pane id="tab-centos">
<code>
mkdir -p /var/www/mikbill/modules/bonus
cd /var/www/mikbill/modules/bonus
touch bonus_1.json
chown apache:apache bonus_1.json
</code>
</pane>

<pane id="tab-debian">
<code>
mkdir -p /var/www/mikbill/modules/bonus
cd /var/www/mikbill/modules/bonus
touch bonus_1.json
chown www-data:www-data bonus_1.json
</code>
</pane>
</tabs>

Содержимое файла:
<code>
[
  {
    "gid": "1",
    "description": "Бонус за пополнение счета (недоступен)",
    "disabled": true,
    "bonus_1": {
      "summ": "100",
      "bonus": "10"
    }
  },
  {
    "gid": "any",
    "description": "Акция 'Пополни заранее'",
    "bughtypeid": 17,
    "start_day": 25,
    "end_day": 31,
    "bonus_123": {
      "summ": "300",
      "bonus": "15"
    }
  },
  {
    "gid": "4-10, 15, 67, 22, 140-145",
    "description": "Бонус за пополнение счета",
    "bughtypeid": 93,
    "bonus_1": {
      "summ": "100",
      "bonus": "2"
    },
    "bonus_2": {
      "summ": "50",
      "bonus": "1"
    },
    "bonus_3": {
      "summ": "200",
      "bonus": "2",
      "is_percent": true
    },
    "bonus_4": {
      "summ": "1000",
      "bonus": "3",
      "is_percent": true
    }
  }
]
</code>

В данном примере настроены следующие бонусы:\\
\\
Данный бонус будет проигнорирован так как в нем есть параметр **disabled** с значением **true**
<code>
{
    "gid": "1",
    "description": "Бонус за пополнение счета (недоступен)",
    "disabled": true,
    "bonus_1": {
      "summ": "100",
      "bonus": "10"
    }
}
</code>


----

Данный бонус срабатывает на всех тарифах так как в параметре **gid** указано значение **any**\\
Так же у бонуса указано что срабатывать он должен только с 25 по 31 число (параметры **start_day** и **end_day**)\\
При пополнении от 300 и выше будет начислено 15 бонуса на баланс
<code>
{
    "gid": "any",
    "description": "Акция 'Пополни заранее'",
    "bughtypeid": 17,
    "start_day": 25,
    "end_day": 31,
    "bonus_123": {
      "summ": "300",
      "bonus": "15"
    }
}
</code>


----

Данный бонус сработает на тарифах с ID: 4,5,6,7,8,9,10,15,22,67,140,141,142,143,144,145 так как такой диапазон указан в параметре **gid**\\
При пополнении от 100 будет начислен бонус 2 на баланс\\
При пополнении от 50 будет начислен бонус 1 на баланс\\
При пополнении от 200 будет начислен бонус 2% от суммы пополнения на баланс, так как стоит параметр **is_percent** с значением **true**\\
При пополнении от 1000 будет начислен бонус 3% от суммы пополнения на баланс, так как стоит параметр **is_percent** с значением **true**\\
<code>
{
    "gid": "4-10, 15, 67, 22, 140-145",
    "description": "Бонус за пополнение счета",
    "bughtypeid": 93,
    "bonus_1": {
      "summ": "100",
      "bonus": "2"
    },
    "bonus_2": {
      "summ": "50",
      "bonus": "1"
    },
    "bonus_3": {
      "summ": "200",
      "bonus": "2",
      "is_percent": true
    },
    "bonus_4": {
      "summ": "1000",
      "bonus": "3",
      "is_percent": true
    }
}
</code>

==== Список параметров и значений ====

^ Параметр ^ По умолчанию ^ Возможные значения ^ Описание ^ 
| gid |  | ''any'',''1'',''1-5'',''1-5,7,8,9'' | ID тарифов на которых бонус должен срабатывать (any - срабатывать на любом тарифе) | 
| disabled | ''false'' | ''true'', ''false'' | Отключает бонус | 
| description | | ''string'' | Описание бонуса которое будет занесено в описание платежа |
| bughtypeid | ''93'' | ''int'' | ID типа платежа под которым будет зачислен бонус (список типов платежей можно найти в ''Настройки => Прием платежей => Типы платежей'') |
| usersgroupid | ''0'' | ''int'' | ID субпровайдера абонента |
| user_created_days_ago | ''0'' | ''int'' | Кол-во дней с момента создания абонента |
| user_created_years_ago | ''0'' | ''int'' | Кол-во лет с момента создания абонента |
| start_date |  | ''Y-m-d H:i:s'' | Дата начала работы бонуса, если не указать ''H:i:s'' то будет считать от ''00:00:00'' | 
| end_date |  | ''Y-m-d H:i:s'' | Дата окончания работы бонуса, если не указать ''H:i:s'' то будет считать от ''00:00:00'' | 
| start_day |  | ''1-31'' | Номер дня когда бонус начинает работать | 
| end_day |  | ''1-31'' | Номер последнего дня когда бонус еще работает | 
| allow_legal_users | ''true'' | ''true'', ''false'' | Разрешить срабатывание бонуса на юр. абонентах | 
| allow_individual_users | ''true'' | ''true'', ''false'' | Разрешить срабатывание бонуса на физ. абонентах | 
| allow_nomoney_users | ''true'' | ''true'', ''false'' | Разрешить срабатывание бонуса на должниках | 
| allow_freezed_users | ''true'' | ''true'', ''false'' | Разрешить срабатывание бонуса на замороженных | 
| only_voucher | ''false'' | ''true'', ''false'' | Срабатывать только при пополнении ваучером |
| only_paysystems | ''false'' | ''true'', ''false'' | Срабатывать только при пополнении платежной системой |
| only_cash_payments | ''false'' | ''true'', ''false'' | Срабатывать только при наличном платеже (кассир) |
| only_cashless_payments | ''false'' | ''true'', ''false'' | Срабатывать только при безналичном платеже (кассир) |
| only_if_no_blocks | ''false'' | ''true'', ''false'' | Срабатывать только если у абонента не было блокировок баланса за всю историю |

Параметры для блока **bonus_x**:
^ Параметр ^ По умолчанию ^ Возможные значения ^ Описание ^ 
| summ |  | ''1-2147483647'' | Минимальная сумма пополнения для начисления бонуса | 
| bonus | ''false'' | ''true'', ''false'' | Значение бонуса (ед. или процентов, зависит от **is_percent **) | 
| is_percent | ''false'' | ''true'', ''false'' | Включает начисление процента от суммы пополнения | 





==== Результат ====

{{:billing:howto:bonus_type1_result.jpg?900&nolink|}}