Import/Export

Du kannst Deine Inhalte in Shopware 6 auf sehr einfachem Weg über Importe pflegen. Exporte kannst Du nutzen, um Deine vorhandenen Inhalte auszulesen oder an Schnittstellen und Auswertungstools zu übermitteln. In dieser Dokumentation beschreiben wir Dir allgemein die Optionen, die Du für Importe und Exporte hast.

Grundmodul

Du findest den Menüpunkt in Deiner Administration unter Einstellungen > Shop > Import/Export.

Einige Programme wie z.B. Excel beherrschen keine UTF-8 konforme Kodierung und kodieren die Umlaute in einem eigenen Format. Solltest Du Umlaute nutzen, so stelle sicher, dass die CSV UTF-8 konform ist.

Vorbereitung

Stelle sicher, dass die Zeichensätze im validen UTF-8 mit Semikolon getrennt werden. Sollten außerdem Anführungsszeichen auftauchen werden diese ebenfalls als Zeichenketten-Trenner interpretiert. Das UTF-8 Format und die Trenner Semikolon und Anführungszeichen sind die Grundvoraussetzungen für einen erfolgreichen Import in Shopware. In den meisten Tabellenkalkulationsprogrammen, wie beispielsweise Libre Office dies im Vorfeld einstellen.

Die erforderlichen Feldoptionen sind:

Zeichensatz	UTF-8
Feldtrenner	Semikolon
Zeichenketten-Trenner	Anführungszeichen

Import

Im Reiter Import hast Du die Möglichkeit, mit Hilfe von CSV-Dateien Daten in Deine Shopware 6 Umgebung zu importieren.

Beachte, dass Du mit dem Import generell nur Informationen hinzufügen kannst, aber keine entfernen kannst. Hat ein Produkt bspw. eine Verkaufskanalzuordnung, kann diese nicht durch einen Import entfernt werden.

Nachkommastellen beim Preis werden grundsätzlich durch einen Punkt getrennt. Beispiel: 5.00 statt 5,00. Wenn Du ein Komma setzt, wird der Preis nicht korrekt importiert. Achte also darauf, dass bei jeder Preisangabe mit dem Datenbankeintrag "price" ein Punkt gesetzt ist.

CSV-Datei hochladen (1):
Wähle hier die native CSV-Datei von Deinem PC aus, welche für den Import verwendet werden soll. In der CSV-Datei sind die Daten enthalten, welche in Deine Shopware 6 Umgebung importiert werden sollen. Im Bereich Import haben wir Dir Beispieldateien zur Verfügung gestellt.

Einige Tabellenkalkulationsprogramme beeinflussen eventuell die Separatoren oder führende Nullen der CSV-Dateien. Du solltest daher darauf achten ein Tool zu verwenden, welches native CSV-Dateien erstellt. Ein kostenfreies Tool, welches native CSVs erstellt ist beispielsweise Open Office Calc.

Profil auswählen (2):
Wähle hier das Profil aus, anhand dessen die CSV-Datei importiert werden soll. Das Profil bestimmt, welche Daten aus der CSV-Datei in welche Datenbanktabellen hinterlegt werden.

Import starten (3):
Mit diesem Button startest Du den Import der CSV-Datei über das ausgewählte Profil. Es werden nun alle Datensätze überprüft und alle fehlerfreien Datensätze importiert. Alle fehlerhaften Datensätze werden in einer neuen CSV-Datei zusammengefasst, welche anschließend heruntergeladen werden kann.

Testlauf starten (4):
Mit diesem Button kannst Du den Import einmal komplett testen, bevor Du ihn wirklich startest. So kannst Du schon vor dem Import einmal testen, ob die komplette Import Datei importiert werden kann oder ob es beim Import zu Problemen kommen wird. So verhinderst Du bereits vor dem Import, dass die Datei nur teilweise importiert wird und der Import ggf. später umständig vervollständigt werden muss.

Import-Aktivität (5):
In der Import-Aktivität siehst Du eine Historie Deiner vergangenen Importe. Angezeigt werden hier alle Importe der letzten 30 Tage.
Über das Kontextmenü am Ende jeder Zeile kann die importierte Quell-CSV-Datei nochmal heruntergeladen werden und das genutzte Profil geöffnet werden. Bei Importen mit fehlerhaften Datensätzen kann zudem eine CSV-Daten heruntergeladen werden, welche nur die fehlerhaften Daten enthält.

Vorgang abbrechen (6):
Über das Kontextmenü auf der Rechten Seite jedes Import Eintrages in den Import-Aktivitäten kannst Du einen Import Vorgang auch noch während des Importierens abbrechen. Beachte, dass es dabei vorkommen kann, dass einzelne Daten bereits importiert wurden.

Export

Im Reiter Export kannst Du vorhandene Daten aus Deiner Shopware 6 Umgebung exportieren und in eine CSV-Datei schreiben.

Export (1):
Im Bereich Export wählst Du anhand des Profils aus, welche Daten exportiert werden sollen. Eine Auflistung, welches Profil welche Daten ausgibt, erhältst Du im Bereich Profile.
Über den Button Export starten wird eine CSV Datei erstellt, welche Du Dir anschließend direkt herunterladen kannst.

Export-Aktivität (2):
In der Export-Aktivität siehst Du eine Historie Deiner vergangenen Exporte. Angezeigt werden hier alle Exporte der letzten 30 Tage.
Über das Kontextmenü am Ende jeder Zeile kann die erstellte CSV-Datei noch einmal heruntergeladen werden und das genutzte Profil geöffnet werden.

Export-Assistent - AI Copilot

Über den AI Copilot kannst Du mithilfe der KI bestimmte Datensätze ganz einfach exportieren.

Bei dem AI Copilot handelt es sich um ein Feature, dias Bestandteil ab dem Plan Shopware Rise ist. Voraussetzung ist zudem das Aktivieren der Commercial Erweiterung.

AI Copilot aktivieren (1):
In diesem Bereich kannst Du den KI-gestützten Export-Assistenten aktivieren. Wenn Du dort klickst, öffnet sich das Export-Assistent Modul.

In dem Modul findest Du Vorschläge, die durch den Export-Assistenten verarbeitet werden können.

In dieser Version des Assistenten werden nur Kunden- , Produkt- , Bestell- , Kategorie- , Newsletter- , Promotion-Code- , Promotion-Rabatt- , Eigenschaften- , Cross-Selling- und Produkt-Preisdaten unterstützt.

Profile

Im Reiter Profile verwaltest Du die Profile, welche für den Import und den Export verwendet werden. Das Profil, welches beim Import und beim Export ausgewählt wird, gibt an, auf welche Datenbankeinträge beim Import/Export zugegriffen wird.

Profil-Übersicht (1):
In der Profil-Übersicht findest Du alle angelegten Profile. Außerdem wird Dir angezeigt, ob es sich um ein Standard Profil oder ein selbst angelegtes Benutzerprofil handelt.

Menü (2):
In diesem Kontextmenü kann das Profil geöffnet oder gelöscht werden. Außerdem kann das Profil über dieses Kontextmenü dupliziert und dann verändert werden.

Neues Profil anlegen (3):
Über diesen Button kannst Du ein komplett neues Profil anlegen. Weitere Informationen wie Du hier im Detail vorgehen kannst, erfährst Du im Bereich Individuelle Profile anlegen.

Suche (4):
Sollte die Profilübersicht auf Grund zu vieler angelegter Profile an Übersichtlichkeit verlieren, kannst Du jedes angelegte Profil über die Suche finden.

Individuelle Profile anlegen

Neben den Standard Profilen, die von Shopware mitgeliefert werden, hast Du zudem die Möglichkeit, eigene Profile anzulegen.
Ein neues eigenes Profil kannst Du unter Einstellungen > Shop > Import/Export im Reiter Profile anlegen.
Hier gibt es zwei Möglichkeiten, ein neues Import/Export Profil zu erstellen.
Über das Kontextmenü neben jedem Profil kannst Du das entsprechende Profil duplizieren. So kannst Du ein bestehendes Profil oder eines der Standard Profile duplizieren und verändern.

Wenn Du ein eigenes Profil anlegst, achte darauf, dass Du zuvor die Systemstandard-Sprache ausgewählt hast (Oben rechts über den Sprachwechsler). Dies gilt auch für Profile, welche für eine andere Sprache gelten sollen. Anderenfalls ist ein Import/Export nicht möglich. Die Systemstandard-Sprache ist die Sprache, welche Du ganz zu Anfang Deiner Shopware-Installation festgelegt hast.

Über den Button Neues Profil hinzufügen kannst Du aber auch ein komplett neues Profil erstellen und alle Einstellungen von Grund auf selbst vornehmen.
Es öffnet sich dann ein neues Fenster, in welchem folgende Angaben gemacht werden können:

Allgemein

Profilname (1):
Der Profilname wird zum einen in der Profilliste verwendet, aber auch in der Profilauswahl im Import sowie im Export.

Objekt-Typ (2):
Der Objekt-Typ gibt an, auf welche Datenbank Tabellen und Spalten das Profil zugreifen kann. Beispielsweise kann mit dem Objekt-Typ Produkt auf alle Produktrelevanten Einträge aus der Datenbank zugegriffen werden, während mit dem Typ Kunde auf alle Kundenrelevanten Einträge zugegriffen werden kann.

Nutzung (3):
Hier kannst Du wählen, ob das Profil für den Import von Daten genutzt werden soll, für den Export oder für beide Wege. Mit Profilen, die für den Import gedacht sind ist ein Export nicht möglich.

Separator-Zeichen(4):
Das Seperatorzeichen wird verwendet, um in der CSV-Datei die einzelnen Felder voneinander zu trennen. Im Standard ist dies das Semikolon.

Einfassungszeichen (5):
Das Einfassungszeichen steht am Anfang und am Ende eines Textes. Innerhalb dieser Zeichen werden Seperatorenzeichen nicht beachtet.
Beim Anlegen eines individuellen Profils greifst Du auf Datenbankeinträge zu und weist diese einer Spalte in der CSV-Datei zu.

Import-Einstellungen (6):
Hier kannst Du festlegen, wie der Import die Werte der Import-Datei behandeln soll. Mit dem Schalter Neue Datensätze erstellen legst Du fest, ob der Import in der Lage ist neue Datensätze im Shop anzulegen. Hierzu kann die ID in der Import Datei leer gelassen werden. Mit Vorhandene Daten aktualisieren wird der Import damit befähigt, bestehende Informationen im Shop zu überschreiben.

CSV-Datei hochladen

