Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak.

Contracten overzetten naar HubSpot

Laatst bijgewerkt: 23 juli 2026

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Revenue Hub Professional, Enterprise

Vereiste seats

Abonnement vereist A Revenue Hub -abonnement is vereist om contracten te migreren.

Vereiste seats Een Revenue Hub licentie vereist om contracten te migreren.

Machtigingen vereist Superbeheerdersrechten zijn vereist om de migratie uit te voeren.

Migreer bestaande contracten vanuit een verouderd systeem naar HubSpot om facturering, facturen en omzetrapportage te beheren. Bij de migratie blijven betaalmethoden, contractgeschiedenis en toekomstige factureringsschema’s behouden. Na de migratie kun je HubSpot gebruiken als de centrale bron van waarheid voor vastgelegde omzet. Lees meer over het gebruik van contracten in HubSpot.

Voordat je aan de slag gaat

Zorg ervoor dat je, voordat je met deze functie aan de slag gaat, volledig begrijpt welke stappen je van tevoren moet nemen, wat de beperkingen van de functie zijn en wat de mogelijke gevolgen van het gebruik ervan zijn.

Zorg dat je de vereisten begrijpt

Let op: als u een superbeheerder, kun je je account aanmelden voor de Betaalmigraties naar Revenue Hub-contracten .
Je HubSpot-account moet Stripe als betalingsverwerkingsoptiegebruiken . Als je HubSpot Payments gebruikt en betaalmethoden van een extern Stripe-account naar HubSpot Payments wilt migreren, vul dandit formulier in .
Maak de CSV op basis van het incassoproces en de optie voor inkomstencontinuïteit die je selecteert. Lees meer over het kiezen van het migratieformaat dat het meest geschikt is voor je bedrijf.

Zorg dat je de beperkingen en aandachtspunten begrijpt

Als je gebruikmaakt van omzetcontinuïteit, test de import dan in een sandbox-omgeving. Als er onjuiste gegevens in je account worden geïmporteerd, kun je historische gegevens in MRR-watervalrapporten niet corrigeren.
Zodra een contract is geactiveerd, wordt HubSpot het officiële systeem voor facturering. De migratie kan niet ongedaan worden gemaakt.
Eventuele contractwijzigingen moeten in HubSpot worden doorgevoerd. Lees meer over het bekijken en beheren van contracten.
Na activering kunt u de 'Billing Start Date Override' en de 'Payment Method ID' alleen bijwerken als het contract geen betaalde facturen of betalingen bevat.

Kies het migratieformaat

Selecteer vóór de migratie een migratieformaat op basis van hoe u wilt dat HubSpot contracten na de migratie beheert. Het migratieformaat hangt af van het verzamelproces en of u historische contractwijzigingen (bijv. upgrades of uitbreidingen) wilt opnemen.

Inningproces

Handmatige betalingen: na de migratie worden facturen gegenereerd die kopers handmatig moeten betalen.
Automatische betalingen: na de migratie worden facturen automatisch in rekening gebracht via een geregistreerde betaalmethode.

Continuïteit van de inkomsten

Geen omzetcontinuïteit: contracten worden geïmporteerd zonder gebeurtenissen die de omzet beïnvloeden.
Omzetcontinuïteit: gebruik 'ramp keys' om regelitems in fasen te groeperen en wijzigingsgebeurtenissen (bijv. upgrades, uitbreidingen, downgrades) weer te geven in de MRR-waterval in HubSpot. Als je gebruikmaakt van omzetcontinuïteit, test de import dan in een sandbox-omgeving. Als er onjuiste gegevens in je account worden geïmporteerd, kun je historische gegevens in MRR-watervalrapporten niet corrigeren.

Ramps

Ramp-sleutels

Ramp-sleutels groeperen meerdere regelitems in fasen. Rijen met dezelfde ramp-sleutel worden behandeld als één doorlopende ramp.

In HubSpot genereert elke rampfase MRR-gebeurtenissen (bijv. nieuwe klant, upgrade, uitbreiding) zodra die fase begint. De ramp-sleutel kan elke willekeurige tekstreeks zijn (bijv. ramp-a). Dezelfde tekstreeks moet in alle rijen van die ramp worden gebruikt.

Een ramp structureren

Om ramps succesvol te migreren, structureer je ze als volgt:

Niet-overlappende datumbereiken: de looptijden van elke rij mogen niet overlappen met die van een andere rij. Als de ramp-fasen aaneengesloten moeten zijn, moet elke fase beginnen wanneer de vorige fase eindigt.
Looptijd per fase: de looptijd in elke rij heeft alleen betrekking op die fase van het contract, niet op de volledige contractduur.
Totale hoeveelheid per rij: voer de totale hoeveelheid voor de regelitem in tijdens die fase
Import-ID van de ramp-sleutel: groepeert de regelitems onder dezelfde ramp. Lees meer over het aanmaken van een aangepaste ramp-eigenschap.

Let op:

