> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metronome.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suivre le solde restant d'un credit ou d'un commit

Suivre le solde restant des credits et des commits vous aide à comprendre avec précision la santé des comptes, à prévoir les revenus et à suivre les actifs et passifs. Cela permet également de fournir aux clients des informations à jour sur leur solde restant. Il existe de nombreuses façons d'afficher le solde restant aux clients et Metronome offre la flexibilité d'afficher à la fois des vues agrégées et détaillées.

<Warning>
  Les valeurs de solde peuvent être des **nombres fractionnaires** (par exemple, `0.8` cent pour USD). Lors de l'intégration avec l'API des soldes, ne tronquez pas les soldes en entiers — cela pourrait entraîner une perte de données. L'arrondi est acceptable s'il est effectué intentionnellement. Pour USD, les montants sont libellés en cents, donc un solde de `0.8` représente 0,008 \$.
</Warning>

## Récupérer le solde restant total d'un client

Pour afficher un solde agrégé en temps réel à vos clients, appelez le point de terminaison [`/getNetBalance`](https://docs.metronome.com/api-reference/credits-and-commits/get-the-net-balance-of-a-customer). Ce point de terminaison renvoie une somme agrégée unique du solde restant d'un client, avec un filtrage avancé par type de solde, devise, frais en attente et custom fields.

## Construire une vue de registre détaillée des soldes individuels

Metronome prend également en charge des vues plus détaillées des soldes individuels en suivant les entrées de registre via le point de terminaison [`listBalances`](https://docs.metronome.com/api-reference/credits-and-commits/list-balances). Chaque credit ou commit est associé à un registre, qui enregistre les événements qui modifient le solde du commit ou du credit. L'addition de toutes les entrées d'un registre donne le solde restant total associé à ce registre. Par exemple, il existe des entrées de registre associées au début de l'`access_schedule`, aux déductions de facture (consommation du credit ou du commit correspondant à l'utilisation) et aux expirations.

Chaque entrée de registre est associée à un `type`, un `amount` (qui peut être positif ou négatif) et un `timestamp` effectif. Il y a une entrée de registre de déduction de facture pour chaque facture qui consomme un credit ou un commit. Le `timestamp` associé aux entrées de registre de déduction de facture est toujours la fin de la période de service associée à la facture d'utilisation. Utilisez le `timestamp` pour montrer aux clients leur solde restant en incluant ou en excluant les frais en attente.

### Exemple de registre

Considérons un exemple où un client se voit attribuer un credit de 100 $avec un segment d'accès du 1er septembre 2024 au 1er octobre 2024. Au cours du mois de septembre, le client a consommé 63$ du credit. Le solde de credit restant a expiré après le 1er octobre.

En conséquence, ce credit a trois entrées de registre :

<CardGroup cols={1}>
  <Card>
    <table style={{ width: '100%', borderCollapse: 'collapse' }}>
      <thead>
        <tr>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Type</th>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Timestamp</th>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Montant</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>credit\_segment\_start</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>01/09/2024</td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>+100 \$</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>credit\_automated\_invoice\_deduction</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>01/10/2024</td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>-63 \$</td>
        </tr>

        <tr>
          <td style={{ padding: '8px' }}><code>credit\_segment\_expiration</code></td>
          <td style={{ padding: '8px' }}>01/10/2024</td>
          <td style={{ padding: '8px' }}>-37 \$</td>
        </tr>
      </tbody>
    </table>
  </Card>
</CardGroup>

### Entrées manuelles de registre

Vous pouvez vouloir ajuster le registre d'un credit ou d'un commit pour tenir compte d'erreurs, pour migrer des clients existants avec des soldes en cours vers Metronome, ou pour de nombreuses autres raisons. Appliquez des ajustements positifs ou négatifs au registre d'un credit ou d'un commit via l'[application Metronome](https://app.metronome.com/) ou l'API en utilisant le point de terminaison [`/addManualBalanceLedgerEntry`](/fr/api-reference/credits-and-commits/add-a-manual-balance-entry).

### Types d'entrées de registre des credits

<CardGroup cols={1}>
  <Card>
    <table style={{ width: '100%', borderCollapse: 'collapse' }}>
      <thead>
        <tr>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Type</th>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Description</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>credit\_segment\_start</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Indique qu'un segment de credit a commencé et que le client a maintenant accès au montant d'utilisation pour ce segment. L'access schedule du credit décrit ces segments.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>credit\_automated\_invoice\_deduction</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente les déductions du segment de credit causées par une facture d'utilisation qui incluait une utilisation applicable à ce credit.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>credit\_segment\_expiration</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente le montant de credit non utilisé qui a expiré à la fin d'un segment de credit.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>credit\_manual</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente une entrée de registre manuelle ajoutée à un credit.</td>
        </tr>

        <tr>
          <td style={{ padding: '8px' }}><code>credit\_seat\_based\_adjustment</code></td>
          <td style={{ padding: '8px' }}>Représente le credit supplémentaire associé à un incrément de seat lors de l'utilisation de credits récurrents liés à un abonnement</td>
        </tr>
      </tbody>
    </table>
  </Card>
</CardGroup>

### Types d'entrées de registre des commits

<CardGroup cols={1}>
  <Card>
    <table style={{ width: '100%', borderCollapse: 'collapse' }}>
      <thead>
        <tr>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Type</th>
          <th style={{ borderBottom: '1px solid #ccc', textAlign: 'left', padding: '8px' }}>Description</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>postpaid\_initial\_balance</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente le solde de départ d'un commit postpayé.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>postpaid\_automated\_invoice\_deduction</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente les déductions de l'obligation restante du commit postpayé suite à une facture comportant une utilisation applicable à ce commit.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>postpaid\_trueup</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente une facture de true-up émise pour ce commit afin de couvrir une utilisation non couverte par les factures d'utilisation automatisées.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>postpaid\_rollover</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente l'utilisation non consommée du commit postpayé qui a été reportée vers un nouveau contrat.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>postpaid\_manual</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente une entrée de registre manuelle ajoutée à un commit postpayé.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>postpaid\_commit\_expiration</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente le montant de commit non utilisé et expiré à la fin d'un segment de commit. N'inclut pas l'utilisation qui a été reportée vers un nouveau contrat.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>prepaid\_segment\_start</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Indique qu'un segment de commit prépayé a commencé et que le client a maintenant accès au montant d'utilisation pour ce segment. L'access schedule du commit prépayé décrit ces segments.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>prepaid\_automated\_invoice\_deduction</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente les déductions du segment de commit prépayé causées par une facture d'utilisation qui incluait une utilisation applicable à ce commit.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>prepaid\_rollover</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente l'utilisation non consommée du commit prépayé qui a été reportée vers un nouveau contrat.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>prepaid\_segment\_expiration</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente le montant de commit non utilisé et expiré à la fin d'un segment de commit. N'inclut pas l'utilisation qui a été reportée vers un nouveau contrat.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>prepaid\_commit\_expiration</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente le montant de commit non utilisé et expiré à la fin d'un segment de commit. N'inclut pas l'utilisation qui a été reportée vers un nouveau contrat.</td>
        </tr>

        <tr>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}><code>prepaid\_manual</code></td>
          <td style={{ borderBottom: '1px solid #eee', padding: '8px' }}>Représente une entrée de registre manuelle ajoutée à un commit prépayé.</td>
        </tr>

        <tr>
          <td style={{ padding: '8px' }}><code>prepaid\_commit\_seat\_based\_adjustment</code></td>
          <td style={{ padding: '8px' }}>Représente le commit supplémentaire associé à un incrément de seat lors de l'utilisation de commits récurrents liés à un abonnement</td>
        </tr>
      </tbody>
    </table>
  </Card>
</CardGroup>