# Abonnements mit dem Toolkit zu Stripe Billing migrieren Erfahren Sie, wie Sie mit dem Toolkit Ihre bestehenden Abonnements zu Stripe migrieren. Verwenden Sie das [Billing-Migrations-Toolkit](https://dashboard.stripe.com/billing/migrations) im Stripe-Dashboard, um Ihre bestehenden Abonnements von einem Drittanbietersystem, einem selbst entwickelten System oder einem vorhandenen Stripe-Konto zu Stripe Billing zu migrieren. ## Before you begin 1. Falls noch nicht geschehen, schauen Sie sich die einzelnen [Migrationsphasen](https://docs.stripe.com/billing/subscriptions/migrate-subscriptions.md#migration-stages) an. 1. [Richten Sie eine Stripe Billing-Integration](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md) ein, bevor Sie die Migration starten. Dies ist eine einmalige Einrichtung, die Sie für zukünftige Migrationen nicht wiederholen müssen. 1. [Fordern Sie einen PAN-Datenimport](https://docs.stripe.com/get-started/data-migrations/pan-import.md) von Ihrem aktuellen Abwickler an. Dieser Schritt ist nur erforderlich, wenn Sie von einem anderen Abwickler zu Stripe migrieren. Wenn die Daten innerhalb von Stripe migriert werden, können Sie diese Voraussetzung überspringen. 1. Wenn Sie von einem Drittanbieter- oder selbst entwickelten System migrieren, sollten Sie die Kündigung Ihrer bestehenden Abonnements und die Erstellung neuer Abonnements in Stripe sorgfältig planen. Um einen Abrechnungszeitraum nicht zu verpassen, erstellen Sie zuerst die neuen Abonnements in Stripe, bevor Sie die alten Abonnements kündigen. Um eine doppelte Abrechnung zu vermeiden, kündigen Sie Abonnements in Ihrem alten System, bevor die Abonnements zur Abbuchung eingestellt werden. Planen Sie für Abonnements mit bevorstehenden Abrechnungsdaten kurz vor der Migration, dass sie nach dem Zyklus beginnen, damit sich die endgültige Rechnung im alten System befindet. ## Billing-Migrations-Toolkit öffnen Erstellen Sie eine *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) im Dashboard, wenn Sie zuerst eine Testmigration durchführen möchten. 1. Gehen Sie zu [Dashboard](https://dashboard.stripe.com/billing) > [Subscriptions](https://dashboard.stripe.com/test/subscriptions) > [**Migrations**](https://dashboard.stripe.com/test/billing/migrations). Alternativ können Sie auf das Überlaufmenü (⋯) neben **+ Abonnement erstellen** klicken und [Abonnements migrieren](https://dashboard.stripe.com/settings/billing/migrations) auswählen. 1. Um Ihre Migration zu starten, klicken Sie auf **Loslegen**. ## Eine CSV-Datei herunterladen Exportieren Sie zunächst Ihre bestehenden Abonnements, indem Sie die exportierten Daten einer migrationskompatiblen CSV-Datei zuordnen. Sie können Ihre eigene CSV-Datei erstellen oder eine der folgenden von Stripe bereitgestellten CSV-Vorlagen herunterladen ([Basis](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#basic), [Artikel mit mehreren Preisen](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#multi-price) und [Ad-hoc-Preisgestaltung](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#ad-hoc)). Außerdem finden Sie Beispiele für CSV-Dateien für gängige [Use cases](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#migration-use-cases) für Migrationen. 1. Klicken Sie auf **CSV-Vorlage herunterladen**. 1. Wählen Sie eine CSV-Vorlage (Basis-, Multipreisartikel oder Ad-hoc-Preise) basierend auf Ihrem Abrechnungsszenario. ### Basis-CSV Dieses Beispiel zeigt eine Migration für gängige Abonnement-Anwendungsszenarien wie Menge, Steuern, Abrechnungsanker, Rabatte, Testversionen und Rückdatierung. ### Geben Sie die folgenden Felder für eine einfache CSV-Datei an: | Attribut | Typ | Beispiel | Beschreibung | | ------------------------------- | -------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer` **(erforderlich)** | Stripe-Kunden-ID | `cus_xxx1` | Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll. | | `start_date` **(erforderlich)** | Zeitstempel im Epoch UNIX-Format | `1658179441` | Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen. | | `price` **(erforderlich)** | Stripe-Preis-ID | `price_1LDGNmDK0D4Fox2RxIaXQkBp` | Sie müssen einen wiederkehrenden Preis verwenden. Wenn Sie mehrere Artikel migrieren, verwenden Sie stattdessen das Format `items.x.{price, quantity}`. Ad-hoc-Preise werden auch mit `adhoc_items.x.{amount, product, interval,currency}` unterstützt. | | `quantity` | Anzahl | `1` | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `metadata.*` | Zeichenfolge | `subscription_1` | Fügen Sie diese Schlüsselwert-Paare hinzu, die Sie an ein Objekt anhängen können. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. Sie können beliebige Metadatenfelder hinzufügen (zum Beispiel `metadata_third_party_sub_id`). Wenn es sich um eine Migration von Stripe zu Stripe handelt, geben Sie `internal:Stripe` ein. | | `automatic_tax` | Boolean | `false` | Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax. | | `billing_cycle_anchor` | Zeitstempel im Epoch UNIX-Format | `1658179441` | Legt das nächste Datum fest, an dem das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll. | | `coupon` | Stripe-Gutschein-ID | `50_off` | Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll. | | `trial_end` | Zeitstempel im Epoch UNIX-Format | `1658179441` | Setzt die Phase auf „Test“ vom Startdatum bis zum `trial_end`-Datum. Sie müssen einen Wert angeben, der vor dem Enddatum des Zyklus liegt, und Sie können ihn nicht mit der Testversion kombinieren. | | `proration_behavior` | Enum | `create_prorations` oder `none` | Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`. | | `collection_method` | Enum | `charge_automatically` oder `send_invoice` | Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei der Erstellung ist standardmäßig `charge_automatically` eingestellt. Wenn Sie `send_invoice` verwenden, müssen Sie `days_until_due` festlegen. | | `default_tax_rate` | Stripe Tax-ID | `txr_1LPcLzAWeZvbCyjpzDA4qs1l` | Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel. | | `backdate_start_date` | Zeitstempel | `1658179441` | Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter [Rückdatierung kostenlos](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge). | | `days_until_due` | Ganze Zahl | `30` | Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dieser Wert ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist. | | `cancel_at_period_end` | Boolean | `false` | Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen. | ### CSV für Artikel mit mehreren Preisen Dieses Beispiel zeigt eine Migration, die mehrere Produkte pro Abonnement umfasst. ### Geben Sie die folgenden Felder für eine CSV-Datei mit mehreren Preisen an: | Attribut | Typ | Beispiel | Beschreibung | | ---------------------------------- | -------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer` **(erforderlich)** | Stripe-Kunden-ID | `cus_xxx1` | Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll. | | `start_date` **(erforderlich)** | Zeitstempel im Epoch UNIX-Format | `1658179441` | Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen. | | `items.0.price` **(erforderlich)** | Stripe-Preis-ID | `price_1LDGNmDK0D4Fox2RxIaXQkBp` | Die Kennung des Preisobjekts. Muss ein wiederkehrender Preis sein. | | `items.0.quantity` | Anzahl | `1` | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `items.1.price` **(erforderlich)** | Stripe-Preis-ID | `price_1LujbnDCA5oQnOCew7kwa4T5` | Die Kennung des Preisobjekts. Muss ein wiederkehrender Preis sein. | | `items.1.quantity` | Anzahl | `1` | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `metadata_third_party_sub_id` | Zeichenfolge | `subscription_1` | Hängen Sie diese Schlüsselwertpaare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. | | `automatic_tax` | Boolean | `false` | Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax. | | `billing_cycle_anchor` | Zeitstempel im Epoch UNIX-Format | `1658179441` | Legt das nächste Datum fest, an dem das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll. | | `coupon` | Stripe-Gutschein-ID | `50_off` | Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll. | | `proration_behavior` | Enum | `create_prorations` | Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`. | | `collection_method` | Enum | `charge_automatically` oder `send_invoice` | Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Der Standardwert ist `charge_automatically`. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei Verwendung von `send_invoice` müssen Sie `days_until_due` festlegen. | | `default_tax_rate` | Stripe Tax-ID | `txr_1LPcLzAWeZvbCyjpzDA4qs1l` | Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel. | | `backdate_start_date` | Zeitstempel | `1705753518` | Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter [Rückdatierung kostenlos](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge). | | `days_until_due` | Ganze Zahl | `30` | Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dies ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist. | | `cancel_at_period_end` | Boolean | `false` | Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen. | | `add_invoice_items.0.amount` | Anzahl | `19.99` | Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50). | | `add_invoice_items.0.product` | Stripe-Produkt-ID | `prod_PjfC3kWS58IoOX` | Die Kennung des Produkts, zu dem die Rechnung hinzugefügt werden soll. | | `add_invoice_items.0.currency` | Zeichenfolge | `usd` | Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine [unterstützte Währung](https://docs.stripe.com/currencies.md). | ### CSV für Ad-hoc-Preise Dieses Beispiel zeigt die Abwicklung einer Abonnementmigration unter Verwendung von [Ad-hoc-Preisen](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-items-price_data) für bestehende Produkte. ### Geben Sie die folgenden Felder für eine CSV-Datei mit Ad-hoc-Preisgestaltung an: | Attribut | Typ | Beispiel | Beschreibung | | ------------------------------------------- | -------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer` **(erforderlich)** | Stripe-Kunden-ID | `cus_xxx1` | Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll. | | `start_date` **(erforderlich)** | Zeitstempel im Epoch UNIX-Format | `1710937191` | Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen. | | `adhoc_items.0.amount` **(erforderlich)** | Anzahl | `19.99` | Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50). | | `adhoc_items.0.product` **(erforderlich)** | Stripe-Produkt-ID | `prod_NwSGSFZb7ENuTW` | Die Kennung des Produkts, das zum Ad-hoc-Preis gehört. | | `adhoc_items.0.interval` **(erforderlich)** | Tag, Woche, Monat oder Jahr | `month` | Die Abrechnungshäufigkeit. | | `adhoc_items.0.currency` **(erforderlich)** | Zeichenfolge | `usd` | Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine [unterstützte Währung](https://docs.stripe.com/currencies.md). | | `adhoc_items.0.quantity` | Anzahl | `1` | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `adhoc_items.1.amount` | Anzahl | `19.99` | Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50). | | `adhoc_items.1.interval` | Tag, Woche, Monat oder Jahr | `month` | Die Abrechnungshäufigkeit. | | `adhoc_items.1.currency` | Zeichenfolge | `usd` | Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine [unterstützte Währung](https://docs.stripe.com/currencies.md). | | `adhoc_items.1.quantity` | Anzahl | `1` | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `metadata.source` | Anzahl | `external:zuora` | Hängen Sie diese Schlüsselwert-Paare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. Sie können beliebige Metadatenfelder hinzufügen (zum Beispiel `metadata_third_party_sub_id`). Wenn es sich um eine Migration von Stripe zu Stripe handelt, geben Sie `internal:Stripe` ein. | | `metadata_third_party_sub_id` | Zeichenfolge | `subscription_1` | Hängen Sie diese Schlüsselwertpaare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. | | `automatic_tax` | Boolean | `false` | Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax. | | `billing_cycle_anchor` | Zeitstempel im Epoch UNIX-Format | `1713615591` | Legt das nächste Datum fest, an dem das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll. | | `coupon` | Stripe-Gutschein-ID | `black_friday` | Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll. | | `proration_behavior` | Enum | `create_prorations` | Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`. | | `collection_method` | Enum | `charge_automatically` oder `send_invoice` | Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Der Standardwert ist `charge_automatically`. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei Verwendung von `send_invoice` müssen Sie `days_until_due` festlegen. | | `default_tax_rate` | Stripe Tax-ID | `txr_1LPcLzAWeZvbCyjpzDA4qs1l` | Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel. | | `backdate_start_date` | Zeitstempel im Epoch UNIX-Format | `1705753518` | Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter [Rückdatierung kostenlos](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge). | | `days_until_due` | Ganze Zahl | `30` | Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dies ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist. | | `cancel_at_period_end` | Boolean | `false` | Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen. | | `add_invoice_items.0.amount` | Anzahl | `19.99` | Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50). | | `add_invoice_items.0.product` | Stripe-Produkt-ID | `prod_PjfC3kWS58IoOX` | Die Kennung des Produkts, zu dem die Rechnung hinzugefügt werden soll. | | `add_invoice_items.0.currency` | Zeichenfolge | `usd` | Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine [unterstützte Währung](https://docs.stripe.com/currencies.md). | 1. Geben Sie in der CSV-Datei die Details der Abonnements an, die Sie exportieren möchten. > #### Für Stripe-zu-Stripe-Migrationen > > Wenn Sie Abonnements innerhalb von Stripe-Konten migrieren, sehen Sie sich das [CSV-Beispiel](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#within-Stripe-accounts) an, bevor Sie eine CSV-Datei angeben und hochladen. ## Eine CSV-Datei hochladen Klicken Sie auf **CSV hochladen**. Die Größenbeschränkung für CSV-Dateien beträgt 120 MB. Stripe validiert die Datei, um zu verifizieren, dass die hochgeladenen Abonnements im erforderlichen CSV-Format vorliegen. Dieser Vorgang kann je nach Größe der Datei einige Stunden dauern. Wenn die Datei gültig ist, können Sie mit dem nächsten Schritt der Migration fortfahren. Wenn Validierungsfehler auftreten, müssen Sie die [Fehler beheben](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#resolve-validation-errors), um fortzufahren. ## Hochgeladene Abonnements prüfen Nachdem Stripe Ihre CSV-Datei validiert hat, überprüfen Sie die Übersicht Ihrer hochgeladenen Abonnements auf Unstimmigkeiten: 1. Überprüfen Sie die Zusammenfassung auf korrekte Angaben: - Datum des Uploads - Name der hochgeladenen Datei - Anzahl der Abonnements - Anzahl der Kundinnen und Kunden - Go-Live-Datum des ersten Abonnements 1. Wenn alles validiert ist, klicken Sie auf **Migration starten**. Wenn Fehler angezeigt werden, klicken Sie auf **Migration abbrechen** und starten Sie die Migration unter [CSV-Datei herunterladen](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#download-csv) erneut. ## Migrationsfortschritt verfolgen Nachdem Sie Ihre hochgeladenen Abonnements überprüft haben, verfolgen Sie den Fortschritt Ihrer Migration: | Migrationsfortschritt | Beschreibung | | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Migration läuft | Ihre Abonnements werden zum angegebenen Startdatum in die Warteschlange gestellt. Dieser Vorgang kann je nach Größe der Datei einige Minuten bis zu einigen Stunden dauern. Beispielsweise dauert die Validierung und Migration für 100.000 Abonnements etwa 30 Minuten. Das Billing-Migrations-Toolkit verwendet den [Abonnementplan](https://docs.stripe.com/api/subscription_schedules.md), um Ihre Abonnements zu migrieren. So können Ihre Abonnements 24 Stunden lang in einem geplanten Status verbleiben, bevor sie live gehen. In einer Sandbox wird die Pufferzeit für eine schnellere Auswertung und Prüfung auf 1 Stunde reduziert. | | Geplante Abonnements | Nach der Migration bleiben Ihre Abonnements 24 Stunden lang in einem geplanten Zustand, bevor sie live gehen. Sie haben 10 Stunden Zeit, um [diese geplanten Abonnements](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#cancel-migration) mit dem Toolkit zu kündigen. Sie können keine geplanten Abonnements mit dem Migrations-Toolkit aktualisieren. Wenn Sie Ihre geplanten Abonnements aktualisieren möchten, können Sie entweder den Endpoint zum [Aktualisieren](https://docs.stripe.com/api/subscription_schedules/update.md) aufrufen oder jedes Abonnement einzeln auf der Seite [Abonnements](https://dashboard.stripe.com/subscriptions) des Dashboards aktualisieren. Kunden können geplante Abonnements nicht über ihr Kundenportal kündigen. Sie können nur Live-Abonnements kündigen. | | Mit Abonnements live gehen | Nach 24 Stunden werden Ihre geplanten Abonnements live geschaltet und die Abbuchung von den Kundenkonten erfolgt zu den jeweiligen Startterminen. Sie können alle Live-Abonnements auf der Seite [Abonnements](https://dashboard.stripe.com/subscriptions) des Dashboards einsehen. Nachdem die Migration live gegangen ist, empfehlen wir Ihnen, Ihre Abonnements ab der ersten Zahlung zu überwachen. Stellen Sie sicher, dass die Abbuchungstermine und -beträge für die migrierten Abonnements mit dem angegebenen [start_date](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-start_date) übereinstimmen. Kundinnen und Kunden können ihre Live-Abonnements im Kundenportal kündigen. | | Abonnements überwachen | Überwachen Sie nach der Migration Ihre Abos auf Probleme im Zusammenhang mit Zahlungsmethoden. Überprüfen Sie beispielsweise Transaktionen auf nicht behebbare [Ablehnungscodes](https://docs.stripe.com/declines/codes.md) des Ausstellers wie `incorrect_number` und ergreifen Sie [Maßnahmen](https://docs.stripe.com/get-started/data-migrations/pan-import.md#remap-customer-ids), um sicherzustellen, dass Rechnungen bezahlt werden. Erwägen Sie, Kundinnen und Kunden mit ungültigen Zahlungsmethoden über andere Kanäle als E-Mail zu benachrichtigen, beispielsweise über SMS oder In-App-Benachrichtigungen. Wenn Sie den automatischen Zahlungseinzug verwenden, überprüfen Sie [offene oder überfällige Rechnungen](https://docs.stripe.com/billing/collection-method.md#failed-incomplete-subscriptions), um sicherzustellen, dass keine [Standardzahlungsmethoden](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings-save_default_payment_method) für die Kundinnen und Kunden fehlen. Dies kann dazu führen, dass kein Zahlungseinzug für die Rechnung möglich ist. | ## Alle Migrationen anzeigen Alle Migrationen anzeigen: 1. Wählen Sie die Migration, die Sie anzeigen möchten, in Ihren [**Migrationen**](https://dashboard.stripe.com/billing/migrations). 1. Um eine Migration zu öffnen, klicken Sie im Dropdown-Menü auf **Ansicht**. Sie können die folgenden Felder nachverfolgen: - Datei hochladen - Dateiname - Migrations-ID für Stripe-Abrechnungen - Anzahl der Abonnements - Migrationsstatus ## Optional: Migration abbrechen Wenn Sie Probleme mit den geplanten Abonnements feststellen, können Sie die Migration rückgängig machen und die geplanten Abonnements wiederherstellen. Das Dashboard zeigt einen Zeitstempel an, um anzugeben, ob Sie die Migration mit dem Toolkit noch abbrechen können. Sie haben ab dem Zeitpunkt, an dem Sie die Abonnements geplant haben, 10 Stunden Zeit, um sie zu kündigen. Nach 10 Stunden wird die Abbruchoption im Toolkit deaktiviert. Um die Migration nach 10 Stunden abzubrechen, können Sie entweder den Endpoint zum [Abbrechen](https://docs.stripe.com/api/subscription_schedules/cancel.md) aufrufen oder jedes Abonnement einzeln auf der Seite [Abonnements](https://dashboard.stripe.com/subscriptions) des Dashboards kündigen. 1. Suchen Sie die Migration, die Sie abbrechen möchten, in Ihren [Migrationen](https://dashboard.stripe.com/billing/migrations). 1. Klicken Sie im Dropdown-Menü auf **Migration abbrechen**. ## Optional: Mehrere Migrationen durchführen Sie können so viele gleichzeitige Abonnementmigrationen ausführen, wie Sie möchten. Teilen Sie bei großen Migrationen die Abonnements in Batches auf und beginnen Sie mit einem kleinen Batch. Dies kann Ihnen helfen, Validierungsprobleme schnell zu identifizieren und Zeit zu sparen. So starten Sie eine neue Migration: 1. Klicken Sie auf **Neue Migration starten**. 1. Starten Sie den Migrationsvorgang unter [CSV-Datei herunterladen](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#download-csv) erneut. Außerdem finden Sie Beispiele für CSV-Dateien für gängige [Use cases](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#migration-use-cases) für Migrationen. ## Optional: Validierungsfehler beheben Wenn die hochgeladene Datei Fehler enthält, zeigt das Toolkit eine Übersicht über die Fehler an. So beheben Sie die Fehler: 1. Klicken Sie auf **Datei herunterladen, um alle Fehler zu überprüfen**. 1. Überprüfen Sie die Spalte `processing_error`, um die Fehler anzuzeigen. 1. Korrigieren Sie alle Fehler. Häufige Fehler sind unter anderem: | Fehler | Fehlerbehebung | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | Ungültige Datumsangaben | Stellen Sie sicher, dass alle Datumsangaben im Epochen- oder Unix-Zeitstempelformat vorliegen. | | Falscher `start_date`-Bereich | Stellen Sie sicher, dass das `start_date` für jedes Abonnement mindestens 24 Stunden in der Zukunft liegt. | | Fehlende Daten | Stellen Sie sicher, dass jeder Datensatz die erforderlichen Felder enthält. | | Preis und Steuern sind unvereinbar | Stellen Sie sicher, dass die Preise für die angegebenen Steuersätze das gleiche `tax_behavior` haben (inklusiv vs. exklusiv). | 1. Klicken Sie auf **Überarbeitete Datei hochladen**, um die korrigierte CSV-Datei erneut hochzuladen (die Größenbeschränkung der CSV-Datei beträgt 120 MB). 1. Warten Sie auf die erneute Validierung, um den neuesten Validierungsstatus anzuzeigen. ## Migrationsszenarien Sie können die Anwendungsszenarien für die Migration in diesem Abschnitt ggf. auf Ihre eigene Migration anwenden. Die Zeitstempel in diesen Beispielen sind im Unix-EPOCH-Format. Die Beispiele enthalten auch Testkunden- und Preis-IDs, die Sie in einer Sandbox verwenden können. Sie können jede von Stripe bereitgestellte CSV-Vorlage ([Basic](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#basic), [Artikel mit mehreren Preisen](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#multi-price), [Ad-hoc-Preisgestaltung](https://docs.stripe.com/billing/subscriptions/import-subscriptions-toolkit.md#ad-hoc)) bei Bedarf mit einem dieser Beispiele kombinieren. ### Abonnements mit verschiedenen Preismodellen migrieren Sie können Abonnements mit Pauschalpreisen migrieren, zum Beispiel einen Basic-Plan für 100 USD pro Monat oder einen Advanced-Plan für 200 USD pro Monat. Diese Abonnements können einen oder mehrere Posten haben. **Beispiel 1 (Basic)**: Migrieren Sie ein monatliches Basisabonnement für 100 USD mit der Menge 2 ab dem 1. Januar. Das Abonnement wird automatisch mit der Standard-Zahlungsmethode belastet. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 2 | subscription_1 | | | | | keine | charge_automatically | | | | | | | | **Beispiel 2 (Artikel mit mehreren Preisen)**: Migrieren Sie die folgenden Abonnements ab dem 1. Januar, um sie automatisch mit der Standard-Zahlungsmethode zu belasten: - Ein Basic-Monatsabonnement über 100 USD mit der Menge 2 - Ein Advanced-Monatsabonnement über 200 USD mit der Menge 1 | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | items.0.price (erforderlich) | items.0.quantity | items.1.price | items.1.quantity | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | price_xxx2 | subscription_1 | | | | | | keine | charge_automatically | | | | | | | | | **Beispiel 3 (Basic)**: Migrieren Sie das folgende Abonnement ab dem 1. Januar, um es automatisch mit der Standard-Zahlungsmethode zu belasten: - Ein Basic-Monatsabonnement über 100 USD mit der Menge 2 - Eine zusätzliche Gebühr für Ad-hoc-Rechnungen in Höhe von 20 USD | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 2 | subscription_1 | | | | | keine | charge_automatically | | | | | 50 | prod_xxx1 | USD | Sie können Abonnements auch mit Ad-hoc-Preisen migrieren, wenn Sie keine festen Preisbeträge haben. **Beispiel 4 (Ad-hoc-Preisgestaltung)**: Migrieren Sie das folgende Abonnement ab dem 1. Januar, um es automatisch mit der Standard-Zahlungsmethode zu belasten: - Ein Ad-hoc-Monatsabonnement in Höhe von 153 USD mit der Menge 1 | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | adhoc_items.0.amount (erforderlich) | adhoc_items.0.product | adhoc_items.0.interval | adhoc_items.0.currency | adhoc_items.0.quantity | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | prod_xxx1 | 1 | subscription_1 | | | | | | keine | charge_automatically | | | | | | | | | ### Abonnements mit verschiedenen Zahlungseinzugsmethoden migrieren Sie können die Zahlung für die migrierten Abonnements entweder automatisch mit der standardmäßig gespeicherten Zahlungsmethode einziehen oder indem Sie eine Rechnung senden, die der Kunde/die Kundin bis zum Fälligkeitsdatum bezahlen kann. **Beispiel 1 (Basic)**: Migrieren Sie ein Jahresabonnement für 500 USD mit der Menge 1 ab dem 1. Januar, um es automatisch mit der Standard-Zahlungsmethode zu belasten. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | | | | | keine | charge_automatically | | | | | | | | **Beispiel 2 (Basic)**: Migrieren Sie ein Jahresabonnement im Wert von 500 USD mit der Menge 1 ab dem 1. Januar. Dieses Abonnement wird mit einer an den Kunden/die Kundin gesendeten Rechnung mit einer Fälligkeit von 30 Tagen abgerechnet. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | | | | | keine | send_invoice | | | 30 | | | | | ### Migration von Abonnements in unterschiedlichen Phasen des Abo-Servicezeitraums **Beispiel 1 (Basic): Migrieren Sie ein Abonnement, das verlängert werden soll**. Migrieren Sie beispielsweise ein monatliches Abonnement über 100 USD mit dem Verlängerungsdatum 1. Januar. Das Abonnement verlängert sich am 1. jedes Monats. - Legen Sie das `start_date` auf das aktuelle Verlängerungsdatum fest, damit das Abonnement sofort belastet wird. - Setzen Sie `billing_cycle_anchor` auf das Datum des nächsten Verlängerungszyklus. - Setzen Sie `proration_behavior` auf `none`. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | | subscription_1 | | 1706745600 | | | keine | charge_automatically | | | | | | | | **Beispiel 2 (Basic): Migration eines bezahlten Abos, das sich mitten in einem Rechnungsstellungszeitraum befindet**. Zum Beispiel die Migration eines monatlichen Abos über 100 USD mit ursprünglichem Startdatum 25. Dezember. Das Migrationsdatum ist der 1. Januar und das Abo verlängert sich jeden Monat am 25. - Setzen Sie `backdate_start_date` auf das ursprüngliche Startdatum des Abonnements. - Setzen Sie `billing_cycle_anchor` auf das bevorstehende Verlängerungsdatum. - `start_date` auf das Migrationsdatum setzen. - Setzen Sie `proration_behavior` auf `none`, um eine erneute Belastung der Kundin/des Kunden zu vermeiden und das Abo bis zum nächsten Rechnungsstellungszeitraum im geplanten Zustand zu belassen. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | | subscription_1 | | 1706140800 | | | keine | charge_automatically | | 1703462400 | | | | | | **Beispiel 3 (Basic): Abonnements mit Testversionen migrieren**. Migrieren Sie beispielsweise ein monatliches Basisabonnement über 100 USD, das am 1. Januar startet. Das Abonnement wird bis zum 31. Januar getestet. Nach Ablauf der Testphase wird das Abonnement automatisch mit der Standard-Zahlungsmethode belastet. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | | | | 1706659200 | keine | charge_automatically | | 1703462400 | | | | | | **Beispiel 4 (Basic): Migrieren von überfälligen Abonnements**. Migrieren Sie beispielsweise ein monatliches Abonnement im Wert von 100 US-Dollar mit einem letzten Zyklusstartdatum am 25. Dezember, das nicht bezahlt wurde. Migrieren Sie diesen mittleren Zyklus ab dem 1. Januar mit einem Verlängerungsdatum am 25. eines jeden Monats. Dadurch wird eine anteilige Rechnung vom 1. Januar bis zum 25. Januar erstellt, für die Stripe versuchen kann, die Zahlung einzuziehen. Um Abonnements zu migrieren, die sich in einem aktiven Zyklus befinden, aber im vorherigen System nicht bezahlt wurden, setzen Sie `proration_behavior` auf `create_prorations`, um sofort eine Rechnung zu erstellen und Zahlungen einzuziehen. Dies geht auch in den Dunning-Ablauf von Stripe ein, wenn die Zahlung noch unbezahlt ist. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | | 1706140800 | | | create_prorations | charge_automatically | | 1703462400 | | | | | | **Beispiel 5: Migrieren von Abonnements, die am Ende des Zyklus gekündigt werden müssen**. Nach der Migration können Sie wählen, ob diese Abonnements belastet werden sollen oder nicht, basierend auf dem Migrationszeitpunkt (in der Mitte des Zyklus oder bei der Verlängerung). Sie werden am Ende dieses Zeitraums gekündigt. Migrieren Sie beispielsweise ein monatliches Basisabonnement über 100 USD, das am 1. Januar startet. Dieses Abonnement wird am 31. Januar automatisch gekündigt. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | | 1706140800 | | | keine | charge_automatically | | 1703462400 | | | TRUE | | | ### Abonnements mit Steuern migrieren **Beispiel 1 (Basic)**: Migrieren Sie Abonnements, um Steuern automatisch zu berechnen, indem Sie Stripe Tax aktivieren. Migrieren Sie beispielsweise ein monatliches Abonnement über 100 USD ab dem 1. Januar mit aktiviertem Stripe Tax, um die Steuern automatisch zu berechnen. Das Migrations-Toolkit überprüft, ob Sie Stripe Tax im Voraus aktiviert haben und ob Kunden/Kundinnen die erforderlichen Felder zur automatischen Berechnung der Steuer angegeben haben. Stellen Sie sicher, dass Ihre Kunden/Kundinnen vor der Migration die erforderlichen Informationen bereitstellen. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | TRUE | | | | keine | charge_automatically | | | | | | | | **Beispiel 2 (Basic)**: Migrieren Sie Abonnements und berechnen Sie Steuern mit [manuellen Steuersätzen](https://dashboard.stripe.com/test/tax-rates). So migrieren Sie beispielsweise ein monatliches Basisabonnement über 100 USD ab dem 1. Januar, bei dem 10 % Steuern mit manuellen Steuersätzen erstellt werden: - Erstellen Sie eine manuelle Steuersatz über 10 % im [Dashboard](https://dashboard.stripe.com/test/tax-rates) (**Produktkatalog** > **Gutscheine**). - Verwenden Sie die Steuersatz-ID in der CSV-Vorlage der Migration. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | FALSE | 1706140800 | | | keine | charge_automatically | txr_xxx1 | | | | | | | **Beispiel 3 (Basis)**: Wenn Sie einen externen Steueranbieter wie Avalara oder Vertex verwenden: Für migrierte Abonnements, bei denen die Steuer bereits berechnet wurde, lassen Sie sowohl `automatic_tax` als auch `default_tax_rate` in der CSV-Datei leer. Nachdem die Abonnements migriert und live sind, folgen sie automatisch den Abläufen zur Steuerintegration, die Sie für neue Abonnements in Ihrer Billing-Integration eingerichtet haben. ### Abonnements mit Rabatten migrieren Das Migrations-Toolkit unterstützt nur einen Gutschein pro Abonnement. Sie können Abonnements mit Rabatten migrieren, die nach der Migration angewendet werden. So migrieren Sie beispielsweise ein monatliches Abonnement im Wert von 100 USD ab dem 1. Januar mit einem dauerhaften Rabatt von 10 %: - Erstellen Sie einen Gutschein über 10 % im [Dashboard](https://dashboard.stripe.com/test/tax-rates) (**Produktkatalog** > **Gutscheine**). - Verwenden Sie den Gutscheinnamen in der Migrations-CSV-Datei. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.third_party_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | add_invoice_items.0.amount | add_invoice_items.0.product | add_invoice_items.0.currency | | **FELD** | cus_xxxx1 | 1704067200 | price_xxx1 | 1 | subscription_1 | | | sample_coupon | | keine | charge_automatically | | | | | | | | ### Abonnements innerhalb von Stripe-Konten migrieren Die Schritte zur Migration von Abonnements von einem Stripe-Konto zu einem anderen sind die gleichen wie bei der Migration von einem Drittanbietersystem. Verwenden Sie das Billing-Migrations-Toolkit, um die Abonnementdaten für Ihre CSV-Datei aus Ihrem alten Stripe-Konto zu exportieren. So erstellen Sie eine Migrations-CSV-Datei für eine Stripe-zu-Stripe-Migration: 1. Exportieren Sie die Abonnements aus dem alten Stripe-Konto über das Dashboard. 1. Verwenden Sie das folgende CSV-Beispiel als Referenz, um Felder zwischen den alten und neuen Stripe-Konten zuzuordnen. | | | | | **ATTRIBUT** | Kundin/Kunde (erforderlich) | start_date (erforderlich) | Preis (erforderlich) | Menge | metadata.old_Stripe_sub_id | automatic_tax | billing_cycle_anchor | Gutschein | trial_end | proration_behavior | collection_method | default_tax_rate | backdate_start_date | days_until_due | cancel_at_period_end | | **FELD** | Exportfeld: Kunen-ID (aus vorherigem Kontoexport) | Exportfeld: Aktuelles Ende des Zeitraums UTC (aus vorherigem Kontoexport) | Die jeweilige Preis-ID auf dem neuen Konto | Exportfeld: Menge (aus vorherigem Kontoexport) | Exportfeld: ID (aus vorherigem Kontoexport) | TRUE, wenn Stripe-Steuern in neuem Konto verwendet wird, sonst FALSE | Das zukünftige Rechnungsdatum auf dem neuen Konto | Der jeweilige Gutschein auf dem neuen Konto, falls vorhanden | Der jeweilige Testzeitraum auf dem neuen Konto, falls vorhanden | `create_prorations` bei anteiliger Rechnung, sonst `none` | `charge_automatically` oder `send_invoice` | Der jeweilige Steuersatz auf dem neuen Konto, falls vorhanden | Exportfeld: Startdatum UTC (aus vorherigem Kontoexport) | Geben Sie an, ob `send_invoice` als Inkassomethode verwendet wird | Geben Sie an, ob ein Abonnement zum Ende des Zeitraums gekündigt werden soll | ### Abonnements mit mehreren Phasen migrieren Das Migrations-Toolkit unterstützt nicht das direkte Hinzufügen mehrerer Phasen zu einem Abonnement. Wir empfehlen die folgende Vorgehensweise: 1. Verwenden Sie das Migrations-Toolkit, um die Anfangsphase des Abonnements zu migrieren. 1. Fügen Sie nach der Migration die zusätzlichen Phasen zu den migrierten Abonnementzeitplänen hinzu. Rufen Sie dazu den [Update](https://docs.stripe.com/api/subscription_schedules/update.md)-Endpoint auf oder verwenden Sie das Stripe [Subscriptions](https://dashboard.stripe.com/test/subscriptions)-Dashboard. 1. Passen Sie das `start_date` der Migration so an, dass zwischen den geplanten und den Live-Statusänderungen genügend Zeit bleibt. So können Sie die Phasenaktualisierungen vornehmen, bevor die Abonnements live gehen. ## CSV-Referenz Für das Migrations-Toolkit müssen Sie eine CSV-Datei hochladen, die bestimmte Informationen in den korrekten Feldern enthält. ### CSV-Voraussetzungen Bevor Sie eine CSV-Datei erstellen oder herunterladen, müssen Sie sicherstellen, dass Sie Zugriff auf die folgenden Informationen haben: | | | | | **Customer-Objekt** | Alle Kunden müssen über [eine Standard-Zahlungsmethode verfügen](https://docs.stripe.com/api/payment_methods/attach.md). Ohne eine Standard-Zahlungsmethode schlagen zukünftige Abonnementzahlungen fehl. Wenn Sie nach der Migration Ihrer Daten keine Standard-Zahlungsmethode für Ihre Kunden festgelegt haben, haben Sie zwei Möglichkeiten: - Holen Sie die Zustimmung des Nutzers/der Nutzerin ein oder verlassen Sie sich auf sein/ihr früheres Zahlungsverhalten, um die Standard-Zahlungsmethode pro Kunde/Kundin festzulegen. - Verwenden Sie dieses [bereitgestellte Skript](https://gist.github.com/bsears90/c3f36bfe379dfd13cae749824c5b45ae), um die neueste Zahlungsmethode an Ihre Kunden/Kundinnen anzuhängen und zur Standardmethode zu machen. | | **Automatische Steuer** | Wenn Sie Stripe Tax verwenden (wenn Sie automatische Steuern auf „true“ festgelegt haben), müssen alle Kundinnen und Kunden entweder [Adressen oder Postleitzahlen](https://docs.stripe.com/tax/customer-locations.md) (oder beides) pro Land angeben. Stripe benötigt diese Informationen, um die Steuern für die angegebenen Abonnements zu berechnen. | | [collection_method](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-collection_method) | Wenn Sie für Ihre Abonnements die Zahlungsmethode `send_invoice` verwenden: - Fügen Sie den erforderlichen Kundinnen/Kunden E-Mail-Adressen hinzu. - Fügen Sie den Parameter [days_until_due](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-days_until_due) in der Migrations-CSV-Datei hinzu, um die Gültigkeit der *Rechnungen* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) für jede Kundin/jeden Kunden anzugeben. | | **Daten** | - Um ein genaues Timing zu gewährleisten, achten Sie besonders auf die Zeitzonen, wenn Sie Epochen-Datumsformate für Ihre Migrations-CSV-Datei erstellen. - Legen Sie für das Toolkit das [start_date](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-start_date) mit einem Spielraum von mindestens 24 Stunden vor dem CSV-Uploadzeitpunkt fest. Wir erstellen einen [Abonnementplan](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), damit Sie diese Extrazeit erhalten, um die Richtigkeit zu bestätigen und zu überprüfen. Wenn das Startdatum beginnt, wechselt das Abonnement vom geplanten Start in den Live-Status. | | **Gutscheine** | - Wenn der Abo-Zeitplan oder das Abonnement über [einen Abrechnungszyklusanker](https://docs.stripe.com/billing/subscriptions/billing-cycle.md) in der Zukunft verfügt und `proration_behavior` auf `none` [gesetzt ist](https://docs.stripe.com/billing/subscriptions/prorations.md#disable-prorations), wird der Gutschein durch das Aktualisieren dieser Objekte aufgehoben. Wenden Sie den Gutschein erneut an, wenn Sie den Abonnementplan oder das Abonnement aktualisieren. - So migrieren Sie ein Abonnement mit laufendem `discount_behavior`: - Legen Sie eine zukünftige Phase fest, in der der Gutschein zum richtigen Datum entfernt wird, anstatt auf ein Ablaufen zu warten. - Erstellen Sie einen Gutschein für jedes Abonnement, wobei die Dauer für jedes Abonnement unterschiedlich ist, damit sie alle korrekt ablaufen. | | **Stripe-zu-Stripe-Migration** | Nutzer/innen können Abonnements innerhalb von Stripe-Konten migrieren. Sie müssen Kunden-IDs und Preis-IDs (und gegebenenfalls auch Gutschrift-IDs und Steuer-IDs) in die Vorlage eingeben, die Ihrem Stripe-Zielkonto zugeordnet ist, und nicht Ihrem Stripe-Quellkonto. Das Migrations-Tool generiert einen Fehler, wenn Sie IDs eingeben, die Ihrem Quellkonto zugeordnet sind. | ### Vollständige CSV-Spezifikation | Attribut | Typ | Beschreibung | | ------------------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `customer` **(erforderlich)** | Stripe-Kunden-ID | Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll. | | `start_date` **(erforderlich)** | Zeitstempel im Epoch UNIX-Format | Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen. | | `price` **(erforderlich)** | Stripe-Preis-ID | Muss ein wiederkehrender Preis sein. Wenn Sie mehrere Artikel migrieren, verwenden Sie stattdessen das Format `items.x.{price, quantity}`. Ad-hoc-Preise werden auch mit `adhoc_items.x.{amount, interval, product, currency}` unterstützt. | | `quantity` | Anzahl | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `items.x.price` **(erforderlich)** | Stripe-Preis-ID | Die ID des Preisobjekts. Muss ein wiederkehrender Preis sein. | | `items.x.quantity` | Anzahl | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `adhoc_items.x.amount` **(erforderlich)** | Anzahl | Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50). | | `adhoc_items.x.product` **(erforderlich)** | Stripe-Produkt-ID | Die Kennung des Produkts, das zum Ad-hoc-Preis gehört. | | `adhoc_items.x.interval` **(erforderlich)** | `day`, `week`, `month` oder `year` | Die Abrechnungshäufigkeit. | | `adhoc_items.x.currency` **(erforderlich)** | Zeichenfolge | Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine [unterstützte Währung](https://docs.stripe.com/currencies.md). | | `adhoc_items.x.quantity` | Anzahl | Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen. | | `metadata_source` | Zeichenfolge | Bei einer Stripe-zu-Stripe-Migration geben Sie `internal:Stripe` ein. | | `metadata_*` | Zeichenfolge | Hängen Sie diese Schlüsselwertpaare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. | | `automatic_tax` | Boolean | Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax. | | `coupon` | Stripe-Gutschein-ID | Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll. | | `currency` | Zeichenfolge | Dreistelliger [ISO-Währungscode](https://www.iso.org/iso-4217-currency-codes.html) in Kleinbuchstaben. Muss eine [unterstützte Währung](https://docs.stripe.com/currencies.md) sein. Wird für die Währungsauswahl mit Preisen in mehreren Währungen verwendet. | | `trial_end` | Zeitstempel | Setzt die Phase auf „Test“ vom Startdatum bis zum `trial_end`-Datum. Sie müssen einen Wert angeben, der vor dem Enddatum des Zyklus/Phase liegt, und Sie können ihn nicht mit der Testversion kombinieren. | | `proration_behavior` | `create_prorations` oder `none` | Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`. | | `collection_method` | `charge_automatically` oder `send_invoice` | Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Der Standardwert ist `charge_automatically`. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei Verwendung von `send_invoice` müssen Sie `days_until_due` festlegen. | | `default_tax_rate` | Stripe Tax-ID | Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel. | | `backdate_start_date` | Zeitstempel im Epoch UNIX-Format | Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter [Rückdatierung kostenlos](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-no-charge). | | `billing_cycle_anchor` | Zeitstempel | Legt die zukünftigen Daten fest, wann das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll. | | `days_until_due` | Ganze Zahl | Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dies ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist. | | `cancel_at_period_end` | Boolean | Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen. | ## See also - [Abonnements mithilfe der Stripe-APIs migrieren](https://docs.stripe.com/billing/subscriptions/import-subscriptions.md)