- Base de connaissances
- Chiffre d'affaires
- Contrats
- Migrer des contrats vers HubSpot
BêtaMigrer des contrats vers HubSpot
Dernière mise à jour: 23 juillet 2026
Disponible avec le ou les abonnements suivants, sauf mention contraire :
-
Revenue Hub Pro, Enterprise
-
Licences utilisateurs requises
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
-
Remarque : Si vous êtes un super administrateur, vous pouvez inscrire votre compte à la version bêta des migrations de facturation vers des contrats Revenue Hub.
-
Votre compte HubSpot doit utiliser Stripe comme option de traitement des paiements. Si vous utilisez l’outil de paiement de HubSpot et que vous souhaitez migrer les moyens de paiement d’un compte Stripe externe vers l’outil de paiement de HubSpot, veuillez remplir ce formulaire.
-
Formatez le fichier CSV en fonction du processus de collecte des paiements et de l’option de continuité des revenus que vous sélectionnez. Découvrez comment choisir le format de migration le mieux adapté à votre entreprise.
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_idvide et utilisez la mêmeimport_unique_idchose 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. |
| 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.
- 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.
- Cliquez sur Importer dans l'angle supérieur droit.
- Dans la section Importer un fichier , cliquez sur Importer des données.
- Cliquez sur Imports avancés (tous les objets).
- Sous Objets, cliquez sur Contrats. L’objet « lignes de produit » sera sélectionné automatiquement.
- Dans l'angle inférieur droit, cliquez sur Suivant.
- 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.
- Dans l'angle inférieur droit, cliquez sur Suivant.
- 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.
- Dans l'angle inférieur droit, cliquez sur Suivant.
- Dans le champ Nom de l’import , saisissez un nom pour l’import.
- 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.
- Cliquez sur le menu déroulant Format de date et sélectionnez un format de date.
- Cliquez sur le menu déroulant Fuseau horaire et sélectionnez un fuseau horaire.
- Cliquez sur le menu déroulant Format de nombre et sélectionnez un format de nombre.
- 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.
- 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.
- 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 :
- Mettez à jour toutes les dates de facturation à une date ultérieure.
- 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 :
- Mettez à jour votre fichier CSV avec de nouveaux identifiants.
- 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. |