Anbindungen → Shopify

Zurück zu Anbindungen | Zurück zur Übersicht

Hier verwalten Sie Ihre Shopify-Shop-Konten. Über diese Anbindung werden Aufträge importiert, Bestände synchronisiert und Versandbestätigungen zurückgemeldet.

Die Anbindung an einen Shopify-Shop läuft über OAuth mit einer Custom App, die Sie einmalig im Admin Ihres Shopify-Shops anlegen. Dadurch bleibt der Zugang jederzeit in Ihrer Hand: Sie sehen die App im Shop-Admin, können Berechtigungen einsehen und die Verbindung mit einem Klick widerrufen.

Konten-Übersicht

Die Tabelle zeigt alle angelegten Shopify-Konten:

Spalte	Beschreibung
ID	Interne Konto-ID
Name	Bezeichnung des Kontos
Shop URL	URL Ihres Shopify-Shops (z.B. `beispiel.myshopify.com`)
Mandant	Zugehöriger Mandant (diese verwalten Sie unter Einstellungen → Mandanten)
Auth	`OAuth` bei neu angelegten Konten, `Legacy` bei älteren Konten mit direkt hinterlegtem Access Token
Status	`ok`, `wartet auf Autorisierung` oder eine Fehlermeldung
Artikel-Anlage	Ob neben Bestandssync auch Artikel neu in Shopify angelegt werden
Aktiv	Ja oder Nein
Aktionen	Bearbeiten, Löschen

Custom App im Shopify-Admin anlegen

Führen Sie diese Schritte einmalig pro Shop durch, bevor Sie das Konto in Scanalot anlegen:

