Zum Hauptinhalt
Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt. Er wurde automatisch mit einer Software übersetzt und unter Umständen nicht korrekturgelesen. Die englischsprachige Fassung gilt als offizielle Version und Sie können dort die aktuellsten Informationen finden. Hier können Sie darauf zugreifen.

Verträge nach HubSpot migrieren

Zuletzt aktualisiert am: 21 September 2026

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

Abonnement erforderlich Für den Import von Verträgen ist ein Revenue Hub-Abonnement erforderlich, es sei denn, Sie sind für die Beta-Version der direkten Erstellung, Bearbeitung und Verlängerung von HubSpot-Verträgen angemeldet.

Berechtigungen erforderlich Um Verträge zu importieren und zu migrieren, sind Importberechtigungen und Bearbeitungsberechtigungen für Verträge erforderlich.

Zusammenfassung

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:

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.
  • Die Migration stoppt nicht die Abrechnung im alten System.

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. Erweiterungen und Kontraktionen) 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. Erweiterungen und Kontraktionen) im MRR-Wasserfall in HubSpot anzuzeigen.
    • Bei der Umsatzkontinuität werden wiederkehrende Umsatzänderungsereignisse für die Berichterstattung berücksichtigt. Historische Rechnungen oder Zahlungen werden nicht wiederhergestellt.
    • Wenn Sie Umsatzkontinuität verwenden, testen Sie den Import in einer Sandbox-Umgebung.
    • Wenn falsche Daten in Ihren Account importiert werden, können Sie historische Daten nur in MRR-Wasserfallberichten korrigieren, indem Sie den mit den falschen Daten verknüpften Vertrag löschen und erneut importieren.

Rampen

Rampenschlüssel

Rampenschlüssel gruppieren mehrere Zeilen von Artikeln in Phasen. Zeilen mit demselben Rampenschlüssel stellen einen kontinuierlichen, wiederkehrenden Stream dar, der sich im Laufe der Zeit ändert.

In HubSpot generiert jede Einarbeitungsphase zu Beginn jeder Phase MRR-Ereignisse (z. B. Neugeschäft, Expansion, Schrumpfung). Der Rampenschlüssel kann eine beliebige Textzeichenfolge sein (z. B. ramp-a). Verwenden Sie dieselbe Zeichenfolge für jede Phase derselben Rampe.

Strukturierung einer Rampe

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

  • Einen Rampenschlüssel für jeden wiederkehrenden Stream verwenden: Weisen Sie denselben Rampenschlüssel allen Phasen eines einzelnen Produkts oder Services zu.
  • Dieselbe Taste für aufeinanderfolgende Phasen verwenden: Wenn eine Phase für dasselbe Produkt oder dieselbe Dienstleistung auf eine andere folgt, verwenden Sie für beide Phasen denselben Rampenschlüssel.
  • Unterschiedliche Schlüssel für gleichzeitige Produkte verwenden: Wenn mehrere Produkte oder Services im gleichen Zeitraum unabhängig voneinander eingeführt werden, weisen Sie jedem anderen Produkt oder Service eine andere ramp_key_import_idzu.
  • Schlüssel leer lassen für flache Produkte: Wenn sich ein Produkt oder eine Dienstleistung während der Vertragslaufzeit nicht ändert, lassen Sie das ramp_key_import_id Feld leer.
  • Nicht überlappende Datumsbereiche verwenden: Datumsbereiche für Zeilen mit demselben Rampenschlüssel dürfen sich nicht überlappen. Starten Sie bei kontinuierlichen Phasen jede Phase, wenn die vorherige Phase endet.
  • Geben Sie den Gesamtstatus für jede Phase ein: Jede Phasenzeile muss die Gesamtmenge oder den Gesamtwert für diese Phase enthalten, nicht die Änderung gegenüber der vorherigen Phase. Wenn sich die Menge beispielsweise von eins auf zwei erhöht, geben Sie für die zweite Phase 1nicht 2 ein.
  • Verwenden Sie die Import-ID des Rampenschlüssels, um Phasen zu gruppieren: Geben Sie für alle Artikel in derselben Rampe denselben Wert ein ramp_key_import_id . 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.
  • 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 Inklusive
Automatische Zahlungen ohne Umsatzunterbrechung Automatische Zahlungen Nicht inbegriffen
Automatische Zahlungen mit Revenue Continuity Automatische Zahlungen Inklusive

