Shopware5-Schnittstelle-einrichten: Unterschied zwischen den Versionen

Aus Faktura-XP Handbuch
Zur Navigation springen Zur Suche springen
Zeile 36: Zeile 36:
 
.
 
.
  
Es öffnet sich der Verbindungsassistent in welchem Sie die von ihnen erworbenenen Shopschnittstellen auswählen können zum starten.
+
Es öffnet sich der Verbindungsassistent, in welchem Sie die von ihnen erworbenen Shop-Shopschnittstellen auswählen, können zum Starten.
  
 
.
 
.
Zeile 42: Zeile 42:
 
  [[Datei:82.VerbindungsAssistent.png]]
 
  [[Datei:82.VerbindungsAssistent.png]]
  
Wählen Sie anschließend aus der Liste der verfügbaren Schnittstellen die Shop-Schnittstelle zu '''Shopware® 5''' aus in dem Sie das Dropdown-Menü anklicken (1). Klicken Sie anschließend den Menüpunkt '''Shopware® 5''' (2) aus der Liste der verfügbaren Schnittstellen an um diese auszuwählen .
+
Wählen Sie aus der Liste der von Ihnen erworbenen Shop-Schnittstellen die Shop-Schnittstelle zu '''Shopware® 5''' aus, in dem Sie das Dropdown-Menü anklicken (1). Klicken Sie anschließend den Menüpunkt '''Shopware® 5''' (2) aus der Liste der verfügbaren Schnittstellen an, um diese auszuwählen .
  
 
  [[Datei:82.VerbindungsAssistent2.png]]
 
  [[Datei:82.VerbindungsAssistent2.png]]

Version vom 5. April 2022, 12:22 Uhr

Verbindung zwischen Faktura-XP und Shopware 5 einrichten

Die Einrichtung der Verbindung zwischen Faktura-XP und Shopware 5 ist sehr einfach und schnell gemacht. Es wird ein vorhandener oder neuer Benutzer im Backend des Shopware 5 für den "API Zuggang" konfiguriert. Diese Zugangsdaten werden dann im "Faktura-XP Shopware Connector" hinterlegt und für die komplette Kommunikation zwischen Faktura-XP und Shopware 5 verwendet.


.

So gehen sie vor

Zugriff in Shopware 5 Einrichten

Loggen sie sich in das Backend ihres Shopware 5 Shop wie gewohnt ein. Dort wählen sie im Menü "Einstellungen" die Benutzerverwaltung aus.

82.Benutzeranlage im shopware backend Menuauswahl.png

In der Benutzerverwaltung legen sie einen neuen Benutzer an oder wählen einen vorhandenen aus. Wir empfehlen aus Sicherheitsgründen einen neuen Benutzer anzulegen, der nur für die Kommunikation zwischen Faktura-XP und Shopware 5 vorgesehen ist.



Geben sie dem Benutzer einen Namen (1), aktivieren diesen direkt durch Setzen des Häkchens (1) und vergeben ein "starkes" Passwort.

82.Benutzeranlage im shopware backend.png

Danach aktivieren sie den "API-Zugang" für diesen Benutzer (2). Es wird nun das Feld API-Schlüssel aktiviert. Klicken sie auf das Schlüsselsymbol am Endes des Feldes um einen Schlüssel zu generieren. Der API-Schlüssel und der Benutzernamen werden später für die Authentifizierung verwendet. Danach geben sie noch die Stammdaten wie Name und Emailadresse sowie Sprache und Berechtigung (Rolle) zu diesem Benutzer ein (3). Mit Speichern (4) wird der Benutzer gespeichert. Die Shopware® 5 API Schnittstelle ist nun einsatzbereit. Nun müssen sie die Zugriffdaten (API-Schlüssel und Benutzername) noch in einem Zugriffprofil in Faktura-XP eingeben.



Shopware 5 API-Zugriff in Faktura-XP einrichten

Navigieren sie zu Verkauf -> Onlinehandel -> Webshop

Web Shop Synchronisieren

.

Es öffnet sich der Verbindungsassistent, in welchem Sie die von ihnen erworbenen Shop-Shopschnittstellen auswählen, können zum Starten.

.

82.VerbindungsAssistent.png

Wählen Sie aus der Liste der von Ihnen erworbenen Shop-Schnittstellen die Shop-Schnittstelle zu Shopware® 5 aus, in dem Sie das Dropdown-Menü anklicken (1). Klicken Sie anschließend den Menüpunkt Shopware® 5 (2) aus der Liste der verfügbaren Schnittstellen an, um diese auszuwählen .

82.VerbindungsAssistent2.png

Bestätigen Sie die Auswahl mit Weiter (3) um die Shop-Schnittstelle zu starten.


.

Beim ersten Verwenden kommt es zu folgender Meldung, die nur Hinweis auf einen noch nicht konfigurierte Verbindung zu Ihrem Onlineshop ist.

82.Verbindung shopware konfigurieren.png


Es wird nun der Faktura-XP Shopconnector für Shopware angezeigt. Klicken sie auf den Register "Shopware" und wählen sie dort den Unterregister "API-Zugriff" aus. Dort legen sie ein neues Profil für den Zugriff an, indem sie auf das "+" Symbol (1) Klicken.


82.shopware parameter profil anlegen.png


Die Anlage eines Profils erfordert nur vier Angaben. Geben sie eine Bezeichnung für das Profil ein (z.B. "Blue-Ray Paradies Onlineshop"). Danach geben sie die vollständige Webadresse zu ihrem Onlineshop inkl. "http://" oder "https://" (z.B. "https://www.Blue-Ray-Paradies-Hamburg.de/"). In den Feldern Benutzername und API-Schlüssel geben sie die Benutzernamen und API-Schlüssel Kombination ein, die sie im Backend ihres Shopware 5 Shop hinterlegt haben.


Um die Verbindung zu Ihrem Shopware 5 Onlineshop zu prüfen, klicken sie auf die Schaltfläche "Profil testen". Ist die Verbindung fehlgeschlagen, wird eine entsprechende Meldung angezeigt. Prüfen sie dann nochmals die Webadresse und die Daten für Benutzername und API-Schlüssel in ihrem Shopware 5 Backend. Ist die Verbindung erfolgreich, wird folgende Meldung ausgegeben.

82.Verbindung Erfolgreich Meldung.png


Nun ist die Kommunikation zwischen Faktura-XP und Ihrem Shopware® 5 Onlineshop fertig eingerichtet und für den ersten Shopabruf bereit.


Weiter geht es im Kapitel Shopware-Schnittstelle anwenden.

.









.