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

Минимальная версия: 3.13.16

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

Активировать бонус тип 1 в системных опциях.

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

CentOS
Debian

mkdir -p /var/www/mikbill/modules/bonus
cd /var/www/mikbill/modules/bonus
touch bonus_1.json
chown apache:apache bonus_1.json

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

Содержимое файла:

[
  {
    "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
    }
  }
]

В данном примере настроены следующие бонусы:

Данный бонус будет проигнорирован так как в нем есть параметр disabled с значением true

{
    "gid": "1",
    "description": "Бонус за пополнение счета (недоступен)",
    "disabled": true,
    "bonus_1": {
      "summ": "100",
      "bonus": "10"
    }
}

Данный бонус срабатывает на всех тарифах так как в параметре gid указано значение any
Так же у бонуса указано что срабатывать он должен только с 25 по 31 число (параметры start_day и end_day)
При пополнении от 300 и выше будет начислено 15 бонуса на баланс

{
    "gid": "any",
    "description": "Акция 'Пополни заранее'",
    "bughtypeid": 17,
    "start_day": 25,
    "end_day": 31,
    "bonus_123": {
      "summ": "300",
      "bonus": "15"
    }
}

Данный бонус сработает на тарифах с 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

{
    "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
    }
}

Параметр	По умолчанию	Возможные значения	Описание
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`	Включает начисление процента от суммы пополнения

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

Бонус тип 1

Настройка

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

Результат

MikBiLL