Die Erstellung und der Versand von Lieferscheinen und Rechnungen wird über Xentral abgewickelt, ebenso wie das Retourenmanagement. Aktualisierte Auftragsstati, die Sendungsverfolgungsnummern versandter Lieferungen und Lagerzahlen der Artikel meldet Xentral automatisch per Prozessstarter an den Shop zurück.

Features der Schnittstelle

Aufträge aus Magento 2 abholen
Auftragsstatus bei Versand umstellen inkl. Meldung Trackingnummer
Artikel einzeln von Xentral nach Magento oder von Magento nach Xentral übertragen
Meldung aktueller Lagerzahlen bei Bestandsänderungen
Artikelfreifelder werden zu Custom Attributes übertragen
Übertragung der Marketingsperre

Installation der Schnittstelle

API Benutzer in Magento 2 erstellen

Schritt 1: Benutzer anlegen

In Magento muss ein neuer Benutzer unter System → All Users → Add New User anlegen werden.

Schritt 2: Account Informationen ausfüllen

Alle Daten ausfüllen - für Xentral benötigen Sie die Felder "User Name" und "New Password"
Unten das Passwort des eigenen Benutzers eingeben und mit "Save User" oben die Änderungen speichern

Schritt 3: User Role überprüfen

Unter "User Role" sollte der Benutzer als Administrator gekennzeichnet sein.

Shopschnittstelle in Xentral anlegen

1. Shopschnittstelle anlegen

Unter Administration → Einstellungen → Online-Shops → NEU kann man nach Magento 2 suchen:

2. Magento 2 Daten eingeben

Vergeben Sie einen Shop-Namen und stellen Sie fürs Erste die Einstellungen wie im Screenshot ein. Danach tragen Sie Ihre Magento Daten in die beschriebenen Felder ein.

3. Verbindung prüfen

Am Schluss überprüfen Sie mit einem Klick auf "Verbindung prüfen" ob die Anbindung geklappt hat:

Sollte es zu einem Fehler kommen überprüfen Sie bitte, ob die Zugangsdaten aus Magento korrekt in Xentral hinterlegt wurden.

Einstellungen der Schnittstelle

Unter den Zugangsdaten befindet sich eine Reihe von Einstellungen, die speziell bei Magento2-Shops relevant sind.

Stücklisten-Unterartikel automatisch mitexportieren → Wenn aktiviert, dann werden die Unterartikel mitexportiert, wenn eine Stückliste zum Shop exportiert wird.
Status "zum Abholen" → Status der Aufträge, die Xentral abholen soll.
Status "in Bearbeitung" → Status, auf den Aufträge nach der Abholung zu Xentral, gesetzt werden sollen.
Status "Abgeschlossen" → Status, auf den Bestellung umgestellt wird, wenn Auftrag in Xentral verarbeitet wurde. Standardmäßig "completed", wenn nichts eingetragen wird.
Attributecodes für Eigenschaften → Beim Artikelimport von Magento zu Xentral können die Attribute des Artikels direkt als Eigenschaften mitimportiert werden. Hierzu muss aber in diesem Feld anhand der Attributcodes aus dem Magento-Backend festgelegt werden, welche Attribute importiert werden sollen.
Normale / Ermäßigte Steuer ID: Wenn beim Export von Artikeln von Xentral zu Magento betehende Steuersätze in Magento verwendet werden sollen (anstatt das Xentral die Steuersätze 7% oder 19% neu anlegt), müssen hier die IDs der Steuersätze aus dem Magento Backend eingetragen.
Wurzelkategorie ID → Beim Export von Artikel bzw. des Artikelbaums von Xentral zu Magento 2, werden diese in die hier eingestellte Wurzelkategorie von Magento2 übertragen.
Attributtyp bei Bedarf anpassen → Beim Export von Artikeln von Xentral zu Magento kann der Typ des Attributs in Magento nur angepasst werden, wenn das Attribut gelöscht und nochmal neu angelegt wird. Dieser Prozess kann durch diese Einstellung bewirkt werden.

Weitere Einstellungen und Mapping

Wie Sie die weiteren Einstellungen vornehmen sowie das Zahlungsweisen- und Versandarten-Mapping vornehmen, erfahren Sie im Artikel Online Shops: Einstellungen.

Aufträge importieren

Abholmodus

Beim Auftragsimport können Sie in Magento 2 zwischen zwei Abholmodi wählen, der Abholung nach Auftragsstatus oder -nummer.

Sollen die Aufträge ab einer bestimmten Bestellnummer abgeholt werden, können Sie "ab Nummer" auswählen und unten die Bestellnummer, ab der die Aufträge abgeholt werden sollen. Xentral wird dann ab einschließlich diesem Auftrag Bestellungen importieren.

Magento 2 erwartet beim Abholmodus "ab Nummer" einen Request an die Auftrags-ID, nicht der eigentlichen Auftragsnummer. Bitte beachten Sie daher, dass dann die Bestell-ID eingetragen werden muss, die im Magento-Backend in der URL des Auftrags zu finden ist bzw. die als Wert 1 unten im Log auftaucht. Die ebenfalls so genannte "Bestell-ID" in der Auftragsübersicht im Magento 2-Backend entspricht dem Wert 2 im Log und kann hier nicht erkannt werden.

Als Internetnummer wird dann allerdings der Wert 2 in den Aufträgen eingetragen, weil er in der Oberfläche von Magento auch die eigentliche Bestellnummer darstellt.

