Versions Compared

Old Version 6

changes.mady.by.user Matthias Korz

Saved on

compared with

New Version Current

changes.mady.by.user Pascal Seibert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Note
titleBeachten Sie:

Bei der Verwendung Aktuell werden beim Einsatz von Shopify in Kombination mit microtech büro+ werden u. a. die folgenden folgende Funktionen unterstützt:

  • Synchronisierung von Adressen
  • Synchronisierung von Vorgängen

...

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. 
Die Einrichtung und die Verbindung von microtech büro+ und dem Shopsystem sind nun enger verzahnt.
Langfristig entstehen viele Vorteile, sodass Sie noch früher von Verbesserungen und Updates profitieren.

...


Info
titleInfo:

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 Shopify auf einem Server. Überlegen Sie dazu bitte im Vorfeld, wie das Hosting des Online-Shops vonstatten gehen soll.
Für das Zusammenspiel von büro+ mit Shopify werden Sicherheitsmerkmale der API des Shops für den Zugang benötigt (genauere Informationen finden Sie in dieser Dokumentation).

"Custom App" / "Benutzerdefinierte App" erstellen und einrichten

Melden Sie sich im Shopify Backend an und wechseln Sie auf der linken Navigationsseite auf: "Apps".

...

  • Konfigurieren die zugelassenen Berechtigungen der "Custom App" und gewähren Sie dieser die notwendigen Zugriffsrechte, die diese für den Shop benötigt, damit die benötigten Sicherheitsmerkmale erzeugt werden
  • Durch die Anlage einer "Custom App" / "Benutzerdefinierten App", erhalten Sie Sicherheitsmerkmale, mit denen büro+ auf die API-Schnittstelle von Shopify zugreifen kann.

...

  1. Vergeben Sie einen Namen für die "Custom App"
  2. Legen Sie fest, wer als "App-Entwickler" eingetragen werden soll (dies kann beispielsweise der Shop-Besitzer oder auch Mitarbeitende mit Entwickler-Rechten sein)
  3. Schließen Sie über die Schaltfläche "Create App" die Neuanlage ab.
  4. Wechseln Sie nun auf das Register: "Configuration" - an dieser Stelle vergeben Sie die benötigten Zugriffsrechte zur API

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
titleInfo:

Weitere Informationen zum Anlegen einer "Custom App" / "Benutzerdefinierten App":

en in englischer Sprache
  • )

Mapping der "Custom App" / "Benutzerdefinierten App" zu büro+

Wechseln Sie nun auf das Register: "API Credentials". Wurden alle notwendigen Berechtigungen erteilt, erhalten Sie an dieser Stelle die notwendigen Sicherheitsmerkmale für den API-Zugriff durch büro+.

...

Note
titleBeachten 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.


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.

Note
title

Führen Sie das Mapping der Sicherheitsmerkmale nach folgendem Muster durch:

...

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:

Image Added


Felder in der büro+API Sicherheitsmerkmale aus der "Custom App"
ApiKeyAPI Key
PasswortAdmin API Access Token
Shopname

...

Als Shopname kopieren Sie die Subdomain der zugehörigen Shop-URL, ohne "www." oder "http bzw. https://"

Beispiel:

Image Modified

Tip
titleTipp:

Im Backend von Shopify ganz links unten, existiert die Schaltfläche für "Settings / Einstellungen".
In diesem Bereich auf "Domains / Domänen", dann steht dort die komplette URL.



Nachdem Sie die Sicherheitsmerkmale 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.

Folgende Status-Werte stehen dabei z. B. zur Verfügung:

Status-ArtStatus-WertWeitere Informationen
fulfillmentcreateBestellung erstellt.
fulfillmentcancelBestellung abgebrochen.
fulfillmentholdBestellung ist in "Wartestellung" (z. B. wegen ausverkaufter Ware, einer nicht auffindbaren Adresse, etc.) - dieser Status ist optional und nicht zwingend für Ihren Workflow.
fulfillmentreleaseFinaler Status (Paket versendet).


Tip
titleTipp:

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).