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

В этой статье:

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

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

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

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

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



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

  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. Для нескольких or после and следует использовать дополнительные скобки: order.type = "RenewalOrder" and order.renewal_is_positive = true and subscription.payment_model = "prepay" and ((order.plans_ids include? 293827) or (order.plans_ids include? 293824) or (order.plans_ids include? 294340))
    • % (например, 30% от Порога срабатывания финансовой блокировкиaccount.financial_blocking_threshold % 30 )

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

    subscription.days_left = 10 AND subscription.status = "active" 
    Этот запрос означает, что обработчик будет работать для всех активных подписок, которые истекают через 10 дней.
  9. Нажать кнопку Создать. Новое Событие будет создано и отображено в Списке событий уведомлений (см. Просмотр списка Событий уведомлений) у текущего Реселлера и его нижестоящих Реселлеров.

Список событий

СобытиеОписание
Приближается финансовая блокировка клиента

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

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

account.financial_blocking_threshold % 35 < -account.balance

Клиент измененПроисходит при блокировке Клиента (финансовой или административной, см. Переход Клиента в финансовую блокировку и Перевод Клиента в административную блокировку) и при активации Клиента после блокировки (см. Выход Клиента из финансовой блокировки и Активация Клиента после административной блокировки).
Клиент созданПроисходит при создании нового Клиента (см. Создание Клиента).
Порог срабатывания финансовой блокировки измененПроисходит при изменении значения Порога срабатывания финансовой блокировки в Правиле обслуживания (см. Создание Правила обслуживания) или при изменении индивидуального значения для Клиента (см. Просмотр и обновление информации о Клиенте). Событие происходит также и при создании нового Клиента. Если Клиенту назначается другое Правило обслуживания, а Порог срабатывания финансовой блокировки не изменяется, то Событие не происходит.
Менеджер клиента измененПроисходит при изменении или назначении менеджера Клиента (см. Просмотр и обновление информации о Клиенте).
Закрытие АктаПроисходит в Финансовый день при выставлении Акта за потребленную Услугу (подробнее см. Управление Актами).
Счет был подтвержденСобытие наступает при вызове сторонней ERP-системой API-метода (см. Approve postpaid invoice) для Акта по модели Постоплата с внешним управлением (см. Управление Актами по модели Постоплата сторонней ERP-системой). Чтобы определить, был ли прикреплен к связанному Платежу Счет на оплату, в Правиле обработки события используется Плейсхолдер invoice.has_attached.
Недостаточно средств на балансеПроисходит если Баланс аккаунта меньше либо равен нулю.
Сотрудник созданПроисходит при создании Сотрудника через Панель управления Оператора (см. Добавление Сотрудника) или по API (см. Create manager). Используется для отправки Сотруднику учетных данных для входа (см. Плейсхолдеры в Шаблонах уведомлений для отдельных Событий уведомлений). Не требует настройки Правила обработки События.
Ручная операцияПроисходит при:
Платеж полученПроисходит при смене статуса Платежа:
Срок оплаты платежа приближается

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

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


payment.days_left = N, 

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

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


payment.days_left = 0, 

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

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

Платеж по постоплате созданПроисходит на следующий день после Финансового дня, когда платформа закрывает Акт по модели Постоплата и создает связанный Платеж. 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).
Финансовый день наступает
Происходит ежедневно для каждого уникального Финансового дня. Пользователю Клиента с ролью Владелец отправляется email сообщение о дате Финансового дня и о сумме предстоящего списания средств с Баланса Клиента. В случае, если у Клиента есть Подписки с типом биллинга Pay as you go, в письме будет указано, что сумма, на которую нужно пополнить Баланс, может измениться. В сообщении также будет размещена ссылка на страницу пополнения Баланса Клиента (см. Пополнение Баланса Клиента). Пользователи, авторизованные в Панели управления Оператора с ролью Системный администратор и Менеджер по продажам (см. Роли Сотрудников), также могут перейти по этой ссылке в Панель управления Клиента в рамках одного Реселлера, если у них в браузере нет сессии с авторизацией в Панели управления Клиента.
Учитываются только Подписки в следующих статусах (см. Просмотр списка Подписок):
  • Активная.
  • Ожидает ручного подтверждения для остановки Подписки.
  • Просрочена оплата.