Im diesem Fenster hast Du die Möglichkeit Dein Profil auf Basis einer bereits bestehenden CSV-Datei erstellen zu lassen. Hierzu kannst Du Beispielsweise den Export aus einem anderen Shop verwenden. Das Profil erhält dann die Felder aus der CSV Datei, die Du anschließend den Datenbankeinträgen zuweisen kannst.
Wenn Du das Profil komplett neu erstellen möchtest kannst Du diesen Schritt aber auch überspringen.

Zuweisung

Neues Mapping hinzufügen (1):
Mit diesem Button lässt sich eine Zeile zum Datenbankmapping hinzufügen. In der noch leeren Zeile wählst Du dann einen Datenbankeintrag, auf welchen zugegriffen werden soll, und gibst den Namen der Spalte aus der CSV-Datei an.

Datenbankmapping (2):
Im Datenbankmapping weist Du den gewünschten Einträgen aus der Datenbank eine Spalte aus der CSV-Datei zu. Der CSV-Name, den Du hier vergibst, muss auch der Name der entsprechenden Spalte in der CSV-Datei sein, welche mit diesem Profil verwendet wird.

Erforderlich (3):
Gib hier an, ob das jeweilige Feld ein Pflichtfeld sein soll. Es muss in der Import Datei dann ausgefüllt ein, damit der Import fehlerfrei funktioniert.

Standard-Wert (4):
Hier kannst Du einen Standard-Wert hinterlegen für den Fall, dass das Feld in der Import Datei nicht gefüllt wurde. In diesem Fall wird dann der Standard-Wert importiert.

Position (4):
Hier legst Du fest, an welcher Position der CSV Datei das jeweilige Feld erwartet wird.

Mapping entfernen (5):
Über das Kontextmenü hinter jedem Eintrag lässt sich dieser wieder entfernen.

Bei dem Erstellen eines neuen Profils werden die zwingend notwendig benötigten Felder bereits automatisch mit angelegt und hinzugefügt.

Im Folgendem findest Du alle Datenbankeinträge der einzelnen Objekt-Typen.

Erweiterte Einstellungen

Bezeichner - Second Unique Identifier

Bisher benötigte der Import immer eine UUID, um die Datensätze den richtigen Entitäten zuzuordnen. Damit musste beispielsweise in jeder Zeile der CSV-Import Datei eine lange, kryptische UUID angegeben werden.
Mit einem Second Unique Identifier (Bezeichner) kannst Du nun selber festlegen, mit welchem Identifier (Bezeichner) die Datensätze mit den Entitäten gemappt werden.
So kannst Du beispielsweise festlegen, dass beim Import von Produkten statt der UUID jetzt die productNumber angegeben werden muss. Die UUID wird damit durch einen anderen Bezeichner, die productNumber, ersetzt.

Um die Funktion zu nutzen, rufe Einstellung > Import/Export auf und begib Dich in den Reiter Profile. Wenn Du das Profil öffnest, findest Du den Reiter Erweiterte Einstellungen.

Objekttyp - "Produkt"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, taxId, productNumber, stock, name.

Besonderheit id: Bei der Neuanlage eines Produktes kann das Feld leer gelassen werden, da das System die ID generiert.

Datenbankeintrag	Beschreibung	Datenbank-Tabelle
active	Angabe ob das Produkt aktiv ist	product
autoIncrement	Einmalige Dezimalzahl	product
available	Angabe ob das Produkt verfügbar ist	product
availableStock	Verfügbarer Lagerbestand	product
childCount	Anzahl der Varianten	product
configuratorGroupConfig	Eigene Sortierung der Eigenschaften	product
cover.id	UUID des Vorschaubildes des Artikels	product_media
cover.versionId	UUID welche die Version des Vorschaubildes des Artikels angibt.	product_media
cover.media.Id	UUID des Vorschaubildes des Artikels. Hinter media kann ein Punkt gesetzt und so auf weitere Felder innerhalb von media zugegriffen werden.	media
cover.position	Position des Vorschaubildes in der Medien Übersicht des Artikels.	product_media
cover.customFields	Vorschaubild Zusatzfeld	custom_field
cover.createdAt	Vorschaubild hochgeladen	product_media
cover.updatedAt	Vorschaubild aktualisiert	product_media
customSearchKeywords	Such-Schlagwörter	product_translation
deliveryTime.id	UUID der Lieferzeit	delivery_time
deliveryTime.name	Name der Lieferzeit	delivery_time_translation
deliveryTime.customFields	Lieferzeit Zusatzfelder	delivery_time_translation
deliveryTime.min	Minimale Lieferzeit	delivery_time
deliveryTime.max	Maximale Lieferzeit	delivery_time
deliveryTime.unit	Lieferzeit Einheit	delivery_time
deliveryTime.translations	Übersetzungen der deliveryTime Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	delivery_time_translation
deliveryTime.createdAt	Lieferzeit erstellt	delivery_time
deliveryTime.updated	Lieferzeit aktualisiert	delivery_time
ean	EAN Nummer	product
height	Höhe des Produktes	product
Id	UUID welche vom System vergeben wird. Beim Neuanlegen von Artikeln sollte diese Spalte leer gelassen werden.	product
isCloseout	Abverkauf	product
length	Länge	product
manufacturer.id	UUID des Herstellers	product_manufacturer
manufacturer.versionId	UUID welche die Version des Herstellers angibt.	product_manufacturer
manufacturer.link	Webseite des Herstellers	product_manufacturer
manufacturer.name	Name des Herstellers	product_manufacturer_translation
manufacturer.description	Beschreibung des Herstellers	product_manufacturer_translation
manufacturer.customFields	Hersteller Zusatzfelder	product_manufacturer_translation
manufacturer.media.Id	UUID des Herstellerbildes. Hinter media kann ein Punkt gesetzt und so auf weitere Felder innerhalb von media zugegriffen werden.	media
manufacturer.translations	Übersetzungen der manufacturer Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	product_manufacturer_translation
manufacturer.createdAt	Hersteller angelegt	product_manufacturer
manufacturer.updatedAt	Hersteller aktualisiert	product_manufacturer
manufacturerNumber	Produktnummer des Herstellers	product
markAsTopseller	Produkt hervorheben	product
maxPurchase	Maximal Abnahme	product
media	URL aller Produktbilder ausgenommen dem Vorschaubild.	wird generiert
minPurchase	Minimal Abnahme	product
optionIds	Variantenoptionen	product_option
options	Varianten Optionen	property_group_option
parent	Felder des Hauptproduktes bei Variantenartikel. Hinter parent kann ein Punkt gesetzt und somit auf alle Felder zugegriffen werden, welche auch im Object Type Product zur Verfügung stehen.	product
price.DEFAULT.net	Standard netto Preis. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product
price.DEFAULT.gross	Standard brutto Preis. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product
price.DEFAULT.currencyId	UUID der Währung. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	currency
price.DEFAULT.linked	Angabe, ob der Netto und Bruttopreis verknüpft sind. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product
price.DEFAULT.listPrice	Erweiterte Preise. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product
productNumber	Produktnummer	product
properties	UUID der Eigenschaften getrennt durch ein Pipe-Symbol (\|).	property_group_option
purchasePrice	Einkaufspreis	product
purchaseSteps	Staffelung	product
purchaseUnit	Verkaufseinheit	product
ratingAvarage	Durchschnittsbewertung	product
referenceUnit	Grundeinheit	product
releaseDate	Erscheinungsdatum	product
restockTime	Wiederauffüllzeit	product
shippingFree	Versandkostenfrei	product
stock	Lagerbestand	product
tagIds	Produkt Tags	product_tag
tags	UUID der Tags, getrennt durch ein Pipe-Symbol (\|)	product_tag
tax.Id	UUID des Steuersatzes	tax
tax.taxRate	Prozentsatz	tax
tax.name	Steuername	tax.translate
tax.customField	Zusatzfelder der Steuersätze	custom_field
tax.createdAt	Steuersatz erstellt	tax
tax.updatedAT	Steuersatz aktualisiert	tax
translations.DEFAULT bsp. translations.de_DE.name translations.de_DE.customFields.Fieldname translations.en_GB.metaTitle	Alle Sprachabhängigen Produktfelder. DEFAULT kann hierbei durch die Sprache ersetzt werden und durch einen anschließenden Punkt kann auf das jeweilige Feld zugegriffen werden. Bspw. translations.en-GB.name	product_translation
unit.Id	UUID der Maßeinheiten	unit
unit.shortCode	Maßeinheit Kürzel	unit_translation
unit.name	Maßeinheit Name	unit_translation
unit.customFields	Maßeinheit Zusatzfelder	unit_translation
unit.translations	Übersetzungen der Maßeinheit Felder. Hinter translations kann ein Punkt gesetzt werden und so auf weitere Felder zugegriffen werden.	unit_translation
unit.createdAt	Maßeinheit erstellt	unit
unit.updatedAt	Maßeinheit aktualisiert	unit
variantRestrictions	Ausschlüsse von Varianten aus dem Variantengenerator	product
variantListingConfig	Storefront-Darstellung bzw. Varianten Darstellung	product_visibility
versionId	UUID welche die Version des Artikels angibt.	product
visibilities.all	UUID des Verkaufskanals, in dem der Artikel komplett verfügbar ist.	product_visibility
visibilities.link	UUID des Verkaufskanals, in dem der Artikel versteckt ist und nur über den direkten Link erreichbar ist.	product_visibility
visibilities.search	UUID des Verkaufskanals, in dem der Artikel nur über die Suche erreichbar ist.	product_visibility
weight	Gewicht	product
width	Breite	product

Objekttyp - "Kunde"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, defaultBillingAddressId, defaultShippingAddressId, customerNumber, firstName, lastName, email.

Besonderheit id: Bei der Neuanlage eines Kunden kann das Feld leer gelassen werden, da das System die ID generiert.

Bitte stelle sicher, dass Du den E-Mail-Versand (Einstellungen > System > Mailer) vor dem Import von Kunden in der Version ab 6.4.9.0 deaktivierst, um zu verhindern, dass nach dem Import Registrierungs-E-Mails an jeden einzelnen Kunden versendet werden.

