Zum Hauptinhalt springen

2.2. Vollständige Integrationseinrichtung mit Magento 2.

Diese Anleitung zeigt den Prozess zum Etablieren einer sicheren bidirektionalen Verbindung zwischen Ihrem Magento 2 Shop und Fozzels. Sie generieren die erforderlichen API-Tokens und konfigurieren Berechtigungen, um einen nahtlosen Produktdatenimport und Inhaltsexport zu gewährleisten.

Die Magento 2-Integration erfordert das Erstellen einer dedizierten neuen Integration im Magento-Admin-Panel, um vier wesentliche Schlüssel zu generieren: Consumer Key, Consumer Secret, Access Token und Access Token Secret. Wir konfigurieren auch das erforderliche Attribut fozzels_completion_date zur Verfolgung der Inhaltssynchronisierung.

Teil 1: Magento 2-Einrichtung (Erstellen der Integration und Tokens)​

Sie müssen eine neue Integration erstellen und spezifische Berechtigungen in Ihrem Magento-Admin-Panel definieren.

Schritt 1: Erstellen Sie eine neue Integration​

  1. Melden Sie sich in Ihrem Magento-Admin-Panel an.

  2. Gehen Sie zu System / Integrationen.

  3. Klicken Sie auf die Schaltfläche ”Neue Integration hinzufügen”.

Schritt 2: Integrationsinformationen ausfüllen​

  1. Navigieren Sie zur Registerkarte Integrationsinformationen (Grundeinstellungen).

  2. Füllen Sie die erforderlichen Felder aus: 2.1. Geben Sie Namen ein: Fozzels. 2.2. Geben Sie E-Mail ein: info@fozzels.com. 2.3. Geben Sie Ihr Magento-Admin-Passwort zur Bestätigung ein.

  3. Überspringen Sie optionale Felder (Callback-URL, Identity-Link-URL).

Schritt 3: API-Berechtigungen (Scopes) konfigurieren​

  1. Klicken Sie auf die Registerkarte ”API”.

  2. Wählen Sie im Dropdown-Menü ”Benutzerdefiniert”.

  3. Markieren Sie nur diese Kontrollkästchen (für Lese-/Schreibzugriff): 3.1. Katalog: Kategorien, Bestand, Produkte, Attribute aktualisieren, Produktdesign bearbeiten. 3.2. Stores: Einstellungen, Alle Stores. 3.3. Attribute: Produkt, Attributsatz.

Schritt 4: Integration speichern und aktivieren​

  1. Klicken Sie auf die Schaltfläche ”Speichern” in der oberen rechten Ecke.

  2. Suchen Sie auf der Seite “Integrationsliste” die neue Fozzels-Integration.

  3. Klicken Sie auf den Link ”Aktivieren”.

  4. Überprüfen Sie auf der Seite “Aktivierungsdetails”, ob die richtigen APIs (aus Schritt 3) ausgewählt wurden, und klicken Sie auf ”Zulassen”.

Schritt 5: API-Schlüssel kopieren und speichern​

  1. Nach dem Klicken auf “Zulassen” werden Sie zur Seite “Integrationstokens für Erweiterungen” weitergeleitet.

  2. Kopieren und speichern Sie alle vier automatisch ausgefüllten Werte sicher: 2.1. Consumer Key 2.2. Consumer Secret 2.3. Access Token 2.4. Access Token Secret

  3. Klicken Sie auf ”Fertig”.

  4. Überprüfen oder bearbeiten Sie Integrationsdetails später, indem Sie die Schaltfläche ”Bearbeiten” auf der Seite “Integrationen” drücken.

Teil 3: Fozzels-Aktivierung und Datensynchronisierung​

Schritt 6: API-Zugriff überprüfen​

Bevor Sie Fozzels verbinden, stellen Sie sicher, dass Ihr Server Anfragen von Fozzels an die Magento REST API (/rest/) und die GraphQL API (/graphql) nicht blockiert oder begrenzt. Firewalls, WAFs und Sicherheitsdienste wie Cloudflare oder Sucuri können diese Anfragen blockieren.

Was tun:​

  1. Lassen Sie die Fozzels IP-Adressen (IPv4 und IPv6) und den Fozzels User-Agent zu und nehmen Sie sie vom Rate Limiting aus. Alle Adressen und Einstellungen, einschließlich einer Anleitung für Cloudflare, finden Sie unter 2.1.1. Verbindungsanforderungen: IP-Adressen, User-Agent und Firewall-Einstellungen.
  2. Leiten Sie diese Seite an Ihren Hosting-Anbieter oder Server-Administrator weiter.

Wenn dies nicht geschehen ist, erhalten Sie beim Erstellen der Integration in Fozzels einen Fehler 401 (Unauthorized) oder während des Produktabrufs einen Fehler 429 (Too Many Requests), und die Verbindung oder Synchronisierung wird nicht abgeschlossen.

Nach Bestätigung der Änderungen können Sie mit dem Erstellen der Integration in Fozzels fortfahren.

Schritt 8: Neue Integration in Fozzels erstellen​

  1. Melden Sie sich in Ihrem Fozzels-Konto an.

  2. Gehen Sie zu Integrationen.

  3. Klicken Sie auf ”Neue Integration erstellen”.

  4. Wählen Sie ”Magento” aus den verfügbaren Optionen.

Schritt 9: Verbindungsdetails ausfüllen​

Sie verwenden die Schlüssel aus Teil 1, um Fozzels zu verbinden und den Datenimport einzuleiten.

  1. Benennen Sie Ihre Integration eindeutig.

  2. Geben Sie die URL Ihrer Magento-Website ein.

  3. Füllen Sie die vier Schlüssel, die in Schritt 5 kopiert wurden, in die entsprechenden Felder ein.

  4. Klicken Sie auf ”Speichern”.

Schritt 10: Stores aktivieren und synchronisieren​

  1. Schalten Sie den Umschalter ’Aktiv’ in der oberen rechten Ecke ein. Ohne dies funktioniert die Verbindung nicht.

  2. Navigieren Sie zur Registerkarte ”Websites & Stores”.

  3. Klicken Sie auf die Schaltfläche ”Websites und Stores abrufen”. Ihre Websites und Stores sollten jetzt angezeigt werden.

  4. Überprüfen Sie, ob die Integration folgende Status hat: Autorisiert: ja und REST API verbunden: ja.

  5. Aktivieren Sie die aktuellen Websites und Stores mit dem Umschalter zur weiteren Verwendung.

Schritt 11: Produkte abrufen und überprüfen​

  1. Klicken Sie auf die Schaltfläche ”Produkte abrufen”, um den Prozess zum Importieren Ihres Produktkatalogs zu starten.

  2. Warten Sie, bis die Produkte geladen werden (der Fortschritt wird in der Fortschrittsleiste angezeigt).

  3. Gehen Sie zur Registerkarte ”Attribute”, um Ihre Synchronisierungsregeln zu konfigurieren.

  4. Lesen Sie mehr über die Arbeit mit Produktattributen und das Anpassen von Datenfeldern hier.