Gérer les transitions de cycle de vie d'un contrat

Ce cas d’utilisation présente des exemples montrant comment utiliser Metronome pour gérer les transitions de cycle de vie d’un contrat. Les transitions de cycle de vie d’un contrat se produisent lorsque la relation entre une entreprise et ses clients change. Par exemple, après la signature initiale d’un accord, des modifications comme des ventes additionnelles à mi-parcours, des renouvellements et l’expiration du contrat peuvent survenir. Metronome vous aide à gérer le cycle de vie d’un contrat, y compris les transitions sans friction entre les états du contrat. Pour soutenir la flexibilité de tarification et de packaging dans votre organisation, vous pouvez :

Créer des contrats qui capturent pleinement les termes convenus, la tarification et le calendrier
Mettre à jour les contrats pour refléter les nouveaux termes, les ventes additionnelles, les rétrogradations ou les lancements de nouveaux produits
Conclure des contrats complexes et restreindre l’utilisation des produits
Consulter un journal d’audit clair de toutes les modifications de cycle de vie d’un contrat

Les exemples sur cette page montrent comment Metronome prend en charge la gestion du cycle de vie d’un contrat à travers différentes motions commerciales.

Créer une motion de contrat d’entreprise

Les termes d’un contrat d’entreprise peuvent varier d’un client à un autre. Les termes peuvent inclure un accès spécial à des produits non publics, des remises sur les prix de liste au niveau SKU, des engagements prépayés ou postpayés, etc. Metronome prend en charge un éventail de motions de tarification et de packaging, donnant à votre équipe commerciale les moyens de proposer des accords sur mesure sans nécessiter l’intervention de l’IT ou d’autres services pour mettre à jour le système de facturation. Metronome alimente également votre workflow de droits d’accès aux produits, garantissant que seul un client avec un contrat actif peut utiliser les produits et services de votre entreprise. Par exemple, l’équipe commerciale de votre organisation vient de proposer un contrat d’entreprise d’un an à une société nommée Moogle. Les termes de l’accord sont un engagement prépayé de 100 000 $ pour le droit d’utiliser le Produit A à partir du 1er janvier 2025, avec une remise de 10 % sur le prix de liste standard du Produit A. Pour prendre en charge ce cas d’utilisation dans Metronome :

Configurez les billable metrics pour agréger correctement l’utilisation de votre client.
Créez des produits qui représentent les SKU pour lesquels vous facturerez vos clients.
Configurez une rate card pour définir la tarification et le droit d’accès standard de vos produits.
Configurez une intégration avec un fournisseur de factures en aval comme Stripe pour prendre en charge la facturation du client.
Créez un objet client représentant Moogle.
Créez un contrat dans Metronome associé à Moogle.

Vous pouvez créer le contrat avec l’API /contracts/create :

curl https://api.metronome.com/v1/contracts/create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "450f7264-9b3d-43d5-8ee1-fc369a144c01",
    "name": "Enterprise Contract",
    "uniqueness_key": "1234",
    "rate_card_id": "6f06fad5-d017-4674-8b7f-1e00a1208109",
    "starting_at": "2025-01-01T00:00:00Z",
    "ending_before": "2026-01-01T00:00:00Z",
    "commits": [
      {
        "type": "prepaid",
        "name": "Prepaid Commit Moogle",
        "product_id": "7bb1bdf6-e4af-42e0-be27-3cde86056919",
        "access_schedule": {
          "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "schedule_items": [
            {
              "amount": 1000000,
              "starting_at": "2025-01-01T00:00:00Z",
              "ending_before": "2026-01-01T00:00:00Z"
            }
          ]
        },
        "invoice_schedule": {
          "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "schedule_items": [
            {
              "amount": 1000000,
              "timestamp": "2025-01-01T00:00:00Z"
            }
          ]
        },
        "rollover_fraction": 0.5,
        "priority": 100,
        "applicable_product_ids": ["d6695114-299b-4bd7-b57c-7a9134ba50ae"]
      }
    ],
    "overrides": [
      {
        "starting_at": "2025-01-01T00:00:00Z",
        "ending_before": "2026-01-01T00:00:00Z",
        "entitled": true,
        "type": "multiplier",
        "multiplier": 0.9,
        "product_id": "d6695114-299b-4bd7-b57c-7a9134ba50ae"
      }
    ]
  }'

Après la création du contrat, alimentez vos workflows de droits d’accès avec l’API /contracts/get. Par exemple, utilisez l’API /contracts/get pour confirmer que le contrat de Moogle est actif avant de leur permettre d’utiliser le Produit A.