Importbeispiele für monatliche und vierteljährliche Abrechnung

Verstehen Sie, wie Monats- und Quartalsverträge nach dem Import abgerechnet werden, basierend auf dem Datum des Inkrafttretens des Vertrags, dem Startdatum des Artikels und der Überschreibung des Startdatums der Abrechnung.

Eigenschaftsdefinitionen

Eigenschaft Typ Beschreibung
Datum des Inkrafttretens des Vertrags Rechtsabteilung Das ursprüngliche rechtliche und kommerzielle Datum des Vertragsbeginns, wie von beiden Parteien unterzeichnet. Wird für Audits, Umsatzrealisierungen und Berichte verwendet. Steuert nicht den Abrechnungszeitpunkt in HubSpot.
Startdatum des Artikels Abrechnungs-Anker Das Datum, das den Abrechnungszeitplan des Artikels verankert. Für wiederkehrende Artikel werden alle zukünftigen Abrechnungsintervalle ab diesem Datum berechnet. Beispielsweise wird ein vierteljährlicher Artikel, der am 1. Januar beginnt, immer am 1. Januar, 1. April, 1. Juli und 1. Oktober abgerechnet, unabhängig davon, wann die Migration stattfindet.
Begriff Dauer Die Gesamtlänge des Artikels oder der Einarbeitungsphase, ausgedrückt als ISO-8601-Dauer , z. B. P3M oder P1Y. Legt fest, wann der aktuelle Bindungszeitraum endet. Eine 12-monatige Amtszeit ab dem 1. Januar endet am 31. Dezember desselben Jahres.
Startdatum der Abrechnung überschreiben Überschreiben Das früheste Datum, an dem HubSpot die zukünftige Abrechnung für einen migrierten Vertrag veranlassen kann. Verhindert, dass HubSpot Rechnungen für Zeiträume erstellt, die bereits im alten System abgerechnet wurden. Dieses Feld setzt die Frequenz der wiederkehrenden Häufigkeit nicht zurück oder verschiebt sie nicht. Es legt fest, ab welchem Datum im nächsten Rhythmus HubSpot zuerst handelt.

Beispiele für monatliche und vierteljährliche Aktivitäten

Wenn die Überschreibung des Startdatums der Abrechnung zwischen zwei Kadenzterminen liegt, springt HubSpot zum nächsten geplanten Kadenzdatum nach der Überschreibung. Der Trittfrequenzanker (Startdatum des Artikels) wird nie verschoben.

Szenario Datum des Inkrafttretens des Vertrags Startdatum des Artikels Laufzeit Startdatum der Abrechnung überschreiben Erstes Abrechnungsdatum in HubSpot
Monatliche Migration während der Vertragslaufzeit 1. Januar 2024 1. Januar 2024 12 Monate 1. Juni 2024 1. Juni 2024
Monatlich, Überschreibung liegt zwischen den Kadenzdaten 15. März 2024 15. März 2024 12 Monate 20. Juli 2024 15. August 2024
Vierteljährlich, Überschreibung entspricht dem Rhythmus 1. Februar 2024 1. Februar 2024 12 Monate 1. August 2024 1. August 2024
Vierteljährlich, Überschreibung fällt Mitte des Quartals 1. Januar 2024 1. Januar 2024 12 Monate 15. April 2024 1. Juli 2024

Lifecycle einer Migration

Sehen Sie sich unten den vollständigen Lifecycle einer Vertragsmigration an:

Konfigurieren Sie eine CSV-Datei und verwenden Sie das Import-Tool, um sie nach HubSpot zu importieren. Weitere Informationen Konfigurieren einer CSV-Datei für den Import.

Verträge werden als Entwürfe erstellt. Überprüfen Sie etwaige Formatierungsprobleme. Erfahren Sie mehr über Überprüfung von Formatierungsproblemen.

Überprüfen Sie alle Validierungsfehler, bevor Sie Verträge für die Migration validieren. Erfahren Sie mehr über Validierung von Fehlern und Abschluss der Migration.

Die Vertragsmigration erfolgt und die Rechnungsstellung beginnt auf der Grundlage der Migrationsformat ausgewählt.

 

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. Im Folgenden erfahren Sie mehr über das Importverhalten bestimmter CSV-Felder, laden CSV-Beispieldateien herunter und verweisen darauf, wie eine CSV-Datei für einen Vertragsimport formatiert werden sollte.

