Passer au contenu principal
Les factures dans Metronome représentent les produits ou services vendus à vos clients ou consommés par eux. Cette page décrit les types de factures, les statuts, les postes et la présentation configurable.
FACTURATION CLIENTPour savoir comment facturer vos clients et collecter le paiement des factures Metronome, consultez nos guides de facturation
Dans le contexte de la facturation basée sur l’usage, où les clients sont facturés en fonction de la consommation réelle d’un service (comme le stockage cloud, les appels API ou le traitement de données), la facture joue un rôle crucial pour plusieurs raisons :
  • Transparence Dans un modèle basé sur l’usage, le montant facturé peut varier d’un mois à l’autre. La facture détaille ce qui a été utilisé, quand il a été utilisé et comment les charges ont été calculées, offrant une clarté au client sur ce qu’il paie.
  • Précision Des factures précises garantissent que le client n’est facturé que pour les ressources qu’il a réellement consommées. Cela réduit les litiges et renforce la confiance entre le prestataire et le client.
  • Reconnaissance du revenu Pour les entreprises, les factures sont nécessaires pour suivre les revenus et s’assurer que les bons montants sont enregistrés en fonction de l’usage réel.
  • Conformité Dans de nombreuses industries, les exigences réglementaires imposent une facturation précise à des fins fiscales et légales. Les factures aident les entreprises à se conformer aux lois fiscales, car elles documentent quand les services ont été fournis et quand les paiements sont dus.
  • Gestion de la trésorerie Les factures signalent également aux clients quand les paiements sont dus, ce qui aide les entreprises à gérer leur trésorerie. Dans la facturation basée sur l’usage, une facturation en temps voulu aide les entreprises à maintenir des revenus stables malgré des schémas d’utilisation variables.
Le principal mécanisme qui génère des factures dans Metronome est le contrat. Lorsque vous provisionnez un contrat pour un client, il produit automatiquement des factures tout au long de son cycle de vie selon des calendriers prédéfinis.

​
Types de factures Metronome

Metronome produit deux types de factures : les factures d’usage et les factures planifiées.

​
Factures d’usage

Les factures d’usage enregistrent les produits ou services auxquels un client a droit et ce qu’il a consommé sur une période donnée. Elles sont générées selon le calendrier et la fréquence des relevés d’usage définis dans le contrat. Elles sont continuellement mises à jour en temps réel, offrant une visibilité sur les dépenses du client. Si un client a un crédit ou un engagement prépayé appliqué, la facture d’usage peut afficher un total de zéro dollar et ne nécessite pas de paiement. Dans ces cas, la facture d’usage sert d’enregistrement pour la reconnaissance du revenu et peut être affichée via un tableau de bord au lieu d’être envoyée pour la collecte du paiement. Une facture d’usage comprend :
  • Tous les services auxquels le client a droit, comme indiqué sur la grille tarifaire avec le prix catalogue, le prix spécifique au client et la quantité consommée
  • Tous les engagements et crédits appliqués à la facture
Fonctionnalités uniques Planifiez des changements sur n’importe quel produit, tarif, engagement ou crédit dans Metronome. Ces changements sont automatiquement reflétés sur la facture sans nécessiter l’émission d’une nouvelle facture. De plus, Metronome décompose la facture d’usage en périodes distinctes, détaillant quand différents services étaient inclus, quand des tarifs étaient actifs et quand des engagements ou des crédits étaient disponibles. Metronome applique les engagements ou les crédits à chaque poste et calcule le dépassement par article. Cette flexibilité vous permet de planifier des changements en milieu de période sur une métrique facturable ou un prix et de voir la facture s’ajuster automatiquement. Schéma Les factures d’usage sont identifiées par le type USAGE et sont toujours associées à une période de facturation, définie par billing_period_start_date et billing_period_end_date. Les factures d’usage ont une période de grâce configurable, durant laquelle l’usage peut encore être déclaré après la billing_period_end_date. Une fois finalisée, la facture est émise à la issue_date.

​
Factures planifiées

Les contrats Metronome peuvent également produire des factures planifiées. Celles-ci sont utilisées pour des frais fixes comme des prépaiements d’engagement, des régularisations d’engagements postpayés, ou de simples frais initiaux ou récurrents. Générez une facture planifiée en ajoutant un engagement ou une charge planifiée à un contrat. Fonctionnalités uniques Metronome offre un ensemble très flexible d’options de planification. Créez un calendrier de facturation personnalisé qui répond aux besoins de vos clients, vous permettant de conclure des affaires plus rapidement. Planifiez des charges à facturer mensuellement, trimestriellement, ou définissez même des calendriers personnalisés précis. Metronome regroupe automatiquement toutes les charges planifiées sur la même facture. Schéma Les factures planifiées sont identifiées par le type SCHEDULED. Il n’y a pas de période de grâce pour ces factures. Elles sont finalisées à la issue_date configurée (voir les limitations ci-dessous) et n’ont pas de billing_period_start_date ni de billing_period_end_date.
MÉCANIQUE DE FINALISATION DES FACTURES PLANIFIÉESLes factures planifiées sont finalisées selon des règles de temporisation spécifiques basées sur leur date d’émission et l’heure de création du contrat :
  • Si la date d’émission est dans le passé ou présent, la facture est finalisée immédiatement
  • Si la date d’émission est dans les 2 heures suivant la création du contrat, la facture est finalisée dans les 2 heures et 30 minutes suivant la création du contrat
  • Si la date d’émission est à plus de 2 heures de la création du contrat, la facture est finalisée dans les 30 minutes suivant la date d’émission