Een contract kan zowel line items met een opbouwfase als line items zonder opbouwfase bevatten. Laat voor line items zonder opbouwfase het veld ` ramp_key_import_id leeg en gebruik dezelfde ` import_unique_id als de bijbehorende contractrijen.
Een contract kan meerdere producten bevatten die onafhankelijk van elkaar een ramp-periode doorlopen. Elk product moet zijn eigen ` ramp_key_import_id` hebben. Elke ramp genereert zijn eigen MRR-gebeurtenissen.

Bijvoorbeeld voor een contract van 12 maanden met een prijswijziging na drie maanden:

Regelpost	Eenheidsprijs	Aantal	Looptijd	Startdatum	ramp_key_import_id
Maandelijkse service	$100	1	3 maanden	1 januari 2026	`ramp-a`
Maandelijkse service	$100	2	9 maanden	1 april 2026	`ramp-a`

Mogelijke migratieformaten

Migratieformaat	Inningproces	Inkomstencontinuïteit
Handmatige betalingen zonder inkomstencontinuïteit	Handmatige betalingen	Niet inbegrepen
Handmatige betalingen met inkomstencontinuïteit	Handmatige betalingen	Inbegrepen
Automatische betalingen zonder inkomstencontinuïteit	Automatische betalingen	Niet inbegrepen
Automatische betalingen met inkomstencontinuïteit	Automatische betalingen	Inbegrepen

Voorbereiding op de migratie

Stel, voordat u met de migratie begint, uw account in en bereid uw CSV-bestand voor op basis van het geselecteerde migratieformaat.

Aangepaste eigenschappen aanmaken

Maak de vereiste aangepaste eigenschappen aan voordat u uw CSV-bestand importeert. Welke eigenschappen u moet aanmaken, hangt af van het geselecteerde migratieformaat. Lees meer over het aanmaken van aangepaste eigenschappen.

Migratieformaat	Object	Aangepaste eigenschapnaam	Aangepast eigenschapstype	Validatieregels	Gebruikt voor
Alle opties	Contracten	`import_unique_id`	Tekst op één regel	Vereist unieke waarden	Groepeert alle rijen die bij hetzelfde contract horen.
Handmatige betalingen met inkomstencontinuïteit of Automatische betalingen met inkomstencontinuïteit	Regelitems	`ramp_key_import_id`	Tekst op één regel	Geen	Groepeert meerdere regelitemrijen in fasen.

Configureer het CSV-bestand

Configureer het CSV-bestand dat u met de importtool gaat gebruiken om contracten naar HubSpot te migreren.

Voorbeeld-CSV-bestanden

Gebruik de onderstaande voorbeeld-CSV-bestanden, afhankelijk van het migratieformaat dat je gebruikt.

Migratieformaat	CSV-link
Handmatige betalingen, geen continuïteit in de inkomsten	Download
Handmatige betalingen met inkomstencontinuïteit	Download
Automatische betalingen, geen continuïteit van inkomsten	Download
Automatische betalingen met inkomstencontinuïteit	Download
Gemengd: één product met oplopende tarieven en één product met een vast bedrag (zonder opbouwcode)	Download
Meerdere onafhankelijke ramps: Product A (`ramp-a`) en Product B (`ramp-b`) lopen afzonderlijk op	Download

CSV-indeling

Je CSV-bestand moet de volgende kolommen en HubSpot-eigenschappen bevatten.

Kolomnaam	Object	Eigenschap	Details
Ingangsdatum contract	Contract	`hs_contract_effective_date`	De datum waarop het contract rechtsgeldig wordt.
Valutacode	Contract	`hs_currency_code`	Valutacode, bijvoorbeeld USD.
Naam	Contract	`hs_name`	Naam van het contract.
HubSpot-facturering ingeschakeld	Contract	`hs_hubspot_billing_enabled`	Moet `TRUE` zijn voor alle contracten die worden gemigreerd.
Inningproces	Contract	`hs_collection_process`	Handmatig of automatisch. Moet overeenkomen met het migratieformaat.
Overschrijving van de startdatum van de facturering	Contract	`hs_billing_start_date_override`	De datum waarop HubSpot begint met factureren. Bij migratie moet dit een datum in de toekomst zijn. Vereist voor alle migratieformaten.
ID van de betaalmethode	Contract	`hs_external_payment_method_reference_id`	Laat leeg voor handmatige betalingen. Vereist voor automatische betalingen.
E-mail	Contact	`email`	Het e-mailadres van de contactpersoon voor facturering.
Voornaam	Contact	`firstname`	Voornaam van de contactpersoon voor de facturering.
Achternaam	Contact	`lastname`	Achternaam van de contactpersoon voor de facturering.
Product	Regel	`hs_product_id`	Record-ID van het product. De migratie verwijst naar een bestaand productrecord en maakt geen nieuw product aan
Naam van de regelitem	Regel	`name`	Naam van de regelitem.
Eenheidsprijs	Regel	`price`	Prijs per eenheid in de contractvaluta.
Aantal	Regel	`quantity`	De hoeveelheid van de regelitem tijdens een fase.
import_unique_id	Regel	Aangepaste eigenschap	Gedeelde ID voor alle rijen in hetzelfde contract.
Term	Regelpost	`hs_recurring_billing_period`	De looptijd van de regelitem. Bij gebruik van opbouwperioden voert u de looptijd voor elk segment in.
Frequentie van terugkerende facturering	Regelpost	`recurringbillingfrequency`	Factureringsfrequentie (bijv. maandelijks).
Startdatum van de regelitem	Regel	`hs_recurring_billing_start_date`	Startdatum van de facturering voor de post.
ramp_key_import_id	Regel	Aangepaste eigenschap	Groepeert de fasen van de regelitem in één opbouw. Vereist voor omzetcontinuïteit. Laat dit veld leeg voor migratieformaten zonder omzetcontinuïteit.

