Bestellungen aus einer CSV per API erzeugen

Einleitung

Dieser Artikel erklärt dir, wie du mit der Cockpit API Bestelldaten aus einer csv Datei an das Cockpit übermittelt.

Als realistisches Beispiel nutzen wir einen CSV Order Export aus Shopify. Es kann z.B. vorkommen, dass Bestellungen in Shopify erstellt wurden, bevor die Produkte mit Shirtigo als Fulfillment-Dienstleister verknüpft waren. In diesem Fall ist es nicht möglich, diese Bestellungen nachträglich direkt über Shopify als Fulfillment-Auftrag an Shirtigo zu übertragen.

Ein praktischer Workaround besteht darin, diese Bestellungen über den Export per CSV und ein Python-Script direkt an das Shirtigo Cockpit zu übermitteln, ohne jede Bestellung manuell anzulegen. In diesem Artikel zeigen wir, wie das Python-Script genutzt werden kann, um solche Bestellungen automatisch zu übertragen.

Das Python-Script verwendet den offizielle Shirtigo Python API Client.

Voraussetzungen

Shirtigo API Zugang: Um auf die API zugreifen zu können, benötigst du einen API-Token, den du im Shirtigo Cockpit unter „Shops > API“ erstellen kannst.
Python installiert: Stelle sicher, dass Python auf deinem Computer installiert ist.
Bestellungen exportieren: Exportiere die relevanten Bestellungen als CSV-Datei aus deinem Shopify-Adminbereich.

Inhaltsverzeichnis

Schritt-für-Schritt-Anleitung

1. Installiere die benötigten Python-Abhängigkeiten

Zuerst muss der Shirtigo Python API Client installiert werden. Diesen kannst du über github runter laden: Shirtigo Python API Client.

2. CSV-Export von Shopify vorbereiten

Exportiere die Bestellungen aus Shopify, die vor der Verknüpfung mit Shirtigo eingegangen sind. Dies machst du im Shopify-Adminbereich unter Bestellungen > Exportieren.

Stelle sicher, dass der Export die folgenden relevanten Felder enthält:

Name: Name des Bestellers
Email: E-Mail-Adresse
Lineitem sku: Die SKU des bestellten Produkts
Shipping Name: Name des Empfängers
Shipping Address1: Erste Zeile der Lieferadresse
Shipping Address2: Zweite Zeile der Lieferadresse (optional)
Shipping Company: Firma des Empfängers (optional)
Shipping City: Stadt
Shipping Zip: Postleitzahl
Shipping Country: Land

3. Python-Script für die Bestellungsausführung

Das folgende Python-Script liest die CSV-Datei ein und überträgt die Bestellungen an das Shirtigo Cockpit. Für jede Bestellung, die in der CSV-Datei erfasst ist, wird ein entsprechender Auftrag im Cockpit erstellt.

Link zum Script

Anpassungen

Die folgenden Punkte muss du anpassen um das script zu benutzen.

API_TOKEN: Um das Script nutzen zu können musst du zunächst im Cockpit unter Shops > API einen API key erstellen und im Script eintragen
PATH_TO_YOUR_CSV: Hier muss du den Pfad zu deiner CSV Datei auf deinem Gerät angeben.
SKU-Anpassungen: Falls die SKUs in Shopify und Shirtigo nicht identisch sind, kannst du sie im Script mit .replace() anpassen.

4. Ausführung des Scripts

Nachdem du das Script entsprechend angepasst hast, führe es in deiner Python-Umgebung aus. Die Bestellungen werden nun automatisch an Shirtigo übermittelt.

Fehlerbehandlung: Das Script enthält grundlegende Fehlerbehandlung. Sollte ein Fehler auftreten (z.B. falsche Daten), wird das Script beendet und die problematische Bestellung ausgegeben.

Was this article helpful?

YesNo

Zurück zur Übersicht