Zum Hauptinhalt springen

Magento 2

Inhaltsverzeichnis​

  1. Einführung
  2. Magento-Modul aktivieren
  3. Magento-Modul Ersteinrichtung
  4. Magento Webshop Grundeinstellungen
  5. Best Practices
  6. Fehlerbehebung
  7. FAQ - Häufig gestellte Fragen

Einführung​

Zweck dieser Dokumentation​

Diese Anleitung beschreibt, wie Sie Ihren Magento Webshop mit dem eaWi Warenwirtschaftssystem verbinden und die grundlegenden Einstellungen für die Datensynchronisation vornehmen. Eine korrekte Einrichtung ist essenziell für den reibungslosen Austausch von Daten wie Produkten, Bestellungen und Kundendaten.

Zielgruppe​

  • Primär: Administratoren und technische Anwender der eaWi Warenwirtschaft.
  • Sekundär: E-Commerce-Manager und Shop-Betreiber.
  • Voraussetzungen: Administratorzugriff auf die eaWi Warenwirtschaft und die API-Zugangsdaten für Ihren Magento 2.x Shop.

Was ist das Magento-Modul?​

Das Magento-Modul der eaWi Warenwirtschaft ermöglicht die Synchronisation von Daten zwischen Ihrem eaWi-System und Ihrem Magento-Webshop. Es ist die zentrale Schnittstelle, um Produktinformationen, Bestände, Bestellungen, Zahlungen und weitere relevante Daten automatisch abzugleichen.

Magento-Modul aktivieren​

Um die Synchronisation mit Ihrem Magento Webshop nutzen zu können, muss das entsprechende Modul in eaWi zuerst aktiviert werden.

  1. Öffnen Sie die Registerkarte "Module":

    • Drücken Sie gleichzeitig STRG + SHIFT + LEERTASTE für die Quicknavigation.
    • Tippen Sie das Wort "Module" (Groß- und Kleinschreibung spielt keine Rolle) in die Suchleiste ein.
    • Doppelklicken Sie mit der linken Maustaste auf den Eintrag "(Karte) Registerkarte ‚Module‘".
    • (Tipp: Wenn nur ein Eintrag in der Suche erscheint, können Sie auch einfach die Enter-Taste drücken.)

  2. Suchen Sie das "Magento 2.x" Modul: Finden Sie das Modul in der angezeigten Liste der verfügbaren Module.

  3. Aktivieren Sie das Modul:

    • Klicken Sie mit der rechten Maustaste auf das "Magento 2.x" Modul.
    • Wählen Sie die Option "Beim nächsten Server Neustart aktivieren".

  4. Starten Sie den Server neu:

    • Starten Sie den eaWi Server oder den gesamten PC neu. Dies ist notwendig, damit die Änderung wirksam wird und das Modul auf dem Server geladen werden kann.

Magento-Modul Ersteinrichtung​

Nachdem das Magento-Modul aktiviert wurde, können Sie mit der initialen Konfiguration beginnen.

  1. Öffnen Sie das Magento-Modul: Doppelklicken Sie mit der linken Maustaste auf das "Magento 2.x" Modul in der Modulübersicht.
  2. Starten Sie den Einrichtungsassistenten: Klicken Sie auf den Button "Ersteinrichtung", um den Assistenten zu starten.
  3. Folgen Sie den Anweisungen: Gehen Sie die Schritte des Assistenten durch und klicken Sie auf "Weiter", um zum nächsten Schritt zu gelangen.

Schritt 1: Magento Zugangsdaten​