Motion d’ajouts à mi-parcours et de renouvellements

Des opportunités se présentent souvent pour capturer plus de valeur d’une relation commerciale existante. Cela se manifeste généralement sous la forme d’ajouts à mi-parcours à un contrat actif, y compris l’accès à de nouveaux SKU, de nouveaux engagements monétaires avec des remises variables sur les prix de liste, et des renouvellements anticipés de contrats. Metronome aide votre équipe commerciale à saisir les opportunités au fur et à mesure qu’elles se présentent, permet à vos équipes produit de déployer et de facturer pour de nouvelles fonctionnalités, et épargne à votre équipe IT le stress de gérer des changements contractuels fréquents et complexes.

Exécuter un ajout à mi-parcours

Votre entreprise prévoit de lancer en bêta le Produit B le 1er octobre 2025. Vous proposez un taux remisé de 20 % à votre client nommé Moogle en échange d’un nouvel engagement prépayé de 10 000

. Cet engagement prépayé de 10 000

ne s’appliquerait qu’à l’utilisation du Produit B et débuterait le 1er octobre 2025. Pour prendre en charge ce cas d’utilisation dans Metronome :

Créez un produit basé sur l’utilisation représentant le Produit B.
Mettez à jour la rate card existante pour inclure le Produit B avec votre prix de liste et votre droit d’accès par défaut. Définissez le droit d’accès du Produit B sur false par défaut. Cela garantit que seuls les clients ayant accès au Produit B sont facturés pour son utilisation.
Modifiez le contrat Moogle existant pour :
- Changer le droit d’accès du Produit B à true, planifié pour le 1er octobre 2025
- Ajouter un nouveau commit prépayé au contrat existant pour 10 000 $ planifié pour le 1er octobre 2025, configuré pour que seule l’utilisation du Produit B soit déduite
- Remplacer le tarif de liste du Produit B pour accorder une remise de 20 % à Moogle

Modifiez le contrat avec l’API /contracts/edit :

curl https://api.metronome.com/v2/contracts/edit \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "450f7264-9b3d-43d5-8ee1-fc369a144c01",
    "contract_id": "7b347536-56ac-4036-b5d1-67142b0d00e5",
    "add_commits": [
      {
        "type": "prepaid",
        "name": "mid-term prepaid commit",
        "product_id": "7bb1bdf6-e4af-42e0-be27-3cde86056919",
        "access_schedule": {
          "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "schedule_items": [
            {
              "amount": 1000000,
              "starting_at": "2025-10-01T00:00:00Z",
              "ending_before": "2026-01-01T00:00:00Z"
            }
          ]
        },
        "invoice_schedule": {
          "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "schedule_items": [
            {
              "amount": 1000000,
              "timestamp": "2025-10-01T00:00:00Z"
            }
          ]
        },
        "rollover_fraction": 0.5,
        "priority": 100,
        "applicable_product_ids": ["f0608ff2-30b6-4010-b2a6-bada4296b8a0"]
      }
    ],
    "add_overrides": [
      {
        "starting_at": "2025-10-01T00:00:00Z",
        "ending_before": "2026-01-01T00:00:00Z",
        "type": "multiplier",
        "multiplier": 0.8,
        "product_id": "f0608ff2-30b6-4010-b2a6-bada4296b8a0",
        "entitled": true
      }
    ]
  }'

Renouvellement de contrat

Imaginez que nous sommes maintenant le 1er décembre 2025, ce qui signifie que Moogle a encore 1 mois sur son contrat existant. Ils sont globalement satisfaits de vos services et souhaitent renouveler leur contrat pour qu’il commence le 1er janvier 2026 pour une année supplémentaire. Cependant, Moogle a encore 10 000

de commit prépayé restant pour le Produit A. Selon les détails du contrat initial, le pourcentage de rollover était fixé à 50 % du solde initial en cas de renouvellement. Comme 10 000

est inférieur à 50 % de 100 000

, les 10 000

restants du commit seront entièrement reportés. Moogle apprécie cet accord et renouvelle avec un commit prépayé supplémentaire de 200 000 $ pour l’utilisation combinée du Produit A et du Produit B. Pour prendre en charge ce cas d’utilisation dans Metronome, créez un nouveau contrat prévu pour commencer le 1er janvier 2026 :

Attribuez le type de transition de contrat renewal et liez-le au contrat précédent.
Ajoutez un engagement prépayé de 200 000 $ configuré pour être déduit au fur et à mesure de l’utilisation du Produit A et du Produit B.
Supposez qu’une facture de 200 000 $ soit envoyée à la date de début du contrat (1er janvier 2026).

