---
title: Limitações de medição e perguntas frequentes
slug: pt/limitacoes-de-medicao-e-perguntas-frequentes
icon: {"faIcon":"fa-brands fa-wordpress"}
createdAt: 2026-02-23T14:38:52.766Z
---



# O que é Metering, em termos simples?

Quando um cliente compra uma oferta SaaS no Microsoft Marketplace, ele normalmente paga uma taxa mensal fixa. Mas algumas ofertas também cobram com base no uso real — coisas como emails enviados, chamadas de API feitas ou GB de dados processados. Isso é chamado de cobrança medida.

A forma como isso funciona é simples: sua plataforma (o software do ISV) acompanha quanto o cliente usa e, sempre que o uso ultrapassa o valor incluído, ela envia um relatório para a Microsoft dizendo "este cliente usou X unidades de Y item". A Microsoft então cobra o cliente por esse uso extra.

Esse relatório é enviado por meio da Metering Service API. E essa API tem regras específicas sobre como e quando você pode enviar esses relatórios.



# A única regra que você precisa conhecer

Quase tudo sobre a API de medição se resume a uma regra:



| **📌  A Regra de Ouro**<br />Você só pode enviar UM relatório de uso por assinatura de cliente, por métrica de cobrança, por hora do calendário. Se você tentar enviar um segundo para a mesma combinação dentro da mesma hora, ele será rejeitado como duplicado. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |



É isso. Todo o resto é apenas uma variação disso.



## O que "por assinatura + por métrica + por hora" realmente significa?

Assinatura = o pedido de um cliente. Cada pedido tem um ID exclusivo.

Métrica (dimensão) = o item pelo qual você está cobrando (por exemplo, emails\_sent, api\_calls, storage\_gb). Cada oferta pode ter várias.

Hora do calendário = por exemplo, 08:00–08:59 é uma hora. 09:00 inicia um novo intervalo.



Portanto, a regra se aplica a uma combinação específica dos três. Mude qualquer um deles, e será um intervalo completamente separado.



# Então, o que posso enviar?

## ✅ Dois relatórios para clientes diferentes — sem problema

Se o Cliente A e o Cliente B tiverem assinaturas ativas, você poderá enviar um relatório para ambos exatamente ao mesmo tempo. Eles têm IDs de assinatura diferentes, então são totalmente independentes. Você poderia enviar relatórios para 100 clientes diferentes simultaneamente.



## ✅ Dois relatórios para métricas diferentes — sem problema

Se sua oferta tiver duas dimensões de cobrança (digamos, emails\_sent e api\_calls), você poderá enviar um relatório para ambas no mesmo minuto. Métricas diferentes = intervalos diferentes. Sem conflito.



## ✅ Dois relatórios para o mesmo cliente, mesma métrica, horas diferentes — tudo certo

Se você enviar um relatório para o uso de email do Cliente A às 08:55 e, depois, novamente às 09:05 — tudo certo. Essas são duas horas diferentes do calendário, então são intervalos separados.



## ❌ Dois relatórios para o mesmo cliente, mesma métrica, mesma hora — rejeitado

Se você enviar um relatório para o uso de email do Cliente A às 08:10 e depois outro às 08:45 para a mesma métrica — o segundo será rejeitado. Você já preencheu esse intervalo.



| **💡  A forma correta de lidar com isso**<br />Não envie cada evento de uso conforme ele acontece. Em vez disso, colete e some todo o uso dentro de uma hora e, então, envie um único relatório no final dessa hora com o total. Isso também é o que a Microsoft recomenda. |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |



# Somente assinaturas ativas

Você só pode enviar relatórios de uso para assinaturas que estejam ativas no momento. A Microsoft rejeitará eventos para assinaturas que estejam:

•        Canceladas / com assinatura cancelada

•        Suspensas

•        Ainda pendentes de ativação (PendingFulfillmentStart)



A única exceção: se um cliente cancelar hoje, você ainda poderá enviar relatórios de uso para o período anterior ao cancelamento — desde que faça isso dentro da janela de 24 horas.



# Cenários comuns em resumo



| **Situação**                                                                                    | **Resultado**    | **Motivo**                                          |
| ----------------------------------------------------------------------------------------------- | ---------------- | --------------------------------------------------- |
| Dois eventos para o mesmo pedido, mesmo medidor, com 5 min de diferença (mesma hora)            | **❌  Rejeitado** | Mesma hora — combinar em um único evento            |
| Dois eventos para o mesmo pedido, mesmo medidor, em horas diferentes (por exemplo, 8:50 e 9:05) | **✅  Aceito**    | Horas diferentes, sem conflito                      |
| Dois eventos para o mesmo pedido, medidores diferentes, no mesmo horário                        | **✅  Aceito**    | Dimensões diferentes são independentes              |
| Dois eventos para pedidos diferentes (assinaturas), mesmo medidor, mesmo horário                | **✅  Aceito**    | Assinaturas diferentes = nenhum conflito            |
| Evento para uma assinatura cancelada ou suspensa                                                | **❌  Rejeitado** | Somente assinaturas ativas (Subscribed) são aceitas |





*[Fonte: Microsoft Learn — APIs e FAQ do Metering Service](https://learn.microsoft.com/en-us/partner-center/marketplace-offers/marketplace-metering-service-apis)*