Datenbankeintrag	Beschreibung	Datenbank-Tabelle
active	Angabe, ob der Kunde aktiv ist	customer
affiliateCode	Partner Code	customer
autoincrement	Einmalige Dezimalzahl	customer
birthday	Geburtstag	customer
campaignCode	Kampagnen Code	customer
company	Firma	customer
createdAt	Wann wurde der Kunde erstellt	customer
customFields	Kunden Zusatzfelder	customer
customerNumber	Kundennummer	customer
defaultBillingAddress.id	UUID der Rechnungsadresse	customer
defaultBillingAddress.firstName	Vorname der Rechnungsadresse	customer_address
defaultBillingAddress.lastName	Nachname der Rechnungsadresse	customer_address
defaultBillingAddress.zipcode	PLZ der Rechnungsadresse	customer_address
defaultBillingAddress.city	Stadt der Rechnungsadresse	customer_address
defaultBillingAddress.company	Firma der Rechnungsadresse	customer_address
defaultBillingAddress.street	Straße der Rechnungsadresse	customer_address
defaultBillingAddress.department	Abteilung der Rechnungsadresse	customer_address
defaultBillingAddress.title	Titel der Rechnungsadresse	customer_address
defaultBillingAddress.vatId	Steuer-IdNr. der Rechnungsadresse	customer_address
defaultBillingAddress.phoneNumber	Telefonnummer der Rechnungsadresse	customer_address
defaultBillingAddress.additionalAddressLine1	Adresszusatz 1 der Rechnungsadresse	customer_address
defaultBillingAddress.additionalAddressLine2	Adresszusatz 2 der Rechnungsadresse	customer_address
defaultBillingAddress.customFields	Zusatzfelder der Rechnungsadresse	customer_address
defaultBillingAddress.customer	Kunden-Felder der Rechnungsadresse. Hinter customer kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer, customer_address
defaultBillingAddress.country	Land-Felder der Rechnungsaddresse. Hinter country kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_address, country, country_translation
defaultBillingAddress.countryState	Bundesland-Felder der Rechnungsadresse. Hinter countryState kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_address, country_state, country_state_translation
defaultBillingAddress.salutation	Anrede-Felder der Rechnungsadresse. Hinter salutation kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_address, salutation, salutation_translation
defaultBillingAddress.createdAt	Wann wurde die Rechnungsadresse angelegt	customer_address
defaultBillingAddress.updatedAt	Wann wurde die Rechnungsadresse aktualisiert	customer_address
defaultPaymentMethod.id	UUID der Standardzahlungsart	customer
defaultPaymentMethod.pluginID	UUID des Plugins der Standardzahlungsart	payment_method
defaultPaymentMethod.handleridentifier	Speicherort des PaymentHandler	payment_method
defaultPaymentMethod.name	Name der Standardzahlungsart	payment_method
defaultPaymentMethod.description	Beschreibung der Standardzahlungsart	payment_method
defaultPaymentMethod.position	Position der Standardzahlungsart	payment_method
defaultPaymentMethod.active	Angabe ob die Standardzahlungsart aktiv ist.	payment_method
defaultPaymentMethod.customFields	Zusatzfelder der Standardzahlungsart	payment_method_translation
defaultPaymentMethod.formattedHandlerIdentifier	Verkürzte Form des HandlerIdentifier	payment_method
defaultPaymentMethod.translations	Übersetzungen der Standardzahlungsart. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	payment_method, payment_method_translation
defaultPaymentMethod.media	Felder des Zahlungsart Logos. Hinter media kann ein Punkt gesetzt und so auf weitere Felder innerhalb von media zugegriffen werden.	payment_method, media
defaultPaymentMethod.availabilityRule	Felder der Zahlungsart-Verfügbarkeitsregel. Hinter availabilityRule kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	payment_method, rule
defaultPaymentMethod.plugin	Felder des Zahlungsart-Plugins. Hinter plugin kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	payment_method, plugin
defaultPaymentMethod.salesChannels	Verkaufskanäle, in welchen die Standardzahlungsart hinterlegt ist, getrennt durch ein "Pipe" Symbol (\|)	payment_method
defaultPaymentMethod.createdAt	Wann wurde die Standardzahlungsart angelegt?	payment_method
defaultPaymentMethod.updatedAt	Wann wurde die Standardzahlungsart aktualisiert?	payment_method
defaultShippingAddress.id	UUID der Lieferadresse	customer
defaultShippingAddress.firstName	Vorname der Lieferadresse	customer_address
defaultShippingAddress.lastName	Nachname der Lieferadresse	customer_address
defaultShippingAddress.zipcode	PLZ der Lieferadresse	customer_address
defaultShippingAddress.city	Stadt der Lieferadresse	customer_address
defaultShippingAddress.company	Firma der Lieferadresse	customer_address
defaultShippingAddress.street	Straße der Lieferadresse	customer_address
defaultShippingAddress.department	Abteilung der Lieferadresse	customer_address
defaultShippingAddress.title	Titel der Lieferadresse	customer_address
defaultShippingAddress.vatId	Steuer-IdNr. der Lieferadresse	customer_address
defaultShippingAddress.phoneNumber	Telefonnummer der Lieferadresse	customer_address
defaultShippingAddress.additionalAddressLine1	Adresszusatz 1 der Lieferadresse	customer_address
defaultShippingAddress.additionalAddressLine2	Adresszusatz 2 der Lieferadresse	customer_address
defaultShippingAddress.customFields	Zusatzfelder der Lieferadresse	customer_address
defaultShippingAddress.customer	Kunden-Felder der Lieferadresse. Hinter customer kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer, customer_address
defaultShippingAddress.country	Land-Felder der Lieferadresse. Hinter country kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_address, country, country_translation
defaultShippingAddress.countryState	Bundesland-Felder der Lieferadresse. Hinter countryState kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_address, country_state, country_state_translation
defaultShippingAddress.salutation	Anrede-Felder der Lieferadresse. Hinter salutation kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_address, salutation, salutation_translation
defaultShippingAddress.createdAt	Wann wurde die Lieferadresse angelegt	customer_address
defaultShippingAddress.updatedAt	Wann wurde die Lieferadresse aktualisiert	customer_address
doubleOptInConfirmDate	Wann wurde die doubleOptIn-Mail bestätigt?	customer
doubleOptInEmailSendDate	Wann wurde die doubleOptIn-Mail versendet?	customer
doubleOptInRegistration	War bei der Registrierung doubleOptIn-Registrierung aktiv?	customer
email	E-Mail	customer
firstLogin	Erster Login des Kunden	customer
firstName	Vorname	customer
group.id	UUID der Kundengruppe	customer
group.name	Name der Kundengruppe	customer_group
group.displayGross	Steuerdarstellung der Kundengruppe	customer_group
group.customFields	Kundengruppen Zusatzfelder	customer_group_translation
group.translations	Übersetzungen der Kundengruppen-Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer_group_translation
group.createdAt	Wann wurde die Kundengruppe angelegt?	customer_group
group.updatedAt	Wann wurde die Kundengruppe aktualisiert?	customer_group
guest	Handelt es sich um einen Gastbesteller?	customer
hash	Hashwert, welcher für die doubleOptIn Bestätigungs Mail verwendet wird.	customer
Id	UUID des Kunden. Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.	customer
language.id	UUID der Sprache	customer
language.name	Name der Sprache	language
language.customFields	Sprache Zusatzfelder	language
language.parent	UUID der Sprache, von der geerbt wird.	language
language.locale	Felder der Lokalisierung der Sprache. Hinter locale kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	language, locale, locale_translation
language.translationCode	Felder des ISO-Codes der Sprache. Hinter translationCode kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	language, locale, locale_translation
language.salesChannels	UUID der Verkaufskanäle, in denen die Sprache verwendet wird.	language
language.createdAt	Wann wurde die Sprache erstellt	language
language.updatedAt	Wann wurde die Sprache aktualisiert	language
lastLogin	Letzter Login des Kunden	customer
lastName	Nachname	customer
lastOrderDate	Datum der letzten Bestellung	customer
lastPaymentMethods	Felder der letzten Zahlungsart. Hinter lastPaymentMethods kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	customer, payment_methods, payment_methods_translation
legacyEncoder	Encoder um Systemfremdes Passwort zu entschlüsseln	customer
legacyPassword	Systemfremdes, verschlüsseltes Passwort bspw. nach einer Migration	customer
newsletter	Hat der Kunde den Newsletter aktiviert?	customer
orderCount	Anzahl der Bestellungen	customer
password	Verschlüsselter Hashwert des Passwortes	customer
remoteAddress	IP Adresse des Kunden	customer
salesChannel.id	UUID des Verkaufskanal, dem der Kunde zugeordnet ist.	customer
salesChannel.type.	Felder zum Typ des Verkaufskanals. Hinter type kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, sales_channel_type, sales_channel_type_translation
salesChannel.language.	Felder zur Sprache des Verkaufskanals. Hinter language kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, language, language_translation
salesChannel.customerGroup.	Felder zur Standardkundengruppe des Verkaufskanals. Hinter customerGroup kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, customer_group, customer_group_translation
salesChannel.currency	Felder zur Standardwährung des Verkaufskanals. Hinter currency kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, currency, currency_translation
salesChannel.paymentmethod	Felder zur Standardzahlungsart des Verkaufskanals. Hinter paymentmethod kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, payment_method, payment_method_translation
salesChannel.shippingMethod	Felder zur Standardversandart des Verkaufskanals. Hinter shippingMethod kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, shipping_method, shipping_method_translation
salesChannel.country	Felder zum Standardland des Verkaufskanals. Hinter country kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, country, country_translation
salesChannel.navigationCategory	Felder zur Kategorie, die als Einstiegspunkt für die Haupt-Navigation des Verkaufskanals hinterlegt ist. Hinter navigationCategory kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, category, category_translation
salesChannel.navigationCategoryDepth	Hauptnavigations-Ebenen	sales_channel
salesChannel.footerCategory	Felder zur Kategorie, die als Einstiegspunkt für die Footer-Navigation des Verkaufskanals hinterlegt ist. Hinter footerCategory kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, category, category_translation
salesChannel.serviceCategory	Felder zur Kategorie, die als Einstiegspunkt für die Service-Navigation des Verkaufskanals hinterlegt ist. Hinter serviceCategory kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, category, category_translation
salesChannel.mailHeaderFooter	Felder die zur Header und Footer Vorlage des Verkaufskanals hinterlegt sind. Hinter mailHeaderFooter kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel, mail_header_footer, mail_header_footer_translation,
salesChannel.name	Name des Verkaufskanals	sales_channel
salesChannel.shortName	Kürzel des Verkaufskanals	sales_channel
salesChannel.accessKey	API-Zugang	sales_channel
salesChannel.configuration	Config Einträge für den Verkaufskanal	sales_channel
salesChannel.active	Angabe, ob der Verkaufskanal aktiv ist	sales_channel
salesChannel.maintenance	Wartungsmodus	sales_channel
salesChannel.maintenanceWhiteList	Whitelist für den Wartungsmodus	sales_channel
salesChannel.customFields	Verkaufskanal Zusatzfelder	sales_channel_translation
salesChannel.translations	Übersetzungen der Verkaufskanal-Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	sales_channel_translation
salesChannel.currencies	Währungen des Verkaufskanals	sales_channel_currency
salesChannel.languages	Sprachen des Verkaufskanals	sales_channel_language
salesChannel.countries	Länder des Verkaufskanals	sales_channel_country
salesChannel.paymentMethods	Zahlungsarten des Verkaufskanals	sales_channel_payment_method
salesChannel.shippingMethods	Versandarten des Verkaufskanals	sales_channel_shippingMethod
salesChannel.createdAt	Wann wurde der Verkaufskanal angelegt	sales_channel
salesChannel.updatedAt	Wann wurde der Verkaufskanal aktualisiert	sales_channel
salesChannel.themes	Welches Theme ist dem Verkaufskanal zugeordnet	theme_sales_channel
salutation.id	UUID der Anrede	salutation
salutation.salutationKey	Technischer Name der Anrede	salutation
salutation.displayName	Name der Anrede	salutation_translation
salutation.letterName	Briefanrede	salutation_translation
salutation.translations	Übersetzungen der Anrede Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	salutation, salutation_translation
salutation.createdAt	Wann wurde die Anrede erstellt	salutation
salutation.updatetAt	Wann wurde die Anrede aktualisiert	salutation
tags	Kunden Tags	customer_tag
title	Titel	customer
updatedAt	Wann wurde der Kunde aktualisiert	customer

