Fonctionnement des crédits et engagements
Les crédits et engagements dans Metronome sont flexibles sur les dimensions suivantes :- Période effective : les crédits et engagements possèdent un
access_schedulequi définit les allocations de dépenses associées à une ou plusieurs plages de dates. Définissez les plages de dates en utilisant n’importe quelle heure pleine ; seule la consommation comprise dans la plage consomme le crédit ou l’engagement. - Produits applicables : précisez un sous-ensemble de produits, défini par des identifiants de produits (
applicable_product_ids) ou des étiquettes de produits (applicable_product_tags), pour consommer un crédit ou un engagement. Les étiquettes de produits applicables garantissent que les nouveaux produits lancés dans une famille existante peuvent consommer automatiquement les bons engagements. Vous pouvez également utiliser le champ specifiers pour cibler la consommation des crédits et engagements en fonction des valeurs de groupe de tarification ou des valeurs de groupe de présentation. - Calendrier de facturation : avec les engagements prépayés, définissez une facture unique ou répartissez le paiement sur plusieurs factures selon n’importe quel calendrier. Personnalisez le montant facturé pour tout engagement prépayé.
- Champs personnalisés : étiquetez les crédits et engagements avec des métadonnées utiles aux flux de travail en aval comme les alertes, la réconciliation des données et la reconnaissance du revenu. Par exemple, soyez alerté lorsque le solde restant des crédits portant le champ personnalisé
free_trialatteint 0.
Accorder un crédit gratuit
Les crédits offrent aux clients un montant monétaire de consommation gratuite. Les cas courants pour les crédits gratuits incluent les essais gratuits, les remboursements pour temps d’arrêt (crédits SLA) et les promotions.Pour le USD, tous les montants monétaires dans l’API sont exprimés en cents (par exemple,
1000 = $10,00). Les autres devises prises en charge utilisent des unités entières. Voir dénomination des devises pour plus de détails.- Allez dans Customers > sélectionnez le client > Contract commits and credits > cliquez sur Add credit.
- Liez le crédit à un produit fixe en sélectionnant le produit Crédit dans la liste déroulante. Les crédits et engagements dans Metronome sont toujours associés à un produit fixe. Par exemple, vous pouvez créer des produits distincts pour un crédit gratuit, un crédit SLA et un crédit promotionnel.
- (Facultatif) Ajoutez une description interne pour expliquer pourquoi vous accordez le crédit.
- (Facultatif) Si le crédit ne peut être consommé que par un sous-ensemble de la consommation, précisez les identifiants ou étiquettes de produits applicables. Si vous omettez ce paramètre, toute la consommation, les abonnements et les frais composites peuvent consommer les crédits.
- (Facultatif) Si le crédit ne doit être consommé que par un sous-ensemble des contrats du client, précisez les noms ou identifiants de contrats applicables. Si vous omettez ce paramètre, la consommation liée à tous les contrats consomme le crédit.
- Créez un calendrier d’accès. Un calendrier d’accès se compose d’un ou plusieurs segments, chacun défini par une plage de dates et associé à un montant. Par exemple, pour accorder un crédit de $10/mois pendant trois mois, créez trois segments dans le calendrier d’accès :
- (Facultatif) Précisez le pourcentage de report du crédit. En cas de renouvellement de contrat, indiquez le pourcentage du solde initial du crédit qui doit être reporté sur le nouveau contrat. En savoir plus sur les transitions de contrat.