​
Cycle de vie des factures

Toutes les factures sont dans l’un de quatre états : brouillon, période de grâce, finalisée ou annulée.

​
Factures en brouillon

Brouillon est un état initial de la facture. Ce qui se produit pendant ou après cet état dépend du type de facture. Factures d’usage Dès qu’une période de facturation de contrat commence, Metronome crée une facture d’usage brouillon (status = DRAFT). À mesure que les données d’usage sont envoyées à Metronome, la facture brouillon se met à jour en continu pour refléter les dépenses en temps réel. Factures planifiées Une fois que vous ajoutez des charges planifiées ou des engagements prépayés à un contrat, Metronome crée des factures planifiées en brouillon (status = DRAFT). Celles-ci restent en brouillon jusqu’à la date de facture planifiée. Pour les engagements postpayés, Metronome crée automatiquement une facture de régularisation en brouillon (status = DRAFT). Cette facture suit combien le client doit dépenser de plus pour atteindre son engagement. Elle est finalisée après la finalisation de la dernière facture d’usage de ce contrat.

​
Période de grâce

Après la fin de la période de facturation, Metronome applique une période de grâce avant de finaliser la facture. Cette période tampon permet de prendre en compte les données d’usage arrivées tardivement et les corrections de facture. La période de grâce est de 24 heures par défaut. Contactez votre représentant Metronome pour personnaliser la période de grâce.

​
Factures finalisées

Une fois qu’une facture est finalisée (status = FINALIZED), aucune autre modification ne peut être apportée, même si un usage supplémentaire est déclaré pour la période. La facture finalisée est immuable et prête à être livrée au client et reportée officiellement. Si la facture finalisée contient des erreurs, elle peut être annulée et régénérée, en intégrant les modifications mises à jour. Les factures finalisées sont distribuées et collectées selon la configuration de facturation de votre contrat.

​
Factures annulées

Une facture finalisée peut être annulée (status = VOID) si elle a été créée par erreur en raison d’un problème de provisionnement.
RÉGÉNÉRER DES FACTURES ANNULÉESUne fois qu’une facture a été annulée, vous pouvez la régénérer via l’interface utilisateur lors de la visualisation de la facture, ou via le point de terminaison d’API /invoices/regenerate. Lorsqu’une facture est régénérée, elle sera recalculée en utilisant l’usage et les conditions tarifaires à jour.

​
Postes de facture

Chaque facture se compose de postes correspondant aux produits et services dans Metronome. Chaque poste comprend :
  • Nom affiché, le nom du produit ou service
  • Quantité (nombre décimal), une quantité par défaut ou une quantité calculée à partir des données d’usage du client
  • Prix unitaire, le prix par unité du service
  • Total, calculé automatiquement en multipliant la quantité par le prix unitaire
  • Clés de groupe de tarification et de présentation, informations de regroupement facultatives pour organiser les données tarifaires

​
Exemple de facture