Objekttyp - "Kategorien"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, type, name.

Besonderheit id: Bei der Neuanlage eines Kunden kann das Feld leer gelassen werden, da das System die ID generiert.

Datenbankeintrag	Beschreibung	Datenbank-Tabelle
active	Angabe, ob die Kategorie aktiv ist	category
afterCategoryId	UUID der Kategorie vor dieser Kategorie	category
afterCategoryVersionID	Version der Kategorie vor dieser Kategorie	category
autoincrement	Einmalige Dezimalzahl	category
childCount	Anzahl der Unterkategorien	category
cmsPage.id	UUID der hinterlegten Erlebniswelt	category
cmsPage.name	Name der hinterlegten Erlebniswelt	cms_page_translation
cmsPage.type	Layout Typ der hinterlegten Erlebniswelt	cms_page
cmsPage.customFields	Erlebniswelt Zusatzfelder	cms_page_translation
cmsPage.locked	Erlebniswelt darf nicht bearbeitet werden.	cms_page
cmsPage.translations	Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	cms_page, cms_page_translation
cmsPage.previewMedia	Felder zum Vorschaubild der Erlebniswelt. Hinter previewMedia kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	cms_page, media
cmsPage.createdAt	Wann wurde die Erlebniswelt erstellt	cms_page
cmsPage.updatedAt	Wann wurde die Erlebniswelt aktualisiert	cms_page
id	UUID der Kategorie. Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.	category
level	Kategorie-Ebene	category
media	Felder des Anzeigebild der Kategorie. Hinter media kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	category, media
parent	Felder der Elternkategorie. Hinter parent kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	category, category_translation, media
path	Pfad zur Kategorie	category
products	UUID der in der Kategorie hinterlegten Produkte, getrennt durch fein "Pipe" Symbol (\|)	product_category
tags	Kategorie Tags	category_tag
translations.DEFAULT bsp. translations.de_DE.name translations.de_DE.description translations.en_GB.keywords	All Sprachabhängigen Kategoriefelder. DEFAULT kann hierbei durch die Sprache ersetzt und durch einen anschließenden Punkt auf das jeweilige Feld zugegriffen werden. Bspw. translations.en-GB.name	category, category_translation
type	Kategorietyp	category
versionId	UUID welche die Version der Kategorie angibt.	category
visible	In der Navigation ausblenden	category

Objekttyp - "Bestellungen"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, salesChannelId, orderDateTime, stateId.

Datenbankeintrag	Beschreibung	Datenbank-Tabelle
affiliateCode	Partner Code	orders
amountNet	Netto Betrag	orders
amountTotal	Gesamtbetrag	orders
autoIncrement	Einmalige Dezimalzahl	orders
billingAddress.additionalAddressLine1	Adresszusatz 1 der Rechnungsadresse	order_address
billingAddress.additionalAddressLine2	Adresszusatz 2 der Rechnungsadresse	order_address
billingAddress.city	Stadt der Rechnungsadresse	order_address
billingAddress.company	Firma	order_address
billingAddress.country	Land	order_adress
billingAddress.country.active	Angabe, ob das Rechnungsland aktiv ist	country
billingAddress.country.checkVatIdPattern	Umsatzsteuer Prüfung	country
billingAddress.country.companyTax	Angaben zur Umsatzsteuer: Betrag; Aktivierung; Währung ID	country
billingAddress.country.companyTaxFree	Angabe, ob die Firma im Land steuerfrei ist	country
billingAddress.country.customerTax	Angaben zur Umsatzsteuer: Betrag; Aktivierung; Währung ID	country
billingAddress.country.displayStateInRegistration	Region wird in der Registrierung angezeigt	country
billingAddress.country.forceStateInRegistration	Region ist Pflichtfeld	country
billingAddress.country.id	ID des Rechnungslandes	order_address country
billingAddress.country.iso	ISO-Code des Rechnungslandes	country
billingAddress.country.iso3	ISO 3-Code des Rechnungslandes	country
billingAddress.country.position	Angabe des Position	country
billingAddress.country.salesChannels	ID des Verkaufkanals	sales_channel_id
billingAddress.country.shippingAvailable	Angabe, ob das Land für den Versand verfügbar ist	country
billingAddress.country.taxFree	Steuerfrei	country
billingAddress.country.translated
billingAddress.country.translations.DEFAULT. bsp. billingAddress.country.translations.de-DE.country billingAddress.country.translations.en-GB.country	Standard Übersetzung
billingAddress.country.vatIdPattern		country
billingAddress.country.vatIdRequired	Angabe, ob die Umsatzsteuer erforderlich ist	country
billingAddress.countryId	ID des Rechnungslandes	order_adress
billingAddress.countryState.active	Angabe, ob die Region aktiv ist	country_state
billingAddress.countryState.shortCode	Shortcode des Landes	country_state
billingAddress.countryState.translated		country_state_translation
billingAddress.countryState.translations bsp. billingAddress.countryState.translations.de-DE.countryState billingAddress.countryState.translations.en-GB.countryState	Übersetzungen
billingAddress.countryStateId	ID der Region	order_adress country_state
billingAddress.createdAt	Wann wurde die Adresse angelegt	order_adress
billingAddress.customFields	Adresse Zusatzfelder	order_adress
billingAddress.department	Abteilung	order_adress
billingAddress.firstName	Vorname	order_adress
billingAddress.id	UUID der Adresse	order_adress
billingAddress.lastName	Nachname	order_adress
billingAddress.order.affiliateCode	Partner Code	order
billingAddress.order.amountNet	Nettobetrag	order
billingAddress.order.amountTotal	Gesamtbetrag	order
billingAddress.order.autoIncrement	Einmalige Dezimalzahl	order
billingAddress.order.billingAddressId	ID der Rechnungsadresse der Bestellung	order
billingAddress.order.billingAddressVersionId	UUID, welche die Version der Rechnungsadresse der Bestellung angibt	order
billingAddress.order.campaignCode	Kampagnen Code der Bestellung	order
billingAddressId	UUID der Rechnungsadresse	order
billingAddressVersionId	UUID, welche die Version der Rechnungsadresse angibt	order
campaignCode	Kampagnen Code	order
createdAt	Wann wurde die Bestellung angelegt	order
createdBy. bsp. createdBy.admin createdBy.firstName	erstellt durch	order
currency.translated	Übersetzung	currency_translation
currency.factor	Währungsfaktor	currency
currency.id	ID der Währung	order
currency.isSystemDefault	Standardwährung	sales_channel_
currency.isoCode	ISO-Code	currency
currency.itemRounding	Rundung der Nachkommastelle	currency
currency.position	Angabe der Position	currency
currency.salesChannels	Verkaufskanal, in der die Währung verwendet wird	sales_channel_currency
currency.symbol	Symbol der Währung	currency
currency.taxFreeFrom	Steuerfrei	currency
currency.translated e.g. currency.translations.de-DE.createdAt currency.translations.en-GB.createdAt	Übersetzungen
currencyFactor	Währungsfaktor	order
currencyId	Währung ID	currency order
customFields	Zusatzfelder	order
customerComment	Kundenkommentar	order
deepLinkCode	Code für einen Deeplink	order
deliveries.createdAt	erstellt am	order_delivery
deliveries.customFields	Zusatzfelder	order_delivery
deliveries.id	ID	order_delivery
deliveries.order	Bestellung	order_delivery
deliveries.orderId	ID der Bestellung	order_delivery
deliveries.orderVersionId	UUID, welche die Version der Bestellung angibt	order_delivery
deliveries.positions	Versand Positionen	order_delivery_position
deliveries.shippingCosts	Versandkosten	order_delivery
deliveries.shippingDateEarliest	Versand frühstens am	order_delivery
deliveries.shippingDateLatest	Versand spätestens am	order_delivery
deliveries.shippingMethod	Versand Methode	order_delivery
deliveries.shippingMethodId	Versand Methode ID	order_delivery
deliveries.shippingOrderAddress	Versand Addresse	oder_delivery
deliveries.shippingOrderAddressId	Versand Addresse ID	order_delivery
deliveries.stateId	ID der Region	order_delivery
deliveries.stateMachineState.	Bestellstatus	state_machine_state
deliveries.trackingCodes	Partner Code	order_delivery
deliveries.updatedAt	Aktualisiert am	order_delivery
deliveries.versionId	Version ID	order_delivery
id	ID	order
itemRounding	Rundung für Nachkommastelle	currency
language. bsp. language.id language.locale	Diverse Sprachinformationen
languageId	UUID der Sprache	order
lineItems		order_line_item
orderCustomer.company	Firma	order_customer
createdBy.recoveryUser.user.aclRoles		user_recovery

Objekttyp - "Medien"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestet das folgende Pflichtfeld: id.

