Limites de comptage et FAQ
Qu’est-ce que le Metering, en termes simples ?
Lorsqu’un client achète une offre SaaS sur Microsoft Marketplace, il paie généralement des frais mensuels fixes. Mais certaines offres facturent également en fonction de l’utilisation réelle — par exemple les e-mails envoyés, les appels API effectués ou les Go de données traités. C’est ce qu’on appelle la facturation à l’usage.
Le fonctionnement est simple : votre plateforme (le logiciel de l’ISV) suit l’utilisation du client et, chaque fois que l’utilisation dépasse le montant inclus, elle envoie un rapport à Microsoft indiquant « ce client a utilisé X unités de Y ». Microsoft facture ensuite cette utilisation supplémentaire au client.
Ce rapport est envoyé via l’API Metering Service. Et cette API impose des règles spécifiques sur la manière et le moment d’envoyer ces rapports.
La seule règle que vous devez connaître
Presque tout ce qui concerne l’API de metering se résume à une seule règle :
📌 La règle d’or Vous ne pouvez envoyer QU’UN seul rapport d’utilisation par abonnement client, par métrique de facturation et par heure calendaire. Si vous essayez d’en envoyer un deuxième pour la même combinaison dans la même heure, il sera rejeté comme doublon. |
|---|
C’est tout. Tout le reste n’est qu’une variation de cette règle.
Que signifie réellement « par abonnement + par métrique + par heure » ?
Abonnement = une commande client. Chaque commande possède un ID unique.
Métrique (dimension) = l’élément que vous facturez (par ex. emails_sent, api_calls, storage_gb). Chaque offre peut en avoir plusieurs.
Heure calendaire = par ex. 08:00–08:59 correspond à une heure. 09:00 démarre un nouveau créneau.
La règle s’applique donc à une combinaison spécifique des trois éléments. Modifiez-en un seul, et il s’agit d’un créneau complètement distinct.
Alors, que puis-je envoyer ?
✅ Deux rapports pour des clients différents — aucun problème
Si le client A et le client B ont tous deux des abonnements actifs, vous pouvez envoyer un rapport pour les deux exactement au même moment. Ils ont des ID d’abonnement différents, ils sont donc totalement indépendants. Vous pouvez envoyer des rapports pour 100 clients différents simultanément.
✅ Deux rapports pour des métriques différentes — aucun problème
Si votre offre possède deux dimensions de facturation (par exemple emails_sent et api_calls), vous pouvez envoyer un rapport pour les deux dans la même minute. Métriques différentes = créneaux différents. Aucun conflit.
✅ Deux rapports pour le même client, la même métrique, mais des heures différentes — autorisé
Si vous envoyez un rapport pour l’utilisation des e-mails du client A à 08:55, puis un autre à 09:05 — c’est autorisé. Il s’agit de deux heures calendaires différentes, donc de créneaux distincts.
❌ Deux rapports pour le même client, la même métrique et la même heure — rejetés
Si vous envoyez un rapport pour l’utilisation des e-mails du client A à 08:10, puis un autre à 08:45 pour la même métrique — le second sera rejeté. Vous avez déjà utilisé ce créneau.
💡 La bonne manière de gérer cela N’envoyez pas chaque événement d’utilisation au moment où il se produit. À la place, collectez et additionnez toute l’utilisation sur une heure, puis envoyez un seul rapport à la fin de cette heure avec le total. C’est également ce que Microsoft recommande. |
|---|
Uniquement les abonnements actifs
Vous ne pouvez envoyer des rapports d’utilisation que pour les abonnements actuellement actifs. Microsoft rejettera les événements pour les abonnements qui sont :
• Annulés / désabonnés
• Suspendus
• En attente d’activation (PendingFulfillmentStart)
La seule exception : si un client annule aujourd’hui, vous pouvez toujours envoyer des rapports d’utilisation pour la période précédant l’annulation — à condition de le faire dans la fenêtre de 24 heures.
Scénarios courants en un coup d’œil
Situation | Résultat | Pourquoi |
|---|---|---|
Deux événements pour la même commande, le même compteur, espacés de 5 min (même heure) | ❌ Rejeté | Même heure — combiner en un seul événement |
Deux événements pour la même commande, le même compteur, à des heures différentes (par ex. 8:50 et 9:05) | ✅ Accepté | Heures différentes, aucun conflit |
Deux événements pour la même commande, des compteurs différents, au même moment | ✅ Accepté | Les différentes dimensions sont indépendantes |
Deux événements pour des commandes différentes (abonnements), le même compteur, au même moment | ✅ Accepté | Abonnements différents = aucun conflit |
Événement pour un abonnement annulé ou suspendu | ❌ Rejeté | Seuls les abonnements actifs (Subscribed) sont acceptés |