> ## 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.

# Provisionner un client

Dans Metronome, les clients sont les destinataires d’une facture et peuvent représenter des utilisateurs individuels, des entreprises, des clés API ou toute spécification dont votre organisation a besoin. Ce guide décrit comment créer un client dans Metronome.

La création de votre client comprend la création de l’objet client et la configuration des configurations de facturation associées facultatives.

<Info>
  **INFO**

  Un client doit avoir au moins un [contrat](/fr/guides/implement-metronome/core-concepts/provision-contract) provisionné pour commencer la tarification de la facturation. Vous pouvez également configurer plusieurs contrats par client, si nécessaire.
</Info>

## Créer un client

Créez un objet client individuel dans Metronome ou construisez un flux pour créer des clients programmatiquement à partir de déclencheurs système.

### Comprendre les alias d’ingestion

Les alias d’ingestion mappent vos identifiants client internes à l’ID client de Metronome. Lorsque vous envoyez de l’usage indexé sur un alias d’ingestion, Metronome l’associe automatiquement au bon client Metronome. Cela vous permet de maintenir vos entités client existantes sans avoir besoin de basculer vers un ID client Metronome.

Les alias d’ingestion peuvent également être utilisés pour maintenir une hiérarchie de comptes. Les clients entreprise ont souvent des sous-organisations qui se rattachent à un seul contrat. Utilisez les alias d’ingestion pour modéliser cela. Par exemple, vous pouvez représenter l’organisation entreprise comme un client dans Metronome, avec chaque sous-organisation représentée par un alias d’ingestion attaché à ce client :

```js theme={null}
Parent Account - Metronome Customer e7f893e5-07f7-483b-8c16-6905944c6a89  
  + Sub-Org 1 - IngestAlias1  
  + Sub-Org 2 - IngestAlias2  
  + Sub-Org 3 - IngestAlias3  
  + Sub-Org 4 - IngestAlias4
```

Vous pouvez répartir l’usage de chaque sous-organisation sur la facture que Metronome génère. Apprenez à utiliser les [clés de groupe](/fr/guides/implement-metronome/core-concepts/create-billable-metrics#3-define-group-keys%E2%80%8B) pour modifier la présentation des factures.

Les alias d’ingestion peuvent être spécifiés sur l’objet client Metronome au moment de la création ou à tout moment après. Ajouter rétroactivement un alias d’ingestion au client est un moyen de retirer Metronome du chemin critique de l’inscription du client tout en mesurant correctement l’usage. Par exemple, si vous envoyez d’abord de l’usage indexé sur `IngestAlias1` et que vous ajoutez plus tard cet alias d’ingestion à un client existant, Metronome associe rétroactivement cet usage au bon client.

### Créer un client avec l’application Metronome

Pour créer un client avec l’application :

1. Allez à la page **Customers** → **Add a customer.**
2. Ajoutez un nom.
3. Ajoutez un alias d’ingestion.
4. (Facultatif) Définissez un champ personnalisé pour le client dans l’onglet **Settings**.

### Construire un flux de création de client avec l’API

Utilisez l’API Metronome pour créer un flux permettant de créer des clients dans Metronome programmatiquement, basé sur des mouvements pilotés par les ventes ou par le produit.

Pour un mouvement piloté par les ventes, vous pouvez utiliser Salesforce CPQ pour capturer des opportunités. Lorsqu’une opportunité est conclue, vous pouvez planifier une tâche pour créer un client à l’aide de l’API Metronome.

Cet exemple de requête montre comment :

* Créer un client fictif, WidgetsExpress, dans Metronome
* Codifier la relation entre le client Metronome et le compte SFDC en stockant le `sfdc_account_id` dans un champ personnalisé

```bash theme={null}
curl https://api.metronome.com/v1/customers \  
  -H "Authorization: Bearer <TOKEN>" \  
  -H "Content-Type: application/json" \  
  -d '{  
    "ingest_aliases": [  
      "team@widgetsexpress.com"  
    ],  
    "name": "WidgetsExpress",  
    "custom_fields": {  
      "sfdc_account_id": "sfdc1001"  
    }  
  }'
```

Pour un mouvement de croissance piloté par le produit, créez un workflow similaire où le déclencheur provient d’une inscription sur votre site web. Stockez la relation entre le client Metronome et votre objet client interne.

### Ajouter une configuration de facturation à un client

Un client dans Metronome peut être facturé à différentes destinations, souvent en fonction de votre mouvement de facturation. Vous devez d’abord créer une `customer_billing_provider_configuration` sur le client puis l’affecter à un contrat. Metronome vous permet de configurer plusieurs `customer_billing_provider_configurations` par client, ce qui signifie qu’un client peut être facturé dans plusieurs systèmes — un par contrat.

<Note>
  **INFO**

  Avant de configurer une `customer_billing_provider_configuration`, Metronome doit d’abord être connecté au système pertinent. Suivez les étapes dans [Facturer avec Stripe](/fr/integrations/invoice-integrations/stripe) ou [Facturer avec les marketplaces (AWS et Azure)](/fr/integrations/marketplace-integrations/aws).
</Note>

Metronome recommande de définir les `customer_billing_provider_configurations` lors de la création du client. Par exemple, supposons que WidgetsExpress a acheté votre produit via AWS Marketplace. Modifiez l’appel précédent pour ajouter une `customer_billing_provider_configurations` au client WidgetExpress :

```bash theme={null}
curl https://api.metronome.com/v1/customers \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "ingest_aliases": [
      "team@widgetsexpress.com"
    ],
    "name": "WidgetsExpress",
    "custom_fields": {
      "sfdc_account_id": "sfdc1001"
    },
    "customer_billing_provider_configurations": [
      {
        "billing_provider": "aws_marketplace",
        "configuration": {
          "aws_customer_id": "ABC123ABC12",
          "aws_product_code": "my_product",
          "aws_region": "us-west-1"
        },
        "delivery_method": "direct_to_billing_provider"
       }
    ]
  }'
```

Après soumission, le client sera créé avec la configuration AWS associée. Cependant, il ne sera pas facturé à AWS tant qu’un contrat n’est pas créé avec AWS défini comme `billing_provider_configuration` du contrat. Si vous ne définissez pas de `customer_billing_provider_configuration` lors de la création du client, vous pouvez en ajouter une plus tard à l’aide du point de terminaison `/setCustomerBillingProviderConfigurations`.

<Note>
  **BÊTA**

  Vous pouvez archiver une `customer_billing_provider_configuration` soit en archivant le client, soit en archivant la configuration spécifique via le point de terminaison `/archiveCustomerBillingProviderConfigurations`. Lorsque vous archivez une configuration de facturation, elle devient disponible pour être réutilisée sur un nouveau client. Si vous archivez une `customer_billing_provider_configuration` qui est attachée à un contrat actif, la configuration sera immédiatement archivée sur le contrat et ne facturera plus à la destination associée. Une nouvelle `billing_provider_configuration` ne peut pas être provisionnée sur le contrat.
</Note>
