Inhalt
Beachten Sie:
Aktuell werden beim Einsatz von Shopify mit büro+ folgende Funktionen unterstützt
- Synchronisierung von Adressen
- Synchronisierung von Vorgängen
1. Hinweise zur Nutzung
Direkt in microtech büro+ integrierte Lösung
- Die Anbindung von Shopify erfolgt direkt in büro+ mittels microtech Cloud und stellt somit langfristig eine voll-integrierte Lösung in microtech büro+ dar.
- Der Zugriff auf Shopify erfolgt über die im Shopsystem integrierte REST-API.
- Durch den Abruf der Vorgänge erhalten Sie relevante Informationen für die weitere Abwicklung der Transaktion, z. B. wie die Anschrift des Kunden, (PayPal) Transaktionsnummer, etc.
- Über Anpassungen im Standard-Layout von Shopify lässt sich auch ein Text über den Warenkorb in den Vorgang von microtech büro+ - Register: INFO einladen (z. B. ein Text für den Gruß auf einer Karte oder einer Geschenkverpackung, etc.).
Allgemeine Systemvoraussetzungen
- Die allgemeinen Systemvoraussetzungen für microtech büro+ können unserer Website entnommen werden: Systemvoraussetzungen.
- Sie haben die Registrierung für die microtech Cloud durchgeführt. Die Daten für die Cloud haben Sie nach der Registrierung in den Parametern von microtech büro+ unter "Sonstige" - "Zugangsdaten" hinterlegt.
Systemvoraussetzungen zur Nutzung von microtech büro+ gemeinsam mit Shopify
- Modul Warenwirtschaft und microtech E-Commerce (Version: siehe Systemvoraussetzungen).
Shopify-Lizenz / -Account - Weitere Informationen unter: https://www.shopify.com/de (Externer Link).
Beachten Sie:
Im Vorfeld muss die Installation des Shopsystem auf einem öffentlich zugänglichen Server erfolgt sein.
2. Vorbereitende Maßnahmen
Installation von Shopify auf dem Server
Installieren Sie Shopify auf einem Server. Überlegen Sie dazu bitte im Vorfeld, wie das Hosting des Online-Shops vonstatten gehen soll.
Für das Zusammenspiel von microtech büro+ mit Shopify werden Sicherheitsmerkmale wie die API des Shops für den Zugang benötigt (genauere Informationen finden Sie in dieser Dokumentation).
"Custom App" / "Benutzerdefinierte App" erstellen und einrichten
Loggen Sie sich mit Ihrem MyShopify-Account in das Backend ein. Wechseln Sie in der linken Navigation auf "Einstellungen".
Wählen Sie in der linken Navigation den Eintrag: "Apps und Vertriebskanäle". Wählen Sie nun die Schaltfläche: "Apps erstellen".
Im Bereich: "App-Entwicklung" wählen Sie nun die Schaltfläche: "Eine App erstellen".
Im Menüpunkt: "Eine App erstellen" vergeben Sie als App-Namen z. B. "microtech Software".
Wählen Sie als App-Entwickler aus der Auswahlliste Ihren Eintrag mit Ihrer E-Mail-Adresse. Bestätigen Sie die Auswahl im Anschluss über die Schaltfläche: "App erstellen".
Im Entwicklungsverlauf sehen Sie nun die erstellte App.
Wechseln Sie auf die Registerkarte: API-ANMELDEDATEN.
Kopieren Sie den API Schlüssel und den geheimen API-Schlüssel und legen Sie diesen an einem nur für Sie zugänglichen Bereich ab.
Wählen Sie nun im Bereich: ZUGRIFFSTOKEN die Schaltfläche: "Admin-API-Bereiche konfigurieren".
An dieser Stelle vergeben Sie die benötigten Zugriffsrechte zur API.
Nachdem Sie alle Einstellungen vorgenommen haben, bestätigen Sie im Bereich der Konfiguration mit der Schaltfläche: SPEICHERN die Übernahme der Einstellungen.
Im Anschluss kann die "Custom App" installiert werden.
Abhängig davon, welche API-Bereiche der App zugewiesen wurden, erhalten Sie einen Admin-API-Zugriffstoken ("Admin API Access Token"), einen Storefront-API-Zugriffstoken oder beide.
Bitte beachten Sie auch die Hilfestellungen der Shopify-Dokumentation an dieser Stelle.
Info:
Weitere Informationen zum Anlegen einer "Custom App" / "Benutzerdefinierten App":
- https://help.shopify.com/de/manual/apps/custom-apps (Externer Link)
- https://help.shopify.com/de/manual/apps/app-types#benutzerdefinierte-apps (Externer Link)
Wechseln Sie nun zurück auf das Register: API-ANMELDEDATEN. Wählen Sie den Eintrag: "App installieren".
Sie erhalten die Abfrage: "microtech Software in (Ihrem Konto) installieren"? Bestätigen Sie den Hinweis mit: INSTALLIEREN.
Fragen Sie nun in den API-Anmeldedaten von Shopify den Admin-API-Zugriffstoken ab.
Beachten Sie:
Der Admin-API-Token lässt sich lediglich ein einziges Mal einblenden!
Kopieren und speichern Sie diesen Token an einem nur für Sie zugänglichen Bereich. Der Token darf nicht verlorengehen, da er nicht erneut eingeblendet werden kann.
Beachten Sie:
Für den nächsten Schritt behalten Sie bitte das Fenster mit den Anmeldedaten im Browser geöffnet und öffnen Sie parallel microtech büro+, um die Zugangsdaten in der Software zu erfassen.
Notieren Sie sich auch das nur einmalig einblendbare Admin-API-Token an einem sicheren, nur für Sie zugänglichen Ort.
3. Plattform "Shopify" in büro+ anlegen und Zugangsdaten eintragen
Navigieren Sie in den Bereich: E-COMMERCE - STAMMDATEN - Register: PLATTFORMEN - und erstellen Sie über die Schaltfläche: NEU einen Plattform-Datensatz.
Als Plattform-Typ ist "Shopify" zu wählen.
Beachten Sie:
Bei der Vergabe des Namens (Bezeichnung) des Plattform-Datensatzes muss darauf geachtet werden, dass dieser in der gesamten Cloud einmalig sein muss, z. B.: "Shopify-Shop " + [Ihre Kundennummer] = "Shopify-Shop 123456".
Hintergrund:
In Ihrem Cloudzugang darf eine Bezeichnung für eine Plattform nur einmal genutzt werden. Wenn Sie Ihren Cloud-Zugang z. B. dafür nutzen, neben Ihrer Live-Plattform auch noch einen Test-Shop anzubinden, ist es zwingend notwendig, eine andere Bezeichnung für die Anlage der Plattform in büro+ zu nutzen, damit diese fehlerfrei vom bestehenden Live-System unterschieden werden kann.
Zugangsdaten im Plattform-Datensatz von microtech büro+ erfassen
| Felder in der büro+ | API Sicherheitsmerkmale aus der "Custom App" |
|---|---|
| ApiKey | API Key |
| Passwort | Admin API Access Token |
| Shopname | Als Shopname kopieren Sie die Subdomain der zugehörigen Shop-URL, ohne "www." oder "http bzw. https://" Beispiel:
Tipp: Im Backend von Shopify ganz links unten, existiert die Schaltfläche für "Settings / Einstellungen". |
Nachdem Sie die Zugangsdaten in büro+ eingegeben haben, schalten Sie die Plattform über das Kennzeichen: AKTIV ein und verlassen Sie das Fenster mittels "Speichern & schließen".
4. Bestell-Status für Shopify mittels microtech büro+ übermitteln
Der Status der Bestellung kann über microtech büro+ an das Shopsystem übermittelt werden.
| Status-Art | Status-Wert | Weitere Informationen |
|---|---|---|
| fulfillment | create |
|
Weitere Status-Werte:
| Status-Art | Status-Wert | Weitere Informationen |
|---|---|---|
| fulfillment | cancel | Bestellung abgebrochen. |
| fulfillment | hold | Bestellung ist in "Wartestellung" (z. B. wegen ausverkaufter Ware, einer nicht auffindbaren Adresse, etc.). |
| fulfillment | release | Der Eintrag "release" löst lediglich den Status "hold" auf. |
Tipp:
In unserem Shopware 6-Bereich haben wir einige Beispiele für die Übertragung des Bestell-Status an die Plattform aufgeführt. Nutzen diese Beispiele in abgewandelter Form für die Übertragung des Bestell-Status an Shopify (Shopware 6 - Vorgänge - Statusprotokoll-Übertragung an Shopsystem sowie Shopware 6 - Übertragung der Status-Protokolle mittels der Bereichs-Aktionen).
5. Optional: Anmerkungen in Shopify-Bestellungen anbieten (Warenkorb) und in microtech büro+ anzeigen (im Vorgang)
In Shopify besteht die Möglichkeit zu einer Bestellung im Warenkorb eine Information erfassen zu können, wie z. B.: "Bestellung als Geschenk mit Grußbotschaft".
Beachten Sie:
Für die Anzeige eines solchen Feldes im Warenkorb des Shops sind entsprechend Anpassungen im Layout von Shopify vorzunehmen, um das Kommentarfeld einzublenden. Sprechen Sie ggf. mit Ihrem Shop-Betreiber. Die Eintragungen in das Feld werden beim Abruf der Vorgänge aus der Plattform in microtech büro+ eingeladen und auf dem Register: INFO des Vorgangs angezeigt.
6. Optional: Rabattcode für bestimmte Artikel in Shopify anbieten
Erfassung des Rabattcodes im Warenkorb von Shopfiy
Über die Eingabe eines Rabattcodes im Warenkorb von Shopify können Kunden direkt einen Rabatt im Warenkorb für berechtigte Artikel erzielen. Der Rabatt wird beim Einladen des zugehörigen Vorgangs in microtech büro+ entsprechend berücksichtigt. Rabattcodes lassen sich im Backend von Shopify anlegen.
Damit ein Rabattcode in die Positionen des Vorgangs in der Software eingeladen werden kann, ist es notwendig zuvor einen Dummy-Artikel in microtech büro+ anzulegen.
Weitere Informationen erhalten Sie in folgendem Bereich der Hilfe: Konfiguration Vorgangserzeugung: Abruf der Transaktionen aus Shop/Marktplatz festlegen.
Über die Anwendung des Rabattcodes im Warenkorb wird der Preis für den rabattfähigen Artikel, zu dem dieser Code gehört, reduziert.
Vorgänge in microtech büro+ einladen
Laden Sie die Vorgänge von der Plattform in die Software ein: Abholen von Bestellungen (Vorgangs- und Adressanlage).
Wird nun im Bereich: VERKAUF - VORGÄNGE - Register: VORGÄNGE ein eigeladener Datensatz mit verwendetem Rabattcode über Schaltfläche: ÄNDERN zum Einsehen geöffnet, ist auf dem Register: POSITIONEN neben dem Artikel auch der Rabatt mit der exakten Bezeichnung und dem exakten Wert aus dem Shopsystem ersichtlich.
Info:
Weitere Infos:
- https://help.shopify.com/de/manual/discounts/discount-types (Externer Link).
- Für die Funktion "Rabattcode" haben wir in der Hilfe ein Beispiel für Shopware hinterlegt. Die Funktion für Shopify verhält sich analog zu diesem Beispiel: Shopware 6 - Rabattcode.