Cet exemple montre comment Metronome crée les postes de facture. Votre client est provisionné avec l’accès à un produit nommé API Tokens à un prix unitaire de 1 paruniteˊ.Leclientaeˊgalementpreˊacheteˊunengagementpreˊpayeˊde50par unité. Le client a également préacheté un engagement prépayé de 50, ce qui correspond à 50 jetons. Si le client a utilisé 80 jetons pendant la période de facturation en cours, la facture en brouillon est décomposée comme suit :
Toutes les valeurs monétaires de cette facture sont dans la dénomination de la devise. Pour l’USD, les valeurs sont en cents — donc un "total" de 3000 signifie 30,00 etun‘"unitprice"‘de‘100‘signifie1,00et un `"unit_price"` de `100` signifie 1,00. D’autres devises peuvent utiliser des unités entières. Voir dénomination des devises pour plus de détails.
  • Un poste pour les 50 premiers jetons consommés totalisant 50 $
  • Un ajustement de poste indiquant que l’engagement prépayé de 50 acompenseˊletotalpourlespremiers50a compensé le total pour les premiers 50
  • Un poste couvrant les 30 jetons restants consommés totalisant 30 $
{  
  "id": "INVOICE_ID",  
  "issued_at": "2024-10-02T00:00:00+00:00",  
  "start_timestamp": "2024-09-01T00:00:00+00:00",  
  "end_timestamp": "2024-10-01T00:00:00+00:00",  
  "customer_id": "CUSTOMER_ID",  
  "customer_custom_fields": {},  
  "type": "USAGE",  
  "credit_type": {  
    "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",  
    "name": "USD (cents)"  
  },  
  "status": "DRAFT",  
  "total": 3000,  
  "external_invoice": null,  
  "contract_id": "CONTRACT_ID",  
  "contract_custom_fields": {},  
  "custom_fields": {},  
  "billable_status": "billable",  
  "line_items": [  
    {  
      "product_id": "PRODUCT_ID",  
      "product_type": "UsageProductListItem",  
      "product_custom_fields": {},  
      "name": "Tokens Consumed",  
      "total": 5000,  
      "credit_type": {  
        "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",  
        "name": "USD (cents)"  
      },  
      "starting_at": "2024-09-01T00:00:00+00:00",  
      "ending_before": "2024-10-01T00:00:00+00:00",  
      "commit_id": "COMMIT_ID",  
      "commit_segment_id": "COMMIT_SEGMENT_ID",  
      "commit_type": "PrepaidCommit",  
      "commit_custom_fields": {},  
      "unit_price": 100,  
      "quantity": 50  
    },  
    {  
      "product_id": "PRODUCT_ID",  
      "product_type": "UsageProductListItem",  
      "product_custom_fields": {},  
      "name": "Prepaid Tokens applied",  
      "total": -5000,  
      "credit_type": {  
        "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",  
        "name": "USD (cents)"  
      },  
      "starting_at": "2024-09-01T00:00:00+00:00",  
      "ending_before": "2024-10-01T00:00:00+00:00",  
      "commit_id": "COMMIT_ID",  
      "commit_segment_id": "COMMIT_SEGMENT_ID",  
      "commit_type": "PrepaidCommit",  
      "commit_custom_fields": {}  
    },  
    {  
      "product_id": "PRODUCT_ID",  
      "product_type": "UsageProductListItem",  
      "product_custom_fields": {},  
      "name": "Tokens Consumed",  
      "total": 3000,  
      "credit_type": {  
        "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",  
        "name": "USD (cents)"  
      },  
      "starting_at": "2024-09-01T00:00:00+00:00",  
      "ending_before": "2024-10-01T00:00:00+00:00",  
      "unit_price": 100,  
      "quantity": 30  
    }  
  ]  
}
L’application Metronome visualise l’objet facture, affichant la quantité d’usage continuellement mise à jour à mesure que les événements d’usage sont ingérés pour ce client et les ajustements comme les engagements prépayés et les crédits accordés sont appliqués.
Visualisation de la facture

​
Présentation des factures

Dans Metronome, vous contrôlez la structure de vos factures et le niveau de granularité fourni à vos clients pour assurer la confiance et la sérénité. Vous pouvez configurer :
  • Un nom de produit clair que Metronome affiche comme description du poste.
  • Les clés de groupe de tarification facultatives pour ajouter de la granularité sur chaque produit d’usage. Par exemple, vous pouvez définir un prix différent pour les jetons d’entrée et de sortie.
  • Les clés de groupe de présentation facultatives pour regrouper les produits d’usage sous une propriété comme le nom d’équipe ou le nom d’organisation.

​
Postes avec clés de groupe de tarification

Vous pouvez configurer des produits d’usage avec une ou plusieurs clés de regroupement tarifaire et définir un tarif pour chaque combinaison de clés de groupe de tarification. Les factures Metronome ont automatiquement un poste distinct pour chaque combinaison de clés de groupe de tarification. Prenons l’exemple de Tokens Consumed, où vous ajoutez une clé de groupe de tarification type au produit et définissez deux tarifs dans la grille tarifaire : un pour type = input et un pour type = output. La facture comporte désormais deux postes, affichant la valeur de la clé de groupe de tarification pour chacun :
Facture avec clés groupées de tarification
Notez que, contrairement aux produits d’usage sans clé de groupe de tarification, Metronome ne crée pas de poste pour chaque clé de groupe de tarification à moins qu’elle ait des données d’usage.

​
Regrouper les postes avec des clés de groupe de présentation

En plus des clés de groupe de tarification, regroupez les produits d’usage sur une facture par toute propriété pertinente. Cela aide vos clients à faire des choses comme allouer les dépenses à l’unité commerciale appropriée. Considérez l’exemple précédent où les clients créent des projects et consomment des jetons par projet. Vous voulez regrouper les postes d’usage par project_name sur la facture. Pour ce faire, définissez une clé de groupe de présentation sur votre produit Tokens Consumed. La facture Metronome regroupe automatiquement les postes par project_name.
Facture avec clés groupées de présentation