API выставления счетов за потребление в Marketplace — вопросы и ответы

После того как клиент подписывается на службу SaaS, приложение Azure с планом управляемых приложений или предложением приложения Kubernetes с выставлением счетов, вы будете отслеживать потребление для каждого используемого измерения выставления счетов. Если потребление превышает количество, предусмотренное условиями использования, которые выбрал клиент, служба будет отправлять Майкрософт события использования.

Для предложений SaaS, управляемых приложений и приложений Kubernetes

Как часто ожидается отправка сведений об использовании?

В идеале предполагается, что ваши сведения об использовании будут отправляться каждый час за предыдущий час, но только если в этот период было отмечено использование.

Существует ли максимальный период от одной отправки до другой?

Такого ограничения нет. Отправляйте сведения об использовании только по мере их появления. Например, при необходимости можно отправлять только одну единицу использования за все время существования подписки.

Какова максимальная задержка между возникновением события и отправкой события использования в корпорацию Майкрософт?

В идеале событие использования отправляется каждый час и включает события за предыдущий час. Однако задержки вполне ожидаемы. Максимально допустимая задержка составляет 24 часа, после чего события использования не будут приниматься. Рекомендуется накапливать сведения об использовании за час и отправлять их как одно событие в конце часа.

Например, если событие использования происходит в 13.00, то вы можете отправить сведения об этом событии до 13.00 следующего дня. Если система, передающая данные об использовании, отказала, у нее есть время на восстановление, после чего она может отправить событие использования для часового интервала, в котором оно было зафиксировано, без потери точности.

Если после фактического использования прошло 24 часа, вы все равно можете сообщить об потребленных единицах вместе с более поздними событиями использования. Однако эта практика может повредить доверие к отчетам о событиях выставления счетов для конечного клиента. Рекомендуется не отправлять данные измерения в режиме один раз в день, в неделю или в месяц. Будет труднее понять, сколько фактически потребляет клиент, а также решать проблемы или вопросы, которые могут возникать в отношении событий использования.

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

Что произойдет, если отправить несколько событий использования в течение одного часа?

Для интервала в один час принимается только одно событие использования. Часовой интервал начинается в 0 минут и заканчивается в 59 минут. Если в течение одного часа выдается более одного события использования, все последующие события удаляются как дубликаты.

Что произойдет, если клиент отменит покупку в течение времени, допускаемого политикой отмены?

Оплата по фиксированной ставке не будет начисляться, но будет начислена оплата за избыточное использование.

Можно ли использовать пользовательские планы контроля потребления для одноразовых платежей?

Да, вы можете определить пользовательское измерение как единицу одноразового платежа и отправлять его только один раз для каждого клиента.

Можно ли использовать пользовательские планы контроля потребления для многоуровневой модели ценообразования?

Да, можно, при этом каждое пользовательское измерение будет представлять одну ценовую категорию.

Например, компания Contoso хочет взимать плату 0,5 долл. США за каждое сообщение из первой тысячи сообщений электронной почты, 0,4 долл. США за каждое сообщение в диапазоне от 1000 до 5000 сообщений и 0,2 долл. США за каждое сообщение сверх 5000 сообщений электронной почты. Она может определить три пользовательских измерения, которые соответствуют трем ценовым категориям электронной почты. Отправка единиц первого измерения будет происходить до тех пор, пока количество сообщений электронной почты не превысит 1000. Пока число сообщений больше 1000, но меньше 5000, будут отправляться единицы второго измерения, а когда число сообщений превысит 5000, будут отправляться единицы третьего измерения.

Что произойдет в случае сбоя службы контроля потребления Marketplace?

Если isV отправляет пользовательский счетчик и получает ошибку, которая могла быть вызвана проблемой на стороне Майкрософт (обычно в случае, если аналогичные события были приняты раньше без ошибки), то isV должен ждать и повторить выброс.

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

Только для предложений SaaS

Что происходит при отправке данных об использовании для подписки SaaS, которая уже отменена?

После удаления подписки SaaS события использования, переданные для нее на платформу Marketplace, не будут приниматься.

Данные об использовании можно отправлять только для подписок с состоянием “Оформлена подписка” (а не для подписок с состоянием PendingFulfillmentStart, Suspended или Unsubscribed).

Единственное исключение — сообщение об использовании за период перед отменой подписки SaaS.

Например, клиент отменил подписку SaaS сегодня в 15.00. Сейчас 17.00. Издатель все еще может отправить данные об использовании для этой подписки SaaS за период с 18.00 вчерашнего дня и до 15.00 сегодня.

Можно ли получить список всех подписок SaaS, включая активные и отмененные?

Да, если вызвать API получения списка подписок, так как он содержит список всех подписок SaaS. В ответном сообщении у каждой подписки SaaS есть поле состояния, где указано, активна она или отменена.

Существуют ли даты начала и окончания срока действия подписки SaaS и производится ли в связи с этим отправка сведений об избыточном использовании?

События избыточного использования можно отправлять в любое время для существующей подписки SaaS с состоянием Оформлена подписка. Издатель несет ответственность за отправку событий использования согласно политике, установленной для плана выставления счетов. Избыточное потребление должно рассчитываться согласно датам, определенным условиями использования подписки SaaS.

Например, если издатель определяет план SaaS с фиксированным ежемесячным платежом 100 долларов США, который включает 1000 сообщений электронной почты в месяц, каждое сообщение сверх этой тысячи оплачивается по цене 1 доллар США с помощью настраиваемого измерения.

Если клиент покупает и активирует подписку 6 января, подсчет 1000 сообщений, включенных в фиксированный платеж, начнется с этого дня. Таким образом, если до 5 февраля (конец первого месяца подписки) будет отправлено только 900 сообщений, клиент внесет только фиксированный платеж за первый месяц этой подписки, а издатель не отправит ни одного события чрезмерного использования в период с 6 января по 5 февраля. 6 февраля подписка будет автоматически продлена, а отсчет начнется снова. Если 15 февраля количество сообщений от клиента достигло 1000, то остальные сообщения, отправленные до 5 марта, будут оплачиваться как избыточные (по 1 доллару США за сообщение) в соответствии с событиями чрезмерного использования, передаваемыми издателем.

Следующие шаги