mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 14:10:28 +01:00
1 line
22 KiB
Plaintext
1 line
22 KiB
Plaintext
<p><strong><span style="font-size:28px;">Shopware 6 Schnittstelle - Installation & Einrichtung</span></strong></p>Mit dieser Schnittstelle können Sie Xentral mit Shopware 6 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).<br /> <h1>Features der Schnittstelle</h1><ul><li>Aufträge aus Shopware importieren</li><li>Auftragsstatus bei Versand umstellen inkl. Meldung der Trackingnummer an Shopware</li><li>Zahlungsstatus der Aufträge an Shopware übertragen</li><li>Rechnungen zu importieren Aufträgen an Shopware übertragen</li><li>Artikel inkl. Artikeldaten und -bildern von Xentral nach Shopware exportieren, auch gezielt in bestimmte Sales Channels von Shopware 6</li><li>Artikeleigenschaften und -freifelder von Xentral zu Shopware exportieren</li><li>Synchronisation aktueller Lagerzahlen bei Bestandsänderungen</li><li>Crossselling-Verknüpfungen von Artikel an Shopware übertragen</li><li>Artikel-Einheiten an Shopware übertragen</li><li>Search Engine Optimization (SEO)-Pfade an Shopware übertragen</li></ul><span class="wiki-text">Rechnungen und Lieferscheine können in Xentral mit eigenem Nummernkreis erstellt werden. Die Belege werden im Versandprozess automatisch erstellt und versendet bzw. am Versanddrucker ausgedruckt.</span><h1><br />Anbindung zu Xentral</h1><h2>Benutzer in Shopware erstellen</h2>Zunächst muss in Shopware unter Einstellung → System → Benutzer & Rechte ein Benutzer hinzugefügt für den Importer angelegt werden. Es ist zwar möglich, einen bereits bestehenden Benutzer zu verwenden, aber ein eigener Benutzer speziell für die Schnittstelle zu Xentral wird ausdrücklich empfohlen.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2786" style="width: 1200px; height: 597px;" /><br /><br /> <h2>Shopschnittstelle in Xentral anlegen</h2>Für eine neue Schnittstelle zu einem Shopware 6-Shop wird das Modul <strong>Shopware6</strong> ausgewählt.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2787" style="width: 1200px; height: 283px;" /><br /><br /><br />Nachdem Sie Shopware6 ausgewählt haben, können Sie im nächsten Schritt die nötigen Daten für die Verbindung der beiden Systeme eintragen.<ul><li><strong>Benutzername</strong> → Benutzername des Benutzers in Shopware, der für die Schnittstelle angelegt wurde</li><li><strong>Passwort</strong> → Passwort des Benutzers in Shopware, der für die Schnittstelle angelegt wurde</li><li><strong>Shop API URL</strong> → Shop-URL + <strong>/api</strong>, z.B. http://www.meinshop.de/api</li></ul><strong>Wichtig:</strong><ul><li>Im Feld <strong>"Passwort"</strong> ist hier das eigentliche Passwort des Benutzers einzutragen, <strong>nicht</strong> der API Key. Der API Integration Key (API-Zugangsschlüssel) aus Shopware 6 kann ggf. angelegt werden, doch für die Anbindung sind immer Benutzername und Passwort zu verwenden.</li><li>Je nachdem, ob die URL des Shops mit http:// oder https:// beginnt, muss die <strong>vollständige URL</strong> korrekt eingetragen werden. Die API-Schnittstelle kann unter Umständen nicht vollständig von https:// auf http:// oder umgekehrt weiterleiten.</li></ul><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2788" style="width: 1200px; height: 560px;" /><br /><br />Sobald die Daten eingetragen wurden, können Sie die Verbindung zwischen beiden System über den Button Verbindung prüfen testen.Bei einer erfolgreichen Verbindung erhalten Sie die Meldung <strong>"Verbindung: success"</strong>.<h1><br />Weitere Einstellungen</h1><ul><li><strong>Standard Hersteller</strong> → Für die Übertragung eines Artikels nach Shopware muss ein <strong>Hersteller</strong> mit übergeben werden. Falls im Artikel kein Hersteller hinterlegt ist, fällt der Importer auf den hier eingestellten Hersteller zurück. Standardmäßig wird als Hersteller "Keine Herstellerinformationen" übertragen, um anzuzeigen, dass es keine Informationen gibt.</li><li><strong>Name der Standardpreisgruppe</strong> → Für die Übertragung eines Artikels muss eine Preisgruppe übergeben werden. Die im Shop zu verwendende Preisgruppe kann hier eingestellt werden.</li></ul><h2>Versandkostenmapping von Shopware</h2>Die Versandkosten werden automatisch nach Xentral mit importiert. In Shopware können die Versandkosten ab einem bestimmten Einkaufsbetrag auf portofrei gesetzt werden. Nach Xentral werden die Aufträge mit Portokosten ganz normal mit einem Portoartikel und dessen Preis importiert. Portofreie Bestellungen werden mit dem Portoartikel importiert, jedoch ist dieser mit 0,00 EUR aufgeführt, somit ist die Bestellung für den Kunden portofrei.<h1><br />Aufträge zu Xentral importieren</h1>Das Importieren von Bestellungen aus Online Shops wird in <a href="https://xentral.com/helpdesk/kurzanleitung-import-von-bestellungen-aus-online-shops?">diesem Artikel</a> beschrieben.<br /> <h2>Auftragsstatus Einstellungen</h2>Standardmäßig importiert Xentral Bestellungen mit dem Status "offen" aus Shopware 6. Bei Bedarf kann auch ein anderer Status abgeholt werden. Ebenso kann festgelegt werden, ob Xentral nur Aufträge mit einem bestimmten Liefer- oder Bezahlstatus importieren soll. Zuletzt kann auch bestimmt werden, auf welche Stati die Aufträge in Shopware 6 umgestellt werden sollen, nachdem sie von Xentral abgeholt und dann nochmal, wenn sie in Xentral fertig verarbeitet wurden. Stornierungen können ebenfalls zurückgemeldet werden und in Shopware 6 auf einen bestimmten Status gestellt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3666" style="width: 1200px; height: 622px;" /><br /> <ul><li><strong>Abzuholender Bestellstatus</strong> → Xentral holt Aufträge ab, die in Shopware diesen Status besitzen</li><li><strong>Eingrenzen auf Lieferstatus</strong> → Xentral holt nur Aufträge ab, die in Shopware den unter "Abzuholender Bestellstatus" eingestellten Status haben und außerdem diesen Lieferstatus</li><li><strong>Eingrenzen auf Bezahlstatus</strong> → Xentral holt nur Aufträge ab, die in Shopware den unter "Abzuholender Bestellstatus" eingestellten Status haben und außerdem diesen Bezahlstatus</li></ul>Dabei ist zu beachten, dass die Status "zum Abholen" und "in Bearbeitung" nie identisch sein sollten, da das System sonst immer wieder den selben Auftrag importiert.<h2><br />Rechnung zu Shopware übertragen</h2><p>Mit dem Abschluss eines Auftrags in xentral, z.B. durch den Paketmarkendruck im Versandzentrum, wird der Auftragsstatus im Shop auf "abgeschlossen" gesetzt. Dadruch ausgelöst wird auch die von xentral erstellte Rechnung des Auftrags als PDF zum Shop übertragen. Die Rechnung findet sich dann im Auftrag in Shopware 6 unter <strong>"Belege"</strong>.<br /><br /><strong>Hinweis:</strong> Die Rechnung kann nur zum Shop übertragen werden, wenn sie zum Zeitpunkt des Abschließens des Auftrags schon existiert. Wird ein Logistikprozess so konfiguriert, dass noch kein Rechnungsbeleg von xentral erstellt wurde, wenn der Auftrag abgeschlossen wird, kann auch <strong>kein</strong> Upload der Rechnung zu Shopware erfolgen. Gegebenenfalls kann eine Rechnung im Nachgang noch zu Shopware exportiert werden, wenn im entsprechenden Auftrag die Aktion <strong>"Shop Status zurückmelden"</strong> (Aktionsmenü) ausgeführt wird.</p><h1><br />Artikel übertragen</h1>Wie Artikel von xentral zu Shopware 6 übertragen werden können, wird im Artikel <a href="index.php?module=wiki&action=list&cmd=index.php?module=wiki&action=list&cmd=onlineshops" target="_blank">Online-Shop-Anbindung: Einstellungen</a> (Artikel zum <span class="highlight" rel="Shop">Shop</span> exportieren/aktualisieren) beschrieben.<br /><br /><strong>Hinweis: </strong>Damit Übersetzungen in andere Sprachen zu Shopware übertragen werden können, z.B. bei Artikelbezeichnungen und Artikelbeschreibungen, muss die Sprache, in die übersetzt werden soll, bereits in Shopware angelegt sein. Das geht in Shopware im Menü Einstellungen → Sprachen.<br /> <h2>Übertragung in Sales Channels</h2><p>In Shopware 6 können Artikel in verschiedene<strong> Sales Channels</strong> unterteilt werden, um die Verkäufe zu kanalisieren und zu kategorisieren.<br />Um Artikel von xentral direkt in einen bestimmten Sales Channel von Shopware 6 zu übertragen, können die Artikel<strong> Eigenschaften</strong> genutzt werden.<br /><br />Im Artikel kann unter "Eigenschaften" eine Eigenschaft angelegt werden, die unbedingt genau <strong>shopware6_sales_channel</strong> heißen muss. Im Wert muss <strong>ganz genau</strong> der Name des Sales Channels stehen, zu dem der Artikel nach dem Export zu Shopware hinzugefügt werden soll. Hierbei muss auch Groß- und Kleinschreibung beachtet werden.</p><ul></ul><h2><span style="color:#e74c3c;"><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3405" style="width: 1200px; height: 362px;" /></span></h2><br />Alle Artikel, die zu Shopware übertragen werden, aber nicht per Eigenschaft einem bestimmten Sales Channel zugeordnet sind, werden zum Standard-Sales Channel hinzugefügt.<br /><br />Dieser kann in der Schnittstelle selbst im Feld <strong>"Standard Sichtbarkeit"</strong> hinterlegt werden – der Name des Sales Channels muss auch hier genau dem in Shopware entsprechen. Auch hier muss die Groß- und Kleinschreibung beachtet werden.<br />Mit <strong>Komma getrennt</strong> können hier auch mehrere Sales Channel eingetragen werden, sodass Artikel standardmäßig zu allen eingetragenen Channels hinzugefügt werden.<h1><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3404" style="width: 1200px; height: 284px;" /></h1><h2><br />Crossselling-Verknüpfungen übertragen</h2>In der App <a href="index.php?module=wiki&action=list&cmd=index.php?module=wiki&action=list&cmd=crossselling" target="_blank">Crossselling</a> von xentral können Artikel mit <strong>ähnlichen</strong> Artikeln oder <strong>Zubehör</strong>-Artikeln verknüpft werden. Das geht in der App selbst oder im Reiter "Crossselling" in den Stammdaten eines Artikels.<br /><br />Diese Verknüpfungen werden beim Artikelexport zu Shopware 6 mitexportiert, sodass dem Endkunden beim Einkauf die korrekten Ähnlichen und Zubehör-Artikel vorgeschlagen werden. In Shopware 6 können zu diesem Zweck Crossselling-Gruppen, also verschiedene Arten des Crosssellings, angelegt und benannt werden. Beim Artikelexport von xentral zu Shopware werden in den übertragenen Artikeln <strong>immer</strong> alle Zuweisungen gelöscht und vollständig neu gesetzt.<br />Beim Artikelexport muss die Crossselling-Zuordnung daher vorhanden sein, weil sie stets neu gefüllt wird.<br /><br />Diese Zuordnung findet sich in Shopware dann im Artikel unter "Cross Selling" (Xentral Zuweisung ist hier ein Platzhalter für den Namen der Crossselling-Gruppe).<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3403" style="width: 1200px; height: 504px;" /><br /><br />Die Crossselling-Gruppen, die xentral in Shopware 6 anlegt, sind statisch. Zubehör-Verknüpfungen heißen immer <strong>"Zubehör"</strong> und Ähnliche Artikel heißen immer <strong>"Ähnlich"</strong>.<br />Wurden in Shopware bereits Crossselling-Gruppen zufällig genau so genannt, müssen diese umbenannt werden, damit es beim Artikelexport nicht zu Konflikten kommt.<br /><br /><strong>Wichtig:</strong> Damit die Crossselling-Verknüpfungen korrekt übertragen werden können, müssen die zugeordneten Artikel bereits in Shopware 6 existieren und eine gültige Artikelnummer besitzen. Sollen ganz neue Artikel, die im Shop noch nicht existieren, mit Crossselling-Verknüpfungen zu Shopware exportiert werden, empfiehlt es sich daher, diese Artikel erst vollständig zu Shopware zu übertragen und im Anschluss in xentral die Crossselling-Verknüpfungen der Artikel anzulegen. Im Nachgang wird dann noch einmal ein Artikelexport durchgeführt.<h1><br />Eigenschaften übertragen</h1>Aus Xentral heraus können Artikel mitsamt ihren Eigenschaften zu Shopware 6 übertragen werden. Im Reiter "Eigenschaften" in den Stammdaten eines Artikels können neue Eigenschaften sowie Übersetzungen der Eigenschaften angelegt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2946" style="width: 1200px; height: 239px;" /><br /><br />Über "neue Eigenschaft" kann eine neue Eigenschaft angelegt werden. Damit Eigenschaften übertragen werden, reicht es aus eine neue Eigenschaft bei Artikeln anzulegen und diese im Anschluss zu nach Shopware zu exportieren.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2948" style="width: 1200px; height: 524px;" /><br /> <h2>Artikel Einheiten übertragen</h2><p>In Shopware besitzen Artikel mehrere Einheiten, so z.B. die Maßeinheit, die Verkaufseinheit, die Verpackungseinheit etc. Diese Einheiten können in Xentral als Eigenschaften angelegt werden, um sie beim Artikelexport zu Shopware zu füllen. Die Eigenschaften müsse wie folgt heißen, um den Einheiten aus Shopware zugeordnet zu werden:</p><ul><li><strong>shopware6_unit</strong> → Maßeinheit</li><li><strong>shopware6_purchase_unit </strong>→ Verkaufseinheit</li><li><strong>shopware6_reference_unit </strong>→ Grundeinheit</li><li><strong>shopware6_pack_unit </strong>→ Verpackungseinheit</li><li><strong>shopware6_pack_unit_plural</strong> → Verpackungseinheit Mehrzahl</li></ul><p>Der eingetragene Wert befüllt die Einheit im Shopware. Alternativ möglich ist ein Freifeldmapping im Reiter "Freifelder" in der Shopschnittstelle.<br /><br />Artikel Einheiten in Xentral übertragen standardmäßig in das Feld "<strong>Maßeinheit</strong>" von Shopware. Überschreibbar ist das mit Eigenschaften oder einem Freifeld-Mapping. Dann geht der Wert der Eigenschaft, die der Xentral-Einheit entspricht, in das eingestellte Feld.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3643" style="width: 1200px; height: 395px;" /><br /><br /><br />Für die "Maßeinheit" gibt es eine Besonderheit zu beachten: Damit sie richtig gefunden werden kann, muss in Xentral die entsprechende <strong>Einheit</strong> als solche angelegt sein und existieren. Für das Beispiel "Liter" sieht das so aus: Das <strong>Kürzel</strong> der Einheit muss im Feld "Einheit" stehen, nicht der ausgeschrieben Name. Das ist wichtig, damit die Einheit beim Artikelexport der Einheit in Shopware zugeordnet wird und nicht neu angelegt wird.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3644" style="width: 1200px; height: 395px;" /></p><h2><br />SEO-Pfade übertragen</h2><p>In Shopware 6 können in Artikeln "SEO-Pfade" angelegt werden. Diese stellen SEO-optimierte URLs dar, sodass der Artikel in Online-Suchmaschinen besser gefunden wird. Pro Sales Channel kann ein Artikel einen eigenen SEO-Pfad besitzen. Diese SEO-Pfade können auch in Xentral im Artikel angelegt werden, damit sie beim Artikelexport zu Shopware übertragen werden.<br /><br />Dafür wird in Xentral im Artikel eine Eigenschaft mit dem Namen "<strong>shopware6_seo_url</strong>" angelegt. Der in dieser Eigenschaft hinterlegte Wert wird als SEO-Pfad an Shopware übertragen. Falls ein Sales Channel-spezifischer SEO-Pfad übertragen werden soll, muss der Name des Sales Channels im Namen der Eigenschaft nach einem Trennstrich hinzugefügt werden, z.B. "<strong>shopware6_seo_url|Name des Verkaufskanals</strong>". Werden mehrere Sales Channel-spezifische SEO-Pfade als Eigenschaften angelegt, werden auch alle an Shopware übertragen.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3642" style="width: 1200px; height: 315px;" /><br /><br />Wenn sowohl ein allgemein gültiger SEO-Pfad sowie Sales Channel-spezifische angelegt werden, so werden in den angesprochenen Sales Channels die Spezifischen exportiert. Der allgemein Gültige wird in alle übrigen Sales Channels exportiert.<br /><br />Alternativ kann ein Freifeld mit dem Namen "<strong>shopware6_seo_url</strong>" angelegt werden und auf das entsprechende Feld in Shopware 6 gemappt werden. Das geht in der Shopschnittstelle im Reiter "Freifelder".</p><h1><br />Freifelder übertragen</h1>Freifelder eines Artikels können von Xentral zu Shopware 6 übertragen werden, wenn die Im Artikel unter "Freifelder" können zusätzliche Felder selbst definiert werden. Damit diese Option zur Verfügung steht, müssen die Freifelder zuvor erst in Shopware angelegt werden.<br /><br />Im ersten Schritt wird ein Custom-Field-Set benötigt.<br /><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2947" style="width: 1200px; height: 864px;" /><br /><br />Im nächsten Schritt müssen dann die eigentlichen Custom-Fields angelegt werden. Über den Button "Neues Zusatzfeld" kann ein neues Zusatzfeld angelegt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2949" style="width: 1200px; height: 1141px;" /><br /><br />Besonders wichtig ist hier der <strong>technische Name</strong>, da dieser später für das Mapping benötigt wird.<br /><br />Im Anschluss kann über den Reiter "Freifelder" ein Freifeld in Xentral erstellt werden, um es dann nach Shopware exportieren zu können.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2951" style="width: 1200px; height: 287px;" /><ul><li><strong>Freifeld Xentral</strong> → Auswahl des Freifelds über das Dropdown Menü</li><li><strong>Bezeichnung in Shop</strong> → Bezeichnung des Textfeldes im Shop (<strong>Technischer Name</strong>)</li></ul>Über speichern wird dann ein neues Freifeld angelegt.<br /><br />Im Artikelstamm unter "Parameter und Freifelder" kann anschließend das Freifeld mit einem Wert befüllt werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2955" style="width: 1200px; height: 324px;" /><br /><br />Das Freifeld erscheint nach einem Artikelexport wiefolgt im Shop.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=2956" style="width: 1200px; height: 660px;" /><br /> <h1>Gruppenmapping</h1><h2>Gruppenpreise übertragen</h2>Damit eine <strong>Preisgruppe</strong> von Xentral an Shopware übertragen werden kann, muss die Gruppe das richtige Mapping auf eine <strong>Preisregel</strong> in Shopware haben. Der Name der Preisregel muss 1:1 aus Shopware übernommen werden. Preisregeln kann Xentral <strong>nicht</strong> durch einen Artikelexport anlegen, diese müssen in Shopware angelegt werden. Dann kann in den Stammdaten eines Artikels ein Preis auf diese Preisgruppe erstellt werden und dieser kommt beim Export als Preis (zu einer Preisregel gehörig) in Shopware an.<br /><br />Ein korrekts Mapping von Preisgruppen aus Xentral auf Preisregeln in Shopware 6 könnte beispielhaft so aussehen:<br /><br />1.) Im Modul <strong>Gruppen</strong> von Xentral werden zwei Preisgruppen angelegt.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3645" style="width: 1200px; height: 274px;" /><br /><br /><br />2.) In der Shopschnittstelle werden die Preisgruppen im Reiter "Gruppenmapping" auf Preisregeln von Shopware gemappt. Die Bezeichnung der Preisregel in Shopware muss genau übernommen werden.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3647" style="width: 1200px; height: 332px;" /><br /><br />Zum Vergleich: Die Preisregeln in Shopware sehen so aus:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware6&fileid=3646" style="width: 1200px; height: 188px;" /> |