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.
Auf dieser Seite
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. Du kannst die Beispiel-CSV-Vorlage herunterladen, um ein Beispiel für einen Vertrag mit mehreren Positionen anzusehen.
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.
| Spalte | Beschreibung |
|---|---|
| Handle | Handles sind die eindeutigen IDs für jeden Vertrag. Ein Beispiel ist rotes Shirt. 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. Der Wert für das nächste Rechnungsdatum muss auf ein Datum und eine Uhrzeit mindestens 24 Stunden nach dem Datum und der Uhrzeit, an denen die CSV-Datei importiert wird, festgelegt werden. |
| customer_id | Die Kunden-ID. Die ID muss mit der ID eines vorhandenen Kunden in deinem Shopify-Adminbereich übereinstimmen und sollte eine Zahlenfolge sein. Beispiel: 6320530986896. |
| 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:
|
| cadence_interval | Die Zustellungsfrequenz des Abonnements. Ein Vertrag kann eines der folgenden Kadenz-Intervalle haben:
|
| 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. Die ID ist eindeutiger alphanumerischer Code. Beispiel: 24e8c839c47ef47d30ad28346d130e74. |
| delivery_price | Der Preis der Zustellung im richtigen Währungsformat. |
| delivery_method_type | Die Zustellmethode des Abonnements. Die Zustellmethode muss eine der Folgenden sein:
|
| 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 | Der ISO-Code für die Provinz bzw. den Bundesstaat der Zustelladresse. Dieses Feld wird nur für die Methoden Versand und Lokale Zustellung benötigt. |
| delivery_address_country_code | Der ISO-Code für das Land 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 – z. B. +1 (613) 555-5555. 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 – z. B. 53154087005812. 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 – z. B. 3607724288. 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 berechtigten Abonnement-App eines Drittanbieters aus dem Shopify App Store oder aus der Shopify Subscriptions-App in einem anderen Shop zu importieren.
Die CSV-Datei kann nicht zum Bearbeiten oder Überschreiben bestehender Verträge verwendet werden. Duplikate bestehender Verträge werden beim Import ignoriert.
Importieren von Verträgen aus einer Abonnement-App eines Drittanbieters
Möglicherweise kannst du Verträge aus einer Abonnement-App eines Drittanbieters importieren. Beachte die folgenden Verhaltensweisen, wenn du einen Import aus einer Drittanbieter-App durchführst:
- Wenn deine Drittanbieter-Abonnement-App nicht in den Shopify Checkout integriert ist, kannst du deine Verträge nicht importieren.
- Du kannst Daten nicht direkt aus deiner Drittanbieter-App importieren. Du musst die Vertragsdaten aus deiner Drittanbieter-App im richtigen Format zu einer mit der Shopify Subscriptions-App kompatiblen CSV hinzufügen.
- Wenn deine Abonnement-App eines Drittanbieters keine Exportfunktion hat oder wenn die exportierten Daten nicht alle erforderlichen Daten enthalten, wende dich an den App-Entwickler, um Unterstützung zu erhalten.
Schritte:
- Gehe in deinem Shopify-Adminbereich zu Subscriptions > Verträge.
- Klicke auf Importieren.
- Klicke auf Datei hinzufügen und wähle die CSV-Datei aus, die du importieren möchtest.
- 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:
- Gehe in deinem Shopify-Adminbereich zu Subscriptions > Verträge.
- Klicke auf Exportieren.