Melden Sie sich in Ihrem Shopify-Admin an und öffnen Sie Einstellungen -> Apps und Vertriebskanäle -> Apps entwickeln.
Klicken Sie auf App erstellen, vergeben Sie einen Namen (z.B. „Scanalot") und speichern Sie.
Wechseln Sie auf den Reiter Konfiguration.
Tragen Sie unter App URL ein: https://oauth.scanalot.io/oauth/market/shopify/install
Tragen Sie unter Allowed redirection URL(s) ein: https://oauth.scanalot.io/oauth/market/shopify
Wechseln Sie zurück auf die App-Übersicht und öffnen Sie API-Anmeldedaten.
Kopieren Sie Client ID und Client Secret, diese Werte brauchen Sie gleich beim Anlegen des Kontos in Scanalot.

Neues Konto in Scanalot anlegen

Klicken Sie oben in der Aktions-Karte auf + Neues Konto.
Tragen Sie ein:
Name (frei wählbar)
Shop URL (ohne https://, z.B. beispiel.myshopify.com)
Client ID und Client Secret aus der Custom App
Location ID (optional, für Bestandszuordnung)
Mandant (Auswahl aus Ihren Mandanten)
Artikel-Anlage aktivieren (Haken setzen, wenn Scanalot auch Produkte in Shopify anlegen soll → ohne Haken werden nur Bestände synchronisiert)
Aktiv auf Ja
Klicken Sie auf Speichern und autorisieren. Es öffnet sich ein neuer Tab mit dem Shopify-Consent-Screen Ihrer eigenen Custom App.
Bestätigen Sie die Autorisierung im Shopify-Admin. Scanalot erhält daraufhin automatisch das Zugangs-Token und setzt den Status des Kontos auf ok.

Solange die Autorisierung noch nicht abgeschlossen ist, steht der Status auf wartet auf Autorisierung. Bricht die Autorisierung ab oder wird sie nicht innerhalb der Wartezeit abgeschlossen, springt der Status auf einen Fehlerwert → in dem Fall neu auf Speichern und autorisieren klicken oder das Konto neu anlegen.

Erneut autorisieren

Wenn ein Konto irgendwann in einen Fehlerstatus läuft (z.B. weil die Custom App im Shopify-Admin gelöscht und neu installiert wurde oder das Token abgelaufen ist), können Sie ohne Datenverlust neu autorisieren:

Bearbeiten in der Kontenzeile klicken.
Auf Erneut autorisieren klicken (nur bei OAuth-Konten sichtbar).
Consent-Screen im neuen Tab bestätigen.

Die Custom-App-Credentials bleiben dabei erhalten → Sie müssen nichts noch einmal eintragen.

Konto bearbeiten / löschen

Nutzen Sie die Buttons in der Aktionsspalte. Beim Bearbeiten sind Name, Shop URL, Location ID, Mandant, Artikel-Anlage und Aktiv-Status änderbar. Bei Legacy-Konten (Auth-Spalte Legacy) können Sie zusätzlich einen neuen Access Token hinterlegen → das ist der einzige Weg, ein Legacy-Konto weiter zu pflegen, ohne es neu anzulegen.

SKU-Matching (nur bei „Artikel-Anlage aus")

Wenn Sie beim Konto Artikel-Anlage aktivieren angehakt haben, legt Scanalot Produkte selbst in Shopify an und merkt sich dabei die Zuordnung, Bestandssync läuft direkt.

Wenn Sie den Haken nicht gesetzt haben, pflegen Sie die Produkte im Shopify-Admin selbst. Damit Scanalot trotzdem weiß, welche Bestände wohin gehören, gleichen wir die SKU ab. Der Abgleich läuft auf drei Wegen:

Automatisch bei jedem Auftragsimport: taucht in einer eingehenden Bestellung eine Variant auf, die Scanalot noch nicht kennt, wird sie sofort per SKU einem Scanalot-Artikel zugeordnet. Ab dem nächsten Bestands-Update funktioniert die Synchronisation für diesen Artikel.
Einmal täglich per Cron: nachts läuft ein Vollabgleich über den kompletten Shopify-Katalog. Damit werden auch Produkte gefunden, die noch nie verkauft wurden.
Manuell: im Konto-Bearbeiten-Modal auf SKU-Matching starten klicken. Praktisch, wenn Sie gerade viele Produkte im Shop angelegt haben und nicht bis zur nächsten Nacht warten wollen.

Mehrdeutige Fälle (mehrere Scanalot-Artikel oder mehrere Shopify-Varianten mit derselben SKU) werden übersprungen, es wird nichts falsch verknüpft. Der Bestand für nicht zugeordnete Artikel bleibt einfach unverändert bei Shopify.

Synchronisation

Funktion	Beschreibung
Auftragsimport	Neue Bestellungen werden regelmäßig von Shopify abgerufen und als Aufträge in Scanalot importiert
Bestandssynchronisation	Lagerbestände aus Scanalot werden an Shopify übermittelt, passend zur Verfügbarkeitsgruppe des Kontos
Artikel-Anlage	Optional: Scanalot legt neue Produkte in Shopify an (über das zentrale Feld-Mapping)
Versandbestätigung	Über Auftragsevents kann die Trackingnummer automatisch an Shopify gemeldet werden (Aktion: „Shopify Versand bestätigen")
Erstattung	Aktion „Shopify Erstattung". Läuft auf zwei Wegen automatisch, je nachdem worauf das Event greift: auf einem Original-Auftrag wird die komplette Bestellung inkl. Versand erstattet, auf einem Retoure- oder Gutschrift-Beleg nur die dort geführten Positionen mit deren Menge und deren Betrag (Teilretouren und Kulanz-Erstattungen mit reduziertem Betrag). Der Kunde bekommt eine Erstattungs-Mail von Shopify. Der Warenbestand wird nicht über Shopify zurückgebucht, das übernimmt das scanalot-Bestandsmodul.
Stornierung senden	Aktion „Shopify Stornierung". Meldet den Auftrag bei Shopify als storniert, erstattet dabei automatisch bereits bezahlte Beträge und schickt eine Storno-Mail an den Kunden. Bestand wird nicht angetastet (übernimmt scanalot).
Stornierung erkennen	Ein Cron-Job fragt alle 15 Minuten Shopify nach seit dem letzten Check stornierten Aufträgen ab. Findet er einen, wird der zugehörige Auftrag in Scanalot auf den Storno-Status verschoben, den Sie im Konto-Bearbeiten-Modal wählen. Feld leer lassen = Erkennung aus. Aufträge, die von Scanalot selbst per „Shopify Stornierung" storniert wurden, werden dabei übersprungen (keine Doppel-Bewegung).