Datenbankeintrag	Beschreibung	Datenbank-Tabelle
avatarUser	Felder zu dem Benutzer, welchem dieses Bild als Avatar zugeordnet ist. Hinter avatarUser kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden	media
fileExtension	Dateiendung	media
fileName	Dateiname	media
fileSize	Dateigröße	media
id	UUID der Media Datei. Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.	media
mediaFolder.childCount	Anzahl der Unterordner	media_folder
mediaFolder.configuration.createThumbnails	Thumbnails für diesen Ordner generieren	media_folder_configuration
mediaFolder.configuration.createdAt	Wann wurden die Ordnereinstellungen erstellt.	media_folder_configuration
mediaFolder.configuration.customFields	Zusatzfelder zu den Ordnereinstellungen	media_folder_configuration
mediaFolder.configuration.id	UUID der Konfiguration	media_folder
mediaFolder.configuration.keepAspectRation	Seitenverhältnis beibehalten	media_folder_configuration
mediaFolder.configuration.mediaThumbnailSizes	Thumbnail-Größe	media_folder_configuration
mediaFolder.configuration.thumbnailQuality	Thumbnail-Qualität	media_folder_configuration
mediaFolder.configuration.updatedAt	Wann wurden die Ordnereinstellungen aktualisiert	media_folder_configuration
mediaFolder.createdAt	Wann wurde der Ordner angelegt	media_folder
mediaFolder.customFields	Medienordner Zusatzfelder	media_folder
mediaFolder.defaultFolder	Felder zum Standardspeicherort. Hinter defaultFolder kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	media_folder, media_default_folder
mediaFolder.id	UUID des Ordners, in welchem die Mediadatei liegt	media
mediaFolder.name	Name des Ordners	media_folder
mediaFolder.parent	Felder zum Ordner oberhalb dieses Ordners. Hinter parent kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	media_folder
mediaFolder.updatedAt	Wann wurde der Ordner aktualisiert	media_folder
mediaFolder.useParentConfiguration	Einstellungen vom überliegenden Ordner übernehmen	media_folder
mediaTpe	Medien Typ	media
metaData	Meta Daten der Media	media
mimeType	Internet Media Type	media
tags	Medien Tags	media_tags
translations.DEFAULT' bsp. translations.de-DE.alt translations.de-DE.title	Alle Sprachabhängigen Media Felder. DEFAULT kann hierbei durch die Sprache ersetzt und durch einen anschließenden Punkt auf das jeweilige Feld zugegriffen werden. Bspw. translations.en-GB.alt
uploadedAt	Wann wurde die Media Datei hochgeladen	media
url	URL zur Media Datei	wird generiert
user.	Felder des Benutzers, welcher die Media Datei hochgeladen hat. Hinter user kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	user

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, email, status, hash, salesChannelId.

Datenbankeintrag	Beschreibung	Datenbank-Tabelle
city	Stadt des Newsletter-Empfängers	newsletter_recipient
confirmedAt	Wann wurde der Newsletter-Empfänger bestätigt	newsletter_recipient
createdAt	Wann wurde der Newsletter-Empfänger angelegt	newsletter_recipient
customFields	Zusatzfelder der Newsletter-Empfänger	newsletter_recipient
email	E-Mail des Newsletter-Empfänger	newsletter_recipient
firstName	Vorname des Newsletter-Empfänger	newsletter_recipient
hash	Hashwert zur Bestätigung des Newsletter Empfängers	newsletter_recipient
id	UUID des Newsletter-Empfängers	newsletter_recipient
language	Felder der Sprache des Newsletter-Empfängers. Hinter language kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	newsletter_recipient, language,
salesChannel	Felder des Verkaufskanals, in dem der Newsletter-Empfänger angemeldet ist. Hinter salesChannel kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	newsletter_recipient, sales_channel
salutation	Felder der Anrede des Newsletter-Empfänger angemeldet ist. Hinter salutation kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	newsletter_recipient, salutation
status	Status des Newsletter-Empfängers	newsletter_recipient
street	Straße des Newsletter-Empfängers	newsletter_recipient
tags	Tags des Newsletter-Empfängers	newsletter_recipient_tag
title	Titel des Newsletter-Empfängers	newsletter_recipient
updatedAt	Wann wurde der Newsletter Empfänger aktualisiert	newsletter_recipient
zipCode	PLZ des Newsletter-Empfängers	newsletter_recipient

Objekttyp - "Eigenschaften"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, groupId, name.

Datebankeintrag	Beschreibung	Datenbank-Tabelle
colorHexCode	Farbcode der in der Eigenschaft hinterlegten Farbe.	property_group_option
group.displayType	Darstellung der Ausprägungsauswahl	property_group
group.id	UUID der Eigenschaftsgruppe	property_group
group.sortingType	Sortierung der Eigenschaftsgruppe	property_group
group.translations.DEFAULT bsp. group.translations.de-DE.description group.translations.en-GB.	Alle Sprachabhängigen Felder der Eigenschaftengruppe. DEFAULT kann hierbei durch die Sprache ersetzt und durch einen anschließenden Punkt kann auf das jeweilige Feld zugegriffen werden. Bspw. group.translations.en-GB.description	property_group_translations
id	UUID der Eigenschaften-Ausprägung	property_group_option
media	Felder des Standardbildes der Eigenschaften-Ausprägung. Hinter media kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	property_group_option, media
productOptions	UUID der Varianten, die diese Eigenschafts-Ausprägung nutzen	product_option
productProperties	UUID der Produkte, denen diese Eigenschafts-Ausprägung als Eigenschaft zugewiesen wurde.	product_property
translations.DEFAULT bsp. translations.de-DE.name translations.en-GB.position	Alle Sprachabhängigen Felder der Eigenschafts-Ausprägung. DEFAULT kann hierbei durch die Sprache ersetzt und durch einen anschließenden Punkt kann auf das jeweilige Feld zugegriffen werden. Bspw. translations.en-GB.name	property_group_option_translation

Objekttyp - "Erweiterte Preise"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, productId, ruleId, quantityStart.

Datebankeintrag	Beschreibung	Datenbank-Tabelle
createdAt	Wann wurde der erweiterte Preis angelegt	product_price
id	Einmalige UUID des erweiterten Preises.	product_price
price.DEFAULT bsp. price.EUR.currencyId price.USD.gross price.GBP.net	Alle Felder zu dem Preis der importiert werden soll. DEFAULT kann hierbei durch den ISO Code der Währung ersetzt und durch einen anschließenden Punkt kann auf das jeweilige Feld zugegriffen werden. Bsp. price.USD.gross	product_price
product.DEFAULT bsp. product.active product.availableStock product.categories	Alle Produktabhängigen Felder, des Produktes, für den die erweiterten Preise gelten. DEFAULT kann hierbei durch den Feldnamen ersetzt werden auf den zugegriffen werden soll. Bsp. product.id	product
purchasePrices.DEFAULT bsp. purchasePrices.EU.currencyId purchasePrices.USD.gross purchasePrices.GBP.net	Alle Felder zu dem Einnkaufspreis der importiert werden soll. DEFAULT kann hierbei durch den ISO Code der Währung ersetzt und durch einen anschließenden Punkt kann auf das jeweilige Feld zugegriffen werden. Bsp. price.USD.gross	product
quantityEnd	Maximale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.	product_price
quantityStart	Minimale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.	product_price
ruleId	Eindeutige UUID der Regel die für diesen erweiterten Preis angewendet wird.	product_price
rule.DEFAULT bsp. rule.name rule.priority	Alle Felder zu der verwendeten Regel aus dem Rulebuilder. DEFAULT kann hierbei durch den Feldnamen ersetzt werden auf den zugegriffen werden soll. Bsp. rule.name	rule

Objekttyp - "Variantenkonfiguration"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, productid, optionid.

Datebankeintrag	Beschreibung	Datenbank-Tabelle
createdAt	Wann wurde die Variantenkonfiguration angelegt	product_configurator_setting
customFields	Variantenkonfiguration Zusatzfelder	product_configurator_setting
id	UUID der Variantenkonfiguration	product_configurator_setting
media	Medien Felder der Eigenschaftenbilder aus der Storefront Darstellung	product_configurator_setting
option.id	UUID der Eigenschaften-Ausprägung	property_group_option
option.group	Felder der Eigenschaften Gruppe der Eigenschaften-Ausprägung. Hinter group kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	property_group_option, property_group
option.Id	UUID der Eigenschaften-Ausprägung	property_group_option
option.media	Felder des Bildes der Eigenschaften-Ausprägung. Hinter media kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	property_group_option, media
option.productOptions	UUID der Varianten, die diese Option nutzen	product_option
option.properties	UUID der Produkte, denen diese Option als Eigenschaft zugewiesen wurde.	product_property
option.translations.DEFAULT bsp. translations.de-DE.name translations.en-GB.position	Alle Sprachabhängigen Felder der Eigenschafts-Ausprägung. DEFAULT kann hierbei durch die Sprache ersetzt und durch einen anschließenden Punkt auf das jeweilige Feld zugegriffen werden. Bspw. translations.en-GB.name	property_group_option_translation
position	Position in der Storefront-Darstellung	product_configurator_setting
price.DEFAULT.net	Netto Aufschlag. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product_configurator_setting
price.DEFAULT.gross	Brutto Aufschlag. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product_configurator_setting
price.DEFAULT.currencyId	UUID der Währung. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product_configurator_Setting, currency
price.DEFAULT.linked	Angabe, ob der Nett und Bruttopreis verknüpft sind. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product_configurator_setting
price.DEFAULT.listPrice	Erweiterte Preise. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR	product_configurator_setting
product	Felder des Produktes, dem die Variantenkonfiguration zugewiesen ist.	product_configurator_setting
updatedAt	Wann wurde die Variantenkonfiguration aktualisiert	product_configurator_setting

Objekttyp - "Cross-Selling"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, name, position, type, productId.

Besonderheit id: Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.

Datebankeintrag	Beschreibung	Datenbank-Tabelle
active		product_cross_selling
assignedProducts	Produkt ID des zugewiesenes Produkt	product_cross_selling_assigned_products
id	ID der Produktempfehlung. Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.	product_cross_selling
limit	Maximale Anzahl der Produkte	product_cross_selling
position	Zahlenwert zur Reihenfolge	product_cross_selling
product.active	Angabe, ob das Produkt aktiv ist	product
product.autoIncrement	Einmalige Dezimalzahl	product
product.available	Angabe, ob das Produkt verfügbar ist	product
product.availableStock	Verfügbarer Lagerbestand	product
product.canonicalProduct. diverse Optionen	Hinter canonicalProduct kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.	product
product.canonicalProductId		product
product.categories	UUID der Kategorie	product
product.categoriesRo
product.categoryIds	ID der Kategorie	product
product.categoryTree	IDs der Kategorien	product
product.cheapestPrice	Günstigster Preis	product
product.childCount	Anzahl der Varianten	product
product.cmsPage.translations.DEFAULT e.g. product.cmsPage.translations.de-DE.cmsPage product.cmsPage.translations.en-GB.cmsPage	Standard Übersetzung	cms_page_translation
product.cmsPage.config	Konfiguration	cms_page
product.cmsPage.entity	Element	cms_page
product.cmsPage.id	ID	product
product.cmsPage.locked	Sperrung	cms_page
product	Produkt	product
updatedAt	Wann wurde die Variantenkonfiguration aktualisiert	product_configurator_setting

Objekttyp - "Promotions"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, productid, optionid.