Hier geben Sie die notwendigen API-Zugangsdaten Ihres Magento-Webshops ein. Diese Daten sind für die Kommunikation zwischen eaWi und Magento unerlässlich.

  • Anzeigename: Ein frei wählbarer Name für Ihr Magento-Shop-Paneel in eaWi (z.B. "Mein Hauptshop").
  • Shop URL: Die vollständige Webadresse (URL), unter der Ihr Magento-Shop erreichbar ist (z.B. https://www.ihrshop.de/).
  • Benutzername: Der Benutzername des API-Zugangs für Ihren Magento-Shop.
  • Passwort: Das zugehörige Passwort des API-Benutzers.
  • API URL: Die Webadresse, unter der die API-Schnittstelle Ihres Shops erreichbar ist (oft https://www.ihrshop.de/rest/V1/).

Schritt 2: Daten importieren​

In diesem Schritt haben Sie die Möglichkeit, bestehende Daten aus Ihrem Magento-Webshop in eaWi zu importieren. Dies ist besonders nützlich für die Migration von Daten aus einem bereits laufenden System.

Sie können wählen, welche Daten importiert werden sollen:

  • Kategorien
  • Attribute
  • Produkte

💡 Tipp: Handelt es sich bei Ihrem Magento-Webshop um eine neue Installation ohne vorhandene Produktdaten, empfehlen wir, an dieser Stelle nichts zu importieren, da Sie die Daten stattdessen von eaWi nach Magento synchronisieren werden.

Schritt 3: Magento Shop Einstellungen​

Im letzten Schritt der Ersteinrichtung legen Sie globale Steuereinstellungen und den Importzeitpunkt für Bestellungen fest.

  • Steuereinstellung: Diese Einstellung muss unbedingt mit der Steuereinstellung in Ihrem Magento-Webshop übereinstimmen. Andernfalls kann es zu fehlerhaften Preisdarstellungen im Webshop kommen.
  • Datum, ab wann Bestellungen importiert werden sollen: Sie können dieses Datum frei wählen.
    • Bei einem bestehenden Webshop empfiehlt es sich, ein Datum zu wählen, das sicherstellt, dass Bestellungen nicht doppelt verarbeitet werden (z.B. den Tag des Umstiegs auf eaWi).
    • Bei einem neuen Webshop können Sie das aktuelle Datum oder ein früheres Datum wählen.

Klicken Sie abschließend auf den Button "Speichern und schließen". Die neue Verbindung wird nun gespeichert, und das Modul-Paneel für Ihren Webshop wird automatisch angezeigt, wo Sie weitere detaillierte Einstellungen vornehmen können.

Magento Webshop Grundeinstellungen​

Nach der erfolgreichen Aktivierung und Ersteinrichtung des Magento-Moduls folgt die Konfiguration der Grundeinstellungen. Diese Einstellungen legen Standardwerte fest, die immer dann greifen, wenn keine gesonderte Einstellung für ein Produkt oder eine Kategorie vorgenommen wurde. Dies vereinfacht die weitere Arbeit und hilft, Fehler zu vermeiden.

Was sind Grundeinstellungen?​

Für eine reibungslose Synchronisierung mit Ihrem Magento-Webshop müssen Sie verschiedene Einstellungen vornehmen. Dies umfasst Standardeinstellungen für den Export relevanter Kategorien, Produkte und Schlagworte sowie Konfigurationen für den Import und Abgleich von Bestellungen und Zahlungen.

Kategorien​

Hier können Sie Standardeinstellungen für neue Kategorien festlegen. Diese werden übernommen, wenn Sie in einer neuen Kategorie keine spezifischen Werte hinterlegen.

  • Aktiv / sichtbar: Steuert die Sichtbarkeit der Kategorie im Frontend.
  • Im Hauptmenü anzeigen: Legt fest, ob die Kategorie im Hauptnavigationsmenü des Shops erscheint.
  • Anzeigemodus: Definiert, wie Produkte in der Kategorie angezeigt werden (z.B. "Produkte nur", "Statische Blöcke und Produkte").
  • Anker: Relevant für die Filterung in der Navigation.

Produkte​

Hier konfigurieren Sie die Standardwerte für die Synchronisierung von Produkten.

  • Synchronisierung aktivieren: Globale Steuerung der Produktsynchronisierung.
  • Beschreibung übernehmen: Legt fest, ob die Produktbeschreibung aus eaWi übernommen wird.
  • Aktiv / sichtbar: Steuert die initiale Sichtbarkeit des Produkts im Frontend.
  • Sichtbarkeit: Definiert, wo das Produkt sichtbar ist (z.B. "Katalog", "Suche", "Katalog & Suche").
  • Sichtbarkeit ändern bei Varianten: Legt fest, ob Variantenprodukte eine eigene Sichtbarkeit erhalten.
  • Variantenhauptprodukt nur nutzen, bei 2+ Optionen: Optimiert die Anzeige von Variantenprodukten.
  • Auf Variantenhauptprodukt verweisen: Für SEO-Zwecke und zur Vermeidung von Duplicate Content.
  • Produkt URL-Endung: Definiert die Endung der Produkt-URLs.
  • Sichtbarkeit, wenn Canonical URL gesetzt: Verhalten der Sichtbarkeit bei gesetzter Canonical URL.
  • [BSS] Varianten in Kategorien anzeigen: Eine spezifische Einstellung für das BSS Commerce Modul zur Anzeige von Varianten in Kategorien.
  • Preisgruppe: Die Standard-Preisgruppe, die für Produkte aus eaWi in Magento verwendet wird.
  • Versandlager: Das Standard-Versandlager, aus dem die Produkte für den Versand berücksichtigt werden.
  • Virtuellen Bestand nutzen: Aktiviert die Nutzung eines virtuellen Bestands in Magento.
  • Als „neu“ markieren: Markiert neue Produkte für eine bestimmte Zeit als "neu" im Shop.
  • Variantenhauptprodukt auch als neu markieren: Überträgt die "Neu"-Markierung auch auf das Hauptprodukt bei Varianten.
  • Anzahl Tage, die Produkte als neu gelten: Definiert die Dauer der "Neu"-Markierung.
  • Bestellbare Menge bei Angeboten begrenzen: Steuert, ob die Bestellmenge bei Angeboten limitiert ist.

Schlagworte (Magento Attribute)​

Diese Einstellungen spiegeln die Konfiguration von Attributen und deren Werten in Ihrem Magento-Webshop wider. Sie ermöglichen eine 100%ige Synchronisierung von Schlagworten und Gruppen aus eaWi mit Magento-Attributen.

  • Art des Eingabefeldes: Der Typ des Eingabefeldes für das Attribut (z.B. "Textfeld", "Dropdown", "Mehrfachauswahl").
  • Gültigkeitsbereich: Wo das Attribut im Backend sichtbar und bearbeitbar ist (z.B. "Store View", "Global").
  • Verwenden in: Legt fest, wo das Attribut verwendet werden kann:
    • Tabellen: Für die Darstellung in Tabellen.
    • Filter: Als Filteroption in der Navigation.
    • Suche: Für die Suche im Shop.
    • Erweiterter Suche: Für die erweiterte Suche.
    • Vergleich: Für den Produktvergleich.
  • In Filternavigation anzeigen: Ob das Attribut in der linken/rechten Filternavigation angezeigt wird.
  • In Filternavigation bei Suchen anzeigen: Ob das Attribut auch in der Filternavigation bei Suchergebnissen angezeigt wird.
  • Für Katalog / Warenkorbregeln verwenden: Ob das Attribut für Preisregeln oder Warenkorb-Promotions genutzt werden kann.
  • HTML Tags erlauben: Ermöglicht die Verwendung von HTML-Tags im Attributwert.
  • Sichtbar auf Katalogseiten: Ob das Attribut auf den Produkt-Detailseiten angezeigt wird.
  • Sichtbar in Produktlisten: Ob das Attribut in Produktübersichtslisten angezeigt wird.
  • Danach sortieren erlauben: Ob nach diesem Attribut sortiert werden kann.
  • Im Checkout anzeigen: Ob das Attribut im Checkout-Prozess angezeigt wird.

Bestellungen​

Die Einstellungen für die Synchronisierung von Bestellungen haben direkten Einfluss auf den Workflow nach dem Import aus Magento.

  • Synchronisierung aktivieren: Globale Steuerung des Bestellimports.
  • Zahlungsinformationen synchronisieren: Legt fest, ob Zahlungsinformationen mit importiert werden.
  • Versandinformationen synchronisieren: Legt fest, ob Versandinformationen mit importiert werden.
  • Belegstatus nach dem Import: Der Standardstatus, den importierte Bestellungen in eaWi erhalten.
  • Kontaktart für Neukunden: Die standardmäßige Kontaktart (z.B. "Kunde") für neue Kunden, die über Magento importiert werden.
  • Adressart für Rechnungsanschrift: Die Adressart, die für die Rechnungsanschrift importierter Bestellungen verwendet wird.
  • Adressart für Lieferanschrift: Die Adressart, die für die Lieferanschrift importierter Bestellungen verwendet wird.
  • Kreditlimit für Neukunden: Das Standard-Kreditlimit, das neuen Kunden aus Magento zugewiesen wird.
  • Preisgruppe für Neukunden: Die Standard-Preisgruppe für Neukunden aus Magento.
  • Abweichendes Versandlager: Definiert ein abweichendes Versandlager für Bestellungen aus Magento.

Erweiterungen​

Auf Kundenwunsch wurden bereits Integrationen zu speziellen Magento-Modulen und Erweiterungen implementiert.

  • Hungersoft BasePrice Modul:
    • Produkt Einheit: Die Einheit für den Produkt-Grundpreis.
    • Produkt Menge: Die Menge des Produkts für den Grundpreis.
    • Grundpreis Einheit: Die Einheit des Grundpreises (z.B. "pro 100g").
    • Grundpreis Menge: Die Menge des Grundpreises.
  • Mirasvit Reward Points Modul:
    • Bonuspunkte Modul: Aktiviert die Synchronisierung von Bonuspunkten.
    • Name der Punkte: Der Name der Bonuspunkte.

Administration​

Diese Einstellungen sollten nur von einem Administrator geändert werden, da sie kritische Zugangs- und Grundeinstellungen betreffen.

  • URL der Webseite: Die Webadresse Ihres Magento-Shops.
  • Benutzername: Der API-Benutzername.
  • Password: Das API-Passwort.
  • URL der API: Die API-Schnittstellen-URL.
  • Steuereinstellungen für Produktpreise: Wichtige Konfigurationen für die steuerliche Handhabung von Produktpreisen.
  • Attribute-Sets aktualisieren: Ermöglicht das Neuladen der Attribute-Sets aus Magento.

Best Practices​

Sorgfältige Ersteinrichtung​

  • Datenabgleich: Stellen Sie sicher, dass Ihre Steuereinstellungen in eaWi exakt mit denen in Magento übereinstimmen, um Preisabweichungen zu vermeiden.
  • Importstrategie: Planen Sie genau, welche Daten Sie bei der Ersteinrichtung importieren möchten. Bei einem bestehenden Shop ist es oft sinnvoll, nur relevante historische Bestellungen zu importieren oder gar keine Produktdaten, wenn eaWi das führende System für Produkte sein soll.

Regelmäßige Überprüfung​

  • Synchronisationslogs: Überprüfen Sie regelmäßig die Synchronisationsprotokolle im Magento-Modul, um Fehler oder Abweichungen frühzeitig zu erkennen.
  • Datenkonsistenz: Führen Sie Stichproben durch, um sicherzustellen, dass Produkte, Bestände und Bestellungen korrekt zwischen eaWi und Magento synchronisiert werden.

Sicherheit​

  • API-Zugangsdaten: Verwalten Sie Ihre Magento API-Zugangsdaten sorgfältig und gewähren Sie nur autorisierten Personen Zugriff auf diese Einstellungen.
  • Berechtigungen: Stellen Sie sicher, dass der API-Benutzer in Magento nur die notwendigen Berechtigungen für die Synchronisation besitzt (Prinzip der geringsten Rechte).

Fehlerbehebung​

Häufige Probleme und Lösungen​

Problem: "Magento-Modul lässt sich nicht aktivieren oder erscheint nicht in der Modulliste"​

Mögliche Ursachen:

  • Server wurde nach dem Markieren des Moduls nicht neu gestartet.
  • Modul ist nicht korrekt installiert oder lizenziert (selten).

Lösungsschritte:

  1. Stellen Sie sicher, dass Sie den eaWi Server (oder den gesamten PC, auf dem der Server läuft) nach dem Markieren des Moduls zum Aktivieren neu gestartet haben.
  2. Wenn das Problem weiterhin besteht, kontaktieren Sie den eaWi Support.

Problem: "Fehlermeldung bei der Ersteinrichtung oder Synchronisation (z.B. 'API-Zugriff fehlgeschlagen')"​

Fehlerursachen:

  • Falsche API-Zugangsdaten (Benutzername, Passwort, Shop URL, API URL).
  • API-Benutzer in Magento hat nicht die notwendigen Berechtigungen.
  • Firewall- oder Serverkonfigurationsprobleme blockieren die Verbindung.

Lösungsansätze:

  1. Zugangsdaten prüfen: Überprüfen Sie alle eingegebenen Daten (Shop URL, API URL, Benutzername, Passwort) in Schritt 1 des Einrichtungsassistenten auf Tippfehler.
  2. Magento API-Benutzerberechtigungen: Stellen Sie sicher, dass der in Magento verwendete API-Benutzer alle erforderlichen Berechtigungen für den API-Zugriff auf Produkte, Kategorien, Bestellungen etc. besitzt.
  3. Netzwerk/Firewall: Prüfen Sie, ob Firewalls oder Serverkonfigurationen die Kommunikation zwischen dem eaWi-Server und Ihrem Magento-Shop blockieren. Wenden Sie sich gegebenenfalls an Ihren Hosting-Anbieter oder Systemadministrator.

Problem: "Preise oder Steuern werden in Magento falsch angezeigt nach Synchronisation"​

Diagnose:

  • Die Steuereinstellungen in eaWi und Magento stimmen nicht überein.

Lösungsansatz:

  1. Überprüfen Sie in Schritt 3 der Ersteinrichtung und in den "Administration"-Einstellungen des Magento-Moduls, ob die Steuereinstellungen für Produktpreise exakt mit der Konfiguration in Ihrem Magento-Shop übereinstimmen. Passen Sie diese bei Bedarf an.

FAQ - Häufig gestellte Fragen​

1. Kann ich mehrere Magento-Shops mit einer eaWi-Instanz verbinden?​

Antwort: Die eaWi Warenwirtschaft unterstützt in der Regel die Anbindung mehrerer Webshops. Für jeden zusätzlichen Shop müssten Sie ein separates Magento-Modul aktivieren und konfigurieren.

2. Welche Magento-Versionen werden unterstützt?​

Antwort: Das Modul ist für Magento 2.x optimiert. Bei älteren Magento-Versionen (z.B. Magento 1.x) oder speziellen Modifikationen kontaktieren Sie bitte den eaWi Support für Kompatibilitätsinformationen.

3. Was passiert, wenn ich das Magento-Modul deaktiviere?​

Antwort: Wenn Sie das Magento-Modul deaktivieren, wird die Kommunikation zwischen eaWi und Ihrem Magento-Shop eingestellt. Es findet keine weitere Synchronisation von Daten statt. Bereits importierte Daten bleiben in eaWi erhalten.

4. Kann ich bestimmte Produkte oder Kategorien von der Synchronisation ausschließen?​

Antwort: Ja, in den detaillierten Einstellungen des Magento-Moduls (nach der Ersteinrichtung) und oft auch direkt an Produkten oder Kategorien können Sie spezifische Regeln definieren, um die Synchronisation zu steuern und bestimmte Elemente auszuschließen oder nur in eine Richtung zu synchronisieren.

5. Wie oft findet die Synchronisation statt?​

Antwort: Die Synchronisationsintervalle können in den Einstellungen des Magento-Moduls konfiguriert werden. Sie können festlegen, wie oft Bestände, Bestellungen oder andere Daten automatisch abgeglichen werden sollen. Eine manuelle Synchronisation ist bei Bedarf auch jederzeit möglich.