Start de migratie

Nadat je je CSV-bestand hebt geconfigureerd, kun je beginnen met het migreren van contracten naar HubSpot.

Klik in je HubSpot-account op Meer en navigeer vervolgens naar Omzet > Contracten. Als Meer niet in je account verschijnt, navigeer dan direct naar Omzet > Contracten.
Klik rechtsboven op Importeren.
Klik in het gedeelte Een bestand importeren op Gegevens importeren.
Klik op Geavanceerde importen (alle objecten).
Klik onder 'Objecten' op 'Contracten'. Het object 'Regelitems' wordt automatisch geselecteerd.
Klik rechtsonder op Volgende.
Stel in hoe u uw gegevens wilt importeren:
- Een bestand uploaden: sleep het bestand naar het venster of klik op 'Een bestand kiezen' en selecteer vervolgens uw importbestand.
- Kopiëren en plakken: klik op 'Direct vanuit uw spreadsheet plakken' en plak uw gegevens. De gegevens moeten worden gekopieerd vanuit een spreadsheetbestand (bijv. Numbers, Google Sheets).
- Taal: als u gegevens importeert in een andere taal dan uw standaardtaal, klikt u op het vervolgkeuzemenu 'Selecteer de taal van de kolomkoppen in uw bestand' en selecteert u de taal. Door de juiste taal te selecteren, kan HubSpot uw kolomkoppen beter koppelen aan bestaande standaardkenmerken. Als er geen overeenkomst is in de door u geselecteerde taal, zoekt HubSpot naar een Engels kenmerk dat overeenkomt.
Klik rechtsonder op ‘Volgende’.
Koppel de kolommen in het importbestand aan HubSpot-eigenschappen. Lees meer over de CSV-eigenschapskoppelingen.
Klik rechtsonder op 'Volgende'.
Voer in het veld 'Importnaam' een naam in voor de import.
Klik op het vervolgkeuzemenu 'Selecteer de rechtsgrondslag voor de verwerking van de gegevens van een contactpersoon' en selecteer een rechtsgrondslag. Lees meer over het bijhouden van de rechtsgrondslag voor verwerking in HubSpot.
Klik op het vervolgkeuzemenu 'Datumnotatie' en selecteer een datumnotatie.
Klik op het vervolgkeuzemenu 'Tijdzone' en selecteer een tijdzone.
Klik op het vervolgkeuzemenu 'Getalnotatie' en selecteer een getalnotatie.
Schakel het selectievakje 'Deze contacten instellen als marketingcontacten' in als je de geïmporteerde contacten wilt benaderen met behulp van de marketingtools van HubSpot. Lees meer over marketingcontacten.
Vink het selectievakje ‘Records aanvullen’ aan om records tijdens het importeren aan te vullen. Lees meer over het aanvullen van contact- en bedrijfsgegevens.
Klik rechtsonder op 'Import voltooien'.

Problemen oplossen

Bekijk veelvoorkomende importfouten en de stappen om deze op te lossen. Als je een andere fout tegenkomt, controleer dan de opmaak van je CSV-bestand en de toewijzingen van de eigenschappen, en probeer de import vervolgens opnieuw.

Overschrijving van de factureringsstartdatum in het verleden

De fout 'Factureringsstartdatum ligt in het verleden' treedt op wanneer de factureringsstartdatum van een regel in het CSV-bestand in het verleden ligt.

Om deze fout op te lossen:

Wijzig eventuele factuurdata in een datum in de toekomst.
Sla het CSV-bestand op en start het importeren opnieuw.

Ongeldige of ontbrekende Stripe-betaalmethode-ID

Deze fout treedt op wanneer de optie 'automatische betalingen' is geselecteerd als incassoproces, maar er geen Stripe-betaalmethode-ID aan het CSV-bestand is toegevoegd.

Om deze fout op te lossen, kunt u het volgende doen:

Wijzig automatische betalingen in handmatige betalingen.
Voeg een Stripe-betalingsmethode-ID toe voor automatische betalingen in het CSV-bestand.

Kopieer de `import_unique_id` van een eerdere poging

Als een import mislukt, kan HubSpot de `import_unique_id `-waarden van de mislukte import nog steeds registreren.