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).

Features der Schnittstelle

Aufträge aus Shopware abholen
Auftragsstatus bei Versand umstellen inkl. Meldung der Trackingnummer an Shopware
Artikel von Xentral nach Shopware oder von Shopware nach Xentral übertragen
Meldung aktueller Lagerzahlen bei Bestandsänderungen

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.

Installation in Xentral

API Benutzer in Shopware erstellen

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.Der API-Zugang muss auf aktiviert sein. Der Benutzername kann frei gewählt werden.

Shopschnittstelle in Xentral anlegen

Unter Administration → Einstellungen → Online-Shops → NEU kann ein neuer Shop angelegt und das Modul Shopware ausgewählt werden.

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.

API User: Benutzername des Benutzers in Shopware, der für die Schnittstelle angelegt wurde
API Key: Generierter API-Key aus der Benutzerverwaltung von Shopware
API URL: Shop-URL + /api, z.B. http://www.meinshop.de/api/

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 'Verbindung: success' oder, falls die Schnittstelle Subshops erkennt, eine Auflistung der erkannten 'Subshops' und deren Subshop-IDs.

Praxistipp: Die API-URL können Sie direkt im Browser aufrufen und dort die Zugangsdaten eingeben. Als Ergebnis sollte folgende Rückmeldung erscheinen:

success: false
message:Resource not found

Sollte die Verbindung fehlschlagen, kann auch eine Authentifizierung über Digest durchgeführt werden.

Aufträge zu Xentral übertragen

Das Importieren von Bestellungen aus Online Shops wird in diesem Artikel beschrieben.

Alte Aufträge zu Xentral übertragen

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.In der Shopschnittstelle in Xentral gibt es hierfür den Button Alte Aufträge importieren.

Sobald Sie auf diesen Button geklickt haben, können Sie im Dialogfenster anhand der Shopware-Bestellnummern angeben, welche alten Aufträge abgeholt werden sollen.

Nummer von → Älteste Belegnummer im Shop von der die Aufträge abgeholt werden sollen. Wenn leer gelassen, dann wird ab dem ältesten Auftrag abgeholt.
Nummer bis → Letzte Belegnummer im Shop bis zu der die Aufträge abgeholt werden sollen. Wenn leer gelassen, dann wird bis zum neuesten Auftrag abgeholt.
Auftrag abschließen → Der importierte Auftrag wird auf Status "abgeschlossen" gesetzt.
Stornierte Aufträge auch abholen → Holt auch die Aufträge ab, die im Shop den Status 'storniert' haben.

Über den Button Abholen 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.

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.
Idealerweise werden nur unbedingt benötigte Altaufträge importiert.

Demo- und Testfunktionen

Testlauf: Einzelne Aufträge von Shopware abholen

Vom Shop können auch gezielt einzelne Aufträge direkt nach der Auftragsnummer in Shopware abgeholt werden. Hierzu muss folgendes eingestellt werden:

Abholmodus: Ab Nummer (Status)
ab Nummer: Bestellnummer (bei Bestellnummern die Buchstaben in der Zeichenfolge enthalten die ID der Bestellung) eingeben
Nur 1 Auftrag pro Anfrage: Haken setzen

Praxistipps: Der Shopstatus und in manchen Fällen auch der Zahlstatus des Auftrags muss in Shopware offen sein, damit der Auftrag zu Xentral importiert werden kann.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.Im Abholmodus "ab Nummer" kann gezielt ein bestimmter Auftrag abgeholt werden. Anderweitig wäre nur die Abholung des ältesten, offenen Auftrags möglich.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 ID des Datensatzes der Bestellung umgestellt wird bzw. umgestellt werden muss.

Sonderfunktionen

Subshops

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.So könnte ein Mapping beispielsweise aussehen:

Wichtig: Bitte beachten Sie, dass das Subshop-Mapping nur klappt, wenn die Subshops in Shopware auch als Subshops eingestellt sind und nicht als Sprachshops!