Le 1er janvier 2026, les 10 000

restants en commit prépayé pour l'utilisation du Produit A sont reportés au nouveau contrat. Cela signifie que Moogle a deux commits : un rollover commit de 10 000

uniquement pour l’utilisation du Produit A, et un commit prépayé de 200 000

pour l'utilisation combinée du Produit A et du Produit B. Sur ce nouveau contrat, le rollover commit de 10 000

est déduit en premier, avant que le commit de 200 000 $ ne soit utilisé. Complétez le renouvellement avec l’API /contracts/create :

curl https://api.metronome.com/v1/contracts/create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "450f7264-9b3d-43d5-8ee1-fc369a144c01",
    "name": "Enterprise Contract Renewal",
    "uniqueness_key": "12345",
    "rate_card_id": "6f06fad5-d017-4674-8b7f-1e00a1208109",
    "starting_at": "2026-01-01T00:00:00Z",
    "ending_before": "2027-01-01T00:00:00Z",
    "commits": [
      {
        "type": "prepaid",
        "name": "renewal prepaid commit",
        "product_id": "7bb1bdf6-e4af-42e0-be27-3cde86056919",
        "access_schedule": {
          "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "schedule_items": [
            {
              "amount": 20000000,
              "starting_at": "2026-01-01T00:00:00Z",
              "ending_before": "2027-01-01T00:00:00Z"
            }
          ]
        },
        "invoice_schedule": {
          "credit_type_id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "schedule_items": [
            {
              "amount": 20000000,
              "timestamp": "2026-01-01T00:00:00Z"
            }
          ]
        },
        "rollover_fraction": 0.5,
        "priority": 101,
        "applicable_product_ids": [
          "d6695114-299b-4bd7-b57c-7a9134ba50ae",
          "f0608ff2-30b6-4010-b2a6-bada4296b8a0"
        ]
      }
    ],
    "transition": {
      "type": "renewal",
      "from_contract_id": "7b347536-56ac-4036-b5d1-67142b0d00e5"
    }
  }'

Mettre fin à une motion de contrat

La fin d’une relation commerciale implique deux tâches critiques : s’assurer que les obligations financières stipulées dans le contrat sont remplies, et que l’accès aux produits et services de votre entreprise est rapidement restreint. Metronome répond aux deux exigences, car le système suit automatiquement les termes du contrat par rapport à l’utilisation de votre client et offre des fonctionnalités pour alimenter votre workflow de droits d’accès aux produits. Cela signifie que si un contrat se termine avant la date de fin prévue, le client reçoit une facture pour ses obligations financières restantes tout en envoyant simultanément un signal à votre système de droits d’accès aux produits indiquant que le client n’est plus actif. Par exemple, Moogle décide de se séparer de votre entreprise avant d’avoir utilisé l’intégralité de son engagement prépayé, et souhaite quitter le contrat renouvelé le 1er mars 2026. Pour prendre en charge ce cas d’utilisation dans Metronome :

Planifiez la date de fin du contrat existant pour qu’elle soit effective le 1er mars 2026.
Assurez-vous de restreindre l’accès à votre produit au moment de la fin du contrat :
- Configurez une alerte pour générer un webhook lorsqu’un commit atteint un solde bas (dans ce cas, 0,00 $)
- Configurez votre système de droits d’accès pour écouter le webhook et restreindre immédiatement l’accès

Comme ce client a été facturé pour le commit prépayé au moment du début du contrat (1er janvier 2026), il a déjà reçu sa facture de 200 000

de votre fournisseur de factures. Le 1er mars 2026, le commit prépayé restant du contrat passe à 0,00

. Mettez à jour la date de fin du contrat avec l’API /contracts/updateEndDate :

curl https://api.metronome.com/v1/contracts/updateEndDate \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "450f7264-9b3d-43d5-8ee1-fc369a144c01",
    "contract_id": "7b347536-56ac-4036-b5d1-67142b0d00e5",
    "ending_before": "2026-03-01T00:00:00Z"
  }'

​Créer une motion de contrat d’entreprise

​Motion d’ajouts à mi-parcours et de renouvellements

​Exécuter un ajout à mi-parcours

​Renouvellement de contrat

​Mettre fin à une motion de contrat

Créer une motion de contrat d’entreprise

Motion d’ajouts à mi-parcours et de renouvellements

Exécuter un ajout à mi-parcours

Renouvellement de contrat

Mettre fin à une motion de contrat