Datebankeintrag	Beschreibung	Datenbank-Tabelle
active	Gibt an ob die Promotion aktiv ist	promotion
code	Der Aktivierungscode für die Rabattaktion	promotion
use.codes	Gibt an ob ein Aktivierungscode verwendet wird	promotion
id	ID der des Rabatts der Promotion	promotion_discount
promotion.id	ID der Promotion	promotion, promotion_discount
scope	Definiert den Bereich wo der Rabatt angewendet wird	promotion_discount
type	Bestimmt die Art des Rabattabzugs	promotion_discount
value	Wert des Rabatts	promotion_discount
consider.advanced.rules	Gibt an ob erweiterte Regeln in der Rabattaktion enthaltren sind	promotion_discount
max.value	Gibt den Höchstwert des Rabatts an der gewährt wird	promotion_discount
discount.rules	Gibt an ob im Rabatt Regeln hinterlegt sind	promotion_discount
applier.key	Gibt an wieviele Artikel den Rabatt erhalten	promotion_discount
sorter.key	Gibt an ob der Preis auftseigen oder absteigend sortiert wird	promotion_discount
valid.from	Ab wann ist die Promotion aktiv	promotion
valid.until	Bis wann die Promotion aktiv ist	promotion

Objekttyp - "Aktionscodes"

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, promotionid.

Datebankeintrag	Beschreibung	Datenbank-Tabelle
promotion.active	Aktiv	promotion
promotion.cartRules	Warenkorb-Regeln	promotion_cart_rule
promotion.code	Code	promotion
promotion.customerRestriction	Beschränkung auf Kunden	promotion
promotion.exclusionIds	UUID	promotion
promotion.id	UUID	promotion
promotion.individualCodePattern	Muster der generierten Codes	promotion
promotion.maxRedemptionsGlobal	Zahlenwert; maximale Anzahl an Einlösungen der Aktion	promotion
promotion.maxRedemptionsPerCustomer	Zahlenwert; maximale Anzahl an Einlösungen der Aktion pro Kunde	promotion
promotion.orderCount	Anzahl Bestellungen	promotion
promotion.orderRules	Bestellungs-Regeln	promotion_order_rule
promotion.personaCustomers	Angaben zur Promotion ID & Kunden ID	promotion_persona_customer
promotion.personaRules	Angaben zur Promotion ID & Rule ID	promotion_persona_rule
promotion.perventCombinaton	Verhindert die Kombination mit anderen Aktionen	promotion
promotion.translated.DEFAULT. bsp. translations.de_DE.language translations.de_DE.customFields translations.en_GB.name	Alle Sprachabhängigen Produktfelder. DEFAULT kann hierbei durch die Sprache ersetzt werden und durch einen anschließenden Punkt kann auf das jeweilige Feld zugegriffen werden. Bspw. translations.en-GB.name	promotion_translation
code	Code	promotion
createdAt	Erstellt am	promotion
id	UUID	promotion
payload	Angaben zur Order ID, Kunden ID und Kundenname	promotion_individual_code
promotionId	UUID der Aktion	promotion_individual_code
updatedAt	Geändert am	promotion

Import von Produkten

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Produkt aus. Anders als bei anderen Profilen wird bei der Auswahl dieses Profils anschließend eine Checkbox Produktvarianten importieren angezeigt. In diesem Fall aktivierst Du diese Checkbox nicht. Wie Du Produktvarianten importierst erfährst Du hier.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Produkte und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV-Datei

Eine Beispiel Datei für das Standardprofil Produkte findest Du hier: Standardprofil Produkte

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID des Produktes. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
parent_id	Eindeutige UUID des Elternproduktes, falls es sich um ein Variantenartikel handelt. Auch dieses Feld kann leer bleiben.
product_number	Produktnummer
active	1 für aktiv und 0 für inaktiv.
stock	aktueller Lagerbestand
name	Name des Produktes
description	Beschreibung
price_net	Nettopreis
price_gross	Bruttopreis
tax_id	Trage hier die eindeutige UUID des Steuersatzes ein. Wenn Du die Konfigurationsseite des jeweiligen Steuersatzes aufrufst, wird die ID in der Adresszeile angezeigt. Möchtest Du einen komplett neuen Steuersatz anlegen, lässt Du dieses Feld frei.
tax_rate	Wert des Steuersatz (bsp. 7 oder 19)
tax_name	Name des Steuersatzes (bsp. 7% oder 19%)
cover_media_id	Wenn Du ein Bild als Vorschaubild verwenden möchtest, welches sich bereits in der Shopware Installation befindet, trage hier die UUID dieses Bildes ein. Diese findest Du in der Datenbank Tabelle media in der Spalte id. Möchtest Du ein neues Bild importieren, lasse dieses Feld frei.
cover_media_url	URL zu dem Bild, welches Du als Vorschaubild verwenden möchtest. Dies kann auch eine externe URL außerhalb der Shopware Installation sein. Der Import weiterer Bilder sind im Standard Profil nicht enthalten. Hierzu ist es notwendig ein neues Produkt Profil anzulegen und das Datenbank Mapping "media" hinzuzufügen.
cover_media_title	Der Titel, unter dem das importierte Vorschaubild intern abgespeichert werden soll.
cover_media_alt	Alt-Text des Vorschaubildes
manufacturer_id	Wenn Du den Artikel einem Hersteller zuordnen möchtest, der bereits in Deinem Shop existiert, trage hier die UUID des Herstellers ein.Wenn Du die Konfigurationsseite des jeweiligen Herstellers aufrufst, wird die ID in der Adresszeile angezeigt. Möchtest Du einen neuen Hersteller importieren, lasse dieses Feld leer.
manufacturer_name	Wenn Du einen neuen Hersteller anlegen möchtest, trage hier den Namen den neuen Herstellers ein.
categories	Trage hier die UUIDs der Kategorien ein, denen der Artikel zugeordnet ist. Wenn Du die Konfigurationsseite der jeweiligen Kategorie aufrufst, wird die ID in der Adresszeile angezeigt. Wenn Du mehrere Kategorien zuordnen möchtest, trenne die UUIDs durch Pipe Symbole (\|).
sales_channels	Trage hier die UUIDs des Verkaufskanals ein, dem der Artikel zugeordnet ist. Wenn Du die Konfigurationsseite des jeweiligen Verkaufskanals aufrufst, wird die ID in der Adresszeile angezeigt. Wenn Du mehrere Verkaufskanäle zuordnen möchtest, trenne die UUIDs durch Pipe Symbole (\|).

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Produkte nun unter Kataloge > Produkte sehen und weiter bearbeiten.
Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV-Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Die nicht importierten Einträge kannst Du Dir nun als neue CSV-Datei herunterladen. Diese Datei enthält dann nur noch die fehlerhaften Datensätze mit der zusätzlichen Spalte _error. In dieser Spalte wird angegeben, warum der Import dieses Datensatzes fehlgeschlagen ist. Diese kannst Du nun direkt in der heruntergeladenen CSV-Datei korrigieren und die Datei dann erneut importieren.

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Newsletter-Empfänger aus.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Newsletter-Empfänger und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV-Datei

Eine Beispiel Datei für das Standardprofil Newsletter-Empfänger findest Du hier: Standardprofil Newsletter-Empfänger

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID des Empfängers. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
email	E-Mail Adresse des Empfängers
title	Optionaler Titel des Empfängers
salutation	Anrede
first_name	Vorname
last_name	Nachname
zip_code	PLZ
city	Stadt
street	Straße
status	Trage hier den Status für den Empfänger ein. Im Standard wird hier nur "direct" verwendet. Plugins können teilweise auch andere Status verwenden.
hash	Der Hash Wert dient dazu, die korrekte Registrierung zu gewährleisten. Trage hier einen zufälligen einmaligen Hashwert ein.
sales_channel_id	Trage hier die UUIDs des Verkaufskanals ein, dem der Artikel zugeordnet ist. Wenn Du die Konfigurationsseite des jeweiligen Verkaufskanals aufrufst, wird die ID in der Adresszeile angezeigt. Wenn Du mehrere Verkaufskanäle zuordnen möchtest, trenne die UUIDs durch Pipe Symbole (\|).

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Produkte nun unter Marketing > Newsletter-Empfänger sehen und weiter bearbeiten.

Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Import von Eigenschaften

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Eigenschaften aus.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Eigenschaften und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV-Datei

Eine Beispiel Datei für das Standardprofil Eigenschaften findest Du hier: Standardprofil Eigenschaften

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID der Eigenschaftsausprägung Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
color_hex_code	Farbcode der in der Eigenschaft hinterlegten Farbe
name	Name der Eigenschaft
position	Jede Eigenschaft hat eine Position, mit welcher sie im Admin angezeigt wird.
group_id	Eindeutige UUID der Eigenschaftsgruppe.
group_display_type	Darstellung der Ausprägungsauswahl
group_sorting_type	Sortierung der Ausprägungsauswahl. Hier kannst Du "alphanumeric", "numeric" und "position" angeben.
group_name	Name der Eigenschaftsgruppe
group_description	Beschreibung der Eigenschaftsgruppe (Optional)
group_position	Position der Eigenschaftsgruppe (Optional)
media_id	Wenn Du ein Bild als Vorschaubild verwenden möchtest, welches sich bereits in der Shopware Installation befindet, trage hier die UUID dieses Bildes ein. Diese findest Du in der Datenbank Tabelle media in der Spalte id. Möchtest Du kein Vorschaubild verwenden oder ein neues Bild importieren, lasse dieses Feld frei.
media_folder_id	Optional kannst Du hier die UUID des Ordners ein, in dem das zu verwendende Bild liegt. Wenn Du die Konfigurationsseite des jeweiligen Bilderordners unter Inhalte > Medien aufrufst, wird die ID in der Adresszeile angezeigt. Wenn Du kein Bild importieren möchtest, kannst Du das Feld leer lassen.
media_type	Dieses Feld enthält beim Export Eigenschaften des verwendeten Bildes. Für den Import kann dies aber leer gelassen werden.
media_title	Wenn Du ein Bild importieren möchtest, trage hier den Titel des Bildes ein. Alternativ kannst Du das Feld auch leer lassen.
medie_alt	Wenn Du ein Bild importieren möchtest, trage hier den alternativen SEO Titel des Bildes ein. Alternativ kannst Du das Feld auch leer lassen.

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Produkte nun unter Kataloge > Eigenschaften sehen und weiter bearbeiten.

Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Die nicht importierten Einträge kannst Du Dir nun als neue CSV Datei herunterladen. Diese Datei enthält dann nur noch die fehlerhaften Datensätze mit der zusätzlichen Spalte _error. In dieser Spalte wird angegeben, warum der Import dieses Datensatzes fehlgeschlagen ist. Diese kannst Du nun direkt in der heruntergeladenen CSV Datei korrigieren und die Datei dann erneut importieren.

