Shopify-API-Schlüssel erstellen und Shop umziehen

Was dieser Schlüssel ist und warum Sie ihn selbst erzeugen

Shopify gibt kein Passwort heraus, mit dem ein fremder Dienst Ihren Shop lesen könnte. Stattdessen legen Sie in Ihrem eigenen Shop eine kleine App an, setzen genau fest, was sie lesen darf, und Shopify gibt dieser App ein Token. Dieses Token fügen Sie in Omniterra ein, und wir lesen Ihren Katalog darüber.

Daraus folgen zwei Dinge, beide zu Ihrem Vorteil:

Sie bestimmen, was wir sehen. Wir bekommen nur die Berechtigungen, die Sie setzen. Wir bitten um Lesezugriff, nichts, was in Ihren Shopify-Shop schreibt.
Sie können jederzeit abschalten. Löschen Sie die App in Shopify, und das Token funktioniert sofort nicht mehr – ganz ohne Nachricht an irgendwen.

Ihr Shopify-Shop läuft die ganze Zeit weiter. Nichts, was wir tun, verändert ihn.

Schritt 1 — App-Einstellungen öffnen

Gehen Sie im Shopify-Adminbereich zu Einstellungen → Apps und Vertriebskanäle → Apps entwickeln.

Wenn eine Schaltfläche Entwicklung benutzerdefinierter Apps erlauben erscheint, drücken Sie sie. Shopify fragt das einmal pro Shop, und nur der Shop-Inhaber kann es bestätigen.

Schritt 2 — App anlegen

Drücken Sie App erstellen, geben Sie ihr einen Namen, den Sie später wiedererkennen – „Omniterra Migration“ genügt – und bestätigen Sie.

Die App ist jetzt leer. Lesen kann sie noch nichts.

Schritt 3 — Berechtigungen setzen

Öffnen Sie den Reiter Konfiguration, dann Admin-API-Integration → Bearbeiten.

Setzen Sie Lesezugriff für alles, was Sie mitnehmen wollen:

Was Sie umziehen wollen	Zu setzende Berechtigung
Produkte, Varianten, Bilder	`read_products`
Kategorien	`read_products`
Kunden	`read_customers`
Bestellungen	`read_orders`, `read_all_orders`
Rabatte	`read_discounts`, `read_price_rules`
Seiten, Blogbeiträge	`read_content`
Menüs	`read_online_store_navigation`
Weiterleitungen (wichtig fürs SEO)	`read_online_store_pages`
Dateien und Bilder	`read_files`
Bestand und Standorte	`read_inventory`, `read_locations`

Drücken Sie Speichern.

Omniterra zeigt Ihnen genau diese Liste auch auf dem Import-Bildschirm, fertig zum Kopieren, und sagt Ihnen, welche noch fehlen, falls die Verbindung unvollständig zurückkommt.

Schritt 4 — App installieren und Token kopieren

Gehen Sie zum Reiter API-Zugangsdaten und drücken Sie App installieren.

Shopify zeigt jetzt das Admin-API-Zugriffstoken, eine Zeichenkette, die mit `shpat_` beginnt. Kopieren Sie es.

Lesen Sie diesen Teil genau: Shopify zeigt dieses Token nur ein einziges Mal. Wenn Sie die Seite schließen, ohne es zu kopieren, sehen Sie es nicht wieder – Sie müssen die App deinstallieren und neu installieren, um ein neues zu bekommen. Verloren ist dabei nichts, aber es sind ärgerliche fünf Minuten.

Schritt 5 — in Omniterra einfügen

Gehen Sie in Ihrem Omniterra-Adminbereich zu Produkte → Import / Export, wählen Sie Shopify, tragen Sie Ihre Shop-Adresse ein (`mein-shop.myshopify.com`) und fügen Sie das Token ein.

Drücken Sie Verbinden. Wir lesen Ihren Katalog und zeigen Ihnen, was wir gefunden haben, bevor irgendetwas geschrieben wird: wie viele Produkte, Kunden, Bestellungen, Seiten. Es bewegt sich nichts, bevor Sie es sagen.

Wenn es heißt, Berechtigungen fehlen

Das überrascht viele, deshalb vorab: Shopify meldet die Berechtigungen, die bei der Installation erteilt wurden, nicht das, was in der Konfiguration jetzt steht. Wenn Sie nach der Installation weitere Häkchen setzen, behält die App den alten, engeren Zugriff.

