Authentifizierung zum Onlineshop
Hier finden Sie alle Informationen rund um das Setup des Shopware API Connectors.
1. Initial-Setup
Sobald der Shopware 6 API Connector auf Ihrem Business Central System installiert ist, kann die Verbindung zum Onlineshop aufgebaut werden.
Sie werden feststellen, dass ein neuer Reiter in Business Central hinzugefügt wurde:
Wenn Sie den Reiter "Shopware" auswählen, öffnet sich ein Untermenü:
Nach Auswahl des Reiters "Konfiguration" öffnet sich das Menü, mit dem Sie sowohl die Verbindung zu Shopware herstellen können, also auch viele weitere Einstellungen treffen können. Um diese bearbeiten zu können, müssen Sie in den Editier-Modus wechseln, den Sie mittig oben im Fenster finden (das Stiftsymbol):
Anschließend können Sie alle Einstellungen bearbeiten.
1.1 Ersteinrichtung
Folgende Informationen, die Sie unter "Shopware Informationen" finden, sind für das Initial-Setup nötig:
Webshop-Code: Ein von Business Central intern genutzter Code, der Ihren Shop einzigartig kennzeichnet.
Webshop-Name: Ein beschreibender Name Ihres Onlineshops
Website-URL: Die URL zu Ihrem Shopware Shop mit https://
API-Modulpfad: In der Regel endet der Pfad auf /api
Integrationszugriff: Hier legen Sie fest auf welche Art die Verbindung zwischen Business Central und Shopware stattfinden soll. JA --> Setzen Sie "Integrationszugriff" auf JA, so werden eine Shopware Access Key ID und ein Shopware Secret Access Key benötigt. NEIN --> Setzen Sie "Integrationszugriff" auf NEIN, benötigen Sie einen Shopware Benutzername sowie das dazugehörige Benutzerpasswort mit Admin-Rechten.
Erlaube Entwickler-Protokoll: JA --> Wird nur benötigt, wenn Fehler bei Sync auftreten sollten, z.B. weil Daten nicht oder falsch im Shop ankommen. Mit dem Entwickler-Protokoll kann genau abgelesen werden, welche API-Calls getätigt werden und wo Fehler auftauchen.
Aktivieren: Entscheidet ob der Shop aktiv ist (JA) oder nicht (NEIN). Das ist vor allem für Multishop (COMING SOON) eine relevante Einstellung.
1.2 Verbindungsaufbau
Anschließend können Sie einen Verbindungstest starten.
Sind alle Daten korrekt ausgefüllt, erscheint eine Erfolgsmeldung.
Tritt eine Fehlermeldung auf, kann dies verschiedene Ursachen haben.
Prüfen Sie, ob alle Felder korrekt gefüllt sind.
Testen Sie einen anderen Admin-Nutzer für Shopware bzw. eine andere Version des "Integration Access".
Prüfen Sie, ob Ihr Server die Verbindung zulässt. Eine häufige Ursache für fehlgeschlagene Verbindungen zwischen Business Central und Shopware sind spezielle Serverkonfigurationen.
Sofern Ihr Shop noch in Entwicklung ist, stellen Sie sicher, dass kein Passwortschutz aktiv ist.
2. Initialdownload
Der Initialdownload lädt alle relevanten Daten von Shopware nach Business Central und ist erforderlich, um die Werte zwischen beiden Systemen korrekt zuzuordnen.
Bevor das möglich ist, müssen noch zwei wichtige Werte gefüllt werden. Zu finden sind diese unter "Bestandskonfiguration":
Übergeordnete Kategorie-ID
Bildordner-ID
2.1 Übergeordnete Kategorie-ID
Die "Übergeordnete Kategorie-ID" legt fest, welche Kategorien aus Shopware importiert werden sollen und wo neu erstellte Kategorie hinzugefügt werden. Die ID finden Sie in Shopware. Wechseln Sie dafür in den Backend-Bereich Ihres Shopware-Shops.
Unter dem Reiter Kataloge > Kategorien wählen Sie jene Kategorie aus, die Sie als die übergeordnete Kategorie festlegen möchten. In der Regel ist das die oberste Ebene bzw. "Home".
Wählen Sie diese Kategorie aus.
In der URL finden Sie nun zwischen zwei Schrägstrichen eine lange ID, die aus Buchstaben und Zahlen besteht. Kopieren Sie diese und fügen Sie diese ID in Business Central ein.
2.2 Bilder Ordner-ID
Für die "Bildordner-ID" verfahren Sie ähnlich. Wechseln Sie zuerst in den Backend-Bereich Ihres Shopware-Shops.
Unter dem Reiter Inhalte > Medien wählen Sie den Ordner aus, in dem die Produktbilder gespeichert werden sollen. In der Regel ist das der "Product Media" Ordner.
In der URL finden Sie nun zwischen zwei Schrägstrichen eine lange ID, die aus Buchstaben und Zahlen besteht. Kopieren Sie diese und fügen Sie diese ID in Business Central ein.
2.3 Initialdownload
Nun ist alles für den Initial-Download vorbereitet. Sie finden ihn oben, unter dem Reiter "Start".
2.4 Nächste Schritte
Wir empfehlen Ihnen direkt zu den Grundeinstellungen überzugehen, um das erstmalige Setup der Anwendung abzuschließen.
Zuletzt aktualisiert