Arten von Artikeln

Beim Import von Verträgen wird jede Zeile in Ihrer CSV-Datei als einer von zwei Artikeltypen behandelt, je nachdem, ob das Feld Produkt ausgefüllt wird.

  • Produktgestützt: Das Feld Produkt enthält die Datensatz-ID eines vorhandenen HubSpot-Produkts. Wenn unterstützte Felder (z. B. Preismodell, Stufen, Preis, Laufzeit, Abrechnungsfrequenz oder Steuerkategorie) in der CSV-Datei leer bleiben, übernimmt die Zeile diese Werte vom verknüpften Produkt.

  • Eigenständig: Das Feld Produkt bleibt leer. Die Zeile verwendet nur die in der CSV-Datei angegebenen Werte und der Artikel ist mit keinem Produkt in Ihrem Katalog verknüpft.

Bitte beachten: Wenn eine produktgestützte Zeile auf ein wiederkehrendes Produkt verweist, aber die Wiederholungsfelder leer lässt, kann sie die Konfiguration der wiederkehrenden Abrechnungshäufigkeit des Produkts übernehmen, auch wenn die Gebühr als einmalig beabsichtigt war.

Dauerhafte Verträge

Ein wiederkehrender Dauerartikel hat eine wiederkehrende Abrechnungsfrequenz und keine Laufzeit. Es verlängert sich automatisch bis zur Kündigung und hat kein wiederkehrendes Enddatum für die Abrechnung. Solange der Vertrag aktiv ist, wird die Abrechnung gemäß der Abrechnungsfrequenz fortgesetzt, bis der Vertrag gekündigt oder gekündigt wird. Vertragsendedatum, TCV und ACV können leer bleiben, während aktueller MRR und aktueller ARR weiterhin berechnet werden.

Preismodelle

Beim Import von Verträgen können vorhandene Preismodelle und Stufen angewendet werden, je nachdem, ob das Feld Einzelpreis ausgefüllt wird.

  • Wenn das Feld Produkt eine gültige HubSpot-Produktdatensatz-ID enthält und der Einzelpreis leer ist, verwendet das importierte Produkt das vorhandene Preismodell und die vorhandenen Stufen.
  • Wenn das Feld Produkt eine gültige HubSpot-Produktdatensatz-ID enthält und das Feld Einzelpreis ausgefüllt ist, behält die Zeile ihre ProduktZuordnung bei und verwendet den eingegebenen Betrag als Pauschalpreis. Die bestehenden Preismodelle und Stufen des Produkts bleiben unverändert.

Zahlungsbedingungen

Wenn Sie beim Import von Verträgen die hs_net_payment_terms Rechnungs Eigenschaft nicht zu Ihrer CSV-Datei hinzufügen, wird die Nettozahlungsfrist standardmäßig auf 0 (Fällig bei Erhalt) festgelegt, unabhängig von den Standardeinstellungen Ihres Accounts. Um unterschiedliche Zahlungsbedingungen zu verwenden, fügen Sie die Eigenschaft mit dem gewünschten Wert in Ihre CSV-Datei ein (z. B. legt ein Wert von 0 fest, dass Rechnungen bei Erhalt fällig sind. Ein Wert von 30 würde festlegen, dass Rechnungen Zahlungsbedingungen netto 30 haben).

Automatisierte Umsatzsteuer

Abonnement erforderlich Es ist ein Revenue Hub Professional- oder Enterprise-Account erforderlich, um die automatisierte Umsatzsteuer für einen Account verfügbar zu machen.  

Lizenzen erforderlich Für die automatisierte Umsatzsteuer ist mindestens eine zugewiesene Revenue Hub-Lizenz in Ihrem Account erforderlich. Sobald eine berechtigte Lizenz besteht, ist die automatisierte Umsatzsteuer für alle unterstützten Umsatztools Accountweit verfügbar, einschließlich Rechnungen, Zahlungslinks, Angebote, alte Angebote und Abonnements. Benutzer benötigen keine zugewiesene Revenue Hub-Lizenz , um Umsatztools mit aktivierter automatischer Umsatzsteuer zu nutzen.

Wenn Sie in den USA oder Kanada ansässig sind und die Umsatzsteuer automatisch berechnen möchten, konfigurieren Sie die automatische Umsatzsteuer in Ihren Account-Einstellungen, bevor Sie Verträge importieren.