Die Lösung ist eine Neuinstallation: Konfiguration → Admin-API-Integration → Bearbeiten, Fehlendes setzen, Speichern, dann API-Zugangsdaten → App neu installieren. Das Token bleibt dasselbe.

Wenn Sie die App stattdessen im Dev Dashboard gebaut haben

Manche Shops haben eine App, die auf `dev.shopify.com` entstanden ist statt im Shop-Adminbereich. Der Gedanke ist derselbe, mit zwei zusätzlichen Schritten:

Bearbeiten Sie `access_scopes` in der App-Konfiguration und drücken Sie Speichern.
Drücken Sie Veröffentlichen. Ohne Veröffentlichung bleibt Ihre Änderung eine unveröffentlichte Version, die der Shop nie zu sehen bekommt.
Installieren Sie die App im Shop neu, damit die neuen Berechtigungen tatsächlich erteilt werden.

Was mitkommt und was nicht

Produkte mit ihren Varianten, Bilder, Kategorien, Kunden, Bestellungen, Rabatte, Seiten, Blogbeiträge, Menüs, Weiterleitungen und Dateien kommen alle mit.

Manches kann nicht mitkommen, und wir sagen Ihnen vorher, was – nicht hinterher: Gutscheincodes (Shopify gibt sie nie heraus), gespeicherte Kartendaten (sie gehören Ihrem Zahlungsanbieter, nicht Ihrem Shop) und installierte Fremd-Apps samt den Daten, die sie in sich behalten.

Wenn weniger Produkte ankommen als erwartet

Drei Dinge erklären fast jeden Fall, und keines davon bedeutet, dass der Import fehlgeschlagen ist.

Entwürfe und archivierte Produkte bleiben standardmäßig zurück. Shopify hält sie aus dem aktiven Katalog heraus, wir ebenso. Wenn Sie sie haben möchten, veröffentlichen Sie sie vor dem Import in Shopify, oder holen Sie sie herüber und setzen Sie sie hier anschließend auf Entwurf.

Produkte ohne Preis oder ohne Variante werden übersprungen, weil sie so nicht verkauft werden können. Sie erscheinen am Ende im Bericht, mit Namen, damit Sie genau sehen, welche und warum.

Eine Berechtigung, die Sie nach der Installation gesetzt haben, gilt erst nach einer Neuinstallation der App; das ist dieselbe Falle wie oben. Installieren Sie neu und drücken Sie dann im Import-Bildschirm auf Erneut prüfen — wir lesen Ihren Katalog noch einmal, ohne etwas anzurühren, das bereits herübergekommen ist.

Führen Sie den Import ruhig zweimal aus. Produkte werden über ihren Shopify-Handle zugeordnet, ein zweiter Durchlauf aktualisiert also, was schon hier ist, statt Dubletten anzulegen.

Wie lange es dauert

Ein Katalog mit einigen hundert Produkten ist meist in ein paar Minuten fertig. Große Shops laufen in Teilmengen, und Sie können die Seite verlassen – der Import läuft weiter, und Sie sehen den Fortschritt, wenn Sie zurückkommen.

Häufige Fragen

Verändert das etwas in meinem Shopify-Shop?

Nein. Wir lesen nur. Die Berechtigungen, die Sie erteilen, sind reine Leserechte, und Ihr Shopify-Shop verkauft genau wie vorher weiter, während Sie Omniterra ausprobieren.

Was, wenn ich das Token verliere?

App in Shopify deinstallieren und neu installieren – API-Zugangsdaten → Deinstallieren, dann App installieren. Shopify zeigt ein frisches Token. Das alte funktioniert ab der Deinstallation nicht mehr.

Kann ich Ihnen den Lesezugriff später wieder entziehen?

Ja, jederzeit. Löschen Sie die App in Shopify → Einstellungen → Apps und Vertriebskanäle → Apps entwickeln. Das Token stirbt sofort mit ihr.

Ich habe die Berechtigungen gesetzt, es heißt trotzdem, sie fehlen.

Shopify erteilt Berechtigungen bei der Installation, nicht beim Speichern der Konfiguration. Installieren Sie die App neu, dann greifen sie.

Brauche ich dafür einen Entwickler?

Nein. Jeder Schritt läuft im Shopify-Adminbereich über Schaltflächen. Aufpassen müssen Sie nur an einer Stelle: das Token kopieren, bevor Sie die Seite schließen.

Der Shopify-Schlüssel, der Ihren Shop umzieht