Shopify Installation

Um einen Shopify-Shop mit dem Shop Connector zu verbinden, sind einige grundlegende Einstellungen im Shopify-Backend erforderlich.

Shopify-App installieren

Um Business Central mit einem Shopify-Shop zu verbinden, muss im Shopify-Backend eine App erstellt werden. Dazu ist unter „Apps und Vertriebskanäle“ die Option „Apps entwickeln“ zu wählen.

Als App-Name sollte ein aussagekräftiger Name wie WebConnector verwendet werden. Dieser dient lediglich zur Identifikation und hat keine technische Bedeutung.

Unter [API-Anmeldedaten] kann der API-Zugriffsschlüssel eingesehen werden. Dieser Schlüssel ermöglicht die Verbindung zwischen Business Central und dem Shopify-Shop.

Um einen Zugriffsschlüssel zu erstellen, müssen in Shopify bestimmte Berechtigungen festgelegt werden. Diese Berechtigungen bestimmen, welche Aktionen Business Central im Webshop ausführen kann. Je nach Projektanforderungen müssen diese Berechtigungen möglicherweise erweitert werden. Mindestens sind jedoch folgenden Berechtigungen zu setzen:

read_locations, write_products, read_products, read_inventory, write_inventory, read_orders, write_orders, read_customers, read_merchant_managed_fulfillment_orders, write_assigned_fulfillment_orders, read_assigned_fulfillment_orders, write_merchant_managed_fulfillment_orders, write_third_party_fulfillment_orders, read_third_party_fulfillment_orders, write_shipping

Nach der Installation der App kann der Zugriffstoken einmalig angezeigt werden.

Business Central Einrichtung

In der Shop Einrichtung ist ein neuer Datensatz mit der [Art] „Shopify“ anzulegen. Über die Einrichtungskarte ist dann im Feld [Shopify Access Token] der über die Shopify-App erzeugte Zugriffsschlüssel zu hinterlegen.

Außerdem muss als [Api Base Url] die für die Verbindung benötigte Shop-Url hinterlegt werden. Dafür ist hinter der Shop-Url der Suffix admin/api/2024-07/graphql.json anzuhängen (z.B. https://kt24dev.myshopify.com/admin/api/2024-07/graphql.json). In Shopify definierte Redirect-Domains (Aliasse) können nicht als Endpunkt verwendet werden. Die korrekte URL kann im Shopify-Backend unter „Domains“ eingesehen werden.

Shopify Version

Shopify aktualisiert seine API-Versionen vierteljährlich. Die verwendete Version kann über die in der Shop-Einrichtung hinterlegte URL (z.B. 2024-07, 2024-10, 2025-01 usw.) ermittelt werden. Da Shopify die Versionen nur ein Jahr nach ihrer Veröffentlichung unterstützt, ist es wichtig, regelmäßig die hinterlegte Version zu aktualisieren. Bevor die Version in der Shop Einrichtung des Testsystems aktualisiert wird, sind die verwendeten Shop Funktionalitäten im Testsystem zu prüfen.