Eine Vertrags-CSV importieren und exportieren

Du kannst eine CSV-Datei (kommagetrennte Werte) verwenden, um Verträge aus einer Abonnement-App eines Drittanbieters in die Shopify Subscriptions-App zu importieren oder Verträge aus der Shopify Subscriptions-App zu exportieren.

Weitere Informationen zur Verwendung von CSV-Dateien findest du unter Eine CSV-Datei öffnen und bearbeiten.

Beispiel-CSV-Datei herunterladen

Du kannst eine CSV-Beispieldatei für Verträge herunterladen und anzeigen, die du als Vorlage verwenden kannst.

Überlegungen zur Vertrags-CSV-Datei

Bevor du die Vertrags-CSV-Datei zum Importieren von Verträgen verwendest, solltest du die folgenden Überlegungen berücksichtigen.

Die CSV-Datei formatieren

Damit deine Vertrags-CSV-Datei richtig importiert werden kann, überprüfe, ob sie die folgenden Kriterien erfüllt:

  • Die erste Zeile deiner Produkt-CSV-Datei muss die Spaltenüberschriften enthalten, wie in der Tabelle für die Vertrags-CSV-Beschreibung angegeben.
  • Jede Spalte muss durch ein Komma getrennt werden.
  • Eine CSV-Datei kann eine Maximalgröße von 10 MB haben.

Die Spalte "Handle" verstehen

Der Handle wird verwendet, um jeden Vertrag eindeutig zu identifizieren. Handles werden verwendet, um Daten auf folgende Weise zu verwalten:

  • Verträge mit mehreren Positionen gruppieren: Verträge mit mehreren Positionen werden durch einen geteilten Handle gruppiert.
  • Duplizieren von Verträgen verhindern: Duplizierte Verträge werden beim Import ignoriert. Wenn zuvor eine Zeile mit demselben Handle erfolgreich importiert wurde, wird diese Zeile im neuen Importprozess übersprungen. Dieser Mechanismus hilft dabei, die Duplizierung von Daten zu vermeiden.

Verträge mit mehreren Positionen

Verträge, die mehrere Positionen enthalten, benötigen eine separate Zeile für jede Position und werden zusammen mit der Spalte Handle gruppiert.

Wenn ein Vertrag beispielsweise drei Positionen hat, muss jede Position als separate Zeile hinzugefügt werden. Die erste Zeile enthält alle Vertragsinformationen, und die nächsten beiden Zeilen enthalten nur die Werte der folgenden Spalten:

  • handle
  • line_variant_id
  • line_variant_id
  • line_current_price
  • optional: line_selling_plan_id
  • optional: line_selling_plan_name

Der Handle muss für alle drei Spalten identisch sein. Alle anderen Spalten in den Zeilen zwei und drei müssen leer sein.

Beschreibung der CSV-Datei

Die in der Vertrags-CSV verwendeten Informationen fallen in die folgenden Kategorien: * Der Name des Vertrags * Kunden- und Abrechnungsdaten * Zustellmethode und -informationen * Die im Abonnement enthaltenen Artikel

Alle Spalten müssen der CSV-Datei hinzugefügt werden, um richtig importiert werden zu können, und alle Felder sind erforderlich, sofern nicht anders angegeben.

Beschreibung der Spalten in der CSV-Datei für Verträge
Spalte Beschreibung
Handle Handles sind die eindeutigen IDs für jeden Vertrag. Handles können Buchstaben und Zahlen enthalten und sind in der Regel eine kombinierte Zeichenfolge aus Buchstaben, Zahlen oder beidem. Jeder Vertrag muss einen einzigartigen Handle haben.
upcoming_billing_date Das nächste Rechnungsdatum für den Vertrag. Die Zeit ist in UTC (koordinierte Weltzeit) und muss das Format JJJJ-MM-TTTHH:MM:SSZ aufweisen. Zum Beispiel wird die Uhrzeit 15:50 Uhr am 7. September 2019 in der Zeitzone UTC (koordinierte Weltzeit) als 2019-09-07T15:50:00Z dargestellt.
customer_id Die Kunden-ID. Die ID muss mit der ID eines bestehenden Kunden in deinem Shopify-Adminbereich übereinstimmen.
currency_code Der Währungscode des Vertrags. Der Währungscode muss mit einer Währung übereinstimmen, die in deinem Shop aktiv ist.
status Der Status des Vertrags. Verträge können einen der folgenden Status haben:
  • Aktiv
  • Pausiert
