Плейсхолдеры в шаблонах уведомлений для отдельных событий уведомлений

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

Событие уведомленийПлейсхолдерОписание

Приближается финансовая блокировка клиента (Account credit hold is coming)


Клиент изменен (Account changed)


Клиент создан (Account created)


Порог срабатывания финансовой блокировки изменен (Financial blocking threshold was changed)


Менеджер клиента изменен (Account manager changed)


Недостаточно средств на балансе (Low balance)

Все плейсхолдеры для сущностей Клиент, Владелец, Реселлер

См. Плейсхолдеры для сущности Клиент, Общий набор плейсхолдеров для всех событий, Плейсхолдеры для сущности Реселлер

Плейсхолдер account.owner_reset_password_url может использоваться только для события Клиент создан.

hostДомен реселлера

Закрытие Акта (Invoice closed)


Счет был подтвержден (The Invoice was approved)

Все плейсхолдеры для сущностей Клиент, АктСм. Плейсхолдеры для сущности Клиент, Плейсхолдеры для сущности Акты
Запрос сброса пароля (Password reset request)Все плейсхолдеры для сущности ПользовательСм. Плейсхолдеры для сущности Пользователь
tokenУникальный код безопасности, который необходим для аутентификации
urlСсылка для восстановления пароля
localeЯзык, выбранный пользователем при регистрации
Приглашение пользователя (User invitation)inviter.short_nameИмя и фамилия лица, уполномоченного на заключение договора для клиента (см. Просмотр и обновление информации о клиенте)
inviter.first_nameИмя лица, уполномоченного на заключение договора
inviter.last_nameФамилия лица, уполномоченного на заключение договора
inviter.nameНазвание клиента, для которого приглашается пользователь
inviter.idID клиента, для которого приглашается пользователь
invite_urlСсылка, позволяющая приглашенному пользователю перейти в Панель управления Клиента
tokenУникальный токен для приглашения пользователя
hostДомен реселлера
Подтверждение email (Verify email)Все плейсхолдеры для сущности Пользователь

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

Плейсхолдер user.middle_name будет возвращать пустое значение, потому что при регистрации клиента (см. Quick registration) отчество не указывается.

confirmation_urlСсылка для подтверждения адреса электронной почты, указанного при регистрации
tokenУникальный код безопасности, который необходим для аутентификации
localeЯзык, выбранный пользователем при регистрации
hostДомен реселлера
Запрос сброса пароля менеджера (Manager password reset request)Все плейсхолдеры для сущности Сотрудник

См. Плейсхолдеры для сущности Сотрудник (Менеджер)

tokenУникальный код безопасности, который необходим для аутентификации
Загрузка себестоимости CSP (Upload CSP net costs)csp_price_file.accepted_atДата применения новых базовых цен для тарифных планов Microsoft Office 365
Себестоимость изменена (Net cost has been changed)
price_changed_total
Общее количество тарифных планов, для которых изменилась цена
price_changed_time
Дата и время изменения цен в тарифных планах
plans[].nameНазвания тарифных планов, чья себестоимость изменилась
plans[].idИдентификаторы тарифных планов, себестоимость которых изменилась
plans[].linkСсылка на тарифные планы реселлера в платформе
price_list.linkСсылка для перехода в раздел Прайс-лист

Платеж получен (Payment has been received)


Платеж по постоплате создан (Postpay payment created)


Срок оплаты платежа приближается (Payment due date is coming)

Все плейсхолдеры для сущности КлиентСм. Плейсхолдеры для сущности Клиент
Плейсхолдеры для сущности Платеж

См. Плейсхолдеры для сущностей Платеж, Обещанный платеж

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

  • payment.status.was

  • payment.panel_link

  • payment.plan_custom_attributes.item

  • payment.plan_resources_custom_attributes.item