Bitte beachten: Wenn Sie ein Unternehmen oder einen Kontakt importieren, der oder der einem Unternehmen zugeordnet ist, wird die Rechnungsadresse des Unternehmens nicht für automatisierte Umsatzsteuerzwecke verwendet. Wenn Sie die automatisierte Umsatzsteuer verwenden möchten, sehen Sie sich die CSV-Beispieldatei für die automatisierte Umsatzsteuer an, oder fügen Sie Ihrer CSV-Datei die Eigenschaft Automatisierte Umsatzsteuer hinzu und verwenden Sie die folgenden Abrechnungsadresseigenschaften in Ihrer CSV-Datei:

  • hs_billing_address_line_1
  • hs_billing_address_line_2
  • hs_billing_address_state
  • hs_billing_address_zip
  • hs_billing_address_country
  • hs_billing_address_country_code

CSV-Beispieldateien

Verwenden Sie die folgenden CSV-Beispieldateien als Anleitung für Ihre Migration.

Bitte beachten Sie: CSV-Dateien dienen nur zur Veranschaulichung. Ersetzen Sie Beispieldaten, IDs, Produkt-IDs, Kontakte, Beträge, Währungen und alle import_unique_id Einträge in der CSV-Datei. Überprüfen Sie die zugeordneten Eigenschaften und Entwürfe, bevor Sie mit der Migration fortfahren.

Migrationsszenario 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
Wiederkehrende Verträge für immergrüne Prozesse. Erfahren Sie mehr über Evergreen-Verträge Herunterladen
Verträge mit einmaligen und wiederkehrenden Artikeln Herunterladen
Vertrag mit zwei Artikeln, einer mit einem reduzierten Betrag und einer mit einem Rabattprozentsatz Herunterladen
Vertrag mit automatisierter Umsatzsteuer Herunterladen
Vertrag mit mehreren Abrechnungskontakten 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 manual_payments oder automatic_payments. 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.
Referenz-ID der externen Zahlungsmethode Vertrag hs_external_payment_method_reference_id Lassen Sie diese Angabe für manuelle Zahlungen leer. Erforderlich für automatische Zahlungen.
import_unique_id Vertrag Benutzerdefinierte Eigenschaften Eindeutige Vertrags-Eigenschaft mit einer gemeinsamen ID für alle Zeilen im selben Vertrag. Beim erneuten Versuch von Importen muss eine neue ID verwendet werden, auch wenn der vorherige Import fehlgeschlagen ist. 
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 Optionale Eigenschaft. Datensatz-ID des Produkts. Erfahren Sie mehr über produktgestützte und eigenständige Artikeltypen.
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.
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.

Verträge migrieren

Beginnen Sie mit der Migration von Verträgen, einschließlich des Testens der Lokalisierung, bevor Sie mit der endgültigen Migration beginnen.

Lokalisierungstests vor der Migration

Wenn Sie Kunden in verschiedenen Sprachen und Regionen bedienen, empfiehlt es sich, eine Pilotmigration pro Sprache, Region und Währung durchzuführen. Sie können Rechnungen annullieren und Verträge kündigen , nachdem Sie eine erfolgreiche Migration bestätigt haben.

  1. Fügen Sie die Verträge in eine CSV-Datei ein. Erfahren Sie mehr über das Konfigurieren einer CSV-Datei für den Import.
  2. Beginnen und schließen Sie die Migration ab.
  3. Warten Sie, bis Rechnungen für den Vertrag generiert werden.
  4. Überprüfen Sie die Rechnung auf Richtigkeit. Erfahren Sie mehr über das Verwalten von Rechnungen:
    • Zeigen Sie die Rechnung in einem neuen Browser-Tab an.
    • Laden Sie eine PDF-Datei der Rechnung herunter.
    • Senden Sie die Rechnung an eine interne E-Mail-Adresse.
  5. Überprüfen Sie für jede übersetzte Beschriftung, Datum, Zahlen, Währungssymbole, Zeichenwiedergabe, Absender, Empfänger und Links. 

Bitte beachten: Hierbei handelt es sich um ein End-to-End-Pilotprojekt, nicht um eine Vorschaufunktion vor der Aktivierung.

