Magento und Adobe Commerce anbinden

Integration mit Leserechten, Zugriffstoken, Script über die Design-Konfiguration einbinden – für Magento 2.4.

Stand: Die Anbindung nutzt die Standard-REST-API von Magento 2.4 und Adobe Commerce. Getestet mit Mage-OS 4.0 (entspricht Magento Open Source 2.4.9). Sie ist noch neu – melde dich gern im Support, falls bei deinem Shop etwas nicht passt.

Der Assistent liest Produkte, Varianten, Kategorien, Inhaltsseiten und – wenn du es erlaubst – Bestellungen über eine eigene Integration. Er schreibt nie etwas in deinen Shop.

1. Integration anlegen

  1. Admin › System › Erweiterungen › Integrationen › Neue Integration hinzufügen.

  2. Name z.B. ShopLyra, dein Admin-Passwort zur Bestätigung eingeben.

  3. Reiter API: Ressourcenzugriff auf Benutzerdefiniert und nur diese Rechte anhaken (in Klammern die Bezeichnung im englischen Admin):

    • Katalog › Inventar › Produkte und Kategorien (Catalog › Inventory › Products, Categories) – liefert auch den Lagerstatus
    • Shops › Attribute › Produkt (Stores › Attributes › Product) – für Bezeichnungen wie Farbe und Größe; ohne dieses Recht findet der Assistent keine Varianten nach Farbe oder Größe
    • Inhalt › Elemente › Seiten (Content › Elements › Pages) für Versand, Rückgabe, Über uns …
    • optional für Bestellauskünfte: Verkäufe › Vorgänge › Bestellungen › Aktionen › Ansehen (Sales › Operations › Orders › Actions › View) und Lieferungen (Shipments) für die Sendungsnummer
    • optional bei mehreren Store-Views: Shops › Einstellungen › Alle Shops (Stores › Settings › All Stores), damit nur die Inhaltsseiten deiner Store-View übernommen werden

    Ein Haken an einem Oberpunkt setzt alle Unterpunkte mit. Hake bei Bestellungen deshalb nur Ansehen an (nicht „Bestellungen“ selbst, das schließt Anlegen, Bearbeiten und Stornieren ein) und nimm bei Seiten die Haken bei Seite speichern und Seite löschen wieder heraus.

  4. Speichern, dann Aktivieren › Erlauben. Kopiere den Zugriffstoken (Access Token) – Consumer Key und Secret brauchst du nicht.

Magento trennt bei Produkten und Kategorien nicht zwischen Lesen und Schreiben: Wer das Recht „Produkte“ hat, könnte über die API auch Produkte ändern. Der Assistent liest nur – behandle den Token trotzdem wie ein Passwort.

Wichtig ab Magento 2.4.4: Damit der Token direkt funktioniert, unter Shops › Konfiguration › Dienste › OAuth › Consumer-Einstellungen (Stores › Configuration › Services › OAuth › Consumer Settings) die Option „OAuth-Zugriffstoken als eigenständige Bearer-Tokens erlauben“ (Allow OAuth Access Tokens to be used as standalone Bearer tokens) auf Ja stellen. Ist sie aus, meldet der Verbindungstest, dass der Shop den Zugangsschlüssel ablehnt – dieselbe Meldung erscheint, wenn der Integration ein Recht fehlt.

2. Im Konto eintragen

Unter Einstellungen › Verbindungen den Zugriffstoken eintragen und Verbindung testen. Bei mehreren Store-Views trägst du den Store-View-Code ein (z.B. de) und als Shop-Adresse die Adresse genau dieser Store-View (z.B. https://www.shop.de/de oder die eigene Domain) – sonst führen Produktlinks ins Leere. Enden deine Produktlinks nicht auf .html, passe die URL-Endung an.

3. Script einbinden

Admin › Inhalt › Design › Konfiguration › deine Store-View bearbeiten › HTML-Kopf › Skripte und Stylesheets – dort die Zeile aus Einbindung einfügen und speichern. Danach den Cache leeren (System › Cache-Verwaltung).

Im Checkout erscheint der Chat nicht: Magento erlaubt dort ab 2.4.7 nur freigegebene Skripte (Content-Security-Policy). Das ist normal; auf allen anderen Seiten und auf der Bestellbestätigung läuft er. Hast du die CSP für den ganzen Shop auf streng gestellt (restrict), gib https://shoplyra.de bei script-src und connect-src frei (z. B. per csp_whitelist.xml in deinem Theme-Modul) und erlaube 'unsafe-inline' bei style-src – Details unter Sicherheit und Datenschutz.

Was der Assistent sieht

  • Produkte mit Preis, Sonderpreis (im eingestellten Zeitraum), Bild, Verfügbarkeit und Link; bei konfigurierbaren Artikeln den günstigsten Variantenpreis („ab“) und die passende Variante samt Verfügbarkeit – der Link wählt Farbe und Größe auf der Produktseite schon aus.
  • Aktive CMS-Seiten als Wissensquelle.
  • Bestellungen nur zur Prüfung, wenn Kunde Bestellnummer und E-Mail bzw. PLZ nennt – mit Status, Versandstatus, Versandart und Sendungsnummer. Abgefragt werden nur die dafür nötigen Felder (keine Namen, Telefonnummern oder Zahlungsdaten).

Grenzen: Preise übernimmt der Assistent so, wie sie im Katalog gepflegt sind. Pflegst du Netto-Preise und zeigst Brutto-Preise an, oder nutzt du Katalog-Preisregeln, Kundengruppen- oder Staffelpreise, nennt er den Katalogpreis.

Mehr dazu im Ratgeber