cadence_interval Die Zustellungsfrequenz des Abonnements. Ein Vertrag kann eines der folgenden Kadenz-Intervalle haben:
  • Woche
  • Monat
  • Jahr
cadence_interval_count Die Zustellungsfrequenz des Abonnements innerhalb des Gesamtzeitintervalls. Zum Beispiel ist die Anzahl der Kadenz-Intervalle für jeden Monat 1, und das Kadenz-Intervall für alle zwei Wochen 2.
customer_payment_method_id Die ID der Zahlungsmethode, die vom Kunden für den Vertrag verwendet wurde.
delivery_price Der Preis der Zustellung im richtigen Währungsformat.
delivery_method_type Die Zustellmethode des Abonnements. Die Zustellmethode muss eine der Folgenden sein:
  • Versand
  • Lokale Zustellung
  • Abholen
  • Keine
delivery_address_first_name Der Vorname des Empfängers auf der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellungbenötigt.
delivery_address_last_name Der Nachname des Empfängers in der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_address_address1 Die erste Zeile der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_address_address2 Die zweite Zeile der Zustelladresse. Dieses Feld wird nur benötigt, wenn die Adresse ein zweites Feld hat und die Zustellmethode Versand oder Lokale Zustellung ist.
delivery_address_city Der Ort der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_address_province_code Die Provinz bzw. der Bundesstaat der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_address_country_code Der Ländercode der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_address_company Der Unternehmensname der Zustelladresse. Dieses Feld wird nur benötigt, wenn die Bestellung für ein Unternehmen und die Zustellmethode Versand oder Lokale Zustellung ist.
delivery_address_zip Die Postleitzahl der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_address_phone Die Telefonnummer der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt.
delivery_local_delivery_phone Die Telefonnummer der Zustelladresse. Dieses Feld wird für Abonnements mit der Methode Lokale Zustellung benötigt.
delivery_local_delivery_instructions Anweisungen für die lokale Zustellung. Dieses Feld muss nur enthalten sein, wenn Anweisungen für Abonnements mit der Methode Lokale Zustellung bereitgestellt werden.
delivery_pickup_method_location_id Die Standort-ID für die Abholmethode. Dieses Feld wird nur für Abonnements mit der Methode Lokale Zustellung benötigt.
line_variant_id Die ID jeder Position, die im Abonnement enthalten ist. Wenn mehrere Positionen im Abonnement enthalten sind, muss jede Position als neue Zeile mit der eindeutigen Varianten-ID hinzugefügt werden.
line_quantity Die Menge jeder Position, die im Abonnement enthalten ist. Wenn mehrere Positionen im Abonnement enthalten sind, sollte die hinzugefügte Menge für diesen spezifischen Artikel und nicht die Gesamtmenge aller enthaltenen Artikel gelten.
line_current_price Der Preis der Abonnement-Position im richtigen Währungsformat.
line_selling_plan_id Die ID des Abonnements. Dieses Feld ist optional.
line_selling_plan_name Der Name des Abonnements. Dieses Feld ist optional.

Verträge mit einer CSV-Datei importieren

Du kannst eine CSV-Datei verwenden, um bestehende Verträge aus einer Drittanbieter-Abonnement-App aus dem Shopify App Store oder einem anderen Shopify-Shop in deine Shopify Subscriptions-App zu importieren. Die CSV-Datei kann nicht zum Bearbeiten oder Überschreiben bestehender Verträge verwendet werden. Duplikate bestehender Verträge werden beim Import ignoriert.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Subscriptions > Verträge.
  2. Klicke auf Importieren.
  3. Klicke auf Datei hinzufügen und wähle die CSV-Datei aus, die du importieren möchtest.
  4. Klicke auf Datei hochladen.

Nachdem deine CSV-Datei hochgeladen wurde, erhältst du eine Bestätigungs-E-Mail von Shopify an die E-Mail-Adresse, mit der du deinen Shopify-Shop eingerichtet hast. Lies Lösungsvorschläge für häufig aufgetretene Importfehler, um alle Importprobleme zu lösen.

Verträge mit einer CSV-Datei exportieren

Du kannst deine Verträge für deine Datensätze exportieren oder in einen anderen Shopify-Store importieren, in dem du die Shopify Subscriptions-App installiert hast.

Schritte:

  1. Gehe in deinem Shopify-Adminbereich zu Subscriptions > Verträge.
  2. Klicke auf Exportieren.

Bereit, mit Shopify zu verkaufen?

Kostenlos testen