Финансовый день по подпискам менеджера наступил (Billing day for manager's subscriptions has come)

(ранее — Финансовый день наступил (Billing day has come))


previous_billing_period_start_dayДата начала предыдущего финансового периода (ДД.ММ.ГГГГ) относительно финансового дня, для которого было вызвано событие
previous_billing_period_end_dayДата окончания предыдущего финансового периода (ДД.ММ.ГГГГ) относительно финансового дня, для которого было вызвано событие
manager_accountsМножество клиентов менеджера
manager_accounts[].idID клиента
manager_accounts[].primary_nameНазвание клиента
manager_accounts[].type_keyКлюч типа клиентов
manager_accounts[].class_keyКлюч правила обслуживания клиента
manager_accounts[].balanceТекущий баланс клиента
manager_accounts[].financial_blocking_thresholdВеличина порога срабатывания финансовой блокировки клиента, заданная на уровне правила обслуживания или переопределенная на уровне клиента
manager_accounts[].subscriptions[]Множество подписок клиента менеджера
manager_accounts[].subscriptions[].idID подписки клиента
manager_accounts[].subscriptions[].nameНазвание подписки клиента
manager_accounts[].subscriptions[].payment_model

Модель оплаты подписки:

  • prepay — Предоплата
  • postpay — Постоплата.
manager_accounts[].subscriptions[].payment_model_parameters[]

Массив параметров. Возвращается только для подписок payment_model = postpay.

  • "credit_limit" — величина кредитного лимита заданная на уровне подписки. 
  • "current_debt" — текущая задолженность по подписке.
manager_accounts[].subscriptions[].plan_category_keyКлюч категории тарифного плана, который используется для проверки, что у клиента, для которого вызвано событие, есть неудаленные подписки на тарифный план указанной категории
manager_accounts[].
subscriptions[].closed_charges_amount
Сумма списаний в статусе Закрыто для подписки, которые были закрыты за предыдущий финансовый период

До окончания периода подписки (Before subscription expiration)


После окончания периода подписки (After subscription expiration)


Подписка переведена из пробного статуса в платный (After subscription switched from trial to no-trial)


Подписка изменена (Subscription changed)


Кредитный лимит для постоплатной подписки изменен (Credit limit for postpaid subscription was changed)


Приближение к кредитному лимиту постоплатной подписки (Credit limit for postpaid subscription is approaching)

Все плейсхолдеры для сущностей Клиент, Подписка, Продукт

См. Плейсхолдеры для сущности Клиент, Плейсхолдеры для сущности Подписка, Плейсхолдеры для сущности Продукт

Для события Подписка переведена из пробного статуса в платный плейсхолдер subscription.payment_model может использоваться только со значением prepay, так как само событие доступно только для модели Предоплата.

DAYS_PASSED

Количество дней, прошедших с даты истечения подписки

Плейсхолдер доступен только для события После окончания периода подписки.

sales_order_creator.emailEmail менеджера или пользователя клиента, создавшего заказ на покупку подписки. Указывается в поле Получатель шаблона для Email-уведомлений
sales_order_creator.nameИмя и фамилия менеджера или пользователя клиента, создавшего заказ на покупку подписки
reseller.managers_admin_emailsСписок email всех менеджеров с ролью Системный администратор (см. Роли сотрудников) в рамках реселлера, клиенту которого принадлежит подписка. Указывается в поле Получатель шаблона для Email-уведомлений

Заказ изменён (Order changed)


Заказ создан (Order created)


Повторная отправка заказа (Resend the order)

Все плейсхолдеры для сущностей Заказ, Клиент, Владелец, Реселлер, Подписка, Продукт, Платеж
billing_day_dateДата финансового дня, когда произошло событие
hostURL инсталляции

Обещанный платеж создан (Guaranteed payment created)


Обещанный платёж изменён (Guaranteed payment changed)


Обещанный платёж истекает (Guaranteed payment will expire)

Все плейсхолдеры для сущностей Клиент, Обещанный платежСм. Плейсхолдеры для сущности Клиент, Плейсхолдеры для сущностей Платеж, Обещанный платеж
Финансовый день наступает (Billing day is coming)next_billing_period_start_dayДата начала следующего финансового периода относительно финансового дня, для которого было вызвано событие
next_billing_period_end_dayДата начала окончания следующего финансового периода относительно финансового дня, для которого было вызвано событие
Ручная операция (Manual operation)

Все плейсхолдеры для сущностей Клиент, Владелец, Реселлер

См. Плейсхолдеры для сущности Клиент, Общий набор плейсхолдеров для всех событий, Плейсхолдеры для сущности Реселлер

Для события Ручная операция плейсхолдер account.owner_reset_password_url не поддерживается.

subscription.id

ID подписки

subscription.nameНазвание подписки
operation.idID ручной операции
operation.nameТип ручной операции (см. Просмотр списка ручных операций). Пример: manual_provisioning_plugin_application_install
subscription.application_attributes.'plugin_slug'.'attribute_key'

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

Значение plugin_slugМодуль
office365Office365
microsoft_csp_productsMicrosoftCspProducts
vendor_serviceVendor Service Plugin (VSP)
manual_provisioningРучной провижининг (Manual Provisioning plugin)
ПлейсхолдерОписание
subscription.application_attributes.office365.user_manualИнструкция по активации подписки

subscription.application_attributes.vendor_service.user_manual
subscription.application_attributes.microsoft_csp_products.user_manual
subscription.application_attributes.vendor_service.external_idВнешний ID подписки
order_resources (массив: target_id, target_type, type, operation_value, description)Позиции в заказе в виде массива. Пример: {"target_id"=>3008674, "target_type"=>"Subscription", "type"=>"ProvisioningItem::New", "operation_value"=>1, "description"=>"CSPMonthly"}{"target_id"=>39874, "target_type"=>"SubscriptionResource", "type"=>"ProvisioningItem::Upgrade", "operation_value"=>2, "description"=>"Licenses"}
order_subscription_params (массив: name, key, value)Дополнительные параметры подписки в заказе на покупку в виде массива
subscription_resources (массив: id, name, count)Целевая конфигурация ресурсов подписки в виде массива. Пример: {"id"=>39871, "name"=>"vRAM", "count"=>0}{"id"=>39872, "name"=>"Storage", "count"=>0}{"id"=>39873, "name"=>"CPU", "count"=>0}{"id"=>39874, "name"=>"Licenses", "count"=>4}
subscription_resources_was (массив: name, count)Предыдущая конфигурация ресурсов подписки в виде массива
manual_operation.linkСсылка на ручную операцию с учетом домена реселлера
shopping_cart_item.plan_idID тарифного плана, который был выбран в процессе создания заказа на покупку, требующего подтверждения (см. Заказ подписки на коммерческий период по модели Постоплата)
shopping_cart_item.plan_nameНазвание периода тарифного плана, который был выбран в процессе создания заказа на покупку
shopping_cart_item.period_idID периода тарифного плана, который был выбран в процессе создания заказа на покупку
shopping_cart_item.period_duration_valueДлительность периода тарифного плана, который был выбран в процессе создания заказа на покупку
shopping_cart_item.period_duration_typeТип длительности периода тарифного плана, который был выбран в процессе создания заказа на покупку (год, месяц, день)
shopping_cart_item.totalИтоговая сумма заказа на покупку в валюте тарифного плана. Если валюта тарифного плана и валюта реселлера совпадают, плейсхолдер можно использовать для отображения суммы с указанием валюты реселлера {{ shopping_cart_item.total | format_as_currency }}
resource.name
  • Название ресурса в заказе на покупку для услуги на основе модуля Ручной провижининг
  • Текущее название Ресурса в Подписке для Услуги на основе модуля Ручной провижининг
resource.count
  • Количество ресурса в заказе на покупку для услуги на основе модуля Ручной провижининг
  • Текущее количество ресурса в подписке для услуги на основе модуля Ручной провижининг
resource.descriptionНазвание ресурса в заказе на изменение для услуги на основе модуля Ручной провижининг
resource.type

Тип операции над количеством ресурса в заказе на изменение для услуги на основе модуля Ручной провижининг:

  • ProvisioningItem::Upgrade — увеличение количества ресурса
  • ProvisioningItem::Downgrade — уменьшение количества ресурса
resource.operation_valueВеличина, на которую изменяется количество ресурса в заказе на изменение для услуги на основе модуля Ручной провижининг
param.name
  • Название дополнительного атрибута подписки (название параметра услуги на уровне приложения) для услуги на основе модуля Ручной провижининг
  • Название дополнительного атрибута ресурса (название параметра услуги на уровне ресурса) для услуги на основе модуля Ручной провижининг

Подробнее об особенностях параметров услуги на основе модуля Ручной провижининг см. Управление параметрами услуги.

param.resource_nameНазвание ресурса, для которого задан дополнительный атрибут (параметр услуги на уровне ресурса) для услуги на основе модуля Ручной провижининг
param.value
  • Значение дополнительного атрибута подписки (название параметра услуги на уровне приложения) для услуги на основе модуля Ручной провижининг
  • Значение дополнительного атрибута ресурса (название параметра услуги на уровне ресурса) для услуги на основе модуля Ручной провижининг

Создан объединенный платеж (Joined payment created)


Повторная отправка объединенного платежа (Resend the joined payment)

account.idID клиента
account.nameИмя клиента

account.balance

в том числе {{ account.balance | format_as_currency }}

Баланс клиента

payment.id

ID платежа

payment.total

в том числе {{ payment.total | format_as_currency }}

Общая сумма платежа
payment.document_numberНомер платежа
payment.linkСсылка для перехода в раздел Платежи в Панели управления Клиента с фильтрацией по номеру платежа

payment.earliest_charge_from_date

в том числе {{ payment.earliest_charge_from_date | format_as_date }}

Самая ранняя дата from из всех списаний, связанных с платежом

payment.subscriptions

Итератор для вывода массива подписок, связанных с платежом, в виде списка ID - Название подписки или в виде таблицы (см. пример выше)


subscription.idID подписки из массива подписок, связанных с платежом. Используется с итератором payment.subscriptions

subscription.nameНазвание подписки из массива подписок, связанных с платежом. Используется с итератором payment.subscriptions
payment.days_passed

Количество дней, прошедших со дня создания объединенного платежа

Плейсхолдер может быть использован только для события Повторная отправка объединенного платежа.

Сотрудник создан (Manager created)manager.emailАдрес электронной почты, который будет использоваться в качестве логина менеджера
manager.nameИмя менеджера
reseller.domainДомен реселлера, для которого был создан менеджер
tokenУникальный код безопасности для создания пароля менеджера при первом входе
Финансовый день по подписке клиента наступил (Billing day for account's subscription has come)past_billing_period_start_day

Дата начала предыдущего финансового периода (ДД.ММ.ГГГГ или MM/DD/YYYY) относительно финансового дня, для которого было вызвано событие

Доступно использование параметров даты "%m %Y": {{ past_billing_period_start_day | date: "%m %Y" }}

past_billing_period_end_dayДата окончания предыдущего финансового периода (ДД.ММ.ГГГГ или MM/DD/YYYY) относительно финансового дня, для которого было вызвано событие
Все плейсхолдеры для сущности КлиентСм. Плейсхолдеры для сущности Клиент
Плейсхолдеры для сущности Подписка

См. Плейсхолдеры для сущности Подписка

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

  • first_subscription

  • subscription.csp

  • subscription.renewal_payment.receipt_url

  • subscription.days_passed

  • subscription.days_left

  • subscriptions[]

  • subscriptions[].billing_type

  • subscriptions[].billing_day

  • subscriptions[].billing_day_date

  • subscriptions[].billing_day_charge

  • subscriptions[].payment_model

  • subscription['resources'][RESOURCE_PRIORITY].include

  • subscription['resources'][RESOURCE_PRIORITY].additional

  • subscription.responsible_managers_by_product_id[PRODUCT_ID]['KEY_MANAGER_ROLE']['name']

  • subscription.responsible_managers_by_product_id[PRODUCT_ID]['KEY_MANAGER_ROLE']['email']

Корректировка баланса подтверждена (Correction approved)Все плейсхолдеры для сущностей Клиент, Корректировка
Обработка данных по подпискам Azure Plan завершена (Data processing for Azure Plan subscriptions completed)Только плейсхолдеры для сущности РеселлерСм. Плейсхолдеры для сущности Реселлер