APIs de cobrança limitada do Marketplace – Perguntas frequentes

Depois que um cliente assinar um serviço SaaS, um aplicativo do Azure com um plano de Aplicativos Gerenciados ou uma oferta de aplicativo do Kubernetes com cobrança limitada, você acompanhará o consumo de 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, o serviço emitirá eventos de uso para a Microsoft.

Para ofertas SaaS, aplicativos gerenciados e ofertas de aplicativos Kubernetes

Com que frequência é esperada a emissão do uso?

O ideal é que você emita o uso a cada hora da ú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. Só emita o uso conforme ele ocorrer. Por exemplo, se apenas precisar enviar uma unidade de uso por tempo de vida de assinatura, você poderá fazer isso.

Qual é o atraso máximo entre a hora em que um evento ocorre e a hora 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. No entanto, atrasos são esperados. O atraso máximo permitido é de 24 horas, após o qual os eventos de uso não serão aceitos. A prática recomendada é coletar o uso por hora e emitir 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. Caso o sistema que está emitindo o uso esteja inativo, ele poderá recuperar e, em seguida, enviar o evento de uso para o intervalo de horas em que o uso ocorreu, sem perda de fidelidade.

Se 24 horas tiverem passado 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 cobrança para o cliente final. Recomendamos que você evite enviar a emissão de medidores 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 podem ser gerados em relação a 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ária/semanal/mensal.

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

Somente um evento de uso é aceito para o intervalo de uma hora. O intervalo de hora começa no minuto 0 e termina no minuto 59. Se mais de um evento de uso for emitido para 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 será cobrado, mas o uso de excedente sim.

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

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 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 1000 e 5.000 emails e US$ 0,2 por email para mais de 5.000 emails. 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 desde que o número de emails permaneça abaixo de 1000, em seguida, unidades da segunda dimensão quando o número de emails estiver entre 1000 e 5000 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 paralisaçã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 terem sido aceitos antes sem um erro), o ISV deverá aguardar e repetir 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 sem erro seja recebida.

Somente para ofertas de SaaS

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

Qualquer evento de uso emitido para a plataforma do Marketplace não será aceito depois que uma assinatura de SaaS tiver sido excluída.

O uso pode ser emitido somente para assinaturas com o status Inscrito (e não para assinaturas com o status PendingFulfillmentStart, Suspended ou Unsubscribed).

A única exceção é o uso de relatórios para o tempo anterior ao cancelamento de assinatura de SaaS.

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

Você pode obter uma lista de todas as assinaturas de SaaS, incluindo assinaturas ativas e canceladas?

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

As datas de início e de término do período de assinatura de SaaS e a emissão de uso excedente estão conectadas?

Eventos excedentes podem ser emitidos a qualquer momento para a assinatura de SaaS existente no status Assinado. É 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 de SaaS.

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

Quando o cliente adquire e ativa a assinatura em 6 de janeiro, o email 1000 incluído na taxa fixa será contado a partir deste dia. Portanto, se até 5 de fevereiro (final do primeiro mês da assinatura) apenas 900 emails forem enviados, o cliente pagará a taxa fixa somente pelo primeiro mês dessa assinatura, e nenhum evento de uso excedente será emitido pelo editor entre 6 de janeiro e 5 de janeiro. Em 6 de fevereiro, a assinatura será renovada automaticamente, e a contagem, reiniciada. Se, em 15 de fevereiro, o cliente atingir 1000 emails enviados, o restante dos emails enviados até 5 de março será cobrado como excedente (US$ 1 por email) com base nos eventos de uso excedente emitidos pelo editor.