Beginnen Sie mit der Migration

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

  1. 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.
  2. Klicken Sie oben rechts auf Importieren.
  3. Klicken Sie im Abschnitt Datei importieren auf Daten importieren.
  4. Klicken Sie auf Erweiterte Importe (alle Objekte).
  5. Klicken Sie unter Objekte auf Verträge. Die Objekte contacts und line items werden automatisch ausgewählt. Sie können auch andere Objekte (z. B. Unternehmen und Deals) zur gleichen Zeit importieren. Erfahren Sie mehr über das Importieren mehrerer Objekte.
  6. Klicken Sie unten rechts auf „Weiter“.
  7. Klicken Sie auf das Dropdown-Menü Auswählen, wie Kontakte importiert werden sollen und wählen Sie eine Option aus:
    • Nur neue Kontakte erstellen: Es werden neue Kontaktdatensätze für die importierten Kontakte erstellt.
    • Vorhandene Kontakte erstellen und aktualisieren: Es werden neue Kontaktdatensätze erstellt, wenn ein Kontakt nicht im CRM-System vorhanden ist. Aktualisieren Sie einen Kontakt, falls er bereits vorhanden ist. Wenn Sie diese Option auswählen, muss jeder Datensatz über eine eindeutige ID verfügen.
  8. Klicken Sie auf das Dropdown-Menü Auswählen, wie Artikel importiert werden sollen und wählen Sie Nur neue Artikel erstellen aus. 

Bitte beachten: Die Auswahl von "Für Artikel ohne eindeutige ID erstellen und aktualisieren " kann dazu führen, dass identische Artikel aus verschiedenen Verträgen zusammengeführt werden, sodass einige Verträge ohne ihre zugehörigen Produkte übrig bleiben. Es wird empfohlen, Neue Artikel erstellen auszuwählen, um eine Zusammenführung zu vermeiden.

  1. 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.
  2. Klicken Sie unten rechts auf „Weiter“.
  3. Ordnen Sie die Spalten in der Importdatei HubSpot-Eigenschaften zu. Erfahren Sie mehr über die CSV-Eigenschaften-Zuordnungen.
  4. Klicken Sie unten rechts auf „Weiter“.
  5. Geben Sie im Feld Importname einen Namen für den Import ein.
  6. 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.
  7. Klicken Sie auf das Dropdown-Menü Datumsformat und wählen Sie ein Datumsformat aus.
  8. Klicken Sie auf das Dropdown-Menü Zeitzone und wählen Sie eine Zeitzone aus.
  9. Klicken Sie auf das Dropdown-Menü Zahlenformat und wählen Sie ein Zahlenformat aus.
  10. 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.
  11. Aktivieren Sie das Kontrollkästchen Datensätze anreichern , um Datensätze während des Imports anzureichern. Erfahren Sie mehr über Kontakt- und Unternehmens-Anreicherung.
  12. Klicken Sie unten rechts auf Importvorgang abschließen.
  13. Fahren Sie mit der Migration fort.

Formatierungsprobleme überprüfen

Nachdem Sie auf Import abschließen geklickt haben, werden importierte Verträge als Vertragsentwürfe erstellt. Überprüfen Sie Formatierungsprobleme und Zeilenfehler für Kontakte, bevor Sie die Migration abschließen:

Bitte beachten: eine Zeile mit geplanter Abrechnung mit -- als Rechnungsnummer ist ein projizierter Eintrag. Generierte Rechnungen erhalten eine Nummer und werden mit anderen Rechnungsdatensätzen indexiert.

  1. Um Formatierungsprobleme zu bereinigen, klicken Sie unter Importierte Daten bereinigen auf den Wert (z. B. 1) unter Formatierungsprobleme für [Objekt].

    Zusammenfassung der HubSpot-Vertragsimportübersicht mit 2 Importzeilen, 4 neuen Datensätzen und 1 hervorgehobenem Problem bei der Kontaktformatierung sowie einem Banner "Migration abgeschlossen".
  2. Klicken Sie unter Formatierungsprobleme auf Probleme anzeigen.

    Bereich für Importformatierungsprobleme in HubSpot mit einer Warnung vor 3 Formatierungsproblemen für Kontakt-E-Mails aufgrund ungültiger Adressen, wobei die Schaltfläche "Probleme anzeigen" hervorgehoben ist.
  3. Überprüfen Sie in der Tabelle die Probleme und vorgeschlagenen Lösungen:
    • Um die vorgeschlagene Korrektur zu bearbeiten, klicken Sie in der Spalte Vorgeschlagene Korrektur auf das Bleistiftsymbol und geben einen neuen Wert ein.
    • Um alle vorgeschlagenen Korrekturen zu übernehmen, klicken Sie auf Alle akzeptieren.
    • Um alle vorgeschlagenen Korrekturen abzulehnen, klicken Sie auf Alle ablehnen.
    • Um eine vorgeschlagene Korrektur für eine einzelne Zeile zu akzeptieren oder abzulehnen, klicken Sie in der Spalte Aktionen auf Akzeptieren oder Ablehnen.
    • Um den Datensatz aus dem Import zu löschen, klicken Sie in der Spalte Aktionen auf Mehr und wählen Sie dann Diesen Datensatz löschen aus.
  4. Gehen Sie zurück zu Ihrem Import:

