APIs de faturação limitada do Marketplace – FAQ

Depois que um cliente se inscrever em um serviço SaaS, Aplicativo do Azure com um plano de Aplicativos Gerenciados ou oferta de aplicativo Kubernetes com cobrança limitada, você acompanhará o consumo para cada dimensão de cobrança que está sendo usada. Se o consumo exceder as quantidades incluídas definidas para o termo selecionado pelo cliente, seu serviço emitirá eventos de uso para a Microsoft.

Para ofertas de SaaS, aplicativos gerenciados e ofertas de aplicativos Kubernetes

Com que frequência se espera que emita uso?

Idealmente, espera-se que você emita uso a cada hora na última hora, apenas se houver uso na hora anterior.

Existe um período máximo entre uma emissão e a seguinte?

Não existe essa limitação. Emitir apenas o uso à medida que ocorre. Por exemplo, se você só precisa enviar uma unidade de uso por tempo de vida da assinatura, você pode fazê-lo.

Qual é o atraso máximo entre o momento em que um evento ocorre e o momento em que um evento de uso é emitido para a Microsoft?

Idealmente, o evento de uso é emitido a cada hora para eventos que ocorreram na última hora. No entanto, são esperados atrasos. O atraso máximo permitido é de 24 horas, após as quais não serão aceites eventos de utilização. A melhor prática é coletar o uso por hora e emitir é como um evento no final da hora.

Por exemplo, se um evento de uso ocorrer às 13h de um dia, você terá até 13h do dia seguinte para emitir um evento de uso associado a esse evento. Caso o sistema emissor de uso esteja inativo, ele pode recuperar e, em seguida, enviar o evento de uso para o intervalo de horas em que o uso aconteceu, sem perda de fidelidade.

Se tiverem passado 24 horas após o uso real, você ainda poderá emitir as unidades consumidas com eventos de uso posteriores. No entanto, essa prática pode prejudicar a credibilidade dos relatórios de eventos de faturamento para o cliente final. Recomendamos que evite enviar o contador uma vez por dia/semana/mês. Será mais difícil entender o uso real por um cliente e resolver problemas ou questões que possam ser levantadas em relação a eventos de uso.

Outra razão para enviar o uso a cada hora é evitar situações em que o usuário cancele a assinatura antes que o editor envie o evento de emissão diária/semanal/mensal.

O que acontece quando você envia mais de um evento de uso na mesma hora?

Apenas um evento de uso é aceito para o intervalo de uma hora. O intervalo de horas começa no minuto 0 e termina no minuto 59. Se mais de um evento de uso for emitido para a mesma hora, todos os eventos de uso subsequentes serão descartados como duplicados.

O que acontece quando o cliente cancela a compra dentro do prazo permitido pela política de cancelamento?

O valor fixo não será cobrado, mas o uso excedente será.

Os planos de medidores personalizados podem ser usados para pagamentos únicos?

Sim, você pode definir uma dimensão personalizada como uma unidade de pagamento único e emiti-la apenas uma vez para cada cliente.

Os planos de medidores personalizados podem ser usados para modelos de preços diferenciados?

Sim, ele pode ser implementado com cada dimensão personalizada representando um único nível de preço.

Por exemplo, a Contoso quer cobrar US$ 0,5 por email para os primeiros 1000 emails, US$ 0,4 por email entre 1000 e 5000 emails e US$ 0,2 por email para emails acima de 5000. Eles podem definir três dimensões personalizadas, que correspondem aos três níveis de preços de e-mail. Emita unidades da primeira dimensão enquanto o número de e-mails permanecer abaixo de 1000, depois unidades da segunda dimensão quando o número de e-mails estiver entre 1000 e 5000 e, finalmente, unidades da terceira dimensão para mais de 5000 e-mails.

O que acontece se o serviço de medição do Marketplace tiver uma interrupção?

Se o ISV enviar um medidor personalizado e receber um erro, que pode ter sido causado por um problema no lado da Microsoft (geralmente no caso de eventos semelhantes foram aceitos antes sem um erro), então o ISV deve esperar e tentar novamente a emissão.

Se o erro persistir, reenvie esse medidor personalizado na próxima hora (acumule a quantidade). Continue este processo até que uma resposta sem erros seja recebida.

Apenas para ofertas SaaS

O que acontece quando você emite o uso de uma assinatura SaaS que já foi cancelada?

Qualquer evento de uso emitido para a plataforma do marketplace não será aceito após uma assinatura SaaS ter sido excluída.

A utilização só pode ser emitida para subscrições no estado Subscrito (e não para subscrições em PendingFulfillmentStart, Suspendedou Unsubscribed estado).

A única exceção é relatar o uso para o tempo que estava antes da assinatura SaaS ter sido cancelada.

Por exemplo, o cliente cancelou a assinatura de SaaS hoje às 15h. Agora é 17h, a editora ainda pode emitir uso para o período entre 18h de ontem e 15h de hoje para esta assinatura SaaS.

Você pode obter uma lista de todas as assinaturas SaaS, incluindo assinaturas ativas e não assinadas?

Sim, quando você chama a API de Lista de Assinaturas GET, pois ela inclui uma lista de todas as assinaturas SaaS. O campo de status na resposta para cada assinatura SaaS captura se a assinatura está ativa ou cancelada.

As datas de início e término do prazo de assinatura SaaS e da emissão de uso excessivo estão conectadas?

Eventos de excesso de idade podem ser emitidos a qualquer momento para a assinatura SaaS existente no status Assinado . É da responsabilidade do editor emitir eventos de utilização com base na política definida no plano de faturação. O excesso de idade deve ser calculado com base nas datas definidas no prazo da assinatura SaaS.

Por exemplo, se o editor definir um plano SaaS que inclua 1000 e-mails por US$ 100 em taxa fixa mensal, cada e-mail acima de 1000 será cobrado US$ 1 via dimensão personalizada.

Quando o cliente comprar e ativar a assinatura em 6 de janeiro, os 1000 e-mails incluídos na taxa fixa serão contados a partir deste dia. Assim, se até 5 de fevereiro (final do primeiro mês da assinatura) apenas 900 e-mails forem enviados, o cliente pagará a taxa fixa apenas para o primeiro mês desta assinatura, e nenhum evento de uso excedente será emitido pela editora entre 6 de janeiro e 5 de fevereiro. No dia 6 de fevereiro, a assinatura será renovada automaticamente e a contagem será reiniciada. Se em 15 de fevereiro o cliente atingiu 1000 e-mails enviados, o restante dos e-mails enviados até 5 de março será cobrado como excesso de idade (US $ 1 por e-mail) com base nos eventos de uso excessivo emitidos pelo editor.

Próximos passos

  • Para obter mais informações, consulte APIs do serviço de medição do Marketplace.