Import von Erweiterten Preisen

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Erweiterte Preise aus.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Eigenschaften und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV-Datei

Eine Beispiel Datei für das Standardprofil Erweiterte Preise findest Du hier: Standardprofil Erweiterte Preise

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID des Erweiterten Preises aus der Datenbank product_price. Da der Import von erweiterten Preisen nicht für das Anlegen von Erweiterten Preisen gedacht ist, darf dieses Feld nicht leer bleiben.
product_id	Eindeutige UUID des Produktes, für den der erweiterte Preis eingerichtet wurde.
rule_id	Eindeutige UUID der Regel die für diesen erweiterten Preis angewendet wird.
price_net	Netto Preis des erweiterten Preises
price_gross	Brutto Preis des erweiterten Preises
quantity_start	Minimale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.
quantity_end	Maximale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Erweiterten Preise nun unter Kataloge > Produkte im jeweiligen Produkt im Reiter Erweiterte Preise sehen und weiter bearbeiten.

Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Import von Kategorien

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Kategorie aus.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Kategorien und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV Datei

Eine Beispiel Datei für das Standardprofil Kategorie findest Du hier: Standardprofil Kategorie

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID der Kategorie. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
parent_id	Eindeutige UUID der Elternkategorie unter welcher diese Kategorie einsortiert werden soll. Wenn Du die Konfigurationsseite der jeweiligen Kategorie unter Inhalte > Medien aufrufst, wird die ID in der Adresszeile angezeigt.
active	1 für aktiv und 0 für inaktiv.
type	Trage hier den Kategorietyp ein. Page für eine normale Kategorie, folder für eine Strukturkategorie und link für den Kategorietyp Benutzerdefinierter Link.
visible	Trage hier ein, ob die Kategorie in der Navigation ausgeblendet wird. 1 für sichtbar und 0 für ausgeblendet.
name	Name der Kategorie
external_link	Trage hier den externen Link ein, falls Du als Typ link gewählt hast.
description	Beschreibung der Kategorie (optional)
meta_title	SEO Meta Titel (Optional)
meta_description	SEO Meta Beschreibung (Optional)
media_id	Wenn Du ein Bild als Anzeigebild für die Kategorie verwenden möchtest, welches sich bereits in der Shopware Installation befindet, trage hier die UUID dieses Bildes ein. Diese findest Du in der Datenbank Tabelle media in der Spalte id. Möchtest Du kein Anzeigebild verwenden oder ein neues Bild importieren, lasse dieses Feld frei.
media_url	URL zu dem Bild, welches Du als Vorschaubild verwenden möchtest.
media_folder_id	Optional kannst Du hier die UUID des Ordners ein, in dem das zu verwendende Bild liegt. Wenn Du die Konfigurationsseite des jeweiligen Bilderordners unter Inhalte > Medien aufrufst, wird die ID in der Adresszeile angezeigt. Wenn Du kein Bild importieren möchtest, kannst Du das Feld leer lassen.
media_type	Dieses Feld enthält beim Export Eigenschaften des verwendeten Bildes. Für den Import kann dies aber leer gelassen werden.
media_title	Wenn Du ein Bild importieren möchtest, trage hier den Titel des Bildes ein. Alternativ kannst Du das Feld auch leer lassen.
mediea_alt	Wenn Du ein Bild importieren möchtest trage hier den alternativen SEO Titel des Bildes ein. Alternativ kannst Du das Feld auch leer lassen.
cms_page_id	UUID der hinterlegten Erlebniswelt. Wenn Du die Konfigurationsseite der jeweiligen Erlebniswelt unter Inhalte > Erlebniswelten aufrufst, wird die ID in der Adresszeile angezeigt. Wenn Du keine Erlebniswelt verwenden möchtest, kannst Du dieses Feld leer lassen.

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Produkte nun unter Kataloge > Kategorien sehen und weiter bearbeiten.

Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV-Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Import von Medien

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Medien aus.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Medien und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV-Datei

Eine Beispiel Datei für das Standardprofil Medien findest Du hier: Standardprofil Medien

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID der Medien Datei. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
folder_id	Hier kannst Du die UUID des Ordners angeben, in dem das zu verwendende Bild liegt. Wenn Du die Konfigurationsseite des jeweiligen Bilderordners unter Inhalte > Medien aufrufst, wird die ID in der Adresszeile angezeigt.
url	Trage hier die URL des Mediums an, welches Du importieren möchtest. Dies kann auch eine externe URL außerhalb der Shopware Installation sein.
private	Dieses Feld wird ggf. für Plugins verwendet. Für den Standard Import verwende hier "0".
type	In diesem Feld werden die Metadaten des Mediums für den Export hinterlegt. Für den Import kannst Du dieses Feld leer lassen.
title	Titel des Bildes
alt	Alternative SEO Titel

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Produkte nun unter Inhalte > Medien sehen und weiter bearbeiten.

Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV-Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Import von Produktvarianten

Folgende 4 Schritte sind zum Import von Varianten notwendig:

Schritt 1: Produkte importieren

Im ersten Schritt ist es notwendig die Produkte zu importieren, für welche neue Varianten importiert werden sollen.
Wenn Du Varianten für bereits bestehende Produkte importieren möchtest, kannst Du diesen Schritt überspringen.

In der angefügten CSV-Datei trägst Du die neuen Produkte ein. Die Spalte id und parent_id lässt Du frei. Diese werden vom System generiert bzw. in diesem Fall nicht benötigt. Anschließend importierst Du diese Datei im Import/Export Modul mit dem Profil Standardprofil Produkt.

Standardprofil Produkt.csv

Schritt 2: Eigenschaften importieren

Im nächsten Schritt müssen nun die Eigenschaften importiert werden, auf dessen Basis die Varianten erstellt werden sollen. Wenn Du bereits die Eigenschaften, die Du verwenden möchtest angelegt hast, kannst Du auch diesen Schritt überspringen.

Du kannst die angefügte CSV-Datei nutzen, um neue Eigenschaften zu importieren. Die Spalte id lässt Du leer, sodass diese beim Import generiert wird. In der Spalte group_id trägst Du die UUID der Eigenschaftengruppe ein. Diese findest Du bei angelegten Eigenschaften Gruppen in der Adresszeile des Browsers, wenn Du die Eigenschaftengruppe im Shopware Admin aufrufst.

Alternativ erhältst Du diese auch, wenn Du die Eigenschaften mit dem Profil Standardprofil Eigenschaften exportierst.

Wenn Du diese Spalte leer lässt, wird auch die Eigenschaftengruppe durch den Import neu angelegt und eine UUID für diese Gruppe erstellt. Wenn Du die CSV-Datei gefüllt hast, importierst Du sie im Import/Export Modul mit dem Profil Standardprofil Eigenschaften.

Standardprofil Eigenschaften.csv

Schritt 3: Variantenkonfiguration importieren

Nachdem Produkte und Eigenschaften vorhanden sind, müssen diese noch in Form von Variantenkonfigurationen verknüpft werden, um im späteren Schritt die Varianten dann erstellen zu können. In der angefügten CSV-Datei trägst Du zum einen die option_id ein. Das ist die automatisch erstellte UUID der Eigenschaften. Diese ID erhältst Du, wenn Du die Eigenschaften aus dem letzten Schritt noch einmal wieder exportierst.
Danach trägst Du die product_id ein. Das ist die UUID der Hauptprodukte, für die Varianten angelegt werden sollen. Diese findest Du bei angelegten Produkten in der Adresszeile des Browsers, wenn Du die Produkte im Shopware Admin aufrufst.

Alternativ erhältst Du die IDs auch, wenn Du die Produkte mit dem Profil Standardprofil Variantenkonfiguration exportierst.

Die Spalte id lässt Du einfach frei und importierst sie dann im Import/Export Modul mit dem Profil Standardprofil Variantenkonfiguration.

Standardprofil Variantenkonfiguration.csv

Schritt 4: Varianten importieren oder generieren

Hier kannst Du frei wählen ob Du die Varianten importieren oder alternative generieren möchtest. Es muss nur eins der beide Schritten ausgeführt werden, wie Du es machst bleibt die überlassen.

Varianten importieren

Mit den vorherigen Schritten hast Du die Varianten soweit vorbereitet, dass Du sie jetzt einfach nur noch importieren brauchst. Um Varianten importieren zu können benötigst du das Profil Standardprofil Produkt und der Haken muss bei Produktvarianten importieren gesetzt sein.

Pflichtfelder für den Import der Varianten in dem Profil sind parent_id, diese ergibt sich aus der ID des Hauptartikels, product_number, ist die gewünschte Artikelnummer der Variante, active, muss entweder auf 0 oder 1 stehen, stock, gibt den Lagerbestand wieder und optionIds, ergeben sich aus den ID's der
Eigenschaften und können mit | aufgefzählt werden.

Standardprofil Produkt.csv

Varianten generieren

Mit den vorherigen Schritten hast Du die Varianten soweit vorbereitet, dass Du sie jetzt einfach nur noch generieren brauchst.
Öffne hierzu nun in der Shopware Administration den Artikel, für den Du die Varianten importiert hast und öffne den Reiter Varianten generieren.

Klicke im sich dann öffnenden Fenster erneut auf Varianten generieren.

Import von Kunden

Den Import kannst Du unter Einstellungen > Shop > Import/Export im Reiter Import starten.

Als Profil (2) für den Import wählst Du als erstes das Profil Standardprofil Kunde aus.

Als nächstes benötigst Du eine CSV-Datei (1), die zu dem ausgewählten Profil passt. In dieser CSV-Datei sollten alle Medien und notwendigen Informationen mit den korrekten Spaltennamen enthalten sein.

Wenn Du alle Felder ausgefüllt hast, klickst Du abschließend auf Import Starten (3).

Beispiel CSV-Datei

Eine Beispiel Datei für das Standardprofil Kunde findest Du hier: Standardprofil Kunde

Diese Datei enthält folgende Spalten, die Du entsprechend ausfüllst:

