# Migration von SuiteSync zu Stripe Connector for NetSuite Konfigurieren Sie die Stripe Connector for NetSuite-App mit Ihren SuiteSync-Einstellungen. SuiteSync wurde ursprünglich auf einer eigenen technischen Infrastruktur entwickelt, die Stripe erworben hat. Den Stripe Connector for NetSuite haben wir als „v2“ von SuiteSync auf der technischen Infrastruktur von Stripe entwickelt. Ab Anfang 2024 wurden alle neuen Nutzer/innen in den Connector eingegliedert. Die Migration ist eine Neuimplementierung Ihrer bestehenden SuiteSync-Konfiguration in einer ähnlich strukturierten Connector-Umgebung. Befolgen Sie diese Anleitung, um eine Kopie Ihrer aktuellen Konfiguration für dieses Konto zu migrieren. Sie konfigurieren die Einstellungen für den Stripe Connector für NetSuite in der Stripe-Nutzeroberfläche und die zugehörigen Pakete in NetSuite. Der Migrationsprozess ist für die meisten Nutzer/innen mit Hilfe der verfügbaren Anleitung unseres Teams selbstständig durchführbar. Ihr internes Team oder ein externes Beratungsunternehmen kann die Migration durchführen. Sie können SuiteSync bis zur Live-Umstellung ohne Beeinträchtigung der Funktionalität weiter nutzen. Unser Team wird während der Live-Umstellung mit Ihnen in Kontakt stehen, um die Konfiguration zu überprüfen und den Zeitpunkt der Umstellung zu regeln. Sollten Sie zusätzliche Unterstützung benötigen, kontaktieren Sie uns bitte über die Schaltfläche **Support zur Migration anfordern** in der App. Das Team von Stripe Connector for NetSuite bietet Ihnen kostenlose, begrenzte Beratung und technischen Support. Alternativ können wir Ihnen einen von Stripe zugelassenen Implementierungspartner für den Connector vermitteln, der die vollständige Migration gegen eine Gebühr durchführt. ### SuiteSync-Dashboard Das [SuiteSync-Dashboard](https://dashboard.suitesync.io/login) bietet einen begrenzten Einblick in Ihre aktuelle Integrationskonfiguration. Wir stellen für jedes Stripe-Konto, das SuiteSync verwendet, einen individuellen Konfigurationsleitfaden zur Verfügung, damit Sie wissen, wie Sie die Connector-App und die zugehörigen NetSuite-Pakete konfigurieren müssen. ## Überprüfen Sie Ihre Umgebungen und bereiten Sie sie vor Bevor Sie mit der Connector-Installation beginnen, sollten Sie Folgendes beachten: - Unser Team stellt Konfigurationsanweisungen zur Verfügung, die die Live-Modus-Konfiguration von SuiteSync für ein bestimmtes Stripe-Konto offenlegen. Dabei gehen wir davon aus, dass Sie dieses Konto mit dem Connector weiterhin im Live-Modus verwenden werden. Wir gehen nicht auf SuiteSync-Konfigurationen im Test-Modus ein. - Wenn Sie SuiteSync mit mehr als einem Stripe-Konto verwenden, müssen Sie sich bei jedem Konto separat anmelden und erhalten spezifische Anweisungen von unserem Team für eine potenziell einmalige Konfiguration. Befolgen Sie bei der Migration unbedingt die kontospezifischen Anweisungen. ### Wählen Sie die Testumgebung aus Entscheiden Sie, in welcher [Stripe-Testumgebung](https://docs.stripe.com/testing-use-cases.md#test-mode) Sie den Connector installieren möchten: Test-Modus oder Sandbox. Die Unterschiede finden Sie in der folgenden Tabelle. | Stripe-Modus | Format der Stripe-Konto-ID | Hinweise | NetSuite-Modus | Format der NetSuite-Konto-ID | | ----------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ----------------------------------------- | | Live-Modus | `acct_id` | Dieselbe ID wie der entsprechende Test-Modus. Die Anweisungen unseres Teams zeigen die SuiteSync-Konfiguration für diesen Modus und dieses Konto. | Produktion | `123456` | | Test-Modus | `acct_id` | Dieselbe ID wie der entsprechende Live-Modus. Kompatibilität mit Migrationstests ist gegeben. Jeder Live-Modus hat nur einen Test-Modus. | Beliebige Sandbox | `123456_SB`, `123456_SB_1`, `123456_SB_2` | | Beliebige Sandbox | `acct_id` | Eine eindeutige ID, die Sie als „Kopie“ des Live-Modus-Konto für Migrationstests erstellen müssen. Jeder Live-Modus kann mehrere Sandboxes haben. | Beliebige Sandbox | `123456_SB`, `123456_SB_1`, `123456_SB_2` | ### Deaktivieren Sie eventuell vorhandene Testintegrationen Der Stripe Test-Modus war wahrscheinlich während der ursprünglichen SuiteSync-Implementierung oder während nachfolgender Testsitzungen mit einer Ihrer NetSuite-Sandboxes verbunden. Möglicherweise besteht die Verbindung immer noch. SuiteSync und der NetSuite Connector können nicht zuverlässig gleichzeitig im gleichen Modus für dieselbe Stripe-Konto-ID betrieben werden. Dies gilt für den Stripe-Test-Modus und den Live-Modus, jedoch nicht für Stripe-Sandboxes, da nur der Connector dies unterstützt (und nicht SuiteSync). > Wenn Sie keine NetSuite-Sandbox haben, kontaktieren Sie uns, damit wir Ihnen beim Verbinden des Stripe -Test-Modus oder einer Sandbox mit Ihrer NetSuite-Produktionsumgebung für Testzwecke helfen können. Bevor Sie den Connector in einem Stripe-Konto im Test-Modus aktivieren können, müssen Sie sich beim SuiteSync-Dashboard anmelden und überprüfen, dass Sie keine bereits vorhandenen Testintegrationen für das Stripe-Konto aktiviert haben. 1. Gehen Sie zum [SuiteSync-Dashboard](https://dashboard.suitesync.io/login). 1. Wählen Sie die Sandbox oder das Testkonto > *(Ihr Name)* > **Verbindungseinstellungen** aus. - Wenn „Ungültige NetSuite-Anmeldedaten“ oder „Echtzeit-Integration deaktiviert“ angezeigt wird, ist die Testintegration nicht verbunden. - Wenn „Die NetSuite-Verbindung ist aktiv. Stripe-Daten werden an NetSuite übermittelt.“ angezeigt wird, klicken Sie auf **Echtzeit-Integration deaktivieren**. 1. Wenn Sie SuiteSync im Test-Modus deaktiviert haben, können Sie den Stripe Connector for NetSuite gemäß den folgenden Anweisungen auf demselben Stripe-Konto im Test-Modus aktivieren. Alternativ können Sie die aktuelle Test-Modus-Integration von SuiteSync verwenden, wenn Sie aktiv Tests durchführen. Gehen Sie zum Stripe-Konto im Live-Modus und erstellen Sie stattdessen eine neue Stripe-Sandbox und stellen Sie eine Verbindung zur selben oder einer anderen NetSuite-Sandbox her. Erstellen Sie die Stripe-Sandbox als „Kopie“ des Live-Modus-Kontos und nicht als eigenständiges Sandbox-Konto. Die SuiteSync-Testinstanz ist jetzt ungültig. ### Konfigurierte Komponenten Sowohl SuiteSync als auch die Connector-App verfügen über allgemeine Einstellungen und workflow-spezifische Einstellungen. Sie verwenden native, vorgefertigte Connector-App-Einstellungen oder Paket-Funktionen. Ihr Konfigurationsleitfaden enthält Anweisungen für diese Einstellungen. Stripe hat keinen vollständigen Überblick über vier Arten von Komponenten für jede Integration. Unser Team kann diese gemeinsam mit Ihnen überprüfen: - Einige native SuiteSync-Unterfunktionen, die eingehend analysiert werden müssen, um die Nutzung pro Konto zu erkennen. - Native Legacy-Pakete, die Sie in NetSuite installiert haben. - Scriptvorlagen von SuiteSync, die Sie in NetSuite installiert haben. - Benutzerdefinierte Scripts oder Funktionen, die auf der Funktionalität von SuiteSync basieren. Dazu gehören Komponenten, die von einem Stripe-Implementierungspartner, einem anderen Drittunternehmen oder Ihrem Team entwickelt wurden. Diese können auf Ihre spezifische Integration zutreffen. Um sicherzugehen, können Sie die NetSuite-Produktionsumgebung und die Live-Modus-Umgebung von Stripe in allen Fällen überprüfen. Sie sind selbst dafür verantwortlich, für Scriptvorlagen und benutzerdefinierte Scripts oder Funktionen zu pflegen bzw. einen Partner mit deren Pflege zu beauftragen. Die Metadaten-Schlüssel und Funktionen des Connector-Endpoints sind größtenteils unverändert geblieben. Wir empfehlen Ihnen jedoch, alle Komponenten vor der Live-Schaltung zu testen, um sicherzustellen, dass sie weiterhin wie erwartet funktionieren. Die neuen Connector-Pakete enthalten Änderungen an vielen Feld-IDs für entsprechende benutzerdefinierte Felder. > Möglicherweise verwenden Sie benutzerdefinierte Funktionen für Funktionalität, die der Stripe Connector for NetSuite nativ unterstützt, die aber von SuiteSync nicht unterstützt wurde. Dazu gehören die Unterstützung zusätzlicher Zahlungsmethoden und erweiterte Funktionalität für in automatische Zahlungen mit NetSuite und E-Commerce-Integrationen. ### SuiteSync- und NetSuite-Connector-Pakete Die Connector-App verfügt über neue Pakete und einige Pakete, die auch SuiteSync verwendet. Wir haben die Namen und Beschreibungen der Pakete vor der Veröffentlichung des Stripe Connector for NetSuite von „SuiteSync“ zu „SCN“ oder „Stripe“ aktualisiert. Das kann unter Umständen zu Verwechslungen führen. Achten Sie darauf, die Paket-IDs in den Anweisungen unseres Teams und SuiteSync-Pakete mit ähnlichen Namen und Funktionen auseinanderzuhalten. Sie sind unterschiedlich und SuiteSync-spezifische Pakete funktionieren nicht mit den aktualisierten Funktionen der Connector-App. ## Installieren Sie die Connector-App in einer Testumgebung Bevor Sie beginnen, müssen Sie das Stripe-Dashboard im Test-Modus öffnen oder ein Stripe-[Sandbox](https://docs.stripe.com/sandboxes.md)-Konto erstellen, das mit Ihrem Live-Modus-Konto verknüpft ist. 1. Gehen Sie zum Stripe Dashboard für Ihr Konto. 1. Klicken Sie im Live-Modus auf Ihren Kontonamen > **Zur Sandbox wechseln**. 1. Wählen Sie **Sandbox erstellen** oder **Test-Modus** aus. 1. Wenn Sie **Sandbox erstellen** ausgewählt haben, klicken Sie auf **Ihr Konto kopieren**. ### Installieren Sie die Connector-App Installieren Sie als Nächstes die Connector-App in dem von Ihnen ausgewählten Test-Modus- oder Sandbox-Konto. 1. Rufen Sie im **Stripe App Marketplace** die [Seite Stripe Connector for NetSuite](https://marketplace.stripe.com/apps/netsuite-connector) auf. 1. Führen Sie einen der folgenden Schritte aus: - Um zum Test-Modus zu gelangen, klicken Sie auf **Im Test-Modus ausprobieren**. - Für eine Sandbox klicken Sie auf **App installieren**. 1. Überprüfen Sie die Berechtigungen. 1. Die App wird automatisch auf Ihrem ausgewählten Konto installiert. Klicken Sie auf das Symbol „S“ (**S**), um die Seitenschubladenansicht der App zu öffnen. 1. Klicken Sie auf **App-Einstellungen anzeigen**, um mit der Einrichtung fortzufahren. 1. Starten Sie auf der Einrichtungsseite den In-App-Assistenten, um Stripe und NetSuite mit tokenbasierter Authentifizierung zu verbinden. 1. Schließen Sie die Einrichtung gemäß den Anweisungen des Assistenten ab. > Wenn Sie mehrere Sandboxes haben, müssen Sie das NetSuite-Sandbox-Konto auswählen, um eine Verbindung zur Stripe-Testumgebung herzustellen. Wenn Sie SuiteSync zuvor in der NetSuite-Sandbox konfiguriert haben, haben Sie möglicherweise das Paket „Stripe Token Based Authentication“ (früher als „SuiteSync Token Based Authentication“ bezeichnet) mit der Paket-ID 178262 installiert. Sowohl SuiteSync als auch der Stripe Connector for NetSuite verwenden dieses Paket. Wenn der Name des Pakets oder der Integration weiterhin SuiteSync lautet, können Sie diesen Integrationsdatensatz in NetSuite auswählen und der Connector funktioniert weiterhin ordnungsgemäß. In Produktionsumgebungen sind die Token für SuiteSync-Funktionalität auf dieses Paket angewiesen, um Kontinuität während der Live-Umstellung zu gewährleisten. 1. Wenn Sie die Stripe- und NetSuite-Umgebung erfolgreich verbunden haben, wird Ihnen die Seite „App-Einstellungen“ zum Konfigurieren der Registerkarten angezeigt. ## Befolgen Sie Ihre individuelle Konfigurationsanleitung Befolgen Sie die individuelle Konfigurationsanleitung für jedes Ihrer Stripe-Konten, das SuiteSync verwendet. 1. Melden Sie sich bei Ihrem Stripe-Konto an, das SuiteSync verwendet. 1. Öffnen Sie die [Konfigurationsanleitung](https://docs.stripe.com/use-stripe-apps/netsuite/migration/configure-app.md) für Kontoeinstellungen und Anweisungen, die speziell für Ihr Konto gelten. ## Optional: Vereinbaren Sie einen Anruf, um einen individuellen Migrationsleitfaden zu erhalten Unser Team kann Ihnen einen Überblick über den Migrationsprozess geben. Wir behandeln folgende Themen: - Ihre individuelle SuiteSync-Konfiguration für jedes Stripe-Konto - Der Migrationsprozess für die von Ihnen verwendeten Workflows - Informationen zu aktualisierten Workflows und neuen Funktionen - Erste Schritte mit der Migration - Falls Sie Fragen haben Geben Sie unten Ihre E-Mail-Adresse ein, um eine personalisierte Übersicht zu erhalten. Unser Team wird sich mit Ihnen in Verbindung setzen. ## Testen Sie Ihre Connector-App-Einstellungen Befolgen Sie die Schritte im [Konfigurationsleitfaden](https://docs.stripe.com/use-stripe-apps/netsuite/migration/configure-app.md), um die Connector-Einstellungen zu testen, die Sie im Test-Modus oder in einer Sandbox konfiguriert haben, einschließlich der Erstellung von Stripe-Datensätzen und der Synchronisierung mit NetSuite. ### Testen Sie benutzerdefinierte Funktionen oder Scripts Sie sind selbst dafür verantwortlich, Scriptvorlagen und benutzerdefinierten Scripts oder Funktionen zu pflegen bzw. einen Partner mit deren Pflege zu beauftragen. Das umfasst auch die Kenntnis der erforderlichen Workflows und Testverfahren. Stripe hat keinen Einblick in Anpassungen, da sie im Integrationsablauf in der Regel vor- oder nachgelagert zum Connector erstellt werden. ## Stelen Sie von SuiteSync auf den Connector im Live-Modus um Wenn Sie zur Live-Umstellung bereit sind, kontaktieren Sie uns über die Schaltfläche **Migrations-Support unterstützen** in der Connector-App. Planen Sie unbedingt ausreichend Zeit vor eventuellen internen Umstellungsfristen ein. Das Team von Stripe Connector for NetSuite wird mit Ihnen einen Anruf vereinbaren, um Ihre Konfiguration auf Korrektheit zu prüfen und den Zeitpunkt der Live-Umstellung zu regeln. ## See also - [FAQ zur SuiteSync-Migration](https://support.stripe.com/topics/stripe-connector-for-netsuite)