Schließen Sie die Migration ab

Bitte beachten: Benutzer mit Berechtigungen zum Anzeigen, Erstellen, Bearbeiten oder Löschen von Verträgen können Verträge anzeigen, die importiert, aber noch nicht migriert wurden. Benutzer mit Berechtigungen zum Erstellen, Bearbeiten oder Löschen von Verträgen können die beim Import erstellten Vertragsentwürfe validieren, bearbeiten, migrieren und löschen.

  1. Klicken Sie auf Migration abschließen.

    Zusammenfassung des HubSpot-Fensters für den Vertragsimport, auf dem die im Banner zur Vertragsmigration hervorgehobene Schaltfläche "Migration abschließen" mit 2 Importzeilen, 4 neuen Datensätzen und 1 Problem bei der Kontaktformatierung angezeigt wird.
  2. Prüfen Sie Verträge, die Aufmerksamkeit erfordern. Um die Fehler als CSV-Datei herunterzuladen, klicken Sie oben rechts auf Fehler als CSV herunterladen.
  3. Um die Fehler zu beheben, klicken Sie in der Spalte Fehler auf [Eigenschaft] aktualisieren.

    Bildschirm der HubSpot-Vertragsmigration mit der Registerkarte "Benötigt Aufmerksamkeit" und 4 Verträgen, die aufgrund von Fehlern beim Startdatum der Abrechnung als nicht migrationsbereit gekennzeichnet sind, wobei der Link "Überschreiben des Startdatums der Abrechnung aktualisieren" hervorgehoben ist.
  4. Aktualisieren Sie im Dialogfeld die erforderlichen Eigenschaften und klicken Sie dann auf Vertrag erneut validieren.
  5. Der erneut validierte Vertrag wird auf die Registerkarte Bereit für die Migration verschoben.
  6. Wenn Sie alle Verträge überprüft haben, die Ihrer Aufmerksamkeit bedürfen, klicken Sie auf die Registerkarte Bereit für die Migration .
  7. Es wird empfohlen, die folgenden Eigenschaften der Verträge zu überprüfen, bevor Sie die Migration abschließen:
    • Inkassoprozess
    • Zahlungsmethode
    • Termine
    • Produktassoziationen
    • Artikel
    • Zeitplan
    • Steuerkonfiguration
  8. Um Änderungen am Startdatum der Abrechnung oder der Referenz-ID für externe Zahlungsmethoden vorzunehmen, klicken Sie auf das Bearbeiten-Symbol.

