Die Rest API wird nicht mehr zur Einrichtung der Schnittstelle zu Shopify verwendet.
Übersicht
Was ist Shopify?
Einrichtung der Schnittstelle
2.1 Shopify Website: Mark.One Installieren und Credentials auslesen
2.1.1 Mark One. App in Shopify installieren
2.1.2 Credentials auslesen
2.1.3 Shop URL auslesen
2.2 Schnittstelle in der Mark.One Software einrichten
1 Was ist Shopify?
Shopify ist eine cloudbasierte E-Commerce-Plattform. Mit ihr können Personen/Firmen/Betriebe einen eigenen Online-Shop erstellen, Produkte verwalten und Zahlungen abwickeln.
2 Einrichtung der Schnittstelle
Um die Kommunikation für den Austausch von Bestellungsdaten zu gewährleisten ist eine Schnittstelle zwischen Shopify und der Mark.One Software notwendig.
Die Einrichtung besteht aus einem zweistufigen Vorgang. Zu Beginn müssen die notwendigen Informationen aus Shopify herausgelesen werden. Danach werden diese zur Einrichtung in der Mark.One Software verwendet.
2.1 Shopify Website: Mark.One installieren und Credentials auslesen
Für die Einrichtung der Schnittstelle zwischen Mark.One und Shopify muss die Mark.One Software zu Beginn in Shopify integriert werden.
Im ersten Schritt müssen die Admin Zugangsdaten von Shopify organisiert werden.(durch den Kunde selber):
Benutzername + Passwort + Shop URL
Im nächsten Schritt muss die App in Shopify installiert werden, um die Credentials und die URL für die Schnittstellenverbindung herauslesen zu können.
2.1.1 Mark.One App in Shopify intallieren
Am PC in Shopify Einloggen
App herunterladen und installieren
In die Einstellungen einsteigen:
Apps auswählen:
Developapps auswählen:
Build Apps in Dev Dashboard auswählen:
Create App auswählen:
App benennen + Create:
In die neue App die Mark.One URL einfügen (https://markone.app/ ):
Unter Access (Zugriff auf Daten)- Select scopes Folgende auswählen:
- read_all_orders
- read_orders
- write_orders
- read_customers
Mit Done fertigstellen
Endergebnis unter Access einsehen --> Release auswählen (2x):
Home auswählen --> Install App
Store auswählen:
App endgültig Installieren:
Abgeschlossene Installation: App kann aufgerufen werden
2.1.2 Credentials auslesen
Nachdem die Installation der App erfolgt ist, müssen die Credentials für die Übertragung in die Mark.One App ausgelesen werden. Dies kann wie folgend dargestellt, durchgeführt werden:
Im eingeloggten Account Apps auswählen:
Develop Apps auswählen:
Build apps in Dev Dashboard auswählen:
App auswählen:
In die Einstellungen einsteigen:
Credentials können nun ausgelesen werden: Client ID und Secret müssen in die Mark.One Software übertragen werden.
2.1.3 Shop URL auslesen
Im eingeloggten Account kann unter Domains die Shop URL ausgewählt und für die Verbindung in der Mark.One Software kopiert werden.
Für die Einrichtung der Schnittstelle können alle hier aufgeführten URLs verwendet werden.
2.2 Schnittstelle in der Mark.One Software einrichten
Unter: Einstellungen - Marketplace - Webshop
Unter Webshop im Marketplace kann Shopify ausgewählt und durch Klicken auf den "inaktiv" Button die Schnittstelle aktiviert werden. Der Button ändert sich folgend auf "aktiv".
Folgende Einstellungen müssen angepasst werden:
Version: GraphQL API einstellen
Rest API ist die Vorläufer Version und wir in neuen Einrichtungen von Shopify nicht mehr verwendet.
Credentials von Shopify eintragen:
Die in Kap. 2.2.1 beschriebene Client ID und Client Secret, sowie die Shop URL können nun hier eingetragen werden:
Platzhalter Artikel, Kunde und Lieferpauschale Artikel eintragen:
Die hier einzutragenden Platzhalter erscheinen zukünftig in Bestellungen mit unbekannten Artikeln bzw. Kunden. (siehe 2.2.1 Platzhalter Artikel und Kunde)
Die Lieferpauschale Artikel kann hier falls eine besteht eingetragen werden.
Ignorierte SKUs
Hier können IDs von Artikeln, bzw. Kunden eingetragen werden, welche nicht importiert werden sollen.
2.2.1 Platzhalter Artikel und Kunde
Bei der Übertragung von Kunden und Artikel der Shopifybestellungen zu Mark.One werden alle bereits bekannten Daten (in der Mark.One Software) mit ihren Kundennummern und Artikeln übertragen.
Kann keine zugehörige Kundennummer oder Artikel gefunden werden, wird ein Platzhalter verwendet. Dieser Platzhalterkunde bzw. -artikel muss zuvor festgelegt und hier eingerichtet werden. (z.B. Shopify Sammel-Artikel/-Kunde)
Kunden Zuordnung
Die Kundennamen werden transparent übertragen, sobald der Kundenname ident zum Kundennamen in der Mark.One Software ist.
Eine weitere Option ist, die Kundennummer anzugeben. Im Benutzeraccount von Shopify kann unter Customers beim jeweiligen Kunde unter SKU (Stock Keeping Unit) die Kundennummer von der Mark.One Software hinterlegt werden. Dadurch kann der Kunde bei der Übertragung direkt zugeordnet werden.
Artikel Zuordnung
Die Artikelnamen werden transparent übertragen, sobald der Artikelname ident zum Artikelnamen in der Mark.One Software ist.
Eine weitere Option ist, die Artikel ID anzugeben. Im Benutzeraccount von Shopify kann unter Products beim jeweiligen Artikel unter SKU (Stock Keeping Unit) die Artikelnummer von der Mark.One Software hinterlegt werden. Dadurch kann der Artikel bei der Übertragung direkt zugeordnet werden.
3 Automatisierung einrichten
Unter: Automations
Für die Shopify Schnittstelle muss zur Synchronisation der Daten eine Automatisierung eingerichtet werden.
Dazu eine neue Automatisierung hinzufügen.
Ebenso muss ein Job hinzugefügt werden, hier Shopify Sync ausgewählen.
Nach der Einrichtung der Schnittstelle muss die Mark.One Seite neu geladen werden, ansonsten kann Shopify Sync als Job nicht hinzugefügt werden.
Folgende Einstellungen sind zur Job Konfiguration notwendig:
Den Job benennen (1)
Die Ausführung definieren (3)
Für die automatisierte Synchronisationen wird empfohlen Täglich auszuwählen. Die Tage, sowie die Uhrzeit können definiert werden. Ebenso kann der Zeitraum der zu synchronisierenden Jobs gewählt werden.
Option Zeitraum überschreiben
Standardmäßig werden alle Bestellungen der nächsten 14 Tage synchronisiert und übernommen.
Wenn die Synchronisation jedoch für spezielle Tage oder für einen kürzeren Zeitraum gelten soll, kann dieser hier überschrieben werden.