Shopify verbinden

Hinweis: Die fett gesetzten englischen Bezeichnungen entsprechen den Bedienelementen. Je nach Sprache können diese übersetzt erscheinen.

Eine Shopify-Verbindung importiert Bestellungen, Erstattungen, Zahlungen und Fulfillment-Daten. Unterstützte Warenbewegungen erscheinen auch unter Interne Lagertransfers.

Vorbereitung

Sie benötigen Zugang zur Shopify-Verwaltung des Shops sowie die Berechtigung, Apps zu erstellen und zu installieren. Falls diese Optionen fehlen, bitten Sie den Shop-Inhaber um Unterstützung.

Die App muss in derselben Shopify-Organisation wie der Shop erstellt werden. Bei der Einrichtung durch eine Agentur ist die Organisation des Shop-Inhabers zu verwenden. Der Zugriff über ein Agenturkonto allein reicht nicht aus.

Öffnen Sie in Shopify Settings → Domains und kopieren Sie die genaue Domain mit der Endung *.myshopify.com, zum Beispiel example.myshopify.com. Übernehmen Sie auch alle Präfixe und Zahlen.

Shopify-App erstellen und installieren

Wenn bereits eine geeignete App vorhanden ist, öffnen Sie diese und prüfen Sie die Berechtigungen und Installation.

1. Öffnen Sie das Shopify Dev Dashboard und wählen Sie die Organisation aus, der der Shop gehört.
2. Wählen Sie Apps → Create app → Start from Dev Dashboard. Geben Sie einen verständlichen Namen wie „Balta Labs Verbindung“ ein und wählen Sie Create.
3. Legen Sie unter Versions die Zugriffsrechte, genannt Scopes, fest: read_orders für Bestellungen und read_locations für Standorte. Ergänzen Sie read_all_orders, wenn Sie Bestellungen importieren möchten, die älter als 60 Tage sind. Falls Shopify eine App URL verlangt, können Sie die Standardadresse https://shopify.dev/apps/default-app-home verwenden.
4. Wählen Sie Release, damit die Konfiguration installiert werden kann.
5. Öffnen Sie die App-Übersicht und wählen Sie im Bereich Installs die Aktion Install app. Wählen Sie den richtigen Shop, prüfen Sie die angeforderten Rechte und bestätigen Sie in Shopify mit Install. Das Erstellen der App allein verbindet sie noch nicht mit dem Shop.
6. Öffnen Sie in derselben App Settings → Credentials und kopieren Sie Client ID und Client secret. Bewahren Sie das Secret vertraulich auf.

Für Lagertransfers sind zusätzlich read_inventory, read_inventory_transfers und read_inventory_shipments erforderlich. Diese Rechte werden unabhängig vom einfachen Verbindungstest benötigt. Nach Änderungen an den Rechten müssen Sie die aktualisierte Version freigeben und den neuen Zugriff im Shop bestätigen, wenn Shopify dazu auffordert.

Die Shopify-Anleitung zur App-Einrichtung erläutert die einzelnen Ansichten.

Shop in Balta Labs hinzufügen

1. Öffnen Sie Settings → Connections → Add account → Shopify.
2. Geben Sie optional einen Connection name sowie die genaue Shop domain, Client ID und Client secret der installierten App ein.
3. Wählen Sie Save credentials und anschließend Test auf der Verbindungskarte.
4. Öffnen Sie nach einem erfolgreichen Test Explore, um die erteilten Rechte zu prüfen. Achten Sie bei historischen Importen auf den Zugriff auf ältere Bestellungen.
5. Wählen Sie Start import. Bei Test & start import wird die Verbindung vor dem Start geprüft. Der Fortschritt erscheint unter der Verbindung.

Verbinden Sie jeden Shop separat. Das Speichern der Zugangsdaten bestätigt die Verbindung noch nicht. Connected erscheint nach einem erfolgreichen Test.

Häufige Probleme

Shopify meldet, dass die App nicht installiert ist

Öffnen Sie im Dev Dashboard die App, deren Zugangsdaten Sie eingetragen haben. Installieren Sie sie auf dem Shop, der zur gespeicherten Domain gehört, und prüfen Sie die Liste der installierten Apps im Shop. Eine Installation auf einem anderen Shop reicht nicht aus. Wählen Sie danach in Balta Labs erneut Test.

Shopify lehnt die Zugangsdaten ab

Beide Werte müssen aus Settings → Credentials derselben installierten App stammen. Ein Admin-API-Zugriffstoken oder Storefront-Token ersetzt das Client secret nicht. Korrigieren Sie die Werte unter Manage, speichern Sie und testen Sie erneut. Leere Zugangsdatenfelder behalten den gespeicherten Wert bei.

Der Shop wird nicht gefunden oder kann nicht ausgewählt werden

Kopieren Sie die Domain aus Settings → Domains in Shopify. Raten Sie sie nicht anhand des Shop-Namens und verwenden Sie nicht die öffentliche Website-Adresse. Fehlt der Shop bei der Installation, prüfen Sie die ausgewählte Organisation und bitten Sie den Shop-Inhaber, Ihren Zugriff zu bestätigen. Die Shopify-Verbindungsvoraussetzungen erläutern die Organisationsbeschränkung.

Test ist erfolgreich, aber Bestellungen oder Transfers fehlen

Der Test bestätigt die Erreichbarkeit mit den gespeicherten Zugangsdaten. Prüfen Sie unter Explore die Rechte für die gewünschten Daten. Ältere Bestellungen benötigen read_all_orders zusammen mit read_orders; Transfers benötigen die oben genannten zusätzlichen Inventarrechte. Geben Sie die Änderungen frei, bestätigen Sie sie in Shopify und testen und importieren Sie erneut. Die Shopify-Berechtigungsübersicht beschreibt mögliche zusätzliche Freigaben.

Die Verbindung ist fehlgeschlagen und der Import ist deaktiviert

Test und Manage bleiben verfügbar. Korrigieren Sie Installation oder Einstellungen und testen Sie erneut. Nach einem erfolgreichen Test sind Import und Wiederholung wieder möglich. Wenn die unveränderte Einrichtung zuvor funktioniert hat, warten Sie kurz und versuchen Sie Test erneut; Shopify könnte vorübergehend nicht erreichbar sein.