Создание События уведомлений

Перед созданием События уведомлений необходимо:

Созданное Событие уведомлений автоматически создается у всех нижестоящих Реселлеров (подробнее см. Делегирование Шаблонов интерфейса, Шаблонов уведомлений, Событий уведомлений и Категорий уведомлений).

Чтобы создать Событие уведомлений, необходимо:

  1. Войти в Панель управления Оператора.
  2. На Панели навигации перейти в раздел События уведомлений (см. Навигация по Панели управления Оператора). Откроется страница События уведомлений (см. Просмотр списка Событий уведомлений).

  3. На Панели инструментов страницы События уведомлений нажать кнопку Создать. В рабочей области появится страница Добавить обработчик.



    Так как Событие уведомлений делегируется всем нижестоящим Реселлерам, то оно должно быть уникальным. Набор параметров Событие, Тип Шаблона уведомлений, Шаблон уведомлений и Правило не должен совпадать с соответствующим набором параметров существующих Событий уведомлений у текущего Реселлера (Оператора) и всех его нижестоящих Реселлеров.

  4. На странице Добавить обработчик в открывающемся списке Событие выбрать тип события, при наступлении которого должно срабатывать Событие уведомлений. Список Событий уведомлений включает в себя следующие События:

    • Период отсрочки Платежа истекает — происходит только для Подписок по модели Постоплата. В зависимости от условий в Правиле происходит либо за заданное в Правиле количество дней до истечения Периода отсрочки Платежа (см. Плейсхолдеры для описания Правила обработки события), либо при переходе Платежа в статус Просрочен и блокировке связанных Подписок (см. Просмотр Акта для модели Постоплата). При отсутствии условий в поле Правило Событие произойдет в дату истечения Периода отсрочки Платежа.

      Для отправки Уведомлений за несколько дней до истечения Периода отсрочки Платежа следует использовать Правило следующего вида:


      payment.days_left = N,

      где N — количество дней до истечения Периода отсрочки Платежа, за которое нужно отправить Уведомление.

      Чтобы отправить Уведомление в дату истечения Периода отсрочки Платежа и перехода Платежа в статус Просрочен, а связанных Подписок — в статус Заблокирована, следует использовать Правило следующего вида:


      payment.days_left = 0,

      или оставить поле Правило незаполненным.

      Email-уведомление включает счет в формате PDF. PDF-счет формируется для Платежа, связанного с Актом по модели Постоплата. PDF-счет формируется только для Клиентов, у которых задан Способ оплаты по умолчанию на основе модуля CheckCash (см. Просмотр и обновление Типа клиентов).

    • Приближается финансовая блокировка клиента — происходит если Баланс Клиента становится равным либо меньше заданной доли (от 1% до 99% включительно) от Порога срабатывания финансовой блокировки, но не меньше Порога срабатывания финансовой блокировки. Для корректной работы требует обязательной настройки Правила обработки События.

      Например, при следующем Правиле обработки события, Событие произойдет когда Баланс Аккаунта будет составлять менее 35% от Порога срабатывания финансовой блокировки:

      account.financial_blocking_threshold % 35 < -account.balance

    • Клиент изменён — происходит при блокировке Клиента (финансовой или административной, см. Переход Клиента в финансовую блокировку и Перевод Клиента в административную блокировку) и при активации Клиента после блокировки (см. Выход Клиента из финансовой блокировки и Активация Клиента после административной блокировки).
    • Клиент создан — происходит при создании нового Клиента (см. Создание Клиента).
    • Порог срабатывания финансовой блокировки изменен — происходит при изменении значения Порога срабатывания финансовой блокировки в Правиле обслуживания (см. Создание Правила обслуживания) или при изменении индивидуального значения для Клиента (см. Просмотр и обновление информации о Клиенте). Событие происходит также и при создании нового Клиента. Если Клиенту назначается другое Правило обслуживания, а Порог срабатывания финансовой блокировки не изменяется, то Событие не происходит.
    • Менеджер клиента изменен — происходит при изменении или назначении менеджера Клиента (см. Просмотр и обновление информации о Клиенте).
    • Закрытие Акта — происходит в Финансовый день при выставлении Акта за потребленную Услугу (подробнее см. Управление Актами).
    • Недостаточно средств на балансе — происходит если Баланс аккаунта меньше либо равен нулю.
    • Ручная операция происходит при:
    • Платеж по постоплате создан — происходит на следующий день после Финансового дня, когда платформа закрывает Акт по модели Постоплата и создает связанный Платеж. Email-уведомление включает PDF-счет для Платежа. PDF-счет формируется только для Клиентов, у которых задан Способ оплаты по умолчанию на основе модуля CheckCash (см. Просмотр и обновление Типа клиентов).
    • Платеж получен происходит при смене статуса Платежа:
    • Запрос сброса пароля — происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Клиента (подробнее см. Reset password).
    • Запрос сброса пароля менеджера — происходит при запросе письма с инструкциями по сбросу пароля к Панели управления Оператора (подробнее см. Сброс пароля к Панели управления Оператора).
    • До окончания периода подписки — происходит ежедневно для всех Подписок, у которых нет связи с Заказом на продление в статусе Ожидает предоставления или Предоставляется. Для корректной работы требует обязательной настройки Правила обработки События.
    • После окончания периода подписки — происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События. 
    • Подписка переведена из пробного статуса в платный — происходит при переходе Подписки из пробного в тарифицируемый период.
    • Подписка изменена происходит при:
      • смене статуса Подписки на:
        • Активная.
        • Удалена, кроме перехода в статус Удалена из статуса Новый заказ.
        • Остановлена, кроме случая административной блокировки Аккаунта.
        • Просрочена оплата.
        • Требуется ручное подтверждение.
      • при переходе Подписки из пробного в тарифицируемый период.
      • продлении активной подписки в Панели управления Оператора (см. Ручное продление Подписки) или в Панели управления Клиента (см. Renew subscription).
      • при автопродлении Подписки (см. Автоматическое продление Подписки).
      • изменении Ресурсов Подписки.
    • Подтверждение email — происходит при регистрации нового пользователя в Панели управления Клиента, после нажатия кнопки Зарегистрироваться (подробнее см. Quick registration).
    • Приглашения пользователя — происходит при приглашении внешнего пользователя Владельцем или Администратором Аккаунта (подробнее см. Приглашение Внешнего пользователя).
    • Заказ изменён — происходит при смене статуса Заказа на:

    • Заказ создан — происходит при создании нового Заказа (Создание Заказа). В том числе, срабатывает как при ручном, так и при автоматическом создании Заказа на продление.

      Чтобы исключить отправку Клиентам счетов на оплату по Заказам на пролонгацию, создаваемым в Финансовый день для автоматической оплаты с Баланса клиента (см. Пролонгация Подписки), необходимо чтобы для Подписок, у которых установлена Точка автоматического продления (в днях) = 0, События Заказ создан и Заказ изменён не срабатывали. Для этого в Правиле обработки этих Событий необходимо задать условие order.type = "ProlongOrder" AND order.renewal_is_positive = true (см. Плейсхолдеры для описания Правила обработки события). События будут срабатывать только для Подписок, у которых Точка автоматического продления (в днях) больше 0.

    • Обещанный платеж создан — происходит при:
    • Обещанный платеж изменен — происходит при автоматическом или ручном отзыве Обещанного платежа. Подробнее см. Отзыв Обещанного платежа.
    • Обещанный платеж истекает — происходит за указанное количество дней до наступления даты истечения обещанного платежа.
    • Осталось дней до оплаты — происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События.
    • Телефонная верификация — происходит при нажатии кнопки Получить код на шаге SMS верификация при проведении полной регистрации Аккаунта (см. Full registration).
    • Обновление цен CSP — происходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События.
    • Загрузка цен CSP происходит: 
      • после загрузки нового файла с ценами (см. Обновление цен Ресурсов тарифных планов).
      • после утверждения нового файла с ценами, в случае когда файл с ценами из статуса Требуется подтверждение переходит в статус Будущий или Текущий.
      • после перехода файла из статуса Будущий в статус Текущий.
    • Заявка на создание счета отправлена — сформирована ручная операция на создание счета на оплату.
    • Счёт на пополнение баланса готов — счет на оплату для пополнения баланса Клиента сформирован вручную.
    • Отчётный период закрыт — финансовый период завершен.
    • Запрос на сброс пароля при создании пользователя происходит при сбросе пароля Пользователя, в случае если Пользователь был создан в Панели управления Оператора (Создание Пользователя).
    • VSP ресурсы изменились — происходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Обновление на Активная при изменении количества Ресурсов Подписки.
    • VSP подписка создана — происходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Устанавливается на Активная (см. Синхронизация Продуктов и Тарифных планов между Vendor Portal и ActivePlatform).
    • Создание сервера — происходит при создании нового сервера CloudServer (см. Создание Сервера).
    • Сброс пароля сервера — происходит при сбросе пароля сервера CloudServer. Сброс пароля возможен через пользовательский веб-интерфейс управления услугой CloudServer (Сброс пароля администратора сервера через раздел Серверы и Сброс пароля администратора сервера через раздел раздел Дата-центры).

    • Себестоимость изменена — происходит при изменении себестоимости Тарифного плана на уровне текущего Реселлера (см. Просмотр Прайс-листа).

      При создании этого События уведомления следует оставить поле Правило пустым.

      Платформа собирает данные об изменении себестоимости раз в сутки ночью. При этом в выборку Тарифных планов включаются только те планы, чья себестоимость изменилась с 00:00:00 до 23:59:59 предыдущих суток. Если себестоимость Тарифного плана изменилась, например, в 00:01 текущих суток, то этот Тарифный план попадет в выборку только на следующие сутки.

    • Финансовый день наступает — происходит ежедневно для каждого уникального Финансового дня. Пользователю Клиента с ролью Владелец отправляется email сообщение о дате Финансового дня и о сумме предстоящего списания средств с Баланса Клиента. В случае, если у Клиента есть Подписки с типом биллинга По факту потребления, в письме будет указано, что сумма, на которую нужно пополнить Баланс, может измениться. В сообщении также будет размещена ссылка на страницу пополнения Баланса Клиента (см. Пополнение Баланса Клиента). Пользователи, авторизованные в Панели управления Оператора с ролью Системный администратор и Менеджер по продажам (см. Роли Сотрудников), также могут перейти по этой ссылке в Панель управления Клиента в рамках одного Реселлера, если у них в браузере нет сессии с авторизацией в Панели управления Клиента.
      Учитываются только Подписки в следующих статусах (см. Просмотр списка Подписок):
      • Активная.
      • Ожидает ручного подтверждения для остановки Подписки.
      • Просрочена оплата.
      Для корректной работы требует обязательной настройки Правила обработки События.

      Если не задать Правило обработки, то Событие уведомления будет срабатывать во всех возможных ситуациях: ежедневно для каждого уникального Финансового дня, независимо от типа биллинга Подписки. Например, если у Клиента есть три Подписки с типами биллинга Предзаказ, CSP годовой, По факту потребления и тремя разными Финансовыми днями, то в течение всего месяца ему будет приходить по три Уведомления в день.

      Чтобы этого избежать, необходимо задать следующие параметры (см. Плейсхолдеры для описания Правила обработки события):

      • Наличие Подписок с определенной моделью оплаты: задается при помощи Плейсхолдера subscription.payment_model:

        • Если subscription.payment_model = "postpay", то уведомление отправляется, только если у Клиента есть неудаленные Подписки с моделью оплаты Постоплата, у которых наступает Финансовый день.
        • Если subscription.payment_model = "prepay", то уведомление отправляется, только если у Клиента есть неудаленные Подписки с моделью оплаты Предоплата, у которых наступает Финансовый день.

      • Наличие Подписок с определенным типом биллинга у Клиента. Задается при помощи Плейсхолдера monthly_billing. Чтобы Уведомления приходили только Клиентам, у которых есть Подписки с ежемесячными платежами (типы биллинга CSP месячный, ESET solutions for ISP (Monthly), G Suite, Оплата в полном объеме и Без возврата, в поле Правило нужно добавить следующее условие:

        monthly_billing = "true"

      • Количество дней, которые остались до даты Финансового дня: задается при помощи Плейсхолдера billing_day_left. Чтобы Уведомления приходили только за определенное количество дней до наступления уникального Финансового дня, в поле Правило нужно добавить следующее условие:

        billing_day_left = {количество дней до Финансового дня, за которое нужно отправить Уведомление}

      Дополнительно можно задать следующие параметры:

      • Число месяца, на которое установлен Финансовый день. Задается при помощи Плейсхолдера billing_day.
      • Сумма Cписаний в статусе Открыто, которые будут закрыты или заблокированы в Финансовый день, для которого было вызвано событие. Учитываются только Подписки, у которых Точка автоматического продления = 0. Если Списания в статусе Открыто не существуют, то производится расчет суммы на основе предварительной генерации Списаний на будущий Финансовый период. Задается при помощи Плейсхолдера billing_day_open_charges_amount.
      • ID Планов активных Подписок Клиента. Задается при помощи Плейсхолдера plan_ids.
      • ID Продуктов активных Подписок Клиента. Задается при помощи Плейсхолдера product_ids.
      • Ключ Типа Клиента. Задается при помощи Плейсхолдера account.type_key.
      • Ключ Правила обслуживания Клиента. Задается при помощи Плейсхолдера account.class_key.
      • Доступный Баланс Клиента. Задается при помощи Плейсхолдера account.balance.
      • Порог срабатывания финансовой блокировки Клиента. Задается при помощи Плейсхолдера account.financial_blocking_threshold.

      Например:

      billing_day = 1 and billing_day_left = 28 and account.type_key = "personal" and account.class_key = "default" and account.financial_blocking_threshold = 0 and monthly_billing = true and (plan_ids include? 1420) and (product_ids include? 498)

      Если нужно добавить несколько условий, которые должны выполняться одновременно, то следует использовать оператор and: billing_day = 1 and billing_day_left = 28. В данном примере Уведомление будет отправлено для Подписок, Финансовый день которых установлен 1-го числа каждого месяца, за 28 дней до наступления Финансового дня. Всего будет отправлено одно Уведомление.

      Если нужно добавить несколько условий, одно из которых должно выполняться обязательно, то следует использовать оператор or: billing_day = 1 or billing_day = 5. В данном примере по одному Уведомлению будет отправляться каждый день Финансового периода для Подписок, Финансовый день которых установлен как 1-го, так и 5-го числа каждого месяца.

      Для группировки и объединения условий можно использовать скобки (): (billing_day = 1 or billing_day = 2) and (billing_day_left = 3 or billing_day_left = 4) . В данном примере Уведомления будут отправлены для Подписок, Финансовый день которых установлен как 1-го, так и 1-го числа каждого месяца за 23 и за 24 дня до до наступления Финансового дня. Всего будет отправлено четыре Уведомления.

      Также для формирования Правила можно использовать арифметические операторы + и -, операторы сравнения значений Плейсхолдеров > <, менять порядок значений (1 = billing_day).

      Чтобы сформировать таблицу с перечнем Подписок, которые истекают в ближайший Финансовый период, можно использовать следующие Плейсхолдеры:

      • next_billing_period_start_day — дата начала следующего Финансового периода относительно Финансового дня, для которого было вызвано Событие.
      • next_billing_period_end_day — дата окончания следующего Финансового периода относительно Финансового дня, для которого было вызвано Событие.
      • Плейсхолдеры для сущности Подписка (см. Плейсхолдеры для сущности Подписка).
    • Финансовый день наступил. Событие вызывается после прохождения биллинг процесса и закрытия Списаний для каждого Менеджера Реселлера, при выполнении следующего условия:
      1. Хотя бы один Клиент данного Менеджера имеет не удаленную Подписку с Финансовым днем, равным текущей дате выполнения биллинг процесса. Например, у Менеджера один Клиент, и у данного Клиента 3 подписки, у 2-х из них финансовый день 5 число, у 1-ой — 10, соответственно событие будет вызываться дважды — 5 и 10 числа.

      2. Выполняются условия, заданные в поле Правило.

        В поле Получатель на странице создания и редактирования Шаблона уведомлений необходимо указать плейсхолдер {{manager.email}} — email Менеджера, для которого вызвано Событие уведомлений.

    • Кредитный лимит для постоплатной подписки изменен. Событие наступает для Клиентов, у которых есть Подписка по Постоплате в статусе отличном от Удалена, в случае:
        • Изменения Кредитного лимита по подписке в Правиле обслуживания.
        • Изменения Кредитного лимита по подписке на странице Клиента с моделью оплаты по умолчанию Постоплата.
        • Изменения Кредитного лимита по подписке на странице Подписки по Постоплате.
        • Переключения настройки Использовать из правил обслуживания в настройках Клиента, если при этом значение Кредитного лимита по подписке для Клиента изменяется.
        • Переключения настройки Использовать из настроек Клиента на странице Подписки, если при этом значение Кредитного лимита по подписке для Подписки изменяется.
        • Изменения Правила обслуживания для Клиента при включенной настройке Использовать из правил обслуживания, если при этом значение Кредитного лимита по подписке для Клиента изменяется.
        • Создания новой Подписки с моделью оплаты Постоплата.
      2. Событие наступает если перечисленные выше действия выполняются:
        • через интерфейс Панели управления Оператора.
        • через API.

    • Приближение к кредитному лимиту постоплатной подписки. Событие наступает в случае если величина Текущей задолженности по Подписке пересекла установленный % Кредитного лимита для данной Подписки, но не вышла за данный Кредитный лимит, то есть выполнилось условие заданное в поле Правило. Уведомление отправляется 1 раз.

      Например, при следующем Правиле обработки события, Событие произойдет, когда величина Текущей задолженности по Подписке превысит 70% от Кредитного лимита для данной Подписки:

      subscription_postpay.credit_limit % 70 < subscription_postpay.current_debt

    • Закрывающие документы сформированы. Событие наступает при вызове API-метода (см. Send notifications on closing documents) для рассылки уведомлений Клиентам Реселлера о том, что Закрывающие документы за указанный период получены из сторонней ERP-системы и доступны для скачивания по ссылкам и через Панель управления Клиента в разделе Закрывающие документы (см. Closing documents). Раздел Закрывающие документы отображается в Панели управления Клиента, если включена соответствующая системная настройка (см. Задание общих системных настроек). Уведомление отправляется только для документов в статусе Новый. После отправки уведомления статус этих документов меняется на Отправлен.
    • Счет был подтвержден. Событие наступает при вызове сторонней ERP-системой API-метода (см. Approve postpaid invoice) для Акта по модели Постоплата с внешним управлением (см. Управление Актами по модели Постоплата сторонней ERP-системой). Чтобы определить, был ли прикреплен к связанному Платежу Счет на оплату, в Правиле обработки события используется Плейсхолдер invoice.has_attached.
  5. В открывающемся списке Тип шаблона уведомлений выбрать один из способов отправки уведомлений: Email, СМС или Панель управления Клиента.
  6. В списке Шаблон уведомлений выбрать ранее созданный Шаблон уведомлений (см. Управление Шаблонами уведомлений).
  7. Чтобы настроить рассылку уведомлений в определенное время, необходимо:
    • снять флажок Добавить в очередь на отправку сразу, поле Добавить в очередь на отправку в определенное время (час суток) станет доступным.
    • в поле Добавить в очередь на отправку в определенное время (час суток) ввести час суток, в который задачи на отправку уведомлений по данному событию должны быть поставлены в Очередь на отправку.

  8. В поле Правило ввести запрос и условия обработки события, используя Плейсхолдеры (см. Плейсхолдеры для описания Правила обработки события).

    При описании Правила обработки события возможны следующие операции с Плейсхолдерами:

    • >

    • <

    • >=

    • <=

    • =

    • !=

    • include? (например, order.type = "SalesOrder" and (order.plans_ids include? 2000030)) — обработчик события сработает, если в заказ на покупку включен тарифный план с id =2000030)

    • exclude? (исключить определенные сущности (по id, ключу, имени) из выбранного массива сущностей, например, для исключения отправки уведомления о создании заказа на подписку по тарифному плану с id = 2000, необходимо использовать следующее правило: order.plans_ids exclude? 2000)

    • and (например, для исключения нескольких сущностей из массива необходимо использовать (product_ids exclude? 34650) and (product_ids exclude? 34702))

    • or
    • % (например, 30% от Порога срабатывания финансовой блокировки: account.financial_blocking_threshold % 30 )

    При создании Шаблонов уведомлений доступна возможность использовать открытый язык шаблонов Liquid, который позволяет создавать сложные Уведомления. Подробнее https://shopify.github.io/liquid/basics/introduction/.

    subscription.days_left = 10 AND subscription.status = "active" 
Данный запрос означает, что обработчик будет работать для всех активных подписок, которые истекают через 10 дней.

5. Нажать кнопку Создать. Новое Событие будет создано и отображено в Списке событий уведомлений (см. Просмотр списка Событий уведомлений) у текущего Реселлера и его нижестоящих Реселлеров.