Skip to content

shopify

Der erfolgreiche Onlineshop shopify lässt sich mit Hilfe von Synesty Studio und dem shopify Add-On an beliebige Systeme anbinden.

So können unter anderem Artikeldaten aus verschiedenen Quellen eingelesen und in shopify importiert (Lieferantenanbindung und dropshipping) und
Auftragsdaten von shopify an ein Warenwirtschafts- oder Auftragsmanagementsystem übertragen werden. 

API Zugriff einrichten

Um die shopify API über Synesty nutzen zu können, muss im shopify Dev Dashboard eine App erstellt, installiert und die Zugangsdaten anschließend in Synesty hinterlegt werden.

App installieren in shopify und Zugriffsrechte vergeben

Das Dev Dashboard ist zu finden, im Bereich Settings -> Apps -> Develop Apps.

In diesem Bereich klickt man nun auf “Create app” und gibt der App einen Namen, z.B. Synesty.

Nach der Erstellung der App sind zunächst die entsprechenden Zugriffsrechte in den Bereichen Products und Orders zu setzen.

In der darauffolgenden Ansicht müssen die benötigten Scopes(Rechte) der App zugewiesen werden. Optionale Scopes müssen nicht gesetzt werden.

Sind die entsprechenden Rechte nicht gesetzt, erhält man im Synesty Studio die Fehlermeldung IllegalStateException: HTTP status code error: 403 (Forbidden).

Anschließend klickt man auf Release. Um die App installieren zu können, klickt man auf Home und dann auf Install app.

Auf der darauffolgenden Seite muss man nur noch seinen Shop auswählen und anschließend auf Install klicken und der Prozess ist fertig.

Wurde alles richtig gemacht, wird diese auf dem Shopify Dashboard auf der linken Seite unter Apps angezeigt.

Die API-Credentials findet man im Dev Dashboard unter Settings der installierten App.

Verbindungsdaten im Synesty Studio hinterlegen

Im Synesty Studio müssen die Verbindungsdaten von shopify hinterlegt werden.

Im Synesty Studio kommt man zur Account Konfiguration auf der linken Seite unter Meine Verbindungen -> SHOPIFY

Der Accountname ist frei wählbar und wird dann zur Auswahl im jeweiligen shopify Step angezeigt.

shopifyURL - Die URL Ihres shopify Backends (Einstellungen -> Domains).

shopifyStoreType - Bestimmt Ihr RateLimit (Anzahl Aufrufe pro Sekunde)

oAuth2_client_id - Die Client ID aus den Settings der installierten App.

oAuth2_client_secret - Das Secret aus den Settings der installierten App.

