Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt.

Verträge nach HubSpot migrieren

Zuletzt aktualisiert am: 23 Juli 2026

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Revenue Hub Professional, Enterprise

Lizenzen erforderlich

Abonnement erforderlich Für die Migration von Verträgen ist ein Revenue Hub-Abonnement erforderlich.

Lizenzen erforderlich Für die Migration von Verträgen ist eine Revenue Hub-Lizenz erforderlich.

Berechtigungen erforderlich Super-Admin-Berechtigungen sind erforderlich, um die Migration durchzuführen.

Migrieren Sie bestehende Verträge von einem Legacy-System zu HubSpot, um Abrechnung, Rechnungsstellung und Umsatzberichte zu verwalten. Bei der Migration bleiben Zahlungsmethoden, Vertragsverlauf und zukünftige Abrechnungspläne erhalten. Nach der Migration können Sie HubSpot als zentrale Datenquelle für verbindliche Umsätze nutzen. Erfahren Sie mehr über die Verwendung von Verträgen in HubSpot.

Bevor Sie loslegen

Bevor Sie mit dieser Funktion beginnen, sollten Sie sich im Voraus darüber im Klaren sein, welche Schritte unternommen werden sollten und welche Einschränkungen die Funktion mit sich bringt und welche Konsequenzen sich daraus ergeben können.

Dies sind die Voraussetzungen:

Bitte beachten: Wenn Sie ein Super-Admin sind, können Sie Ihren Account für die Beta-Version der Migrationen der Abrechnungsmigration zu Revenue Hub-Verträgen anmelden.
Ihr HubSpot-Account muss Stripe als Option für die Zahlungsabwicklung verwenden. Wenn Sie das Payments-Tool von HubSpot verwenden und Zahlungsmethoden von einem externen Stripe-Konto zum Payments-Tool von HubSpot migrieren möchten, füllen Sie dieses Formular aus.
Formatieren Sie die CSV-Datei basierend auf dem von Ihnen gewählten Zahlungseinzugsprozess und der Option "Umsatzkontinuität". Erfahren Sie mehr über die Auswahl des für Ihr Unternehmen am besten geeigneten Migrationsformats.

Einschränkungen und Wissenswertes

Wenn Sie Umsatzkontinuität verwenden, testen Sie den Import in einer Sandbox-Umgebung. Wenn falsche Daten in Ihren Account importiert werden, können Sie Verlaufsdaten in MRR-Wasserfallberichten nicht korrigieren.
Sobald ein Vertrag aktiviert ist, wird HubSpot zum Aufzeichnungssystem für die Abrechnung. Die Migration kann nicht rückgängig gemacht werden.
Alle Vertragsaktualisierungen müssen in HubSpot vorgenommen werden. Erfahren Sie mehr über das Anzeigen und Verwalten von Verträgen.
Nach der Aktivierung können Sie das Startdatum der Abrechnung und die Zahlungsmethoden-ID nur dann aktualisieren, wenn der Vertrag keine bezahlten Rechnungen oder Zahlungen enthält.

Wählen Sie das Migrationsformat aus

Wählen Sie vor der Migration ein Migrationsformat aus, das darauf basiert, wie HubSpot Verträge nach der Migration verwalten soll. Das Format der Migration hängt vom Erfassungsprozess ab und davon, ob Sie vergangene Vertragsänderungsereignisse (z. B. Upgrades oder Erweiterungen) einbeziehen möchten.

Prozess des Zahlungseinzugs

Manuelle Zahlungen: Nach der Migration werden Rechnungen für Käufer generiert, die manuell bezahlen müssen.
Automatische Zahlungen: Nach der Migration werden die Rechnungen automatisch mit einer hinterlegten Zahlungsmethode belastet.

Kontinuität der Einnahmen

Keine Umsatzkontinuität: Verträge werden ohne Umsatzänderungsereignisse importiert.
Umsatzkontinuität: Verwenden Sie Ramp-Schlüssel, um Artikel in Phasen zu gruppieren und Änderungsereignisse (z. B. Upgrades, Erweiterungen, Downgrades) im MRR-Wasserfall in HubSpot anzuzeigen. Wenn Sie Umsatzkontinuität verwenden, testen Sie den Import in einer Sandbox-Umgebung. Wenn falsche Daten in Ihren Account importiert werden, können Sie Verlaufsdaten in MRR-Wasserfallberichten nicht korrigieren.

Rampen

Rampenschlüssel