id	Eindeutige UUID der Kunden Datei. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
account_type	Hier kannst Du den Account Tyoen des Kunden angeben. In der Beispiel CSV ist dies auf private, da es ein Privatkunde ist.
salutation	Trage hier die Anrede des Kunden ein.
customer_number	Dieses Feld wird für die Kundennummer genutzt.
first_name	In diesem Feld wird der Vorname des Kunden eingetragen.
last_name	In diesem Feld wird der Nachname des Kunden eingetragen.
email	E-Mail Adresse des Kunden.
guest	Hier muss ein Boolwert eingetragen werden. 0 wenn es sich nicht um einen Gastbesteller handelt und 1 wenn es sich um einen Gastbesteller handelt
customer_group	Definiert die Kundengruppe
language	Definiert die Sprache des Kunden
sales_channel	Gibt an, aus welchem Verkaufskanal die Bestellung getätigt wurde.
payment_method	Zahlungsart
billing_id	Rechnungs ID
billing_salutation	Andrede in der Rechnung
billing_title	TItel der Rechnung
billing_first_name	Vorname des Rechnungsträgers
billing_last_name	Nachname des Rechnungsträgers
billing_company	Firma des Rechnungsträgers
billing_street	Straße der Rechnungsadresse
billing_zipcode	Postleitzahl der Rechnungsadresse
billing_city	Stadt der Rechnungsadresse
billing_country	Rechnungsland
billing_phone_number	Telefonnummer des Rechnungsträgers
shipping_id	Versand ID
shipping_salutation	Anrede für den Versand
shipping_title	Titel/Name der Versandart
shipping_first_name	Vorname für die Versandadresse
shipping_last_name	Nachname für die Versandadresse
shipping_company	Firma des Versandträgers
shipping_street	Straße der Versandadresse
shipping_zipcode	Postleitzahl der Versandadresse
shipping_city	Stadt der Versandadresse
shipping_country	Versandland
shipping_phone_number	Telefonnummer des Versandträgers

Nach dem Import

Erhältst Du eine Meldung, dass der Import erfolgreich war, kannst Du die Kunden nun unter Kunden > Übersicht sehen und weiter bearbeiten.

Wenn der Import fehlschlägt, erhältst Du unter dem Import starten Button eine Meldung, wie viele Datensätze aus der CSV-Datei erfolgreich importiert werden konnten und wie viele nicht importiert werden konnten.

Import/Export: Artikel Übersetzungen

Bevor ein Import in das Live-System vorgenommen wird, sollte ein Datenbankbackup vorgenommen werden. In jedem Fall empfiehlt sich auch den Import zuvor in einer Testumgebung oder im Staging-System zu prüfen.

Beim Importieren von Artikelübersetzungen müssen wir darauf achten, die richtige languageId für die Übersetzungen anzugeben. Diese ID ist in der Tabelle product_translation zu finden. Alle sprachabhängigen Felder der Eigenschaft value. DEFAULT können durch die Sprache ersetzt werden und auf das jeweilige Feld kann mit einem nachfolgenden Punkt zugegriffen werden. Zum Beispiel translations.en-GB.name.

Unterstützte Felder inkl. Beschreibung

Feldname	Beschreibung
translations.DEFAULT.productId	id des Produkts
translations.DEFAULT.languageId	id der Sprache
translations.DEFAULT.name	Übersetzung der Name
translations.DEFAULT.keywords
translations.DEFAULT.customFields
translations.DEFAULT.createdAt
translations.DEFAULT.updatedAt
translations.DEFAULT.packUnit
translations.DEFAULT.productVersionId
translations.DEFAULT.metaTitle
translations.DEFAULT.description
translations.DEFAULT.metaDescription
translations.DEFAULT.slotConfig
translations.DEFAULT.packUnitPlural

Dies ist das Profil für Artikelübersetzungen und enthält alle übersetzbaren Artikelfelder. Du kannst ein neues Profil hinzufügen, indem Du den Produktobjekttyp auswählst und die Mappings für die Übersetzung entsprechend hinzufügst.

Hier kannst Du das Profil herunterladen: profile_item translations.csv
Ein Beispiel für eine csv-Datei findest Du hier: item translations example file.csv

Import mehrerer Produktbilder

Der Produktimport bzw. Produktexport kann so erweitert werden, dass neben dem Coverbild des Produkts weitere Medien importiert werden können. Im folgenden erklären wir Dir, mit welchen einfachen Schritten Du das umsetzen kannst.

Schritt 1: Standardprofil duplizieren und erweitern.

Falls nicht bereits geschehen, öffne Einstellungen > Shops > Import / Export > Profile.

Dort klickst Du auf die drei Punkte hinter Standardprofil Produkt und wählst Duplizieren aus. Im neuen Fenster ändere den Produktnamen so, dass Du anhand dessen erkennst, welche Funktion das Profil hat. In diesem Fall beispielsweise "Produktprofil mit zusätzlichen Bildern". Dann wechsle auf den Tab Zuweisungen.
Wir müssen ein neues Feld im Profil hinzufügen. Dafür klicke auf Neues Mapping hinzufügen, wodurch an erster Stelle eine neue Zeile ergänzt wird.

Der CSV-Name ist die Spaltenüberschrift, unter der das neue Feld in der Datei angezeigt wird. Diesen Namen kannst Du frei vergeben. Falls die Datei zum Austausch mit einer anderen Software eingesetzt werden soll, kann es notwendig sein, einen vorgegebenen Namen zu verwenden.
Im Feld Datenbank-Eintrag wähle media. Das ist das Feld aus dem Shopware die Daten abstellen wird oder in das die Daten beim Import eingefügt werden. Daher stehen in der Dropdown Liste nur Einträge zur Verfügung, die Shopware unterstützt.
Die weiteren Einstellungen belasse so, wie Sie Dir vorgeschlagen werden.
Nun kannst Du das Profil speichern.
Das neue Profil steht wird nun mit dem Typ Benutzerdefiniert und dem von Dir vergebenen Namen in der Liste der Profile angezeigt.

Schritt 2: Zusätzliche Produktbilder importieren

Wenn Du bereits Produkte mit mehreren zugeordneten Bildern angelegt hast, kannst Du testweise einen Produktexport mit dem gerade angelegten Profil durchführen. In der Datei kannst Du sehen, wie die Daten für den Import vorliegen müssen.
Das von uns ergänzte Mapping findest Du als erste Spalte in der Datei.
Trage nun in der Spalte media bzw. mit dem von Dir vergebenen Namen gültige URLs nach diesem Muster ein:

http://example.com/example1.png|http://example.com/example2.png

Die Bild-URLs werden durch das Pipe-Zeichen "|" voneinander getrennt. Achte darauf, dass die Dateien keine Leerzeichen und Umlaute enthalten. Das Verzeichnis, in dem Du die Mediendateien für den Import bereit stellst, muss passende Verzeichnisrechte haben, damit der Import die Dateien in die Shopware Medien kopieren und importieren kann.

Wenn die angegebenen Dateien bereits in Medien vorhanden sind, werden sie nicht dupliziert.

Wenn Du das erste Mal mit dem Import / Export arbeitest, teste zunächst nur mit wenigen Produkten, ob Deine Änderungen wunschgemäß ausgeführt werden. Alternativ lege Dir eine Testumgebung an.
Hast Du Deine Datei bearbeitet und gespeichert, öffne den Tab Import.

Klicke auf Datei auswählen, um sie für den Import auszuwählen und wähle das Profil aus, das wir im ersten Schritt angelegt haben. Falls Deine Datei Varianten enthält, aktiviere den Slider Produktvarianten importieren.
Möchtest Du die Datei zunächst nur prüfen, kannst Du das mit Testlauf starten tun. Shopware führt die gleichen Schritt wie beim regulären Import aus, allerdings werden keine Daten in die Datenbanktabellen geschrieben. Für einen vollständigen Lauf wähle Import starten aus.
Unter Import-Aktivität wird bei jeder der Aktionen ein Eintrag vorgenommen, der Dir unter anderem zeigt, ob der Import erfolgreich verlaufen ist oder fehlgeschlagen.
Im Fehlerfall nutze den Eintrag Fehlerhafte Einträge herunterladen. Ganz rechts in der Datei findest Du einen kurzen Hinweis, warum der Import des Datensatzes fehlgeschlagen ist.

Prüfe den Eintrag unter Import-Aktivität immer, wenn Du über die Mitteilungen informiert wirst, dass der Import abgeschlossen wurde. Der Hinweis bedeutet nicht zwangsläufig, dass der Vorgang erfolgreich war.

Import/Export Custom Products zuweisen

Es ist möglich eine bestehende Custom Products Vorlage über Import/Export weiteren Produkten per Import zuzuweisen.

Schritt 1: Produkt zuweisen

Wähle zuerst ein Produkt aus und weise diesem die gewünschte Custom Products Vorlage zu.

Schritt 2: Profil kopieren

Gehe zu Einstellungen > Import/Export > Profile und kopiere das bestehende Standardprofil für Custom Proucts.

Schritt 3: Profil bearbeiten

Gehe in dem Profil auf Zuweisungen und mappe 2 neue Felder. Gebe diesen Feldern daraufhin folgende zwei Datenbankeinträge:

swagCustomizedProductsTemplate.internalName
swagCustomizedProductsTemplate.id

Schritt 4: Profil exportieren:

Exportiere das Profil und Dir sollte auffallen, dass in den zwei Spalten ganz links die Werte zugewiesen wurden.

Schritt 5: Importieren

Kopiere diese Werte und füge diese bei anderen Produkten ein. Daraufhin speichern und das Profil wieder Importieren.

Hiernach ist die Custom Products Vorlage per Import den Produkten zugewiesen.

Import/Export

Grundmodul

Vorbereitung

Import

Export

Export-Assistent - AI Copilot

Profile

Individuelle Profile anlegen

Allgemein

CSV-Datei hochladen

Zuweisung

Erweiterte Einstellungen

Bezeichner - Second Unique Identifier

Objekttyp - "Produkt"

Objekttyp - "Kunde"

Objekttyp - "Kategorien"

Objekttyp - "Bestellungen"

Objekttyp - "Medien"

Objekttyp - "Newsletter-Empfänger"

Objekttyp - "Eigenschaften"

Objekttyp - "Erweiterte Preise"

Objekttyp - "Variantenkonfiguration"

Objekttyp - "Cross-Selling"

Objekttyp - "Promotions"

Objekttyp - "Aktionscodes"

Import von Produkten

Beispiel CSV-Datei

Nach dem Import

Import von Newsletter-Empfänger

Beispiel CSV-Datei

Nach dem Import

Import von Eigenschaften

Beispiel CSV-Datei

Nach dem Import

Import von Erweiterten Preisen

Beispiel CSV-Datei

Nach dem Import

Import von Kategorien

Beispiel CSV Datei

Nach dem Import

Import von Medien

Beispiel CSV-Datei

Nach dem Import

Import von Produktvarianten

Schritt 1: Produkte importieren

Schritt 2: Eigenschaften importieren

Schritt 3: Variantenkonfiguration importieren

Schritt 4: Varianten importieren oder generieren

Import von Kunden

Beispiel CSV-Datei

Nach dem Import

Import/Export: Artikel Übersetzungen

Import mehrerer Produktbilder

Schritt 1: Standardprofil duplizieren und erweitern.

Schritt 2: Zusätzliche Produktbilder importieren

Import/Export Custom Products zuweisen

War dieser Artikel hilfreich?

Version

Inhalt