oAuth2_tokenURL - Die URL Ihres shopify Backends + /admin/oauth/access_token (Bsp. https://example.myshopify.com/admin/oauth/access_token)

Ist alles korrekt hinterlegt, muss man nur noch auf den Button Konfiguration Starten klicken und die restlichen Felder werden automatisch gefüllt.

Migration von bestehenden Verbindungen auf OAuth2

Ab dem 1. Januar 2026 können Sie in shopify keine neuen “Legacy-Apps” mehr erstellen. Dies hat (vorerst) keine Auswirkungen auf bereits vorhandene Apps und die entsprechenden Shopify Verbindungen in Synesty Studio. Wenn Sie bereits eine Shopify Verbindung verwenden, die noch eine alte Authentifizierungsmethode verwendet ( “APIkey + password” oder “Admin API access token”) können Sie folgendermaßen vorgehen, um diese Verbindung auf OAuth umzustellen.

  1. Erstellen Sie zunächst eine neue shopify App, wie oben bei API Zugriff einrichten beschrieben.

  2. Hinterlegen Sie die Daten dieser App (oAuth2_client_id, oAuth2_client_secret, oAuth2_tokenURL) wie in Verbindungsdaten im Synesty Studio hinterlegen

  3. Nachdem Sie die Daten hinterlegt haben, können Sie mit klick auf “Konfiguration starten” einen neuen access token erstellen. Wenn die Konfiguration korrekt hinterlegt wurde, sollten Sie folgende Erfolgsmeldung sehen: Die Felder oAuth2_accessToken und oAuth2_expires_at sollten anschließend gefüllt sein. Sollte diese Felder leer sein, prüfen Sie bitte die Werte der Felder oAuth2_client_id, oAuth2_client_secret, oAuth2_tokenURL bzw. die Einstellungen Ihrer shopify app.

  4. Wenn der oAuth2_accessToken erfolgreich gefüllt wurde, können Sie in den Einstellungen der Verbindung “OAuth aktivieren”.

ProductDataManagement-shopify

Das shopify Add-On enthält Steps im Bereich Produktdaten, um Produkte anzulegen, zu aktualisieren und abzufragen. Auf dieser Seite sind die vorhandenen Steps aufgeführt und beschrieben.

shopifyGetProducts

Dieser Step holt alle Produkte und Varianten im angegebenen Status aus shopify.

In shopify selbst haben auch Produkte, welche keine Ausprägungen (Varianten) enthalten, mindestens ein Variantenprodukt. 

Dieses Variantenprodukt enthält Informationen zum Preis, Gewicht, barcode etc. des Produktes.

Beim Export der Produkte und Varianten wird im Ergebnis gekennzeichnet (Spalte isVariant), ob es sich bei dem exportierten Produkt um ein Variantenprodukt (isVariant=Y) oder um ein einfaches Produkt ohne Ausprägungen handelt (isVariant=N).

Step Konfiguration

Zur Verwendung dieses Steps muss man die Verbindungsdaten zu shopify (account) hinterlegen.
Siehe Verbindungsdaten im Synesty Studio hinterlegen

Die Produktabfrage selbst kann durch verschiedene Filter noch konfiguriert werden, um nur bestimmte Produkte zu erhalten.
Weitere Informationen dazu findet man unter Inputs in der Step Beschreibung <<hier>>.

shopify Zugriffsrechte

Products (View or manage products, variants, and collections) = read_products

shopifyUpdateProductInformation

Mit diesem Step können bei bereits im shopify angelegten Produkten die Produktinformationen, wie Titel, Beschreibung, Produkttyp, Tags und Bilder aktualisiert werden. Auch ist es möglich über diesen Step ein Produkt im Webshop an- und auszuschalten und den Verkaufskanal zuzuordnen.

Step Konfiguration

Zur Verwendung dieses Step muss man die Verbindungsdaten zu shopify (account) und das limit (limit) konfigurieren.

Der Input für diesen Step ist ein Spreadsheet, welches die zu übertragenden Produktinformationen enthält. Eine Liste der möglichen Werte finden Sie <<hier>>

shopify Zugriffsrechte

Products (View or manage products, variants, and collections) = write_products & read_products

shopifyUpdatePriceAndBarcode

Mit diesem Step können bei Produkten/Varianten der Preis und der Barcode (barcode, EAN, UPC oder ISBN) gesetzt werden.

Step Konfiguration

Zur Verwendung dieses Step muss man die Verbindungsdaten zu shopify (account) und das limit (limit) konfigurieren.

Der Input für diesen Step ist ein Spreadsheet, welches die zu übertragenden Produktinformationen enthält. Eine Liste der möglichen Werte finden Sie <<hier>>.

Beispiel für Nutzung des Steps:

shopify Zugriffsrechte

Products (View or manage products, variants, and collections) = write_products & read_products

shopifyGetLocations

Dieser Step holt die Informationen zu allen in shopify angelegten Locations. Die ermittelte location_id wird unter anderem in den Steps shopifySetInventoryLevel und shopifyOrderFulfillment als Pflichteingabe benötigt.  

shopifySetInventoryLevel

Mit diesem Step kann der Bestand an einem Produkt gesetzt werden.

Optionale Eingabefelder

Die optionalen Eingabefelder id, product_id, sku und barcode können mit übergeben werden. Diese Felder werden bei allen Ausgaben in den Ergebnistabellen wieder mit ausgegeben. Dadurch ist es zum Beispiel möglich, gespeicherte Artikelinformationen in einem datastore nach der Ausführung des Steps zu aktualisieren. 

shopifyAddSingleProducts

Mit diesem Step können Produkte ohne Varianten in shopify angelegt werden.

Ergebnisliste von shopifyAddSingleProducts

Nach erfolgreicher Ausführung des Steps erhält man als Ergebnis alle in shopify angelegten Produkte inklusive der von shopify vergebenen internen ID.

Die Ergebnisliste entspricht der Liste von shopifyGetProducts.

Step Konfiguration

Zur Verwendung dieses Step muss man die Verbindungsdaten zu shopify (account) und das limit (limit) konfigurieren.

Der Input für diesen Step ist ein Spreadsheet, welches die zu übertragenden Produktinformationen enthält. Eine Liste der möglichen Werte finden Sie <<hier>>.

shopify Zugriffsrechte

Products (View or manage products, variants, and collections) = write_products & read_products

shopifyUploadProductImages

Mit diesem Step können Produkten bzw. Varianten Bilder hinzugefügt werden.

OrderDataManagement-shopify

Das shopify Add-On enthält Steps im Bereich Auftragsdaten, um Aufträge anzulegen, zu aktualisieren und abzufragen sowie den Versand und die Retouren zu managen.Auf dieser Seite sind die vorhandenen Steps aufgeführt und beschrieben.

shopifyGetOrders

Mit diesem Step werden alle Aufträge im gewählten Status und ab dem angegeben Auftragserstelldatum geholt.

Als Ergebnis erhält man eine Tabelle mit den Auftragskopfdaten und den dazugehörigen Auftragspositionen.

Step Konfiguration

Zur Verwendung dieses Step muss man die Verbindungsdaten zu shopify (account), den zu exportierenden Auftragsstatus (status) und Datum/Zeit der Auftragserstellung (created_at_from), ab welchen exportiert werden soll, konfigurieren.

Analog kann der Parameter created_at_toverwendet werden, der fest legt bis zu welchen Datum die Auftragserstellung erfolgt ist. 

Außerdem kann der Bereich des Aktualisierungsdatums (updated_at_from, updated_at_to) und der Bereich des Bearbeitungsdatums (processed_at_from, processed_at_to) festgelegt werden.

Zusätzlich kann nach der sales_channel, einem tagoder speziell nach order ids(einzeln oder als Komma separierte Liste mehrerer order ids) gefiltert werden.

Werden ids angegeben, werden alle anderen Filter übergangen so das unabhängig vom Status der Auftrag immer ausgegeben wird.

shopify Zugriffsrechte

Orders (View or manage orders, transactions, fulfillments, and abandoned checkouts) = read_orders

shopifyOrderFulfillment

Mit diesem Step können an einem Auftrag Trackinginformationen hinterlegt werden. Es ist weiterhin möglich festzulegen, ob der Kunde nach Hinterlegung der Trackinginformationen

eine E-Mail von shopify mit den Trackinginformationen erhält. Der Auftrag wird im shopify als fulfilled markiert.

Step Konfiguration

Zur Verwendung dieses Step muss man die Verbindungsdaten zu shopify (account) und das limit (limit) konfigurieren.

Der Input für diesen Step ist ein Spreadsheet, welches die oben genannten Werte enthält und über das Mapping im Step zu konfigurieren ist.

shopify Zugriffsrechte

Orders (View or manage orders, transactions, fulfillments, and abandoned checkouts) = write_orders & read_orders

Steps im shopify Add-On

Weitere Informationen