mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-27 07:00:29 +01:00
3 lines
21 KiB
Plaintext
3 lines
21 KiB
Plaintext
<span style="font-size:28px;"><strong>Shopware Schnittstelle - Installation & Einrichtung</strong></span><div class="content"><div class="row column"><div id="system-message-container"> </div></div></div>
|
|
<article><div class="text text-container offset-bottom2"><span class="wiki-text">Mit dieser Schnittstelle können Sie Xentral mit Shopware 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).</span></div> <div class="video-box youtube-video"><span class="wiki-text"><iframe allowfullscreen="" frameborder="0" src="https://www.youtube.com/embed/49PICIq3XP8"></iframe></span></div> <h1>Features der Schnittstelle</h1><ul><li>Aufträge aus Shopware abholen</li><li>Auftragsstatus bei Versand umstellen inkl. Meldung der Trackingnummer an Shopware</li><li>Artikel von Xentral nach Shopware oder von Shopware nach Xentral übertragen</li><li>Meldung aktueller Lagerzahlen bei Bestandsänderungen</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><br /> <h1>Installation in Xentral</h1><h2>API Benutzer in Shopware erstellen</h2><span class="wiki-text">Zunächst muss in Shopware unter Einstellung → Benutzerverwaltung → Benutzer hinzufügen ein API-Benutzer angelegt werden. Dieser Benutzer wird speziell für die Xentral-Schnittstelle verwendet.</span><span class="wiki-text">Der API-Zugang muss auf aktiviert sein. Der Benutzername kann frei gewählt werden.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=1" /></span><h2><br />Shopschnittstelle in Xentral anlegen</h2><span class="wiki-text">Unter Administration → Einstellungen → Online-Shops → NEU kann ein neuer Shop angelegt und das Modul Shopware ausgewählt werden.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=2" /></span><br /><span class="wiki-text">Nachdem Sie Shopware ausgewählt haben, können Sie im nächsten Schritt die nötigen Daten für die Verbindung der beiden Systeme eintragen. Den API-Key haben Sie im Shopware-Backend beim Anlegen des Benutzers für die Schnittstelle erhalten.</span><ul><li><strong>API User</strong>: Benutzername des Benutzers in Shopware, der für die Schnittstelle angelegt wurde</li><li><strong>API Key</strong>: Generierter API-Key aus der Benutzerverwaltung von Shopware</li><li><strong>API URL</strong>: Shop-URL + <strong>/api</strong>, z.B. <a href="http://www.meinshop.de/api/">http://www.meinshop.de/api/</a></li></ul><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=3" /></span><br /><br /><span class="wiki-text">Sobald die Daten eingetragen wurden, können Sie die Verbindung zwischen beiden System über den Button <strong>Verbindung prüfen</strong> testen.</span><span class="wiki-text">Bei einer erfolgreichen Verbindung erhalten Sie die Meldung '<strong>Verbindung: success</strong>' oder, falls die Schnittstelle Subshops erkennt, eine Auflistung der erkannten '<strong>Subshops</strong>' und deren Subshop-IDs.</span><br /><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=4" /></span><br /><br /><span class="wiki-text"><strong><span style="color:#00a2e8">Praxistipp</span></strong>: Die API-URL können Sie direkt im Browser aufrufen und dort die Zugangsdaten eingeben. Als Ergebnis sollte folgende Rückmeldung erscheinen:</span><br /><br /><span class="wiki-text"><strong>success: false<br />message:Resource not found</strong></span><br /><br /><span class="wiki-text">Sollte die Verbindung fehlschlagen, kann auch eine Authentifizierung über <strong>Digest</strong> durchgeführt werden.</span><br /><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=5" /></span><h1><br /><br />Aufträge zu Xentral übertragen</h1><span class="wiki-text">Das Importieren von Bestellungen aus Online Shops wird <a href="https://xentral.com/helpdesk/kurzanleitung-import-von-bestellungen-aus-online-shops?">in diesem Artikel</a> beschrieben.</span><h2><br />Alte Aufträge zu Xentral übertragen</h2><span class="wiki-text">Die Shopware-Schnittstelle ermöglicht auch einen Import alter Aufträge vom Shop zu Xentral. Vor dem Import der Aufträge prüft Xentral ob es schon Aufträge mit dieser Shop-Bestellnummer gibt und holt diese Aufträge gegebenenfalls nicht nochmal ab.</span><span class="wiki-text">In der Shopschnittstelle in Xentral gibt es hierfür den Button <strong>Alte Aufträge importieren</strong>.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=6" /></span><br /><br /><span class="wiki-text">Sobald Sie auf diesen Button geklickt haben, können Sie im Dialogfenster anhand der Shopware-Bestellnummern angeben, welche alten Aufträge abgeholt werden sollen.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=7" /></span><ul><li><strong>Nummer von</strong> → Älteste Belegnummer im Shop von der die Aufträge abgeholt werden sollen. Wenn leer gelassen, dann wird ab dem ältesten Auftrag abgeholt.</li><li><strong>Nummer bis</strong> → Letzte Belegnummer im Shop bis zu der die Aufträge abgeholt werden sollen. Wenn leer gelassen, dann wird bis zum neuesten Auftrag abgeholt.</li><li><strong>Auftrag abschließen</strong> → Der importierte Auftrag wird auf Status "abgeschlossen" gesetzt.</li><li><strong>Stornierte Aufträge auch abholen</strong> → Holt auch die Aufträge ab, die im Shop den Status 'storniert' haben.</li></ul><span class="wiki-text">Über den Button <strong>Abholen</strong> wird der Import angestoßen. Der Import erfolgt dann nach und nach im Hintergrund. Dafür benötigen Sie den Prozessstarter Shopimport Auftragarchiv (Link zum Prozessstarter). Der Import kann je nach Menge der Aufträge eine längere Zeit in Anspruch nehmen.<br /><br />Shopware erlaubt den Import von bis zu 1000 Aufträgen auf einmal. Je nach Auftragsmenge ist es daher nicht möglich, Aufträge mehrerer vergangener Jahre zu importieren.<br />Idealerweise werden nur unbedingt benötigte Altaufträge importiert.</span><h1><br />Demo- und Testfunktionen<br /> </h1><p><strong><span style="font-size:16px;">Testlauf: Einzelne Aufträge von Shopware abholen</span></strong></p><span class="wiki-text">Vom Shop können auch gezielt einzelne Aufträge direkt nach der Auftragsnummer in Shopware abgeholt werden. Hierzu muss folgendes eingestellt werden:</span><br /><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=8" /></span><ul><li><strong>Abholmodus</strong>: Ab Nummer (Status)</li><li><strong>ab Nummer</strong>: Bestellnummer (bei Bestellnummern die Buchstaben in der Zeichenfolge enthalten die ID der Bestellung) eingeben</li><li><strong>Nur 1 Auftrag pro Anfrage</strong>: Haken setzen</li></ul><span class="wiki-text"><span style="color:#00a2e8"><strong>Praxistipps:</strong></span></span><span class="wiki-text"> Der Shopstatus und in manchen Fällen auch der Zahlstatus des Auftrags muss in Shopware <strong>offen</strong> sein, damit der Auftrag zu Xentral importiert werden kann.</span><span class="wiki-text">Falls Einstellungen in der Shopschnittstelle das Abholen verhindern, ist es mitunter schneller direkt über die Shopware-Stapelverarbeitung Aufträge umzustellen (Bestellstatus → "offen"). Diese Aufträge werden dann beim Import abgeholt und der Status wird durch die Schnittstelle in Shopware von "offen" auf "in Bearbeitung" umgestellt.</span><span class="wiki-text">Im Abholmodus "ab Nummer" kann gezielt ein bestimmter Auftrag abgeholt werden. Anderweitig wäre nur die Abholung des ältesten, offenen Auftrags möglich.</span><span class="wiki-text">Zusätzlich ist zu beachten, dass bei einem Shop, in dem die Bestellnummern nicht aus alphanumerischen Zeichen bestehen, die Abholung ab Nummer automatisch auf die <strong>ID</strong> des Datensatzes der Bestellung umgestellt wird bzw. umgestellt werden muss.</span><h1><br />Sonderfunktionen</h1><h2>Subshops</h2><br /><span class="wiki-text">Falls Sie in Shopware verschiedene Subshops haben, können Sie diese im Tab Subshop mappen. Subshops werden z.B. für die Trennung nach Sprache oder Domain (z.B. meinshop.de und meinshop.com) verwendet.</span><span class="wiki-text">So könnte ein Mapping beispielsweise aussehen: </span><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=9" /></span><span class="wiki-text"><strong><span style="color:#ed1c24">Wichtig</span></strong>: Bitte beachten Sie, dass das Subshop-Mapping nur klappt, wenn die Subshops in Shopware auch als Subshops eingestellt sind und <strong><u>nicht</u> als Sprachshops</strong>!</span><h2>Zahlungsstatus zurückmelden</h2><span class="wiki-text">Der Zahlungsstatus der Aufträge direkt an den Shop zurückzumelden.</span><span class="wiki-text">Dazu muss eine von diesen Anforderungen erfüllt sein:</span><ul><li>Die verknüpfte Rechnung zum Auftrag wurde auf manuell bezahlt gesetzt.</li><li>Die verknüpfte Rechnung zum Auftrag wurde durch einen Zahlungseingang komplett beglichen.</li></ul><span class="wiki-text">Damit der Zahlungsstatus zurück gemeldet werden kann, braucht man den Prozessstarter <a href="https://xentral.com/helpdesk/prozessstarter?#nav-prozessstarter--shop-r-ckmeldungen">Shop Rückmeldungen</a>.</span><br /> <h2>Artikelbilder exportieren</h2><span class="wiki-text">Die Shopware-Schnittstelle erlaubt den Export von Artikelbildern von Xentral zum Shop, wenn die Bilder in Xentral im Artikelstamm unter Dateien mit dem Stichwort <strong>Standard Artikelbild (Shopbild)</strong> angelegt wurden. Nur Bilder mit diesem Stichwort wrden an den Shop exportiert.</span><span class="wiki-text">Informationen über den Export von Artikelbildern finden Sie <a href="https://xentral.com/helpdesk/kurzanleitung-einrichtung-online-shop-schnittstelle?#nav-artikelbilder--bertragen">in diesem Artikel</a>.</span><br /> <h2>Versandkostenmapping von Shopware</h2><span class="wiki-text">Die Versandkosten werden automatisch nach Xentral mit importiert.<br />In Shopware können die Versandkosten ab einem bestimmten Einkaufsbetrag auf portofrei gesetzt werden.</span><span class="wiki-text">Nach Xentral werden die Aufträge mit Portokosten ganz normal mit einem Portoartikel und dessen Preis importiert.<br />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.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=10" /></span><h2><br />Freifeldermapping und Export anderer Felder</h2><span class="wiki-text">Für Shopware ist es möglich über ein "direktes Mapping" von Artikel-Freifeldern spezifische Daten beim Artikelexport zu übertragen. Dazu werden beim Mapping der Freifelder, bzw. beim Namen der Eigenschaften die Textbausteine "mainArticle_", bzw. "mainDetail_" vorangestellt. Daten sie übertragen werden, werden über die API direkt an die jeweilige Stelle übergeben. Dadurch ist es möglich spezielle Felder anzusprechen für die es kein Gegenstück in Xentral gibt, oder die durch ein Plugin hinzugefügt wurden.</span><br /><br />Das Freifeldmapping der Shopware-Schnittstelle funktioniert in diesem Umfang nur in eine Richtung, nämlich für den Export von Xentral zu Shopware. Beim Import von Freifeldern von Shopware zu Xentral wird nur auf Felder die mit <strong>"attr" </strong>anfangen Rücksicht genommen.<br /><br /><br /><span class="wiki-text"><span style="font-size:16px;"><strong>Schema</strong></span><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=11" /></span><br /><br /><span class="wiki-text"><strong>Beispiele:</strong></span><span class="wiki-text"> Werden Eigenschaften mit der Bezeichnung "mainArticle_filterGroup" kann das Eigenschaften-Set bei Shopware ansprechen. In Shopware muss für einen Artikel ein Eigenschaften Set angelegt sein, um auch Eigenschaften auswählen zu können. In Xentral wird das Eigenschaften Set dann hinterlegt und beim Export nach Shopware übergeben. Bei Varianten-/Matrixartikeln muss das Eigenschaften Set im Hauptartikel in Xentral angelegt sein.</span><span class="wiki-text">Wird eine Eigenschaft mit der Bezeichnung "mainArticle_notification" und einem Wert von "1" bei einem Artikel hinterlegt sorgt das dafür, dass das Feld für E-Mail-Benachrichtung für den Artikel in Shopware aktiviert wird: </span><br /><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=12" /></span><br /><br /><span class="wiki-text">Folgendes Mapping der Freifelder in den Importereinstellungen würde dafür sorgen, dass die Daten für die Grundpreisberechnung, sowie das Erscheinungsdaten, der Wert für Versandkostenfreiheit, sowie der Wert für die E-Mailbenachrichtigung übertragen wird:</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=13" /></span><h5><br /><strong><span style="font-size:16px;">Mögliche Felder unter mainArticle</span></strong></h5><ul><li>taxId - ID der Steuergruppe</li><li>priceGroupId - ID der Preisgruppe</li><li>filterGroup - <strong>Spezialfeld</strong>. Es ist möglich statt der Filtergruppenid auch die Bezeichnung der Filtergruppe anzugeben. Wenn die Bezeichnung mit der aus Shopware übereinstimmt kann so die Filtergruppenid ermittelt werden</li><li>filterGroupId - ID der Filtergruppe</li><li>configuratorSetId - ID des Konfiguratorsets</li><li>pseudoSales - Anzahl Pseudoverkäufe</li><li>priceGroupActive - Gibt an ob Preisgruppe aktiv ist</li><li>notification - E-Mailbenachrichtigung beim Artikel erlauben</li><li>availableFrom - Verfügbar von</li><li>availableTo - Verfügbar bis</li></ul><h5><br /><span style="font-size:16px;"><strong>Mögliche Felder unter mainDetail</strong></span></h5><ul><li>additionalText - Zusatzinfo</li><li>stockMin - Mindestmenge</li><li>purchasePrice - Einkaufspreis</li><li>position - Position</li><li>minPurchase - Mindestverkaufsmenge</li><li>purchaseSteps - Verkaufsschritte</li><li>maxPurchase - Höchstverkaufsmenge</li><li>purchaseUnit - Verkaufseinheit</li><li>referenceUnit - Artikeleinheit</li><li>packUnit - ID Verpackungseinheit</li><li>shippingFree - Kostenloser Versand</li><li>releaseDate - Veröffentlichungsdatum</li></ul><span class="wiki-text"><strong>Hinweis:</strong> Sollte ein direktes Mapping für ein Feld verwendet werden das bereits beachtet wird (beispielsweise mainDetail_number für die Artikelnummer, oder mainArticle_name für den Namen) sticht der Wert aus der Eigenschaft bzw. dem Freifeld den eigentlich aus den Artikeldaten in Xentral zu übertragenden Wert. Ferner werden Eigenschaften nur dann als PropertyValues übertragen wenn der Artikel eine Filtergruppenid vorweisen kann. Ansonsten werden PropertyValues nicht übertragen. Alle möglichen Felder können direkt über die API eingesehen werden, unter: shopurl/api/articles/ArtikelIDdesArtikels.</span><br /> <h2><strong><span style="font-size:16px;">Freifelder übersetzen</span></strong></h2><span class="wiki-text">Wenn ein Subshopmapping existiert und eine Übersetzung der Freifelder für die entsprechende Sprache existiert, wird die Übersetzung an Shopware exportiert.</span><h1>Eigenschaften zu Shopware übertragen</h1><span class="wiki-text">Wird dem Namen einer Eigenschaft in Xentral <strong>articleAttribute_</strong> vorangestellt, so können diese direkt als <strong>Attribute</strong> in Shopware exportiert werden.</span><br /><br /><span class="wiki-text"><u>Beispiel</u>:</span><span class="wiki-text"> Die Eigenschaft Preishistorie soll wird nun als "articleAttribute_Preishistorie" angelegt (statt einfach nur "Preishistorie").</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=14" /></span><br /><br /><span class="wiki-text">In der Freitextfeld-Verwaltung von Shopware wird das Feld mit dem dazu passenden Namen in der Tabelle <strong>articles_attributes</strong> angelegt.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=15" /></span><br /><br /><span class="wiki-text">Der Wert der Eigenschaft wird beim Artikelexport von Xentral zu Shopware dann in das vorgesehene Feld übertragen.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=16" /></span><h2><br /><br />Crossselling</h2><span class="wiki-text">In Verbindung mit der App Crossselling ist es möglich, Crossselling-Verknüpfungen zwischen zwei Artikeln in Xentral zu pflegen und zu Shopware zu übertragen.</span><span class="wiki-text">In der Crosselling App können Artikel hierzu bidirektional verknüpft werden.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=17" /></span><br /><br /><span class="wiki-text">Wenn die Einstellungen so gespeichert werden, werden die Artikel in Shopware dem jeweils anderen als Zubehörartikel zugeweisen.</span><br /><br /><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=18" /></span><span class="wiki-text"><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_shopware&fileid=19" /></span><br /><br /><span class="wiki-text">Zu beachten ist, dass das Crossselling Rücksicht auf Fremdnummern nimmt. Das bedeutet, wenn für den Shop eine entsprechende Fremdnummer eingestellt ist, wird versucht diese zu verwenden.</span><h2><br />Kundengruppen Mapping</h2><span class="wiki-text">Das Kundengruppening Mapping funktioniert in Verbindung mit der Option <strong>Neukunden automatisch zuweisen</strong>. Das heißt, wenn es ein Mapping mit aktivierter Option gibt, werden neue Adressen automatisch der entsprechenden Gruppe zugeordnet.</span><span class="wiki-text">Es ist möglich, Kundengruppen aus dem Shop zu übernehmen, dazu muss das Kürzel (die Kennziffer) genau übereinstimmen. Wenn die Option im Importer aktiviert ist und es eine Übereinstimmung gibt, wird die Adresse der Gruppe zugewiesen.Zusätzlich kann man in den Importereinstellungen den Haken <strong>Neue Benutzergruppen anlegen</strong> aktivieren. Dann wird eine neue Kundengruppe in Xentral angelegt, falls keine Übereinstimmung gefunden werden konnte.</span><br /><br /><span class="wiki-text">Bitte beachten Sie, dass das Gruppenmapping in Kundengruppen für Shopware aktuell nicht für die automatische Zuordnung von Gruppen greift.</span></article>
|
|
<br /> |