Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.

Migrer des contrats vers HubSpot

Dernière mise à jour: 23 juillet 2026

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Abonnement requis Un abonnement Revenue Hub est nécessaire pour migrer des contrats.

Licences utilisateurs requises Une licence Revenue Hub est requise pour migrer des contrats.

Autorisations requises Les autorisations d’un super administrateur sont requises pour effectuer la migration.

Migrez les contrats existants d’un système hérité vers HubSpot pour gérer la facturation et le reporting sur les revenus. La migration préserve les méthodes de paiement, l’historique des contrats et les calendriers de facturation futurs. Après la migration, vous pourrez utiliser HubSpot comme centre unique d’informations pour les revenus engagés. Découvrez-en davantage sur l’utilisation des contrats dans HubSpot.

Avant de commencer

Avant de commencer à utiliser cette fonctionnalité, assurez-vous de bien comprendre les étapes à suivre à l'avance, ainsi que les limites de la fonctionnalité et les conséquences potentielles de son utilisation.

Compréhension des exigences

Comprendre les limites et les considérations

  • Si vous utilisez la continuité des revenus, tester l’import dans un environnement de sandbox. Si des données incorrectes sont importées dans votre compte, vous ne pourrez pas corriger les données historiques dans les rapports en cascade MRR.
  • Une fois le contrat activé, HubSpot devient le système d’enregistrement pour la facturation. La migration ne peut pas être annulée.
  • Toute mise à jour de contrat doit être effectuée dans HubSpot. Découvrez-en davantage sur l’affichage et la gestion des contrats.
  • Après l’activation, vous pouvez mettre à jour le remplacement de la date de début de la facturation et l’ID du mode de paiement uniquement si le contrat n’a pas de factures ou de paiements payés.

Choisissez le format de migration

Avant la migration, sélectionnez un format de migration selon que vous souhaitez que HubSpot gère les contrats après la migration. Le format de migration dépend du processus de collecte et de l’inclusion ou non des événements de modification de contrat historiques (par exemple, mises à niveau ou extensions).

Processus de collecte des paiements

  • Paiements manuels : après la migration, les factures sont générées pour que les acheteurs paient manuellement.
  • Paiements automatiques : après la migration, les factures sont automatiquement débitées selon un mode de paiement enregistré.

Continuité des revenus

  • Aucune continuité de chiffre d’affaires : les contrats sont importés sans événement de modification de chiffre d’affaires.
  • Continuité des revenus : utilisez les clés de rampe pour regrouper les lignes de produits en phases et afficher les événements de changement (par exemple, mises à niveau, extensions, rétrogradations) dans la cascade de MRR dans HubSpot. Si vous utilisez la continuité des revenus, tester l’import dans un environnement de sandbox. Si des données incorrectes sont importées dans votre compte, vous ne pourrez pas corriger les données historiques dans les rapports en cascade MRR.

Rampes

Clés de rampe

Les touches de rampe regroupent plusieurs lignes de ligne de produit en phases. Les rangées avec la même clé de rampe sont traitées comme une rampe continue.

Dans HubSpot, chaque phase de rampe génère des événements MRR (par exemple, nouveau contrat, mise à niveau, expansion) au début de chaque phase. La touche de rampe peut être n’importe quelle chaîne de texte (par exemple, ramp-a). La même chaîne doit être partagée sur toutes les lignes de cette rampe.

Structurer une rampe

Pour une migration réussie, structurez-les comme suit :

  • Plages de dates qui ne se chevauchent pas : les termes de chaque ligne ne doivent pas se chevaucher avec ceux d’une autre ligne. Si les phases de rampe doivent être continues, chaque phase doit commencer à la fin de la phase précédente.
  • Durée par phase : la durée de chaque ligne couvre uniquement cette phase du contrat et non la durée complète du contrat.
  • Quantité totale sur chaque ligne : saisissez la quantité totale de la ligne de produit pendant cette phase
  • ID d’import de clé de rampe : regroupe les lignes de produit sous la même rampe. Découvrez-en davantage sur la création d’une propriété de rampe personnalisée.