Rampenschlüssel gruppieren mehrere Zeilen von Artikeln in Phasen. Zeilen mit demselben Rampenschlüssel werden als eine kontinuierliche Rampe behandelt.

In HubSpot generiert jede Einarbeitungsphase zu Beginn jeder Phase MRR-Events (z. B. Neugeschäfte, Upgrades, Erweiterungen). Der Rampenschlüssel kann eine beliebige Textzeichenfolge sein (z. B. ramp-a). Die gleiche Zeichenfolge muss für alle Zeilen dieser Rampe freigegeben sein.

Strukturierung einer Rampe

Um Rampen erfolgreich zu migrieren, strukturieren Sie sie wie folgt:

Nicht überlappende Datumsbereiche: Die Laufzeiten jeder Zeile dürfen sich nicht mit den Laufzeiten einer anderen Zeile überschneiden. Wenn die Einarbeitungsphasen kontinuierlich sein müssen, sollte jede Phase mit dem Ende der vorherigen Phase beginnen.
Laufzeiten pro Phase: Die Laufzeit jeder Zeile deckt nur diese Phase des Vertrags ab, nicht die gesamte Vertragslaufzeit.
Gesamtmenge in jeder Zeile: Geben Sie die Gesamtmenge für den Artikel während dieser Phase ein
Import-ID des Rampenschlüssels: gruppiert die Artikel unter derselben Rampe. Erfahren Sie mehr über das Erstellen einer benutzerdefinierten Rampen-Eigenschaft .

Bitte beachten:

Ein Vertrag kann Positionen mit und ohne Rampe enthalten. Lassen Sie bei nicht rampierten Artikeln das ramp_key_import_id Feld leer und verwenden Sie dasselbe import_unique_id wie die zugehörigen Vertragszeilen.
Ein Vertrag kann mehrere Produkte haben, die unabhängig voneinander hochgefahren werden. Jedes Produkt muss sein eigenes ramp_key_import_idhaben. Jede Rampe generiert ihre eigenen MRR-Events.

Zum Beispiel gilt für einen 12-Monats-Vertrag mit einer Preisänderung nach drei Monaten:

Produkt/Artikel	Einzelpreis	Menge	Laufzeit	Startdatum	ramp_key_import_id
Monatlicher Service	100 $	1	3 Monate	1. Januar 2026	`ramp-a`
Monatlicher Service	100 $	2	9 Monate	1. April 2026	`ramp-a`

Mögliche Migrationsformate

Format der Migration	Inkassoprozess	Kontinuität der Einnahmen
Manuelle Zahlungen ohne Umsatzunterbrechung	Manuelle Zahlungen	Nicht inbegriffen
Manuelle Zahlungen mit Umsatzkontinuität	Manuelle Zahlungen	Inbegriffen
Automatische Zahlungen ohne Umsatzunterbrechung	Automatische Zahlungen	Nicht inbegriffen
Automatische Zahlungen mit Revenue Continuity	Automatische Zahlungen	Inklusive

Bereiten Sie sich auf die Migration vor

Bevor Sie mit der Migration beginnen, richten Sie Ihr Konto ein und bereiten Sie Ihre CSV-Datei auf der Grundlage des gewählten Migrationsformats vor.

Benutzerdefinierte Eigenschaften erstellen

Erstellen Sie die erforderlichen benutzerdefinierten Eigenschaften, bevor Sie Ihre CSV-Datei importieren. Die Eigenschaften, die Sie erstellen müssen, hängen vom ausgewählten Migrationsformat ab. Erfahren Sie mehr über das Erstellen von benutzerdefinierten Eigenschaften.

Format der Migration	Objekt	Name der benutzerdefinierten Eigenschaft	Typ der benutzerdefinierten Eigenschaft	Validierungsregeln	Verwendet für
Alle Optionen	Verträge	`import_unique_id`	Einzeiliger Text	Eindeutige Werte verlangen	Gruppiert alle Zeilen, die zum selben Vertrag gehören.
Manuelle Zahlungen mit Umsatzkontinuität oder Automatische Zahlungen mit Umsatzkontinuität	Artikel	`ramp_key_import_id`	Einzeiliger Text	Keine	Gruppiert mehrere Artikelzeilen in Phasen.

Konfigurieren der CSV-Datei

Konfigurieren Sie die CSV-Datei zur Verwendung mit dem Importtool, um Verträge nach HubSpot zu migrieren.