Для корректной работы требует обязательной настройки Правила обработки События.

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

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

  • Наличие Подписок с определенной моделью оплаты: задается при помощи Плейсхолдера 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 Менеджера, для которого вызвано Событие уведомлений.

Себестоимость изменена

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

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

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

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

Событие наступает если перечисленные выше действия выполняются:

    • Через интерфейс Панели управления Оператора.
    • Через API.
Приближение к кредитному лимиту постоплатной подписки

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

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

subscription_postpay.credit_limit % 70 < subscription_postpay.current_debt

Закрывающие документы сформированыСобытие наступает при вызове API-метода (см. Send notifications on closing documents) для рассылки уведомлений Клиентам Реселлера о том, что Закрывающие документы за указанный период получены из сторонней ERP-системы и доступны для скачивания по ссылкам и через Панель управления Клиента в разделе Закрывающие документы (см. Closing documents). Раздел Закрывающие документы отображается в Панели управления Клиента, если включена соответствующая системная настройка (см. Задание общих системных настроек). Уведомление отправляется только для документов в статусе Новый. После отправки уведомления статус этих документов меняется на Отправлен.
Создан объединенный платежСобытие наступает при автоматическом или ручном объединении Платежей (см. Объединение Платежей по модели Предоплата).
Повторная отправка заказаПроисходит через указанное количество дней после создания Заказа для Заказов в статусе Ожидает оплаты, у которых Платеж связан только с одним Заказом (то есть Заказ не связан с объединенным Платежом — см. Объединение Платежей по модели Предоплата).
Повторная отправка объединенного платежаПроисходит через указанное количество дней после создания объединенного Платежа для Платежей в статусе Ожидает оплаты.
Запрос на сброс пароля при создании пользователяПроисходит при сбросе пароля Пользователя, в случае если Пользователь был создан в Панели управления Оператора (Создание Пользователя).
Обновление себестоимости CSPПроисходит ежедневно для всех Подписок. Для корректной работы требует обязательной настройки Правила обработки События.
Загрузка себестоимости CSP 

Происходит:

  • После загрузки нового файла с ценами (см. Updating the net costs of the Resources of the Microsoft Office 365 Plans).
  • После утверждения нового файла с ценами, в случае когда файл с ценами из статуса Требуется подтверждение переходит в статус Будущий или Текущий.
  • После перехода файла из статуса Будущий в статус Текущий.
Заявка на создание счёта отправленаСформирована Ручная операция на создание счета на оплату.
Счёт на пополнение баланса готовСчет на оплату для пополнения баланса Клиента сформирован вручную.
Отчётный период закрытУведомление о закрытии отчетного периода при получении от 1С запроса для сверки баланса Клиентов отправляется в случае совпадения балансов в 1С и ActivePlatform.
VSP ресурсы изменилисьПроисходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Обновление на Активная при изменении количества Ресурсов Подписки.
VSP подписка созданаПроисходит при смене статуса Подписки на Тарифный план, переданный из Vendor Portal, с Устанавливается на Активная (см. Синхронизация Продуктов и Тарифных планов между Vendor Portal и ActivePlatform).
Создание сервераПроисходит при создании нового сервера CloudServer (см. Создание Сервера).
Сброс пароля сервераПроисходит при сбросе пароля сервера CloudServer. Сброс пароля возможен через пользовательский веб-интерфейс управления услугой CloudServer (Сброс пароля администратора сервера через раздел Серверы и Сброс пароля администратора сервера через раздел раздел Дата-центры).