Compartilhar via


APIs de cobrança limitada do Marketplace – perguntas frequentes

Depois que um cliente assina um serviço SaaS, um aplicativo do Azure com um plano de Aplicativos Gerenciados ou uma oferta de aplicativo kubernetes com cobrança limitada, ele pode controlar o consumo para cada dimensão de cobrança 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 aplicativo kubernetes

Com que frequência é esperado emitir o uso?

O ideal é que você emita o uso a cada hora na última hora, somente se houver uso na hora anterior.

Há um período máximo entre uma emissão e a próxima?

Não existe essa limitação. Apenas emita o uso conforme ele ocorre. Por exemplo, se você precisar enviar apenas uma unidade de uso por tempo de vida da assinatura, poderá fazê-lo.

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

O ideal é que o evento de uso seja emitido a cada hora para eventos que ocorreram na última hora. Mas são esperados atrasos. O atraso máximo permitido é de 24 horas, após o qual os eventos de uso não são aceitos. A melhor prática é coletar o uso por hora e emitê-lo como um evento no final da hora. Por exemplo, se um evento de uso ocorrer às 13h em um dia, você terá até 13h do dia seguinte para emitir um evento de uso associado a esse evento. Se o sistema que emite o uso estiver inativo, ele poderá recuperar e enviar o evento de uso para o intervalo de hora no qual o uso ocorreu, sem perda de fidelidade. Se 24 horas passarem após o uso real, você ainda poderá emitir as unidades consumidas com eventos de uso posteriores. Mas essa prática pode prejudicar a credibilidade dos relatórios de eventos de cobrança para o cliente final. Recomendamos que você evite enviar a emissão de medidor uma vez por dia/semana/mês. É mais difícil entender o uso real por um cliente e resolver problemas ou perguntas que podem ser levantadas sobre eventos de uso. Outro motivo 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ário/semanal/mensal.

Nota

Um atraso de 24 horas para enviar eventos de uso também é aplicável em planos convertidos/atualizados. Se um cliente atualizar o plano para um novo plano, o uso do plano anterior deverá ser relatado dentro de 24 horas após a conversão do plano.

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 duplicatas.

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

O valor de taxa fixa não é cobrado, mas o uso excedente é.

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

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

Os planos de medidor personalizados podem ser usados para o modelo de preços em camadas?

Sim, ele pode ser implementado com cada dimensão personalizada que representa um único tipo de preço.

Por exemplo, a Contoso deseja cobrar US$ 0,5 por email pelos primeiros 1.000 emails, US$ 0,4 por email entre 1.000 e 5.000 emails e US$ 0,2 por email para mais de 5.000 e-mails. Eles podem definir três dimensões personalizadas que correspondem aos três tipos de preço de email. Emita unidades da primeira dimensão enquanto o número de emails permanecer abaixo de 1.000, unidades da segunda dimensão quando o número de emails estiver entre 1.000 e 5.000 e, por fim, unidades da terceira dimensão para mais de 5.000 emails.

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

Se o ISV (Fornecedor De Software Independente) 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 terem sido aceitos antes sem um erro), o ISV deverá aguardar e tentar novamente a emissão.

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

Somente para ofertas de SaaS

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

Qualquer evento de uso emitido para a plataforma do marketplace não é aceito depois que uma assinatura SaaS é excluída.

O uso só pode ser emitido para assinaturas no status inscrito (e não para assinaturas em PendingFulfillmentStart, Suspendedou Unsubscribed status).

A única exceção é relatar o uso do tempo antes do cancelamento da assinatura SaaS.

Por exemplo, o cliente cancelou a assinatura saaS hoje às 15h. Agora são 17h, o publicador ainda pode emitir o uso do 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 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 não assinada.

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

Eventos excedentes podem ser emitidos a qualquer momento para a assinatura SaaS existente em status de inscrito. É responsabilidade do editor emitir eventos de uso com base na política definida no plano de cobrança. O excedente deve ser calculado com base nas datas definidas no termo da assinatura SaaS.

Por exemplo, se o editor definir um plano SaaS que inclua 1.000 emails por US$ 100 em taxa fixa mensal, cada email acima de 1.000 será cobrado US$ 1 por meio de dimensão personalizada.

Quando o cliente compra e ativa a assinatura em 6 de janeiro, os 1.000 emails incluídos na taxa fixa são contados a partir deste dia. Portanto, se até 5 de fevereiro (final do primeiro mês da assinatura), apenas 900 emails são enviados, o cliente paga a taxa fixa somente para o primeiro mês desta assinatura e nenhum evento de uso excedente é emitido pelo publicador entre 6 de janeiro e 5 de fevereiro. Em 6 de fevereiro, a assinatura é renovada automaticamente e a contagem é iniciada novamente. Se em 15 de fevereiro, o cliente atingiu 1.000 emails enviados, o restante dos emails enviados até 5 de março são cobrados como excedente (US$ 1 por email) com base nos eventos de uso excessivo emitidos pelo editor.