Zahlungsstatus zurückmelden

Der Zahlungsstatus der Aufträge direkt an den Shop zurückzumelden.Dazu muss eine von diesen Anforderungen erfüllt sein:

Die verknüpfte Rechnung zum Auftrag wurde auf manuell bezahlt gesetzt.
Die verknüpfte Rechnung zum Auftrag wurde durch einen Zahlungseingang komplett beglichen.

Damit der Zahlungsstatus zurück gemeldet werden kann, braucht man den Prozessstarter Shop Rückmeldungen.

Artikelbilder exportieren

Die Shopware-Schnittstelle erlaubt den Export von Artikelbildern von Xentral zum Shop, wenn die Bilder in Xentral im Artikelstamm unter Dateien mit dem Stichwort Standard Artikelbild (Shopbild) angelegt wurden. Nur Bilder mit diesem Stichwort wrden an den Shop exportiert.Informationen über den Export von Artikelbildern finden Sie in diesem Artikel.

Versandkostenmapping von Shopware

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.

Freifeldermapping und Export anderer Felder

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.

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 "attr" anfangen Rücksicht genommen.

Schema

Beispiele: 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.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:

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:

Mögliche Felder unter mainArticle

taxId - ID der Steuergruppe
priceGroupId - ID der Preisgruppe
filterGroup - Spezialfeld. 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
filterGroupId - ID der Filtergruppe
configuratorSetId - ID des Konfiguratorsets
pseudoSales - Anzahl Pseudoverkäufe
priceGroupActive - Gibt an ob Preisgruppe aktiv ist
notification - E-Mailbenachrichtigung beim Artikel erlauben
availableFrom - Verfügbar von
availableTo - Verfügbar bis

Mögliche Felder unter mainDetail

additionalText - Zusatzinfo
stockMin - Mindestmenge
purchasePrice - Einkaufspreis
position - Position
minPurchase - Mindestverkaufsmenge
purchaseSteps - Verkaufsschritte
maxPurchase - Höchstverkaufsmenge
purchaseUnit - Verkaufseinheit
referenceUnit - Artikeleinheit
packUnit - ID Verpackungseinheit
shippingFree - Kostenloser Versand
releaseDate - Veröffentlichungsdatum

Hinweis: 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.

Freifelder übersetzen

Wenn ein Subshopmapping existiert und eine Übersetzung der Freifelder für die entsprechende Sprache existiert, wird die Übersetzung an Shopware exportiert.

Eigenschaften zu Shopware übertragen

Wird dem Namen einer Eigenschaft in Xentral articleAttribute_ vorangestellt, so können diese direkt als Attribute in Shopware exportiert werden.

Beispiel: Die Eigenschaft Preishistorie soll wird nun als "articleAttribute_Preishistorie" angelegt (statt einfach nur "Preishistorie").

In der Freitextfeld-Verwaltung von Shopware wird das Feld mit dem dazu passenden Namen in der Tabelle articles_attributes angelegt.

Der Wert der Eigenschaft wird beim Artikelexport von Xentral zu Shopware dann in das vorgesehene Feld übertragen.

Crossselling

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.In der Crosselling App können Artikel hierzu bidirektional verknüpft werden.

Wenn die Einstellungen so gespeichert werden, werden die Artikel in Shopware dem jeweils anderen als Zubehörartikel zugeweisen.

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.

Kundengruppen Mapping

Das Kundengruppening Mapping funktioniert in Verbindung mit der Option Neukunden automatisch zuweisen. Das heißt, wenn es ein Mapping mit aktivierter Option gibt, werden neue Adressen automatisch der entsprechenden Gruppe zugeordnet.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 Neue Benutzergruppen anlegen aktivieren. Dann wird eine neue Kundengruppe in Xentral angelegt, falls keine Übereinstimmung gefunden werden konnte.

Bitte beachten Sie, dass das Gruppenmapping in Kundengruppen für Shopware aktuell nicht für die automatische Zuordnung von Gruppen greift.