Soll stattdessen nach Auftragsstatus abgeholt werden, so kann man unten die Bezeichungen der beiden Stati aus Magento eintragen. Xentral weiß dann, Aufträge mit welchem Status abgeholt werden sollen und auf welchen Status die Aufträge im Shop umgestellt werden sollen, sobald sie verarbeitet wurden.

Kundenkommentar importieren

Der Magento 2-Importer kann den Kundenkommentar im Warenkorb eines Auftrags als Freitext in den Auftrag in Xentral übernommen werden.
Hat der Kunde mehrere Kommentare hinterlassen, wird allerdings nur der erste Kommentar übertragen, da die Meldungen zum Auftragsstatus in der gleichen Datenstruktur stehen. Es bestünde sonst die Gefahr, dass Statusmeldungen als Kommentar interpretiert werden.

Artikel-Attribute

Bei der Verwendung von Attributen ist immer das Attributset relevant. Um das Attributset auszuwählen gibt es zwei Möglichkeiten:

Die ID des Attributs bei der Eigenschaft mit dem Namen 'AttributeSetID' hinterlegen
Den Namen des zu verwendenden Sets bei der Eigenschaft mit dem Namen 'AttributeSetName' hinterlegen

Das Attributset sehen Sie in Magento in der Artikeltabelle:

Mapping in Xentral:

Wenn kein Attributset in den Eigenschaften festgelegt wird, wird der Artikel standardmäßig der Default-Gruppe zugewiesen.Wichtig: Bei Attributsets gibt es immer eine Ausnahme für Matrixartikel. Hier ist es so, dass das Attributset, welches aus den Matrixeigenschaften gebildet wird, priorisiert wird.

Wichtig: Bei Attributsets gibt es immer eine Ausnahme für Matrixartikel. Hier ist es so, dass das Attributset, welches aus den Matrixeigenschaften gebildet wird, priorisiert wird.

Artikel-Freifelder übertragen

Die Verknüpfung funktioniert über Attribut Codes. Die Freifelder können in Xentral frei benannt werden und werden vom Importer dann auf einen gültigen Attribut Code umgewandelt (z.B. aus Farbe Außen wird farbe_aussen).

Sollen existierende Freifelder zwischen Xentral und Magento verknüpft werden, so muss zunächst der Scope bzw. Gültigkeitsbereich des Attributs in Magento auf Global gestellt werden. Dies kann man in Magento unter Stores → Attributes → Product im jeweiligen Attribut eingestellt werden. Dort ist die Einstellung unter Advanced Attribute Properties zu finden.

Werden Attributes in Magento neu durch einen Export von Xentral angelegt, wird der Scope automatisch auf Global gesetzt.
Dabei gilt es zu beachten, dass die Bezeichnungen der Freifelder in Xentral so gewählt werden, dass auch nach der Umwandlung zu Attribut Codes keine ungewollten Matchings entstehen.

Attributmapping

Im Reiter Attributmapping können die Eigenschaften sowie Freifelder eines Artikels aus Xentral auf Attributtypen von Magento2 gemappt werden. Das ermöglich eine genaue Übertragung von Artikeleigenschaften und -freifelder in den gewünschten Attributtyp von Magento.

Attribut → Hier steht der Attributcode
Parameter → Für Select und Multiselect kann man eine Parameterliste übergeben

Beim Anlegen der Attribute werden die Teile dann als Optionen angelegt. Einzelne Werte werden dabei durch Pipes getrennt. Außerdem ist es möglich einen Parameter durch anhängen von ;1 als Standardoption zu kennzeichnen. Wenn nichts, oder ;0 an den jeweiligen Wert angehangen werden ist das Wert als nicht Default gekennzeichnet.

Die Parameter werden nur bei neu angelegten Attributen übertragen. Es ist nicht möglich, im Nachhinein einem Attribut einen Parameter über diese Mechanik anzuhängen. Wenn ein Artikel mit einer Eigenschaft übertragen wird, deren Wert noch nicht in der Optionsliste des Attributs vorhanden ist, wird der Wert daraufhin als Option vom Importer angelegt.

Wenn ein Attribut im Shop existiert, aber einen anderen Typ hat, als im erweiterten Mapping eingestellt ist wird bei gesetzter Option "Attributtyp bei Bedarf anpassen" (siehe oben) das Attribut aus Magento gelöscht und neu angelegt.
Ein Ändern der Art des Attributes ist seitens Magento nicht möglich. Wenn diese Option nicht gesetzt ist, wird der Attributtyp nicht geändert.

Ohne Mapping werden alle Attribute als Typ "Text" angelegt. Das Mapping bezieht sich auf den Attributcode, den Xentral überträgt. Das bedeutet, es spielt keine Rolle ob es sich um Eigenschaften oder Freifelder handelt, ausschlaggebend ist der Attributcode.

Wichtig: Wenn ein Attribut gelöscht wird, dann werden auch sämtliche Daten zu dem Attribut gelöscht! Sie müssen dann bei allen Artikeln neu übertragen werden.

Übertragung der Marketingsperre

Es ist in Xentral möglich das Feld "Marketingsperre" durch einen Import zu setzen. Sobald ein Kunde angegeben hat, dass er kein "Newsletter" erhalten möchte, kann diese Information über den Button "Importieren von ..." importiert werden.

Dazu muss in der Online Shop - Schnittstelle der Haken "manuelle Adressübertragung" gesetzt werden, ansonsten wird der Button nicht in der Adresse angezeigt.