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

Если требуется, чтобы плейсхолдер, содержащий дату, отображал дату предыдущих суток, используйте модификатор date: "%s" | minus : 86400. Например: {{ invoice.to_date | date: "%s" | minus : 86400 | date: "%d.%m.%Y" }}

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

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

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


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


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


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


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


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

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

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

Плейсхолдеры account.owner_reset_password_url и account.owner_generate_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Уникальный код безопасности, который необходим для аутентификации

Статус MFA для вашего аккаунта изменен (MFA status for your account has been changed)


Настройка MFA изменена на уровне реселлера (MFA setting has been changed on the Reseller's side)

manager.mfa_active

Статус многофакторной аутентификации (MFA) менеджера (см. Просмотр и обновление информации о сотруднике):

  • true — статус MFA менеджера Активный.
  • false — статус MFA менеджера Неактивный.
security_setting.mfa_mandatory

Состояние настройки Обязательность использования для многофакторной аутентификации (MFA) в настройках безопасности реселлера (см. Настройки сотрудника):

  • true — настройка Обязательность использования в положении Вкл.
  • false — настройка Обязательность использования в положении Выкл.
Загрузка себестоимости 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 changed) (ранее — Платеж получен (Payment has been received))


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


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


Срок оплаты платежа наступил (Payment due date has come)

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

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

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

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

До окончания периода подписки (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-уведомлений
До истечения постоплатных подписок клиента (Before account's postpaid subscriptions expiration)Плейсхолдеры для сущностей Клиент, Подписка, Реселлер, Продукт (продукты для апгрейда)См. Плейсхолдеры для сущности Клиент, Плейсхолдеры для сущности Подписка, Плейсхолдеры для сущности РеселлерПлейсхолдеры для сущности Продукт

Заказ изменён (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

Информация о заказе на покупку, требующем подтверждения. Только для ручной операции, для которой operation.type = "postpay_subscription_verify" (см. Заказ подписки по модели Постоплата).

ПлейсхолдерОписание
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
  • Значение дополнительного атрибута подписки (название параметра услуги на уровне приложения) для услуги на основе модуля Ручной провижининг
  • Значение дополнительного атрибута ресурса (название параметра услуги на уровне ресурса) для услуги на основе модуля Ручной провижининг
payment_document_numberНомер платежа для заказа на покупку, продление подписки или изменение количества ресурсов, связанного с ручной операцией
subscription_postpay.credit_limit

Кредитный лимит по подписке — величина задолженности по подписке, при превышении которой подписка по модели Постоплата будет остановлена:

subscription.credit_limit
subscription_postpay.current_debt

Текущая задолженность — сумма потребления по подписке, рассчитанная в зависимости от типа биллинга, как на странице информации о подписке (см. Просмотр и обновление информации о подписке):

  • Для типов биллинга CSP месячный, Monthly Commitment и Pay as you go (external) текущая задолженность равна сумме списаний в статусе Заблокировано и Новое по подписке только за текущий финансовый период.
  • Для остальных типов биллинга текущая задолженность равна сумме всех списаний в статусе Заблокировано и Новое по подписке.

subscription.current_debtCумма всех списаний в статусе Заблокировано по подписке за текущий финансовый период

Создан объединенный платеж (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']

Оплата платежа получена из внешней системы (Paid amount has been received from external system)

Все плейсхолдеры для сущностей Клиент, Корректировка, Менеджер, Внешняя транзакция

Плейсхолдеры для сущности Платеж

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

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

  • payment.id
  • payment.payment_method
  • payment.document_number
  • payment.total
  • payment.currency
  • payment.created_at
  • payment.expiration_date
  • payment.days_left
  • payment.status
  • payment.comment
Корректировка баланса подтверждена (Correction approved)

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

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

Расходы по подписке приближаются к установленному бюджету расходов на период (Spending budget for a period is approaching)


Расходы по подписке достигли установленного бюджета расходов на период (Spending budget has been reached)

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

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

  • Заданные получатели уведомления указываются с помощью плейсхолдера subscription.recipients.emails.
  • Потребление по подписке указывается с помощью плейсхолдера subscription.current_debt или subscription_postpay.current_debt.
  • Информация об установленном бюджете расходов (сущность Подписка) отображается на языке по умолчанию Панели управления Клиента (см. Управление языковыми настройками).
Обнаружение неожиданного увеличения потребления (Unexpected consumption increase detection)Плейсхолдеры для сущностей Клиент, Пользователь, Подписка

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

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

  • subscription.id

  • subscription.name

  • subscription_postpay.current_debt

  • subscription.current_debt

  • subscription.unexpected_consumptions

Пример ссылки для перехода к аналитике по подписке в новой Панели управления Клиента с помощью плейсхолдеров: https://{{ reseller.custom_attributes['vendor_ccp'] }}/client/subscriptions/{{subscription.id}}/analytics?account_id={{account.id}}&filter[details]=day&filter[billing-period]=current

AppSource ссылка для активации сгенерирована (AppSource Activation Link Generated)


subscription.id

ID подписки
subscription.nameНазвание подписки
application['first_subscription']Проверка, что это первая подписка клиента на услуги Microsoft

application['login']

Логин для доступа в портал администрирования Microsoft
application['password']Временный пароль для первого доступа в портал администрирования Microsoft
application['activation_link']Ссылка для активации услуги на стороне вендора (см. Creating a notification template for the Microsoft AppSource service activation)
Microsoft ожидает оформления заказа на покупку (Microsoft pending PO document)Все плейсхолдеры для сущностей Заказ, Клиент, Реселлер, ПодпискаСм. Плейсхолдеры для сущностей Заказ, Списание, Плейсхолдеры для сущности Клиент, Общий набор плейсхолдеров для всех событий, Плейсхолдеры для сущности Реселлер, Плейсхолдеры для сущности Подписка
Microsoft отклонил заказ на покупку (Microsoft rejected PO document)