- Définissez la priorité du crédit. Si un client dispose de plusieurs crédits ou engagements pouvant s’appliquer à la consommation, la priorité dicte l’ordre dans lequel les crédits et engagements sont consommés. Les priorités les plus basses sont consommées en premier. Par exemple, vous pouvez vouloir que tous les crédits soient consommés en premier avant de consommer tout engagement. Lisez la liste complète des règles de priorisation.
Émettre un engagement prépayé ou postpayé
Les engagements prépayés et postpayés représentent l’accord d’un client à dépenser un montant en dollars sur une période de temps. Les engagements prépayés sont payés à l’avance, tandis que les engagements postpayés sont payés à terme échu. Bien qu’ils soient généralement associés à des contrats, vous pouvez également encoder des engagements au niveau du client, où ils sont consommés par tout ou partie des contrats de ce client.Engagements prépayés
Les engagements prépayés sont payés à l’avance. Par exemple, imaginez qu’un client se soit engagé à dépenser $10 000 sur la durée de son contrat, qu’il est facturé en deux factures : une de $4 000 et une de $6 000. Le contrat s’étend du 1er octobre 2024 au 1er octobre 2025. Pour ajouter un engagement prépayé à un contrat dans l’application Metronome :- Lors de la création d’un contrat, cliquez sur Add commit.
- Liez l’engagement à un produit fixe.
- (Facultatif) Ajoutez une description interne expliquant la raison de l’octroi de l’engagement.
- (Facultatif) Si l’engagement ne peut être consommé que par un sous-ensemble de la consommation, précisez les identifiants ou étiquettes de produits applicables. Si vous omettez ce paramètre, toute la consommation, les abonnements et les frais composites peuvent consommer l’engagement.
- Créez un calendrier d’accès. Un calendrier d’accès se compose de segments, chacun défini par une plage de dates et associé à un montant. Par exemple, définissez le calendrier d’accès du 1er octobre 2024 au 1er octobre 2025, correspondant à la durée du contrat.
- (Facultatif) Créez un calendrier de facturation. Cela détermine la cadence à laquelle facturer votre client pour l’engagement.
- Vous pouvez facturer votre client pour n’importe quel montant en n’importe quel nombre de versements. Par exemple, créez deux segments de calendrier de facturation :
- Un segment le 1er octobre 2024 pour $4 000
- Un autre segment le 1er novembre 2024 pour $6 000
- Pour capturer le montant facturé sans générer de facture pour les fournisseurs de facturation en aval, sélectionnez l’option Do not invoice après avoir saisi le montant de la facture.
- Vous pouvez facturer votre client pour n’importe quel montant en n’importe quel nombre de versements. Par exemple, créez deux segments de calendrier de facturation :
- Définissez la priorité de l’engagement. Si un client dispose de plusieurs crédits ou engagements pouvant s’appliquer à la consommation, la priorité dicte l’ordre dans lequel les crédits et engagements sont consommés. Les engagements de priorité plus basse sont consommés en premier.
- (Facultatif) Précisez le pourcentage de report de l’engagement. En cas de renouvellement de contrat, indiquez le pourcentage du solde initial de l’engagement qui doit être reporté sur le nouveau contrat. En savoir plus sur les transitions de contrat.
Engagements postpayés
Pour les engagements postpayés, la consommation pendant la période d’accès (définie paraccess_schedule) est payée à terme échu. Si le montant total payé pendant la période d’accès est inférieur au montant engagé, une facture de régularisation finale est émise à la date invoice_date.
Par exemple, si un client a un contrat avec un engagement postpayé de dépenser $10 000 sur la durée d’un contrat d’un an du 1er octobre 2024 au 1er octobre 2025, facturé mensuellement, chaque mois, le client est facturé à terme échu pour la consommation engagée pendant ce mois. À la fin du contrat, le client a dépensé un total de $9 000. À la date invoice_date spécifiée, une facture de régularisation de $1 000 est émise pour atteindre l’engagement de $10 000.
Pour ajouter un engagement postpayé à un contrat dans l’application Metronome :
- Lors de la création d’un contrat, cliquez sur Add commit.
- Liez l’engagement à un produit fixe.
- (Facultatif) Ajoutez une description interne expliquant la raison de l’octroi de l’engagement.
- (Facultatif) Si l’engagement ne peut être consommé que par un sous-ensemble de la consommation, précisez les identifiants ou étiquettes de produits applicables. Si vous omettez ce paramètre, toute la consommation, les abonnements et les frais composites peuvent consommer l’engagement.
- Créez un calendrier d’accès. Par défaut, le calendrier d’accès correspond à la durée du contrat. Vous pouvez allouer une part des dépenses à des fenêtres de temps distinctes tout au long du contrat. Dans l’exemple, le calendrier d’accès va du 1er octobre 2024 au 1er octobre 2025.
- Sélectionnez la date de facturation. La date de facturation est la date à laquelle une facture de régularisation est émise si les dépenses réelles sont inférieures au montant engagé. Par défaut, la date de facturation est la date de fin du contrat, mais vous pouvez la personnaliser à n’importe quelle date après le calendrier d’accès. Pour l’exemple, la date de facturation est le 1er octobre 2025, date de fin du contrat.
- Pour capturer le montant facturé sans générer de facture pour les fournisseurs de facturation en aval, sélectionnez l’option Do not invoice après avoir saisi le montant de la facture.
- Définissez la priorité de l’engagement. Les engagements prépayés et les crédits sont consommés en premier. Si un client dispose de plusieurs engagements postpayés pouvant s’appliquer à la consommation, la priorité dicte l’ordre dans lequel les engagements postpayés sont consommés. Les engagements de priorité plus basse sont consommés en premier.
- (Facultatif) Précisez le pourcentage de report de l’engagement. En cas de renouvellement de contrat, indiquez le pourcentage du solde initial de l’engagement qui doit être reporté sur le nouveau contrat. En savoir plus sur les transitions de contrat.
Provisionner des crédits de consommation récurrents
Dans le cadre d’un abonnement ou d’un contrat, les organisations allouent généralement un montant fixe de consommation à un client. Le montant évolue généralement selon le niveau du plan, tel que Good, Better et Best. Les organisations adoptent ce modèle pour bénéficier des avantages d’un abonnement avec des revenus récurrents fixes et d’une facturation à l’usage avec collecte sur les dépassements. Modélisez ce comportement dans Metronome en configurant un crédit ou un engagement récurrent sur un contrat.Configurer des crédits ou engagements récurrents
De la même manière que vous pouvez émettre des crédits et engagements individuels, vous pouvez également planifier la libération de crédits et engagements de façon récurrente. Avec les octrois récurrents, un nouveau crédit ou engagement est émis avec un grand livre unique qui lui est attaché au début de chaque période.- Pour une consommation gratuite avec une base de coût de $0, créez un crédit récurrent. Pour une consommation payante, créez un engagement récurrent.
- Précisez le produit de crédit ou d’engagement qui génère l’élément de facturation pour la charge récurrente. Les métadonnées de ce produit, comme les champs personnalisés, sont propagées à la facture où l’engagement ou le crédit est appliqué.
- Précisez à quels produits l’octroi doit s’appliquer. S’il est laissé vide, il s’applique à tous les produits. Utilisez des étiquettes de produits pour une configuration plus simple.
- Précisez si les crédits et engagements non utilisés expirent à la fin de chaque période en définissant
commit_duration. Vous pouvez reporter le montant total des crédits restants pour un certain nombre de périodes. - Mettez éventuellement à jour le calendrier de récurrence. Il s’agit par défaut du calendrier de consommation défini sur le contrat.
INFOSi une
recurrence_frequency est définie sur le contrat, la date d’ancrage de l’engagement récurrent prendra par défaut le starting_at de l’engagement. Cela signifie que si la date de début du contrat et la date de début de l’engagement récurrent sont distinctes, la première période ne sera pas proratisée.- Définissez le comportement de prorata. S’il est laissé nul, le comportement par défaut est de proratiser tout octroi qui ne couvre pas une période complète (
FIRST_AND_LAST). - Définissez éventuellement le comportement d’arrondi lorsque les calendriers d’accès et de facturation des engagements sont proratisés. Cela peut être utilisé pour n’accorder et ne facturer que des montants entiers, par exemple.
- Pour émettre les frais d’engagement sur la même facture que le relevé de consommation du contrat, précisez que la consommation et les frais planifiés doivent être consolidés sur le contrat.
Mise à niveau ou rétrogradation du contrat d’un client
Les clients peuvent passer à de nouveaux niveaux après s’être familiarisés avec votre produit. Pour faciliter cela, créez un nouveau contrat via un renouvellement de contrat. Cela met fin au contrat actuel et à toutes les futures charges récurrentes et génère un nouveau contrat avec des conditions mises à jour. Si un client a droit à conserver son solde existant dans le cadre de la mise à niveau ou de la rétrogradation, précisez un Contract Transition Rollover de 100 % lors de la création du contrat initial.Mise à niveau au début d’une nouvelle période
Pour faciliter ou planifier une mise à niveau au début d’une nouvelle période de facturation :- Créez un nouveau contrat et définissez la date de début au début de la période de facturation. Précisez la transition du contrat comme un Renewal et transmettez l’identifiant du contrat précédent.
- Si un report de contrat a été spécifié pour l’engagement récurrent sur le premier contrat, le solde restant est reporté sur le nouveau contrat selon ce paramètre.
FINALIZED pour le premier engagement récurrent. Il génère également une nouvelle facture d’utilisation DRAFT pour mesurer la consommation du premier mois.
Mise à niveau en milieu de période
Pour faciliter une mise à niveau en milieu de période :- Créez un nouveau contrat et définissez la date de début à la date du jour. Précisez la transition du contrat comme un Renewal et transmettez l’identifiant du contrat précédent.
- Le montant de l’engagement pour la première période sera proratisé.
- Si un report de contrat a été spécifié pour l’engagement récurrent sur le premier contrat, le solde restant est reporté sur le nouveau contrat selon ce paramètre.
DRAFT sur le premier contrat sera finalisée avec la consommation jusqu’à cette date. Le nouveau contrat génère une nouvelle facture d’utilisation DRAFT pour capturer la consommation du reste de la période et une facture planifiée FINALIZED avec la charge proratisée pour le premier engagement récurrent.
Antidater une mise à niveau
L’avantage d’antidater une mise à niveau est que l’utilisateur ne reçoit qu’une seule facture d’utilisation pendant la période de facturation. Pour antidater une mise à niveau :- Créez un contrat et définissez la date de début au premier jour de la période de facturation actuelle. Précisez la transition du contrat comme un Renewal et transmettez l’identifiant du contrat précédent.
- Cela finalise la facture d’utilisation
DRAFTactuelle du premier contrat. La période de service mise à jour commence et se termine le même jour, ce qui signifie que la consommation de la période ouverte est déplacée vers le nouveau contrat. - Sur le nouveau contrat, créez un engagement unique qui représente le montant remisé pour la première période. Le montant doit être (total proratisé) - (montant payé sur le premier contrat).
- Créez un calendrier récurrent qui commence à la deuxième période du contrat sur une base prospective.
Exemple de crédit récurrent
Considérez un exemple où un client souscrit au plan de niveau le plus bas de votre entreprise le 1er janvier. Ce plan gratuit lui donne accès à $10 de crédits gratuits chaque mois et à l’accès aux produits Basic. Si le client n’utilise pas ses crédits chaque mois, ils expirent au début du mois suivant. Cet exemple d’appel API montre comment créer le contrat avec un crédit gratuit récurrent :- $2 de consommation gratuite reportés du premier contrat
- $10 d’un engagement payé avec une base de coût de 0,67
Fonctionnement des crédits et engagements avec les factures
Dans Metronome, les crédits et engagements sont toujours appliqués à la consommation au niveau de l’élément de facturation plutôt qu’au niveau agrégé de la facture. Cette attribution permet de mieux reconnaître les dépenses pré-engagées et les dépassements pour chaque produit. Sur une facture, les éléments de facturation sont séparés selon que la consommation puise dans un engagement, un crédit, ou est en dépassement.INFOUne même consommation ne peut s’appliquer qu’à un seul engagement ou crédit. Par exemple, si vous avez engagé $500 de consommation et que vous disposez d’un contrat encodé avec un engagement prépayé de $400 et un engagement postpayé de $400, l’engagement prépayé est consommé en premier. $400 de la consommation consomment entièrement l’engagement prépayé. Ensuite, les $100 restants comptent pour l’accomplissement de l’engagement postpayé. Comme les engagements postpayés sont payés à terme échu, le client sera tout de même facturé pour $100.
- Consommation couverte par l’engagement prépayé, totalisant $4
- Élément d’application de l’engagement, totalisant -$4
- Consommation non couverte par un engagement prépayé ou un crédit (élément « Overage »), totalisant $6