Bitte beachten: Sie können das Startdatum der Abrechnung nur dann überschreiben und hs_external_payment_method_reference_id, wenn der Vertrag keine bezahlten Rechnungen oder Zahlungen enthält.

  1. Im Dialogfeld:
    • Klicken Sie unter dem Feld Startdatum der Abrechnung überschreiben auf die Datumsauswahl und wählen Sie ein Datum aus.
    • Geben Sie im Feld Zahlungsmethoden-ID eine Zahlungsmethoden-ID ein.
    • Klicken Sie auf Vertrag erneut validieren.
  2. Der Vertrag wird auf die Registerkarte Bereit für die Migration verschoben, wenn er erneut validiert wurde.

    Ein GIF, das importierte Verträge anzeigt, die auf der Registerkarte "Benötigt Aufmerksamkeit" angezeigt werden. Der Benutzer scrollt nach rechts und klickt auf das Bearbeiten-Symbol. Der Benutzer klickt auf die Auswahl Startdatum der Abrechnung, wählt ein Datum aus und klickt dann auf Vertrag erneut validieren.
  3. Überprüfen Sie als letzten Schritt vor der Migration Folgendes:
    1. Die letzte Rechnung aus dem alten Vertrag.
    2. Die erste HubSpot-Rechnung.
    3. Alle offenen Forderungen.
    4. Kündigung des alten Abonnements, falls zutreffend.
    5. Mahnung.
    6. Rechnungs-E-Mails.
    7. Überprüfung der Buchhaltungsintegration. Erfahren Sie mehr über das Verknüpfen von Quickbooks Online und Xero mit HubSpot. 
  4. Klicken Sie oben rechts auf [x] Verträge migrieren.

    Bildschirm der Vertragsmigration in HubSpot mit dem Tab Bereit für die Migration mit 2 Verträgen und der hervorgehobenen Schaltfläche "2 Verträge migrieren".
  5. Überprüfen Sie im Dialogfeld die Migrationsbedingungen, aktivieren Sie das Kontrollkästchen Ich verstehe und stimme zu und klicken Sie dann auf Migration bestätigen.
  6. Der Import von Verträgen und der Beginn der Abrechnung erfolgt auf der Grundlage des gewählten Migrationsformats. Erfahren Sie mehr über das Anzeigen und Verwalten von Verträgen.

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.

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.

So können Sie diesen Fehler beheben:

  1. Aktualisieren Sie Ihre CSV-Datei mit neuen IDs.
  2. Importieren Sie die aktualisierte CSV-Datei.

Glossar

Lesen Sie die folgenden Bedingungen, bevor Sie Verträge zu HubSpot migrieren.

Laufzeit Beschreibung
Automatische Zahlungen Ein Inkassoprozess, bei dem Rechnungen automatisch mit einer gespeicherten Zahlungsmethode belastet werden.
Startdatum der Abrechnung überschreiben Das Datum, an dem HubSpot mit der Abrechnung des migrierten Vertrags beginnen soll.
Inkassoprozess Wie die Zahlungen nach der Migration eingezogen werden. Zahlungen können manuell vom Käufer oder automatisch über eine hinterlegte Zahlungsmethode eingezogen werden.
import_unique_id Eine benutzerdefinierte Eigenschaft, die verwendet wird, um Zeilen zu gruppieren, die während der Migration zum selben Vertrag gehören.
Manuelle Zahlungen Ein Inkassoprozess, bei dem Rechnungen in HubSpot erstellt werden und Käufer sie manuell bezahlen.
Format der Migration Die CSV-Struktur, die für den Import verwendet wird. Das Format der Migration hängt davon ab, wie die Zahlungen eingezogen werden und ob Sie Revenue Continuity einbeziehen möchten.
MRR Monatlich wiederkehrender Umsatz. In HubSpot wird der MRR verwendet, um wiederkehrende Umsätze aus Verträgen zu melden.
MRR-Wasserfall Ein Umsatzbericht, der zeigt, wie sich wiederkehrende Umsätze im Zeitverlauf aufgrund von Ereignissen wie Neugeschäften, Upgrades, Erweiterungen, Downgrades und Abwanderungen ändern.
ID der Zahlungsmethode Die externe Zahlungsmethodenreferenz, die für Verträge mit automatischen Zahlungen verwendet wird.
Rampe Eine Preis- oder Mengenänderung, die im Laufe eines Vertrags auftritt.
Rampenschlüssel Ein Wert, der verwendet wird, um verwandte Artikelzeilen in einen Rampe zu gruppieren.
Einarbeitungsphase Ein Zeitraum innerhalb einer Rampe. Jede Phase hat ihre eigene Laufzeit, ihren eigenen Preis, ihre eigene Menge und ihr eigenes Startdatum.
ramp_key_import_id Eine benutzerdefinierte Artikel-Eigenschaft, die verwendet wird, um Artikelzeilen während der Migration in Einarbeitungsphasen zu gruppieren.
Kontinuität der Einnahmen Eine Option, die frühere Vertragsänderungen wie Upgrades, Erweiterungen oder Downgrades berücksichtigt, damit sie in den Umsatzberichten berücksichtigt werden können
System der Aufzeichnungen Das primäre System zur Verwaltung und Pflege von Vertrags- und Abrechnungsinformationen nach der Migration.
War dieser Artikel hilfreich?
Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.