Remarque :

  • Un contrat peut inclure des lignes de produits avec et sans rampe. Pour les lignes de produit sans rampe, laissez le ramp_key_import_id vide et utilisez la même import_unique_id chose que les lignes de contrat associées.
  • Un contrat peut comporter plusieurs produits qui fonctionnent de manière autonome. Chaque produit doit avoir son propre ramp_key_import_id. Chaque rampe génère ses propres événements MRR.

Par exemple, pour un contrat de 12 mois avec une modification de prix après trois mois :

Ligne de transaction Prix unitaire Quantité Durée Date de début ramp_key_import_id
Service mensuel 100 $ 1 3 mois 1er janvier 2026 ramp-a
Service mensuel 100 $ 2 9 mois 1er avril 2026 ramp-a

Formats de migration possibles

Format de la migration Processus de collecte Continuité des revenus
Paiements manuels sans continuité des revenus Paiements manuels Non inclus
Paiements manuels avec continuité des revenus Paiements manuels Inclus
Paiements automatiques sans continuité des revenus Paiements automatiques Non inclus
Paiements automatiques avec continuité des revenus Paiements automatiques Inclus

Préparer la migration

Avant de commencer la migration, configurez votre compte et préparez votre fichier CSV en fonction du format de migration sélectionné.

Créer des propriétés personnalisées

Créez les propriétés personnalisées requises avant d’importer votre fichier .csv. Les propriétés que vous devez créer dépendent du format de migration sélectionné. En savoir plus sur la création de propriétés personnalisées.

Format de la migration Objet Nom de la propriété personnalisée Type de propriété personnalisée Règles de validation Utilisé pour
Toutes les options Contrats import_unique_id Texte à une ligne Exiger des valeurs uniques Regroupe toutes les lignes qui appartiennent au même contrat.
Paiements manuels avec continuité des revenus ou Paiements automatiques avec continuité des revenus Lignes de transaction ramp_key_import_id Texte à une ligne Aucun Regroupe plusieurs lignes de ligne de produit en phases.

Configurer le fichier CSV

Configurez le fichier CSV à utiliser avec l’outil d’import pour migrer les contrats vers HubSpot.

Fichiers d’exemples CSV

Utilisez les exemples de fichiers CSV ci-dessous, en fonction du format de migration que vous utilisez.

Format de la migration Lien CSV
Paiements manuels, aucune continuité des revenus Télécharger
Paiements manuels avec continuité des revenus Télécharger
Paiements automatiques, pas de continuité des revenus Télécharger
Paiements automatiques avec continuité des revenus Télécharger
Mixte : un produit avec rampe et un produit forfaitaire (sans clé de rampe) Télécharger
Plusieurs rampes indépendantes : rampe du produit A (ramp-a) et du produit B (ramp-b) séparément Télécharger

Format CSV

Votre fichier CSV doit inclure les colonnes et propriétés HubSpot suivantes.

