Mit der Integration Shopware 6 verbindest du deinen Shopware-6-Shop mit Xentral. Xentral überträgt Artikel, Kategorien, Bestände und Preise an deinen Shop, importiert die Bestellungen als Aufträge und meldet Auftragsstatus, Tracking-Informationen und Rechnungen zurück. So wickelst du deine Aufträge vollständig in Xentral ab, z. B. mit dem Autoversand, und dein Shop zeigt stets aktuelle Bestände und Preise.
Shopware ist eine deutsche Open-Source-Shopsoftware, die du als Cloud-Lösung oder selbst gehostet betreiben kannst. Die Integration ist mit allen Shopware-6-Versionen bis einschließlich 6.7.x kompatibel.
Beim Anlegen wählst du die Features aus, die du nutzen möchtest. Jedes Feature richtest du später im Tab Workflows im Detail ein und schaltest es einzeln aktiv.
Feature |
Richtung |
Was übertragen wird |
|---|---|---|
|
Artikel (exkl. Preise und Bestände) abgleichen |
Xentral > Verkaufskanal |
Stammdaten, Varianten, Freifelder, Bilder, Tags, Eigenschaften, Cross-Selling-Artikel, Übersetzungen, Meta-Texte |
|
Kategorien abgleichen |
Xentral > Verkaufskanal |
Artikelbaum ab einem wählbaren Einstiegspunkt |
|
Bestände abgleichen |
Xentral > Verkaufskanal |
Bestand aus einem oder mehreren Xentral-Lagern, optional mit Reservierungen, offenen Aufträgen, Lagerkorrekturwert oder Pseudo-Lagerzahl |
|
Preise abgleichen |
Xentral > Verkaufskanal |
Standardpreis oder Preis einer Kundengruppe, Währungen, erweiterte Preise (Staffel- und Gruppenpreise mit Gültigkeit) |
|
Aufträge abgleichen |
Verkaufskanal > Xentral |
Bestellungen nach Zahlungsstatus, mit Kunden-, Zahlungs-, Versand-, Länder- und Sprachzuordnung |
|
Auftragsstatus und Tracking abgleichen |
Xentral > Verkaufskanal |
Versandstatus, Tracking-Informationen, Stornierungen, optionale Kundenbenachrichtigung durch Shopware |
|
Belege |
Xentral > Verkaufskanal |
Rechnungen als PDF-Datei |
Dazu kommen Shopware-spezifische Möglichkeiten:
-
Sales Channels: Du ordnest Artikel einem oder mehreren Shopware-Sales-Channels zu und weist jedem Sales Channel beim Auftragsimport ein Xentral-Projekt zu.
-
Freifelder und Eigenschaften: Xentral-Freifelder schreibst du wahlweise in Shopware-Zusatzfelder oder in Shopware-Eigenschaften. Ausgewählte Shopware-Standardfelder wie Mindestabnahme oder Lieferzeit befüllst du direkt über Freifelder.
-
Layout: Du legst die Ansicht der Artikelseite und die Darstellung der Varianten in der Storefront fest.
-
Erweiterte Preise: Du ordnest Xentral-Kundengruppen den Kundengruppen oder Preisregeln (Rule Builder) in Shopware zu.
-
Daten aus Shopware nach Xentral übernehmen: Die Integration überträgt Artikel, Kategorien, Bestände und Preise nur von Xentral nach Shopware. Wenn du Artikeldaten aus deinem Shop einmalig nach Xentral übernehmen möchtest, nutze den CSV-Import, siehe Artikel Daten per CSV-Import übernehmen.
-
Shopware 5: Die Integration unterstützt ausschließlich Shopware 6.
-
Freifelder doppelt zuordnen: Ein Xentral-Freifeld kannst du entweder einem Shopware-Zusatzfeld oder einer Shopware-Eigenschaft zuordnen, nicht beidem gleichzeitig.
-
Eigenschaften ohne Standardfeld: Shopware-Felder, für die es kein Standardfeld gibt, befüllst du nur über ein Customizing.
-
Alte Bestellungen: Xentral importiert automatisch nur Bestellungen, die nach der Produktivschaltung des Auftragsimports angelegt wurden und nicht älter als drei Tage sind. Ältere Aufträge importierst du im Journal gezielt über die Auftragsnummer.
-
Bestellungen mit unbekannten Artikeln: Enthält eine Bestellung einen Artikel, den es in Xentral nicht gibt, importiert Xentral die Bestellung nicht und meldet einen Fehler im Journal.
Lager und JIT-Stücklisten: Aus welchen Xentral-Lagern Xentral den Bestand berechnet, wählst du in den Workflows unter Auswahl Xentral Lager. Für JIT-Stücklisten berechnet Xentral den Bestand derzeit über alle Lager.
-
Ein Shopware-6-Shop (Version bis einschließlich 6.7.x), in dem du als Administrator angemeldet bist
-
Administratorrechte in Xentral: Die Integration installieren, einrichten und verwalten derzeit nur Administratoren
-
In Shopware mindestens eine Zahlungsart, eine Versandart und ein Sales Channel (siehe Artikel Shopware 6: Shop einrichten)
-
In Xentral ein Porto-Artikel für Versandkosten und ein Rabatt-Artikel für Rabatte
Shopware 6 ist eine Standardintegration. Du kannst sie in jedem Xentral-Plan nutzen. Sie verursacht keine zusätzlichen Kosten und zählt in der nutzungsbasierten Abrechnung (Usage Based Pricing) weder als Flow noch als API-Call, belastet also dein Inklusivvolumen nicht. Kundenindividuelle Flows und Customizings, die du zusätzlich einsetzt, zählen als Flows; die darin enthaltenen API-Calls zählen nicht. Details zu Inklusivvolumen und Rate-Limits findest du im Artikel Kosten, Pläne und Limits.
Anmerkung
Diese Artikel beschreiben die aktuelle Shopware-6-Integration. Wenn du noch die klassische Shopware-Anbindung (Shopimporter) nutzt, findest du die Anleitung im Artikel Online-Shops (Legacy). Wie du von der klassischen Anbindung auf die aktuelle Version updatest, beschreibt der Artikel Shopimporter updaten.
Beachte beim Wechsel von Shopware 6:
-
Deaktiviere den Livemodus des Shopimporters, bevor du die neue Integration produktiv schaltest. Sonst importiert Xentral Bestellungen doppelt.
-
Lösche die alte Shopimporter-Anbindung nicht. Sie muss im System bleiben.
-
Bestellungen, die vor der Produktivschaltung im Shop angelegt wurden, ruft die neue Integration nicht automatisch ab. Schließe sie im Shopimporter ab oder importiere einzelne Aufträge im Journal per Auftragsnummer.
-
Wenn deine Artikelbilder bisher aus Shopware stammen, aktiviere den Datentyp Bilder erst, wenn die Bilder in Xentral vollständig und aktuell sind.
-
Wurde die Artikelzuordnung aus dem Shopimporter übernommen, steht als Filterkriterium die Online-Shop UUID der alten Anbindung in der Artikelzuordnung. Prüfe, ob die Anzahl der gefundenen Artikel stimmt.
Das Update startest du unter Einstellungen > Integrationen über Bestehende Integration migrieren. Dort siehst du alle Verkaufskanäle, die noch nicht auf die aktuelle Version umgestellt sind. Der Ablauf selbst ist unverändert.
So richtest du die Integration ein:
So verwaltest du die Integration:
Praxiswissen für Shopware 6: