Плейсхолдеры для описания Правила обработки события
Для каждого существующего в системе События уведомления существует набор Плейсхолдеров, который позволяет извлекать определенную информацию из базы данных и автоматически вставлять извлеченные данные в заранее определенное место. Тем самым Плейсхолдер обеспечивает автоматическое заполнение форм и сообщений.
В таблице ниже приведен список Событий и соответствующих им Плейсхолдеров, которые могут быть использованы для описания Правила обработки данного события.
Событие | Плейсхолдер | Описание | Тип | Пример |
---|---|---|---|---|
Общее для всех событий | owner.status | статус владельца клиента | string | owner.status = "active" |
owner.country | 2-буквенный код страны (ISO), к которой принадлежит владелец клиента (например, BY для Республики Беларусь) | string | owner.country = "BY" | |
owner.city | название города, к которой принадлежит владелец клиента | string | owner.city = "Minsk" | |
current_date | текущая дата | date | current_date | |
Клиент изменен (Account changed) Недостаточно средств на балансе (Low balance) Создание сервера (Create instance) Сброс пароля сервера (Reset instance password) | account.type_id | id типа клиента | integer | account.type_id = 1 |
account.type_key | ключ типа клиента | string | account.type_key = "business" | |
account.class_id | id правила обслуживания клиента | integer | account.class_id = 1 | |
account.class_key | ключ правила обслуживания клиента | string | account.class_key = "manual" | |
account.billing_day | финансовый день, установленный в правиле предоставления тарифного плана, на который подписан клиент; порядковый номер дня в месяце | integer | account.billing_day = 30 | |
account.credit_limit | integer | account.credit_limit = 100 | ||
account.balance | баланс клиента | integer | account.balance = 1000 | |
account.balance.was | предыдущее значение баланса клиента | integer | account.balance.was = 100 | |
account.status | статус клиента | string | account.status = "inactive" | |
account.status.was | предыдущий статус клиента | string | account.status.was = "inactive" | |
account.country | 2-буквенный код страны (ISO), к которой принадлежит клиент (например, BY для Республики Беларусь) | string | account.country = "BY" | |
account.city | название города, к которой принадлежит клиент | string | account.city = "Minsk" | |
Недостаточно средств на балансе (Low balance) | account.regular_sending | данный плейсхолдер используется для задания условий отправки уведомлений о низком балансе.
| boolean | "account.regular_sending = true" |
account.has_endless_trial_subscriptions | параметр используется для установки типа подписок для которых необходимо отправлять СМС уведомления (пробная подписка/ коммерческая подписка) Если "account.has_endless_trial_subscriptions = true" СМС уведомление о низком балансе отправляется только при наличии хотя бы одной активной коммерческой подписки, работающей по потребленным ресурсам (IaaS). | boolean | "account.has_endless_trial_subscriptions = true" | |
Закрытие Акта (Invoice closed) | invoice.status | статус акта | string | invoice.status = "open" |
Ручная операция (Manual Operation) | operation.id | id операции | integer | operation.id = 1 |
operation.status | статус операции | string | operation.status = "approval_required" | |
Приглашение пользователя (User invitation) | - | - | - | - |
Платеж получен (Payment has been received) | account.type_key | ключ типа клиента | string | account.type_key = "business" |
account.class_key | ключ правила обслуживания клиента | string | account.class_key = "manual" | |
account.billing_day | финансовый день - число месяца, в которое производится формирование aктов (см. Управление Актами) и изменение статуса cписаний (см. Просмотр Списаний) для клиента (данный параметр может иметь значение от 1 до 31, определяющее день месяца) | integer | account.billing_day = 30 | |
account.credit_limit | integer | account.credit_limit = 100 | ||
account.balance | баланс клиента | integer | account.balance = 1000 | |
account.balance.was | предыдущее значение баланса клиента | integer | account.balance.was = 100 | |
account.status | статус клиента | string | account.status = "inactive" | |
account.status.was | предыдущий статус клиента | string | account.status.was = "inactive" | |
account.country | название страны, к которой принадлежит клиент | string | account.country = "Belarus" | |
account.city | название города, к которой принадлежит клиент | string | account.city = "Minsk" | |
payment.total | общая сумма платежа (Итого), | integer | payment.total = 100 | |
payment.status | статус платежа | string | payment.status = "completed" | |
Запрос сброса пароля (Password reset request) Подтверждение email (Verify email) | user.id | id пользователя | integer | user.id = 1 |
До окончания периода подписки После окончания периода подписки Подписка переведена из пробного статуса в платный Подписка изменена (Subscription changed) | account.type_key | ключ типа клиента | string | account.type_key = "business" |
account.class_key | ключ правила обслуживания клиента | string | account.class_key = "manual" | |
account.billing_day | финансовый день - число месяца, в которое производится формирование aктов (см. Управление Актами) и изменение статуса cписаний (см. Просмотр Списаний) для клиента (данный параметр может иметь значение от 1 до 31, определяющее день месяца) | integer | account.billing_day = 30 | |
account.credit_limit | максимальная задолженность на балансе клиента, которая устанавливается в правиле обслуживания | integer | account.credit_limit = 100 | |
account.balance | баланс клиента | integer | account.balance = 1000 | |
account.balance.was | предыдущее значение баланса клиента | integer | account.balance.was = 100 | |
account.status | статус клиента | string | account.status = "inactive" | |
account.status.was | предыдущий статус клиента | string | account.status.was = "inactive" | |
account.country | название страны, к которой принадлежит клиент | string | account.country = "Belarus" | |
account.city | название города, к которой принадлежит клиент | string | account.city = "Minsk" | |
plan.id | id тарифного плана | integer | plan.id = 1 | |
plan.status | статус тарифного плана | string | plan.status = "completed" | |
plan_category.key | ключ категории тарифных планов | string | plan_category.key = "streaming" | |
plan_period.duration_value | длительность периода подписки на тарифный план | integer | plan_period.duration_value = 30 | |
plan_period.duration_type | тип длительности периода подписки на тарифный план (год, месяц, день) | string | plan_period.duration_type = "months" | |
plan_period.trial | является ли период тарифного плана пробным | boolean | plan_period.trial = "false" | |
plan_period.setup_fee | стоимость установки подписки на период тарифного плана | integer | plan_period.setup_fee = 100 | |
plan_period.recurring_fee | абонентская плата за подписку на период тарифного плана | integer | plan_period.recurring_fee = 100 | |
plan_period.renewal_fee | стоимость продления подписки на период тарифного плана | integer | plan_period.renewal_fee = 100 | |
subscription.id | id подписки | integer | subscription.id = 1 | |
subscription.status | статус подписки | string | subscription.status = "active" | |
subscription.status.was | предыдущий статус подписки | string | subscription.status.was="installing" | |
subscription.auto_renewal | включена ли опция 'Автопродление' в подписке | boolean | subscription.auto_renewal = "true" | |
subscription.days_left | количество дней до даты истечения подписки | integer | subscription.days_left = 7 | |
subscription.days_passed | количество дней, прошедших со дня создания подписки | integer | subscription.days_passed = 15 | |
subscription.plan_class | id правила предоставления тарифного плана | integer | subscription.plan_class = 1 | |
subscription.trial.status | является ли подписка пробной Плейсхолдер может быть применен при настройке обработчика события для события «Подписка изменена» (“Subscription changed”). В этом случае при изменении периода тарифного плана подписок, подпадающих под правила обработчика события, с trial на no-trial, должно направляться соответствующее уведомление согласно настройкам обработчика события. | string | subscription.trial.status = "trial" subscription.trial.status = "no-trial" | |
Заказ изменен (Order changed) Заказ создан (Order created) | order.id | id заказа | integer | order.id = 1 |
order.plans_ids | id заказанных планов | integer | order.type = "SalesOrder" and (order.plans_ids include? 2000030) | |
order.status | статус заказа | string | order.status = "waiting for payment" | |
order.status.was | предыдущий статус заказа | string | order.status.was = "provisioning" | |
order.total | общая стоимость заказа | integer | order.total = 100 | |
order.type | тип заказа | string | order.type = "RenewalOrder" | |
order.renewal_point | установлено ли значение в поле 'Точка автоматического продления (в днях)' на странице Подписки | boolean | order.renewal_point = "true" | |
Обещанный платеж создан (Guaranteed payment created) Обещанный платеж изменен (Guaranteed payment changed) | account.type_id | id типа клиента | integer | account.type_id = 1 |
account.type_key | ключ типа клиента | string | account.type_key = "business" | |
account.class_id | id правила обслуживания клиента | integer | account.class_id = 1 | |
account.class_key | ключ правила обслуживания клиента | string | account.class_key = "manual" | |
guaranteed_payment.status.was | предыдущий статус обещанного платежа | string | guaranteed_payment.status.was = "provided" | |
guaranteed_payment.status | статус обещанного платежа | string | guaranteed_payment.status = "revoked" | |
Финансовый день наступает (Billing day is coming) | billing_day | дата Финансового дня, для которого было вызвано событие | integer | billing_day = 5 |
billing_day_left | количество дней, которое осталось до Финансового дня, для которого было вызвано событие В Финансовый день, для которого было вызвано событие, возвращает не 0, а количество дней до следующего Финансового дня | integer | billing_day_left = 7 | |
billing_day_open_charges_amount | сумма Cписаний со статусом Открыто для активных Подписок с типами биллинга CSP месячный, Оплата в полном объеме, G-Suite, которые будут закрыты или заблокированы в Финансовый день, для которого было вызвано событие | number | billing_day_open_charges_amount = 120.1 | |
plan_ids | массив ID Планов активных Подписок Клиента | array(int) | plan_ids = [200023, 200024] | |
product_ids | массив ID Продуктов активных Подписок Клиента | array(int) | product_ids = [100022, 100023] | |
monthly_billing | флаг, указывающий на то, что у Клиента есть не удаленные Подписки с типами биллинга CSP месячный, Оплата в полном объеме, G-Suite, для которых актуален Финансовый день, для которого было вызвано событие | boolean | monthly_billing = "true" | |
account.type_key | ключ Типа Клиента | string | account.type_key = "personal" | |
account.class_key | ключ Правила обслуживания Клиента | string | account.class_key = "default" | |
account.balance | доступный Баланс Клиента | number | account.balance = 58.5 | |
account.credit_limit | Кредитный лимит, доступный Клиенту | number | account.credit_limit = 10000 |