Nom de la colonne Objet Propriété Détails
Date d’entrée en vigueur du contrat Contrat hs_contract_effective_date La date à laquelle le contrat devient juridiquement effectif.
Code de devise Contrat hs_currency_code Code monétaire, tel que USD.
Nom Contrat hs_name Nom du contrat.
Facturation HubSpot activée Contrat hs_hubspot_billing_enabled Doit être TRUE pour tous les contrats en cours de migration.
Processus de collecte Contrat hs_collection_process Manuelle ou automatique. Doit correspondre au format de la migration.
Remplacement de la date de début de la facturation Contrat hs_billing_start_date_override La date à laquelle HubSpot commence la facturation. Il doit s’agir d’une date ultérieure lors de la migration. Requis pour tous les formats de migration.
ID du mode de paiement Contrat hs_external_payment_method_reference_id Laisser vide pour les paiements manuels. Requis pour les paiements automatiques.
E-mail Contact email L’adresse e-mail du contact de facturation.
Prénom Contact firstname Prénom du contact de facturation.
Nom Contact lastname Nom de famille du contact de facturation.
Les produits Ligne de transaction hs_product_id ID de fiche d’informations du produit. La migration fait référence à une fiche d’informations de produit existante et ne crée pas un nouveau produit
Ligne de produit : Nom Ligne de transaction name Ligne de produit : nom.
Prix unitaire Ligne de transaction price Prix unitaire dans la devise du contrat.
Quantité Ligne de transaction quantity La quantité de ligne de produit pendant une phase.
import_unique_id Ligne de transaction Propriété personnalisée ID partagé pour toutes les lignes d’un même contrat.
Durée Ligne de transaction hs_recurring_billing_period La durée de la ligne de produit. Lorsque vous utilisez des rampes, saisissez le terme pour chaque segment.
Fréquence de facturation récurrente Ligne de transaction recurringbillingfrequency Fréquence de facturation (mensuelle, par exemple).
Ligne de produit Date de début Ligne de transaction hs_recurring_billing_start_date Date de début de facturation de la ligne de produit.
ramp_key_import_id Ligne de transaction Propriété personnalisée Regroupe les phases d’une ligne de produit en une seule rampe. Nécessaire pour la continuité des revenus. Laissez ce champ vide pour les formats de migration sans continuité de revenus.

Commencer la migration

Une fois votre fichier CSV configuré, vous pouvez commencer à migrer les contrats vers HubSpot.

  1. Dans votre compte HubSpot, cliquez sur Plus, puis accédez à Chiffre d'affaires > Contrats. Si l'option Plus n'apparaît pas dans votre compte, accédez directement à Chiffre d'affaires > Contrats.
  2. Cliquez sur Importer dans l'angle supérieur droit.
  3. Dans la section Importer un fichier , cliquez sur Importer des données.
  4. Cliquez sur Imports avancés (tous les objets).
  5. Sous Objets, cliquez sur Contrats. L’objet « lignes de produit » sera sélectionné automatiquement.
  6. Dans l'angle inférieur droit, cliquez sur Suivant.
  7. Configurez la manière dont vous voulez importer vos données :
    • Charger un fichier : glissez-déposez ou cliquez sur Choisir un fichier et sélectionnez votre fichier d’import.
    • Copier et coller : cliquez sur Coller directement dans votre feuille de calcul et collez vos données. Les données doivent être copiées à partir d’un fichier de feuille de calcul (par ex., Numbers, Google Sheets).
    • Langue : si vous importez des données dans une langue autre que votre langue par défaut, cliquez sur le menu déroulant Sélectionner la langue des titres de colonnes dans votre fichier et sélectionnez la langue des en-têtes de colonne de vos deux fichiers . La sélection de la langue correcte permet à HubSpot de mieux associer les en-têtes de colonne aux propriétés par défaut existantes. Si aucune correspondance n'est trouvée pour la langue sélectionnée, HubSpot recherchera une propriété en anglais à associer.
  8. Dans l'angle inférieur droit, cliquez sur Suivant.
  9. Mappez les colonnes du fichier d’import avec les propriétés HubSpot. Découvrez-en davantage sur les mappages de propriétés CSV.
  10. Dans l'angle inférieur droit, cliquez sur Suivant.
  11. Dans le champ Nom de l’import , saisissez un nom pour l’import.
  12. Cliquez sur le menu déroulant Sélectionner la base juridique pour le traitement des données de contact et sélectionnez une base juridique. Découvrez-en davantage sur le suivi de la base juridique pour le traitement dans HubSpot.
  13. Cliquez sur le menu déroulant Format de date et sélectionnez un format de date.
  14. Cliquez sur le menu déroulant Fuseau horaire et sélectionnez un fuseau horaire.
  15. Cliquez sur le menu déroulant Format de nombre et sélectionnez un format de nombre.
  16. Sélectionnez la case à cocher Définir ces contacts comme contacts marketing si vous souhaitez interagir avec les contacts importés à l’aide des outils marketing de HubSpot. En savoir plus sur les contacts marketing.
  17. Sélectionnez la case à cocher Enrichir les fiches d’informations pour enrichir les fiches d’informations lors de l’import. Découvrez-en davantage sur l’enrichissement des contacts et des entreprises.
  18. Dans l’angle inférieur droit, cliquez sur Terminer l’import.