CSV-Beispieldateien

Verwenden Sie je nach verwendetem Migrationsformat die folgenden CSV-Beispieldateien.

Format der Migration	CSV-Link
Manuelle Zahlungen, keine Umsatzkontinuität	Herunterladen
Manuelle Zahlungen mit Umsatzkontinuität	Herunterladen
Automatische Zahlungen, keine Umsatzunterbrechung	Herunterladen
Automatische Zahlungen mit Revenue Continuity	Herunterladen
Gemischt: ein Produkt mit Rampe und ein Produkt mit Pauschalgebühr (ohne Rampenschlüssel)	Herunterladen
Mehrere unabhängige Rampen: Produkt A (`ramp-a`) und Produkt B (`ramp-b`) getrennt	Herunterladen

CSV-Format

Ihre CSV-Datei sollte die folgenden Spalten und HubSpot-Eigenschaften enthalten.

Name der Spalte	Objekt	Eigenschaft	Details
Datum des Inkrafttretens des Vertrags	Vertrag	`hs_contract_effective_date`	Das Datum, an dem der Vertrag rechtswirksam wird.
Währungscode	Vertrag	`hs_currency_code`	Währungscode, z. B. USD
Vor- und Nachname	Vertrag	`hs_name`	Vertragsname.
HubSpot-Abrechnung aktiviert	Vertrag	`hs_hubspot_billing_enabled`	Muss für alle zu migrierenden Verträge gelten `TRUE` .
Inkassoprozess	Vertrag	`hs_collection_process`	Manuell oder automatisch. Muss mit dem Migrationsformat übereinstimmen.
Startdatum der Abrechnung überschreiben	Vertrag	`hs_billing_start_date_override`	Das Datum, an dem HubSpot mit der Abrechnung beginnt. Dies muss ein zukünftiges Datum bei der Migration sein. Erforderlich für alle Migrationsformate.
ID der Zahlungsmethode	Vertrag	`hs_external_payment_method_reference_id`	Lassen Sie diese Angabe für manuelle Zahlungen leer. Erforderlich für automatische Zahlungen.
E-Mail	Kontakt	`email`	Die E-Mail-Adresse des Abrechnungskontakts.
Vorname	Kontakt	`firstname`	Vorname des Abrechnungskontakts.
Nachname	Kontakt	`lastname`	Nachname des Abrechnungskontakts.
Produkt	Produkt/Artikel	`hs_product_id`	Datensatz-ID des Produkts. Die Migration verweist auf einen vorhandenen Produktdatensatz, erstellt jedoch kein neues Produkt
Name des Artikels	Produkt/Artikel	`name`	Name des Artikels.
Einzelpreis	Produkt/Artikel	`price`	Preis pro Einheit in der Vertragswährung.
Menge	Produkt/Artikel	`quantity`	Die Menge der Artikel während einer Phase.
import_unique_id	Produkt/Artikel	Benutzerdefinierte Eigenschaften	Geteilte ID für alle Zeilen im gleichen Vertrag.
Laufzeit	Produkt/Artikel	`hs_recurring_billing_period`	Die Laufzeit des Artikels. Wenn Sie Rampen verwenden, geben Sie den Begriff für jedes Segment ein.
Frequenz für wiederholte Abrechnung	Produkt/Artikel	`recurringbillingfrequency`	Abrechnungsfrequenz (z. B. monatlich).
Startdatum des Artikels	Produkt/Artikel	`hs_recurring_billing_start_date`	Startdatum der Abrechnung für den Artikel.
ramp_key_import_id	Produkt/Artikel	Benutzerdefinierte Eigenschaften	Gruppiert Artikelphasen in eine Rampe. Erforderlich für die Kontinuität des Umsatzes. Lassen Sie dieses Feld leer für Migrationsformate ohne Umsatzkontinuität.

Beginnen Sie mit der Migration

Nachdem Sie Ihre CSV-Datei konfiguriert haben, können Sie mit der Migration der Verträge nach HubSpot beginnen.

