mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 22:20:29 +01:00
1 line
16 KiB
Plaintext
1 line
16 KiB
Plaintext
<strong><span style="font-size:28px;">Magento 2 Schnittstelle - Installation & Einrichtung</span></strong><br /><br />Mit dieser Schnittstelle können Sie Xentral mit Magento 2 verbinden, um Bestellungen von dort in Xentral zu importieren und Ihre im Shop verkauften Artikel in Xentral zu verwalten. Die Anbindung geschieht über eine API-Schnittstelle (Shopimporter).<p dir="ltr">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.</p> <div class="video-box youtube-video"><span class="wiki-text"><iframe allowfullscreen="" frameborder="0" src="https://www.youtube.com/embed/49PICIq3XP8"></iframe></span><h1><br /><span class="wiki-text">Features der Schnittstelle</span></h1><ul><li><span class="wiki-text">Aufträge aus Magento 2 abholen</span></li><li><span class="wiki-text">Auftragsstatus bei Versand umstellen inkl. Meldung Trackingnummer</span></li><li><span class="wiki-text">Artikel einzeln von Xentral nach Magento oder von Magento nach Xentral übertragen</span></li><li><span class="wiki-text">Meldung aktueller Lagerzahlen bei Bestandsänderungen</span></li><li><span class="wiki-text">Artikelfreifelder werden zu Custom Attributes übertragen</span></li><li><span class="wiki-text">Übertragung der Marketingsperre</span><br /><br /> </li></ul><h1><span class="wiki-text">Installation der Schnittstelle</span></h1><h2><br /><span class="wiki-text">API Benutzer in Magento 2 erstellen</span></h2><p><br /><span class="wiki-text"><span style="font-size:16px;"><strong>Schritt 1: Benutzer anlegen</strong></span></span></p><span class="wiki-text">In Magento muss ein neuer Benutzer unter System → All Users → Add New User anlegen werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=3" /><br /><br /><br /><span style="font-size:16px;"><strong>Schritt 2: Account Informationen ausfüllen</strong></span></span><ul><li><span class="wiki-text">Alle Daten ausfüllen - für Xentral benötigen Sie die Felder "User Name" und "New Password"</span></li><li><span class="wiki-text">Unten das Passwort des eigenen Benutzers eingeben und mit "Save User" oben die Änderungen speichern</span></li></ul><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=4" /><br /><br /><br /><br /><span style="font-size:16px;"><strong>Schritt 3: User Role überprüfen</strong></span><br /><br />Unter "User Role" sollte der Benutzer als Administrator gekennzeichnet sein.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=5" /></span><h2><br /><span class="wiki-text">Shopschnittstelle in Xentral anlegen</span></h2><br /><span class="wiki-text"><span style="font-size:16px;"><strong>1. Shopschnittstelle anlegen</strong></span><br /><br />Unter Administration → Einstellungen → Online-Shops → NEU kann man nach Magento 2 suchen:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=3806" style="width: 1836px; height: 458px;" /><br /><br /><br /><span style="font-size:16px;"><strong>2. Magento 2 Daten eingeben</strong></span><br /><br />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.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=3807" style="width: 1828px; height: 748px;" /><br /><br /><br /><span style="font-size:16px;"><strong>3. Verbindung prüfen</strong></span><br /><br />Am Schluss überprüfen Sie mit einem Klick auf "Verbindung prüfen" ob die Anbindung geklappt hat:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=8" /><br /><br /><br />Sollte es zu einem Fehler kommen überprüfen Sie bitte, ob d</span><span class="wiki-text">ie Zugangsdaten aus Magento korrekt in Xentral hinterlegt wurden.</span><br /><span class="wiki-text"> </span><br /> <h1><span class="wiki-text">Einstellungen der Schnittstelle</span></h1><p>Unter den Zugangsdaten befindet sich eine Reihe von Einstellungen, die speziell bei Magento2-Shops relevant sind.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=3542" style="width: 1200px; height: 311px;" /><br /> </p><ul><li><strong>Stücklisten-Unterartikel</strong> <strong>automatisch mitexportieren </strong>→ Wenn aktiviert, dann werden die Unterartikel mitexportiert, wenn eine Stückliste zum Shop exportiert wird.</li><li><strong>Status "zum Abholen"</strong> → Status der Aufträge, die Xentral abholen soll.</li><li><strong>Status "in Bearbeitung"</strong> → Status, auf den Aufträge nach der Abholung zu Xentral, gesetzt werden sollen.</li><li><strong>Status "Abgeschlossen" </strong>→ Status, auf den Bestellung umgestellt wird, wenn Auftrag in Xentral verarbeitet wurde. Standardmäßig "completed", wenn nichts eingetragen wird.</li><li><strong>Attributecodes für Eigenschaften</strong> → 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.</li><li><strong>Normale / Ermäßigte Steuer ID</strong>: 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.</li><li><strong>Wurzelkategorie ID</strong> → Beim Export von Artikel bzw. des Artikelbaums von Xentral zu Magento 2, werden diese in die hier eingestellte Wurzelkategorie von Magento2 übertragen.</li><li><strong>Attributtyp bei Bedarf anpassen</strong> → 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.</li></ul><h2><br /><span class="wiki-text">Weitere Einstellungen und Mapping </span></h2><p><span class="wiki-text">Wie Sie die weiteren Einstellungen vornehmen sowie das Zahlungsweisen- und Versandarten-Mapping vornehmen, erfahren Sie im Artikel <a href="index.php?module=wiki&action=list&cmd=onlineshops" target="_blank">Online Shops: Einstellungen</a>. </span></p><h1><br />Aufträge importieren</h1><h2><span class="wiki-text">Abholmodus</span></h2><span class="wiki-text">Beim Auftragsimport können Sie in Magento 2 zwischen zwei Abholmodi wählen, der Abholung nach Auftragsstatus oder -nummer.<br /><br />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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=9" /></span><br /><br /><br /><span class="wiki-text">Magento 2 erwartet beim Abholmodus "ab Nummer" einen Request an die Auftrags-<strong>ID</strong>, 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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=10" /><br /><br />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.<br /><br />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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=11" /></span><br /><br /> <h2><span class="wiki-text">Kundenkommentar importieren</span></h2>Der Magento 2-Importer kann den Kundenkommentar im Warenkorb eines Auftrags als <strong>Freitext</strong> in den Auftrag in Xentral übernommen werden.<br />Hat der Kunde mehrere Kommentare hinterlassen, wird allerdings nur der <strong>erste</strong> Kommentar übertragen, da die Meldungen zum Auftragsstatus in der gleichen Datenstruktur stehen. Es bestünde sonst die Gefahr, dass Statusmeldungen als Kommentar interpretiert werden.<br /><span class="wiki-text"> </span><h1><span class="wiki-text">Artikel-Attribute</span></h1><span class="wiki-text">Bei der Verwendung von Attributen ist immer das Attributset relevant. Um das Attributset auszuwählen gibt es zwei Möglichkeiten:</span><ul><li><span class="wiki-text">Die ID des Attributs bei der Eigenschaft mit dem Namen '<strong>AttributeSetID'</strong> hinterlegen</span></li><li><span class="wiki-text">Den Namen des zu verwendenden Sets bei der Eigenschaft mit dem Namen '<strong>AttributeSetName</strong>' hinterlegen</span></li></ul><span class="wiki-text">Das Attributset sehen Sie in Magento in der Artikeltabelle:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=12" /><br /><br /><br />Mapping in Xentral:<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=13" /><br /><br />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.<br /><br /><u>Wichtig</u>: 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.</span><h2><br /><span class="wiki-text">Artikel-Freifelder übertragen</span></h2><span class="wiki-text">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).<br /><br />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 <strong>Advanced Attribute Properties</strong> zu finden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=14" /><br /><br /><br />Werden Attributes in Magento neu durch einen Export von Xentral angelegt, wird der Scope automatisch auf Global gesetzt.<br />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.</span><br /> <h2><span class="wiki-text">Attributmapping</span></h2><span class="wiki-text">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.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=3543" style="width: 1200px; height: 210px;" /></span><br /> <ul><li><strong>Attribut</strong> → Hier steht der Attributcode</li><li><strong>Parameter</strong> → Für Select und Multiselect kann man eine Parameterliste übergeben</li></ul><br />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 <strong>;1 </strong>als Standardoption zu kennzeichnen. Wenn nichts, oder <strong>;0 </strong>an den jeweiligen Wert angehangen werden ist das Wert als nicht Default gekennzeichnet.<div class="image-hover" style="float: none;"> </div>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.<br /><br />Wenn ein Attribut im Shop existiert, aber einen anderen Typ hat, als im erweiterten Mapping eingestellt ist wird bei gesetzter Option <strong>"Attributtyp bei Bedarf anpassen" </strong>(siehe oben) das Attribut aus Magento gelöscht und neu angelegt.<br />Ein Ändern der Art des Attributes ist seitens Magento nicht möglich. Wenn diese Option nicht gesetzt ist, wird der Attributtyp nicht geändert.<br /><br />Ohne Mapping werden alle Attribute als Typ <strong>"Text"</strong> 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.<br /><br /><strong><span style="color:#e74c3c;">Wichtig</span>: 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.</strong><h2> </h2><h1><span class="wiki-text">Übertragung der Marketingsperre</span></h1>Es ist in Xentral möglich das Feld "Marketingsperre" <span class="wiki-text"> 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.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=1" /><br /><br /><br />Dazu muss in der Online Shop - Schnittstelle der Haken "manuelle Adressübertragung" gesetzt werden, ansonsten wird der Button nicht in der Adresse angezeigt.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_magento2&fileid=2" /></span><h1> </h1></div> |