Dépannage

Passez en revue les erreurs d’import courantes et les étapes pour les résoudre. Si vous rencontrez une autre erreur, vérifiez le formatage de votre fichier CSV et les mappages de propriétés, puis relancez l’import.

Remplacement de la date de début de la facturation dans le passé

L’erreur Remplacement de la date de début de la facturation dans le passé se produit lorsque la date de début de facturation d’une ligne de produit dans le CSV est passée.

Pour résoudre cette erreur :

  1. Mettez à jour toutes les dates de facturation à une date ultérieure.
  2. Enregistrez le fichier CSV et recommencez l’import.

ID de méthode de paiement Stripe non valide ou manquant

Cette erreur se produit lorsque l’option Paiements automatiques est sélectionnée comme processus de collecte, mais qu’aucun ID de méthode de paiement Stripe n’a été ajouté au fichier CSV.

Pour résoudre cette erreur :

  • Remplacer les saisies de paiements automatiques par des paiements manuels.
  • Ajoutez un ID de méthode de paiement Stripe pour les saisies de paiements automatiques dans le fichier CSV.

Dupliquer import_unique_id d’une tentative antérieure

Si un import échoue, HubSpot peut toujours enregistrer les import_unique_id valeurs de l’import ayant échoué.

Pour résoudre cette erreur :

  1. Mettez à jour votre fichier CSV avec de nouveaux identifiants.
  2. Importer le fichier CSV mis à jour.

Glossaire

Veuillez vérifier les conditions suivantes avant de migrer les contrats vers HubSpot.

Durée Description
Paiements automatiques Un processus de collecte dans le cadre duquel les factures sont automatiquement facturées à l’aide d’un mode de paiement enregistré.
Remplacement de la date de début de la facturation La date à laquelle HubSpot doit commencer à facturer le contrat migré.
Processus de collecte La façon dont les paiements sont collectés après la migration. Les paiements peuvent être collectés manuellement par l’acheteur ou automatiquement à l’aide d’un mode de paiement enregistré dans un fichier.
import_unique_id Une propriété personnalisée utilisée pour regrouper les lignes qui appartiennent à un même contrat lors de la migration.
Paiements manuels Un processus de collecte dans le cadre duquel les factures sont générées dans HubSpot et les acheteurs les payent manuellement.
Format de la migration La structure CSV utilisée pour l’import. Le format de migration dépend de la façon dont les paiements seront collectés et de la façon dont vous souhaitez ou non inclure la continuité des revenus.
MRR Revenu récurrent mensuel. Dans HubSpot, le MRR est utilisé pour déclarer les revenus récurrents provenant des contrats.
Cascade MRR Un rapport sur les revenus qui montre comment les revenus récurrents évoluent au fil du temps en raison d’événements tels que de nouveaux contrats, des mises à niveau, des expansions, des rétrogradations et des pertes de clients.
ID du mode de paiement Référence de la méthode de paiement externe utilisée pour les contrats avec paiements automatiques.
Rampe Il s’agit d’un changement de prix ou de quantité qui se produit au cours d’un contrat.
Clé de rampe Valeur utilisée pour regrouper les lignes de ligne de produit associées dans une rampe.
Phase de rampe Une période dans une rampe. Chaque phase a sa propre durée, son propre prix, sa propre quantité et sa propre date de début.
ramp_key_import_id Une propriété de ligne de produit personnalisée utilisée pour regrouper les lignes de ligne de produit en phases de rampe pendant la migration.
Continuité des revenus Une option qui inclut les modifications historiques de contrat, telles que les mises à niveau, les extensions ou les déclassements, afin qu’elles puissent être prises en compte dans les rapports de chiffre d’affaires.
Système d’enregistrement Le système principal utilisé pour gérer et conserver les informations contractuelles et de facturation après la migration.
Cet article vous a-t-il été utile ?
Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.