Klicken Sie in Ihrem HubSpot-Account auf Mehr und gehen Sie dann zu Umsatz > Verträge. Wenn Mehr nicht in Ihrem Account angezeigt wird, gehen Sie direkt zu Umsatz > Verträge.
Klicken Sie oben rechts auf Importieren.
Klicken Sie im Abschnitt Datei importieren auf Daten importieren.
Klicken Sie auf Erweiterte Importe (alle Objekte).
Klicken Sie unter Objekte auf Verträge. Das Artikelobjekt wird automatisch ausgewählt.
Klicken Sie unten rechts auf „Weiter“.
Konfigurieren Sie, wie Sie Ihre Daten importieren möchten:
- Datei hochladen: Ziehen Sie eine Datei per Drag-&-Drop hierher oder klicken Sie auf Datei auswählen und wählen Sie dann Ihre Importdatei aus.
- Kopieren und Einfügen: Klicken Sie auf "Direkt aus Ihrer Tabelle einfügen " und fügen Sie Ihre Daten ein. Die Daten müssen aus einer Tabellenkalkulation kopiert werden (z. B. Numbers, Google Sheets).
- Sprache: Wenn Sie Daten in einer anderen Sprache als Ihrer Standardsprache importieren, klicken Sie auf das Dropdown-Menü Sprache der Spaltenüberschriften in Ihrer Datei auswählen und wählen Sie die Sprache aus. Die Auswahl der richtigen Sprache ermöglicht es HubSpot, Ihre Spaltenüberschriften besser mit bestehenden Standardeigenschaften abzugleichen. Wenn in Ihrer ausgewählten Sprache keine Übereinstimmung vorhanden ist, sucht HubSpot nach der Eigenschaft „Englisch“ zum Abgleichen.
Klicken Sie unten rechts auf „Weiter“.
Ordnen Sie die Spalten in der Importdatei HubSpot-Eigenschaften zu. Erfahren Sie mehr über die CSV-Eigenschaften-Zuordnungen.
Klicken Sie unten rechts auf „Weiter“.
Geben Sie im Feld Importname einen Namen für den Import ein.
Klicken Sie auf das Dropdown-Menü Rechtliche Grundlage für die Verarbeitung der Kontaktdaten auswählen und wählen Sie eine rechtliche Grundlage aus. Erfahren Sie mehr über das Nachverfolgen der rechtlichen Grundlage für die Verarbeitung von Daten in HubSpot.
Klicken Sie auf das Dropdown-Menü Datumsformat und wählen Sie ein Datumsformat aus.
Klicken Sie auf das Dropdown-Menü Zeitzone und wählen Sie eine Zeitzone aus.
Klicken Sie auf das Dropdown-Menü Zahlenformat und wählen Sie ein Zahlenformat aus.
Aktivieren Sie das Kontrollkästchen Diese Kontakte als Marketingkontakte einstufen , wenn Sie mit den importierten Kontakten mithilfe der Marketingtools von HubSpot interagieren möchten. Erfahren Sie mehr über Marketingkontakte.
Aktivieren Sie das Kontrollkästchen Datensätze anreichern , um Datensätze während des Imports anzureichern. Erfahren Sie mehr über Kontakt- und Unternehmens-Anreicherung.
Klicken Sie unten rechts auf Importvorgang abschließen.

Fehlerbehebung

Sehen Sie sich häufige Importfehler und die Schritte zu deren Behebung an. Wenn ein weiterer Fehler auftritt, überprüfen Sie die CSV-Formatierung und die Eigenschaftszuordnungen und versuchen Sie den Import dann erneut.

Startdatum der Abrechnung in der Vergangenheit überschrieben

Der Fehler " Startdatum der Abrechnung in der Vergangenheit überschreiben " tritt auf, wenn das Startdatum der Abrechnung eines Artikels in der CSV-Datei in der Vergangenheit liegt.

So können Sie diesen Fehler beheben:

Aktualisieren Sie alle Abrechnungsdaten auf ein zukünftiges Datum.
Speichern Sie die CSV-Datei und starten Sie den Import erneut.

Ungültige oder fehlende ID der Stripe-Zahlungsmethode

Dieser Fehler tritt auf, wenn die Option "Automatische Zahlungen" als Einzugsprozess ausgewählt ist, jedoch keine Stripe-Zahlungsmethoden-ID zur CSV-Datei hinzugefügt wurde.

Um diesen Fehler zu beheben, können Sie entweder:

Ändern Sie automatische Zahlungen in manuelle Zahlungen.
Fügen Sie eine Stripe-Zahlungsmethoden-ID für automatische Zahlungen in der CSV-Datei hinzu.

Duplizierte import_unique_id von einem früheren Versuch

Wenn ein Import fehlschlägt, registriert HubSpot möglicherweise dennoch die import_unique_id Werte aus dem fehlgeschlagenen Import.