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:

ZeichensatzUTF-8
FeldtrennerSemikolon
Zeichenketten-TrennerAnfü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.

DatenbankeintragBeschreibungDatenbank-Tabelle
activeAngabe ob das Produkt aktiv istproduct
autoIncrementEinmalige Dezimalzahlproduct
availableAngabe ob das Produkt verfügbar istproduct
availableStockVerfügbarer Lagerbestandproduct
childCountAnzahl der Variantenproduct
configuratorGroupConfigEigene Sortierung der Eigenschaftenproduct
cover.idUUID des Vorschaubildes des Artikelsproduct_media
cover.versionIdUUID welche die 
Version des Vorschaubildes des Artikels angibt.
product_media
cover.media.IdUUID des Vorschaubildes des Artikels. Hinter media kann ein Punkt gesetzt und so auf weitere Felder innerhalb von media zugegriffen werden. media
cover.positionPosition des Vorschaubildes in der Medien Übersicht des Artikels.product_media
cover.customFieldsVorschaubild Zusatzfeldcustom_field
cover.createdAtVorschaubild hochgeladenproduct_media
cover.updatedAtVorschaubild aktualisiertproduct_media
customSearchKeywordsSuch-Schlagwörterproduct_translation
deliveryTime.idUUID der Lieferzeitdelivery_time
deliveryTime.nameName der Lieferzeitdelivery_time_translation
deliveryTime.customFieldsLieferzeit Zusatzfelderdelivery_time_translation
deliveryTime.minMinimale Lieferzeitdelivery_time
deliveryTime.maxMaximale Lieferzeitdelivery_time
deliveryTime.unitLieferzeit Einheitdelivery_time
deliveryTime.translationsÜbersetzungen der deliveryTime Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.delivery_time_translation
deliveryTime.createdAtLieferzeit erstelltdelivery_time
deliveryTime.updatedLieferzeit aktualisiertdelivery_time
eanEAN Nummerproduct
heightHöhe des Produktesproduct
IdUUID welche vom System vergeben wird. Beim Neuanlegen von Artikeln sollte diese Spalte leer gelassen werden. 
 
product
isCloseoutAbverkaufproduct
lengthLängeproduct
manufacturer.idUUID des Herstellersproduct_manufacturer
manufacturer.versionIdUUID welche die Version des Herstellers angibt. product_manufacturer
manufacturer.linkWebseite des Herstellersproduct_manufacturer
manufacturer.nameName des Herstellersproduct_manufacturer_translation
manufacturer.descriptionBeschreibung des Herstellersproduct_manufacturer_translation
manufacturer.customFieldsHersteller Zusatzfelderproduct_manufacturer_translation
manufacturer.media.IdUUID 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.createdAtHersteller angelegtproduct_manufacturer
manufacturer.updatedAtHersteller aktualisiertproduct_manufacturer
manufacturerNumberProduktnummer des Herstellersproduct
markAsTopsellerProdukt hervorhebenproduct
maxPurchaseMaximal Abnahmeproduct
mediaURL aller Produktbilder ausgenommen dem Vorschaubild. wird generiert
minPurchaseMinimal Abnahmeproduct
optionIdsVariantenoptionenproduct_option
optionsVarianten Optionenproperty_group_option
parentFelder 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.netStandard netto Preis. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EUR
 
product
price.DEFAULT.grossStandard brutto Preis. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct
price.DEFAULT.currencyIdUUID der Währung. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURcurrency
price.DEFAULT.linkedAngabe, ob der Netto und Bruttopreis verknüpft sind. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct
price.DEFAULT.listPriceErweiterte Preise. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct
productNumberProduktnummerproduct
propertiesUUID der Eigenschaften getrennt durch ein Pipe-Symbol (|).property_group_option
purchasePriceEinkaufspreisproduct
purchaseStepsStaffelungproduct
purchaseUnitVerkaufseinheitproduct
ratingAvarageDurchschnittsbewertungproduct
referenceUnitGrundeinheitproduct
releaseDateErscheinungsdatumproduct
restockTimeWiederauffüllzeitproduct
shippingFreeVersandkostenfreiproduct
stockLagerbestandproduct
tagIdsProdukt Tagsproduct_tag
tagsUUID der Tags, getrennt durch ein Pipe-Symbol (|)product_tag
tax.IdUUID des Steuersatzestax
tax.taxRateProzentsatztax
tax.nameSteuernametax.translate
tax.customFieldZusatzfelder der Steuersätzecustom_field
tax.createdAtSteuersatz erstellttax
tax.updatedATSteuersatz aktualisierttax
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.nameproduct_translation
unit.IdUUID der Maßeinheitenunit
unit.shortCodeMaßeinheit Kürzelunit_translation
unit.nameMaßeinheit Nameunit_translation
unit.customFieldsMaßeinheit Zusatzfelderunit_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.createdAtMaßeinheit erstelltunit
unit.updatedAtMaßeinheit aktualisiertunit
variantRestrictionsAusschlüsse von Varianten aus dem Variantengeneratorproduct

variantListingConfig

Storefront-Darstellung bzw. Varianten Darstellungproduct_visibility
versionIdUUID welche die Version des Artikels angibt. product
visibilities.allUUID des Verkaufskanals, in dem der Artikel komplett verfügbar ist.product_visibility
visibilities.linkUUID des Verkaufskanals, in dem der Artikel versteckt ist und nur über den direkten Link erreichbar ist.product_visibility
visibilities.searchUUID des Verkaufskanals, in dem der Artikel nur über die Suche erreichbar ist.product_visibility
weightGewichtproduct
widthBreiteproduct
   

Objekttyp - "Kunde" 

Nur ein vollständiges Profil kann gespeichtert werden. Dieses beinhaltet mindestens die folgenden Pflichtfelder: id, defaultBillingAddressIddefaultShippingAddressId, 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.

DatenbankeintragBeschreibungDatenbank-Tabelle
activeAngabe, ob der Kunde aktiv istcustomer
affiliateCodePartner Codecustomer
autoincrementEinmalige Dezimalzahlcustomer
birthdayGeburtstagcustomer
campaignCodeKampagnen Codecustomer
companyFirmacustomer
createdAtWann wurde der Kunde erstelltcustomer
customFieldsKunden Zusatzfeldercustomer
customerNumberKundennummercustomer
defaultBillingAddress.idUUID der Rechnungsadressecustomer
defaultBillingAddress.firstNameVorname der Rechnungsadressecustomer_address
defaultBillingAddress.lastNameNachname der Rechnungsadressecustomer_address
defaultBillingAddress.zipcodePLZ der Rechnungsadresse customer_address
defaultBillingAddress.cityStadt der Rechnungsadressecustomer_address
defaultBillingAddress.companyFirma der Rechnungsadressecustomer_address
defaultBillingAddress.streetStraße der Rechnungsadressecustomer_address
defaultBillingAddress.departmentAbteilung der Rechnungsadressecustomer_address
defaultBillingAddress.titleTitel der Rechnungsadressecustomer_address
defaultBillingAddress.vatIdSteuer-IdNr. der Rechnungsadressecustomer_address
defaultBillingAddress.phoneNumberTelefonnummer der Rechnungsadressecustomer_address
defaultBillingAddress.additionalAddressLine1Adresszusatz 1 der Rechnungsadressecustomer_address
defaultBillingAddress.additionalAddressLine2Adresszusatz 2 der Rechnungsadressecustomer_address
defaultBillingAddress.customFieldsZusatzfelder der Rechnungsadressecustomer_address
defaultBillingAddress.customerKunden-Felder der Rechnungsadresse. Hinter customer kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer, customer_address
defaultBillingAddress.countryLand-Felder der Rechnungsaddresse. Hinter country kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer_address, country, country_translation
defaultBillingAddress.countryStateBundesland-Felder der Rechnungsadresse. Hinter countryState kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer_address, country_state, country_state_translation
defaultBillingAddress.salutationAnrede-Felder der Rechnungsadresse. Hinter salutation kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer_address, salutation, salutation_translation
defaultBillingAddress.createdAtWann wurde die Rechnungsadresse angelegtcustomer_address
defaultBillingAddress.updatedAtWann wurde die Rechnungsadresse aktualisiertcustomer_address
defaultPaymentMethod.idUUID der Standardzahlungsartcustomer
defaultPaymentMethod.pluginIDUUID des Plugins der Standardzahlungsartpayment_method
defaultPaymentMethod.handleridentifierSpeicherort des PaymentHandlerpayment_method
defaultPaymentMethod.nameName der Standardzahlungsartpayment_method
defaultPaymentMethod.descriptionBeschreibung der Standardzahlungsartpayment_method
defaultPaymentMethod.positionPosition der Standardzahlungsartpayment_method
defaultPaymentMethod.activeAngabe ob die Standardzahlungsart aktiv ist.payment_method
defaultPaymentMethod.customFieldsZusatzfelder der Standardzahlungsartpayment_method_translation
defaultPaymentMethod.formattedHandlerIdentifierVerkürzte Form des HandlerIdentifierpayment_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.mediaFelder des Zahlungsart Logos. Hinter media kann ein Punkt gesetzt und so auf weitere Felder innerhalb von media zugegriffen werden.payment_method, media
defaultPaymentMethod.availabilityRuleFelder der Zahlungsart-Verfügbarkeitsregel. Hinter availabilityRule kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.payment_method, rule
defaultPaymentMethod.pluginFelder des Zahlungsart-Plugins. Hinter plugin kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.payment_method, plugin
defaultPaymentMethod.salesChannelsVerkaufskanäle, in welchen die Standardzahlungsart hinterlegt ist, getrennt durch ein "Pipe" Symbol (|)payment_method
defaultPaymentMethod.createdAtWann wurde die Standardzahlungsart angelegt?payment_method
defaultPaymentMethod.updatedAtWann wurde die Standardzahlungsart aktualisiert? payment_method
defaultShippingAddress.idUUID der Lieferadressecustomer
defaultShippingAddress.firstNameVorname der Lieferadressecustomer_address
defaultShippingAddress.lastNameNachname der Lieferadressecustomer_address
defaultShippingAddress.zipcodePLZ der Lieferadresse customer_address
defaultShippingAddress.cityStadt der Lieferadressecustomer_address
defaultShippingAddress.companyFirma der Lieferadressecustomer_address
defaultShippingAddress.streetStraße der Lieferadressecustomer_address
defaultShippingAddress.departmentAbteilung der Lieferadressecustomer_address
defaultShippingAddress.titleTitel der Lieferadressecustomer_address
defaultShippingAddress.vatIdSteuer-IdNr. der Lieferadressecustomer_address
defaultShippingAddress.phoneNumberTelefonnummer der Lieferadressecustomer_address
defaultShippingAddress.additionalAddressLine1Adresszusatz 1 der Lieferadressecustomer_address
defaultShippingAddress.additionalAddressLine2Adresszusatz 2 der Lieferadressecustomer_address
defaultShippingAddress.customFieldsZusatzfelder der Lieferadressecustomer_address
defaultShippingAddress.customerKunden-Felder der Lieferadresse. Hinter customer kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer, customer_address
defaultShippingAddress.countryLand-Felder der Lieferadresse. Hinter country kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer_address, country, country_translation
defaultShippingAddress.countryStateBundesland-Felder der Lieferadresse. Hinter countryState kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer_address, country_state, country_state_translation
defaultShippingAddress.salutationAnrede-Felder der Lieferadresse. Hinter salutation kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer_address, salutation, salutation_translation
defaultShippingAddress.createdAtWann wurde die Lieferadresse angelegtcustomer_address
defaultShippingAddress.updatedAtWann wurde die Lieferadresse aktualisiertcustomer_address
doubleOptInConfirmDateWann wurde die doubleOptIn-Mail bestätigt? customer
doubleOptInEmailSendDateWann wurde die doubleOptIn-Mail versendet? customer
doubleOptInRegistrationWar bei der Registrierung doubleOptIn-Registrierung aktiv?customer
emailE-Mailcustomer
firstLoginErster Login des Kundencustomer
firstNameVornamecustomer
group.idUUID der Kundengruppecustomer
group.nameName der Kundengruppecustomer_group
group.displayGrossSteuerdarstellung der Kundengruppecustomer_group
group.customFieldsKundengruppen Zusatzfeldercustomer_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.createdAtWann wurde die Kundengruppe angelegt?customer_group
group.updatedAtWann wurde die Kundengruppe aktualisiert?customer_group
guestHandelt es sich um einen Gastbesteller?customer
hashHashwert, welcher für die doubleOptIn Bestätigungs Mail verwendet wird.customer
IdUUID des Kunden.
Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.
customer
language.idUUID der Sprachecustomer
language.nameName der Sprachelanguage
language.customFieldsSprache Zusatzfelderlanguage
language.parentUUID der Sprache, von der geerbt wird. language
language.localeFelder der Lokalisierung der Sprache. Hinter locale kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.language, locale, locale_translation
language.translationCodeFelder des ISO-Codes der Sprache. Hinter translationCode kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.language, locale, locale_translation
language.salesChannelsUUID der Verkaufskanäle, in denen die Sprache verwendet wird.language
language.createdAtWann wurde die Sprache erstelltlanguage
language.updatedAtWann wurde die Sprache aktualisiertlanguage
lastLoginLetzter Login des Kundencustomer
lastNameNachnamecustomer
lastOrderDateDatum der letzten Bestellungcustomer
lastPaymentMethodsFelder der letzten Zahlungsart. Hinter lastPaymentMethods kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.customer, payment_methods, payment_methods_translation
legacyEncoderEncoder um Systemfremdes Passwort zu entschlüsselncustomer
legacyPasswortSystemfremdes, verschlüsseltes Passwort bspw. nach einer Migrationcustomer
newsletterHat der Kunde den Newsletter aktiviert?customer
orderCountAnzahl der Bestellungencustomer
passwordVerschlüsselter Hashwert des Passwortescustomer
remoteAddressIP Adresse des Kundencustomer
salesChannel.idUUID 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.currencyFelder zur Standardwährung des Verkaufskanals. Hinter currency kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.sales_channel, currency, currency_translation
salesChannel.paymentmethodFelder 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.shippingMethodFelder 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.countryFelder zum Standardland des Verkaufskanals. Hinter country kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.sales_channel, country, country_translation
salesChannel.navigationCategoryFelder 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.navigationCategoryDepthHauptnavigations-Ebenensales_channel
salesChannel.footerCategoryFelder 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.serviceCategoryFelder 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.mailHeaderFooterFelder 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.nameName des Verkaufskanalssales_channel
salesChannel.shortNameKürzel des Verkaufskanalssales_channel
salesChannel.accessKeyAPI-Zugangsales_channel
salesChannel.configurationConfig Einträge für den Verkaufskanalsales_channel
salesChannel.activeAngabe, ob der Verkaufskanal aktiv istsales_channel
salesChannel.maintenanceWartungsmodussales_channel
salesChannel.maintenanceWhiteListWhitelist für den Wartungsmodussales_channel
salesChannel.customFieldsVerkaufskanal Zusatzfeldersales_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.currenciesWährungen des Verkaufskanalssales_channel_currency
salesChannel.languagesSprachen des Verkaufskanalssales_channel_language
salesChannel.countriesLänder des Verkaufskanalssales_channel_country
salesChannel.paymentMethodsZahlungsarten des Verkaufskanalssales_channel_payment_method
salesChannel.shippingMethodsVersandarten des Verkaufskanalssales_channel_shippingMethod
salesChannel.createdAtWann wurde der Verkaufskanal angelegtsales_channel
salesChannel.updatedAtWann wurde der Verkaufskanal aktualisiertsales_channel
salesChannel.themesWelches Theme ist dem Verkaufskanal zugeordnettheme_sales_channel
salutation.idUUID der Anredesalutation
salutation.salutationKeyTechnischer Name der Anredesalutation
salutation.displayNameName der Anredesalutation_translation
salutation.letterNameBriefanredesalutation_translation
salutation.translationsÜbersetzungen der Anrede Felder. Hinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.salutation, salutation_translation
salutation.createdAtWann wurde die Anrede erstelltsalutation
salutation.updatetAtWann wurde die Anrede aktualisiertsalutation
tagsKunden Tagscustomer_tag
titleTitelcustomer
updatedAtWann wurde der Kunde aktualisiertcustomer

Objekttyp - "Kategorien"

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

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

DatenbankeintragBeschreibungDatenbank-Tabelle
activeAngabe, ob die Kategorie aktiv istcategory
afterCategoryIdUUID der Kategorie vor dieser Kategoriecategory
afterCategoryVersionIDVersion der Kategorie vor dieser Kategoriecategory
autoincrementEinmalige Dezimalzahlcategory
childCountAnzahl der Unterkategoriencategory
cmsPage.idUUID der hinterlegten Erlebnisweltcategory
cmsPage.nameName der hinterlegten Erlebnisweltcms_page_translation
cmsPage.typeLayout Typ der hinterlegten Erlebnisweltcms_page
cmsPage.customFieldsErlebniswelt Zusatzfeldercms_page_translation
cmsPage.lockedErlebniswelt darf nicht bearbeitet werden. cms_page
cmsPage.translationsHinter translations kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.cms_page, cms_page_translation
cmsPage.previewMediaFelder zum Vorschaubild der Erlebniswelt. Hinter previewMedia kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.cms_page, media
cmsPage.createdAtWann wurde die Erlebniswelt erstelltcms_page
cmsPage.updatedAtWann wurde die Erlebniswelt aktualisiertcms_page
idUUID der Kategorie.
Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.
category
levelKategorie-Ebenecategory
mediaFelder des Anzeigebild der Kategorie. Hinter media kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.category, media
parentFelder der Elternkategorie. Hinter parent kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.category, category_translation, media
pathPfad zur Kategoriecategory
productsUUID der in der Kategorie hinterlegten Produkte, getrennt durch fein "Pipe" Symbol (|)product_category
tagsKategorie Tagscategory_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.namecategory, category_translation
typeKategorietypcategory
versionIdUUID welche die Version der Kategorie angibt. category
visibleIn der Navigation ausblendencategory

Objekttyp - "Bestellungen"

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

DatenbankeintragBeschreibungDatenbank-Tabelle
affiliateCodePartner Codeorders
amountNetNetto Betragorders
amountTotalGesamtbetragorders
autoIncrementEinmalige Dezimalzahlorders
billingAddress.additionalAddressLine1Adresszusatz 1 der Rechnungsadresseorder_address
billingAddress.additionalAddressLine2Adresszusatz 2 der Rechnungsadresseorder_address
billingAddress.cityStadt der Rechnungsadresseorder_address
billingAddress.companyFirmaorder_address
billingAddress.countryLandorder_adress
billingAddress.country.activeAngabe, ob das Rechnungsland aktiv istcountry
billingAddress.country.checkVatIdPatternUmsatzsteuer Prüfungcountry
billingAddress.country.companyTaxAngaben zur Umsatzsteuer: Betrag; Aktivierung; Währung IDcountry
billingAddress.country.companyTaxFreeAngabe, ob die Firma im Land steuerfrei istcountry
billingAddress.country.customerTaxAngaben zur Umsatzsteuer: Betrag; Aktivierung; Währung IDcountry
billingAddress.country.displayStateInRegistrationRegion wird in der Registrierung angezeigtcountry
billingAddress.country.forceStateInRegistrationRegion ist Pflichtfeldcountry
billingAddress.country.idID des Rechnungslandesorder_address
country
billingAddress.country.isoISO-Code des Rechnungslandescountry
billingAddress.country.iso3ISO 3-Code des Rechnungslandescountry
billingAddress.country.positionAngabe des Positioncountry
billingAddress.country.salesChannelsID des Verkaufkanalssales_channel_id
billingAddress.country.shippingAvailableAngabe, ob das Land für den Versand verfügbar istcountry
billingAddress.country.taxFreeSteuerfreicountry
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.vatIdRequiredAngabe, ob die Umsatzsteuer erforderlich istcountry
billingAddress.countryIdID des Rechnungslandesorder_adress
billingAddress.countryState.activeAngabe, ob die Region aktiv istcountry_state
billingAddress.countryState.shortCodeShortcode des Landescountry_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.countryStateIdID der Regionorder_adress
country_state
billingAddress.createdAtWann wurde die Adresse angelegtorder_adress
billingAddress.customFieldsAdresse Zusatzfelderorder_adress
billingAddress.departmentAbteilungorder_adress
billingAddress.firstNameVornameorder_adress
billingAddress.idUUID der Adresseorder_adress
billingAddress.lastNameNachnameorder_adress
billingAddress.order.affiliateCodePartner Codeorder
billingAddress.order.amountNetNettobetragorder
billingAddress.order.amountTotalGesamtbetragorder
billingAddress.order.autoIncrementEinmalige Dezimalzahlorder
billingAddress.order.billingAddressIdID der Rechnungsadresse der Bestellungorder
billingAddress.order.billingAddressVersionIdUUID, welche die Version der Rechnungsadresse der Bestellung angibtorder
billingAddress.order.campaignCodeKampagnen Code der Bestellungorder
billingAddressIdUUID der Rechnungsadresseorder
billingAddressVersionIdUUID, welche die Version der Rechnungsadresse angibtorder
campaignCodeKampagnen Codeorder
createdAtWann wurde die Bestellung angelegtorder
createdBy.

bsp.
createdBy.admin
createdBy.firstName
erstellt durchorder
currency.translatedÜbersetzungcurrency_translation
currency.factorWährungsfaktorcurrency
currency.idID der Währungorder
currency.isSystemDefaultStandardwährungsales_channel_
currency.isoCodeISO-Codecurrency
currency.itemRoundingRundung der Nachkommastellecurrency
currency.positionAngabe der Positioncurrency
currency.salesChannelsVerkaufskanal, in der die Währung verwendet wirdsales_channel_currency
currency.symbolSymbol der Währungcurrency
currency.taxFreeFromSteuerfreicurrency
currency.translated

e.g.
currency.translations.de-DE.createdAt
currency.translations.en-GB.createdAt
Übersetzungen 
currencyFactorWährungsfaktororder
currencyIdWährung IDcurrency
order
customFieldsZusatzfelderorder
customerCommentKundenkommentarorder
deepLinkCodeCode für einen Deeplinkorder
deliveries.createdAterstellt amorder_delivery
deliveries.customFieldsZusatzfelderorder_delivery
deliveries.idIDorder_delivery
deliveries.orderBestellungorder_delivery
deliveries.orderIdID der Bestellungorder_delivery
deliveries.orderVersionIdUUID, welche die Version der Bestellung angibtorder_delivery
deliveries.positionsVersand Positionenorder_delivery_position
deliveries.shippingCostsVersandkostenorder_delivery
deliveries.shippingDateEarliestVersand frühstens amorder_delivery
deliveries.shippingDateLatestVersand spätestens amorder_delivery
deliveries.shippingMethodVersand Methodeorder_delivery
deliveries.shippingMethodIdVersand Methode IDorder_delivery
deliveries.shippingOrderAddressVersand Addresseoder_delivery
deliveries.shippingOrderAddressIdVersand Addresse IDorder_delivery
deliveries.stateIdID der Regionorder_delivery
deliveries.stateMachineState.Bestellstatusstate_machine_state
deliveries.trackingCodesPartner Codeorder_delivery
deliveries.updatedAtAktualisiert amorder_delivery
deliveries.versionIdVersion IDorder_delivery
idIDorder
itemRoundingRundung für Nachkommastellecurrency
language.

bsp.
language.id
language.locale
Diverse Sprachinformationen 
languageIdUUID der Spracheorder
lineItems order_line_item
orderCustomer.companyFirmaorder_customer
createdBy.recoveryUser.user.aclRoles user_recovery

Objekttyp - "Medien"

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

DatenbankeintragBeschreibungDatenbank-Tabelle
avatarUserFelder zu dem Benutzer, welchem dieses Bild als Avatar zugeordnet ist. Hinter avatarUser kann ein Punkt gesetzt  und so auf weitere Felder zugegriffen werdenmedia
fileExtensionDateiendungmedia
fileNameDateinamemedia
fileSizeDateigrößemedia
idUUID der Media Datei.
Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.
media
mediaFolder.childCountAnzahl der Unterordnermedia_folder
mediaFolder.configuration.createThumbnailsThumbnails für diesen Ordner generierenmedia_folder_configuration
mediaFolder.configuration.createdAtWann wurden die Ordnereinstellungen erstellt. media_folder_configuration
mediaFolder.configuration.customFieldsZusatzfelder zu den Ordnereinstellungenmedia_folder_configuration
mediaFolder.configuration.idUUID der Konfigurationmedia_folder
mediaFolder.configuration.keepAspectRationSeitenverhältnis beibehaltenmedia_folder_configuration
mediaFolder.configuration.mediaThumbnailSizesThumbnail-Größemedia_folder_configuration
mediaFolder.configuration.thumbnailQualityThumbnail-Qualitätmedia_folder_configuration
mediaFolder.configuration.updatedAtWann wurden die Ordnereinstellungen aktualisiertmedia_folder_configuration
mediaFolder.createdAtWann wurde der Ordner angelegtmedia_folder
mediaFolder.customFieldsMedienordner Zusatzfeldermedia_folder
mediaFolder.defaultFolderFelder zum Standardspeicherort. Hinter defaultFolder kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.media_folder, media_default_folder
mediaFolder.idUUID des Ordners, in welchem die Mediadatei liegtmedia
mediaFolder.nameName des Ordnersmedia_folder
mediaFolder.parentFelder zum Ordner oberhalb dieses Ordners. Hinter parent kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.media_folder
mediaFolder.updatedAtWann wurde der Ordner aktualisiertmedia_folder
mediaFolder.useParentConfigurationEinstellungen vom überliegenden Ordner übernehmenmedia_folder
mediaTpeMedien Typmedia
metaDataMeta Daten der Mediamedia
mimeTypeInternet Media Typemedia
tagsMedien Tagsmedia_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 
uploadedAtWann wurde die Media Datei hochgeladenmedia
urlURL zur Media Dateiwird 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

Objekttyp - "Newsletter-Empfänger"

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

DatenbankeintragBeschreibungDatenbank-Tabelle
cityStadt des Newsletter-Empfängersnewsletter_recipient
confirmedAtWann wurde der Newsletter-Empfänger bestätigtnewsletter_recipient
createdAtWann wurde der Newsletter-Empfänger angelegtnewsletter_recipient
customFieldsZusatzfelder der Newsletter-Empfängernewsletter_recipient
emailE-Mail des Newsletter-Empfängernewsletter_recipient
firstNameVorname des Newsletter-Empfängernewsletter_recipient
hashHashwert zur Bestätigung des Newsletter Empfängersnewsletter_recipient
idUUID des Newsletter-Empfängersnewsletter_recipient
languageFelder der Sprache des Newsletter-Empfängers. Hinter language kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.newsletter_recipient, language, 
salesChannelFelder 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
salutationFelder der Anrede des Newsletter-Empfänger angemeldet ist. Hinter salutation kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.newsletter_recipient, salutation
statusStatus des Newsletter-Empfängersnewsletter_recipient
streetStraße des Newsletter-Empfängersnewsletter_recipient
tagsTags des Newsletter-Empfängersnewsletter_recipient_tag
titleTitel des Newsletter-Empfängersnewsletter_recipient
updatedAtWann wurde der Newsletter Empfänger aktualisiertnewsletter_recipient
zipCodePLZ des Newsletter-Empfängersnewsletter_recipient

Objekttyp - "Eigenschaften"

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

DatebankeintragBeschreibungDatenbank-Tabelle
colorHexCodeFarbcode der in der Eigenschaft hinterlegten Farbe.property_group_option
group.displayTypeDarstellung der Ausprägungsauswahlproperty_group
group.idUUID der Eigenschaftsgruppeproperty_group
group.sortingTypeSortierung der Eigenschaftsgruppeproperty_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.descriptionproperty_group_translations
idUUID der Eigenschaften-Ausprägungproperty_group_option
mediaFelder des Standardbildes der Eigenschaften-Ausprägung. Hinter media kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.property_group_option,
media
productOptionsUUID der Varianten, die diese Eigenschafts-Ausprägung nutzenproduct_option
productPropertiesUUID 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.nameproperty_group_option_translation

Objekttyp - "Erweiterte Preise"

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

DatebankeintragBeschreibungDatenbank-Tabelle
createdAtWann wurde der erweiterte Preis angelegtproduct_price
idEinmalige 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.grossproduct_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.idproduct
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.grossproduct
quantityEndMaximale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.product_price
quantityStartMinimale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.product_price
ruleIdEindeutige 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.namerule

Objekttyp - "Variantenkonfiguration"

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

DatebankeintragBeschreibungDatenbank-Tabelle
createdAtWann wurde die Variantenkonfiguration angelegtproduct_configurator_setting
customFieldsVariantenkonfiguration Zusatzfelderproduct_configurator_setting
idUUID der Variantenkonfigurationproduct_configurator_setting
mediaMedien Felder der Eigenschaftenbilder aus der Storefront Darstellungproduct_configurator_setting
option.idUUID der Eigenschaften-Ausprägungproperty_group_option
option.groupFelder 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.IdUUID der Eigenschaften-Ausprägungproperty_group_option
option.mediaFelder des Bildes der Eigenschaften-Ausprägung.
Hinter media kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.
property_group_option, media
option.productOptionsUUID der Varianten, die diese Option nutzenproduct_option
option.propertiesUUID 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.nameproperty_group_option_translation
positionPosition in der Storefront-Darstellungproduct_configurator_setting
price.DEFAULT.netNetto Aufschlag. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct_configurator_setting
price.DEFAULT.grossBrutto Aufschlag. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct_configurator_setting
price.DEFAULT.currencyIdUUID der Währung. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct_configurator_Setting, currency
price.DEFAULT.linkedAngabe, ob der Nett und Bruttopreis verknüpft sind. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct_configurator_setting
price.DEFAULT.listPriceErweiterte Preise. DEFAULT kann durch die jeweilige Währung ersetzt werden. Bsp. EURproduct_configurator_setting
productFelder des Produktes, dem die Variantenkonfiguration zugewiesen ist. product_configurator_setting
updatedAtWann wurde die Variantenkonfiguration aktualisiertproduct_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.

DatebankeintragBeschreibungDatenbank-Tabelle
active product_cross_selling
assignedProductsProdukt ID des zugewiesenes Produktproduct_cross_selling_assigned_products
idID der Produktempfehlung.
Bei der Neuanlage wird die ID vom System erzeugt. Daher sollte die Spalte bei der Neuanlage leer bleiben.
product_cross_selling
limitMaximale Anzahl der Produkteproduct_cross_selling
positionZahlenwert zur Reihenfolgeproduct_cross_selling
product.activeAngabe, ob das Produkt aktiv istproduct
product.autoIncrementEinmalige Dezimalzahlproduct
product.availableAngabe, ob das Produkt verfügbar istproduct
product.availableStockVerfügbarer Lagerbestandproduct
product.canonicalProduct.

diverse Optionen
Hinter canonicalProduct kann ein Punkt gesetzt und so auf weitere Felder zugegriffen werden.product
product.canonicalProductId product
product.categoriesUUID der Kategorieproduct
product.categoriesRo  
product.categoryIdsID der Kategorieproduct
product.categoryTreeIDs der Kategorienproduct
product.cheapestPriceGünstigster Preisproduct
product.childCountAnzahl der Variantenproduct
product.cmsPage.translations.DEFAULT

e.g.
product.cmsPage.translations.de-DE.cmsPage
product.cmsPage.translations.en-GB.cmsPage
Standard Übersetzungcms_page_translation
product.cmsPage.configKonfigurationcms_page
product.cmsPage.entityElementcms_page
product.cmsPage.idIDproduct
product.cmsPage.lockedSperrungcms_page
productProduktproduct
updatedAtWann wurde die Variantenkonfiguration aktualisiertproduct_configurator_setting

Objekttyp - "Promotions"

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

DatebankeintragBeschreibungDatenbank-Tabelle
activeGibt an ob die Promotion aktiv istpromotion
codeDer Aktivierungscode für die Rabattaktionpromotion
use.codesGibt an ob ein Aktivierungscode verwendet wirdpromotion
idID der des Rabatts der Promotionpromotion_discount
promotion.idID der Promotionpromotion, promotion_discount
scopeDefiniert den Bereich wo der Rabatt angewendet wirdpromotion_discount
typeBestimmt die Art des Rabattabzugspromotion_discount
valueWert des Rabattspromotion_discount
consider.advanced.rulesGibt an ob erweiterte Regeln in der Rabattaktion enthaltren sindpromotion_discount
max.valueGibt den Höchstwert des Rabatts an der gewährt wirdpromotion_discount
discount.rulesGibt an ob im Rabatt Regeln hinterlegt sindpromotion_discount
applier.keyGibt an wieviele Artikel den Rabatt erhaltenpromotion_discount
sorter.keyGibt an ob der Preis auftseigen oder absteigend sortiert wirdpromotion_discount
valid.fromAb wann ist die Promotion aktivpromotion
valid.untilBis wann die Promotion aktiv istpromotion

Objekttyp - "Aktionscodes"

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

DatebankeintragBeschreibungDatenbank-Tabelle
promotion.activeAktivpromotion
promotion.cartRulesWarenkorb-Regelnpromotion_cart_rule
promotion.codeCodepromotion
promotion.customerRestrictionBeschränkung auf Kundenpromotion
promotion.exclusionIdsUUIDpromotion
promotion.idUUIDpromotion
promotion.individualCodePatternMuster der generierten Codespromotion
promotion.maxRedemptionsGlobalZahlenwert; maximale Anzahl an Einlösungen der Aktionpromotion
promotion.maxRedemptionsPerCustomerZahlenwert; maximale Anzahl an Einlösungen der Aktion pro Kundepromotion
promotion.orderCountAnzahl Bestellungenpromotion
promotion.orderRulesBestellungs-Regelnpromotion_order_rule
promotion.personaCustomersAngaben zur Promotion ID & Kunden IDpromotion_persona_customer
promotion.personaRulesAngaben zur Promotion ID & Rule IDpromotion_persona_rule
promotion.perventCombinatonVerhindert die Kombination mit anderen Aktionenpromotion
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.namepromotion_translation
codeCodepromotion
createdAtErstellt ampromotion
idUUIDpromotion
payloadAngaben zur Order ID, Kunden ID und Kundennamepromotion_individual_code
promotionIdUUID der Aktionpromotion_individual_code
updatedAtGeändert ampromotion

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: 
 

idEindeutige UUID des Produktes. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
parent_idEindeutige UUID des Elternproduktes, falls es sich um ein Variantenartikel handelt. Auch dieses Feld kann leer bleiben. 
product_numberProduktnummer
active1 für aktiv und 0 für inaktiv.
stockaktueller Lagerbestand
nameName des Produktes
descriptionBeschreibung
price_netNettopreis
price_grossBruttopreis
tax_idTrage 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_rateWert des Steuersatz (bsp. 7 oder 19)
tax_nameName des Steuersatzes (bsp. 7% oder 19%)
cover_media_idWenn 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_urlURL 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_titleDer Titel, unter dem das importierte Vorschaubild intern abgespeichert werden soll. 
cover_media_altAlt-Text des Vorschaubildes
manufacturer_idWenn 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_nameWenn Du einen neuen Hersteller anlegen möchtest, trage hier den Namen den neuen Herstellers ein. 
categoriesTrage 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_channelsTrage 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. 

Import von Newsletter-Empfänger

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. 

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

idEindeutige UUID der Eigenschaftsausprägung Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
color_hex_codeFarbcode der in der Eigenschaft hinterlegten Farbe
nameName der Eigenschaft
positionJede Eigenschaft hat eine Position, mit welcher sie im Admin angezeigt wird. 
group_idEindeutige UUID der Eigenschaftsgruppe. 
group_display_typeDarstellung der Ausprägungsauswahl
group_sorting_typeSortierung der Ausprägungsauswahl. Hier kannst Du "alphanumeric", "numeric" und "position" angeben. 
group_nameName der Eigenschaftsgruppe
group_descriptionBeschreibung der Eigenschaftsgruppe (Optional)
group_positionPosition der Eigenschaftsgruppe (Optional)
media_idWenn 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_idOptional 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_typeDieses Feld enthält beim Export Eigenschaften des verwendeten Bildes. Für den Import kann dies aber leer gelassen werden.
media_titleWenn Du ein Bild importieren möchtest, trage hier den Titel des Bildes ein. Alternativ kannst Du das Feld auch leer lassen. 
medie_altWenn 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: 

idEindeutige 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_idEindeutige UUID des Produktes, für den der erweiterte Preis eingerichtet wurde. 
rule_idEindeutige UUID der Regel die für diesen erweiterten Preis angewendet wird. 
price_netNetto Preis des erweiterten Preises
price_grossBrutto Preis des erweiterten Preises
quantity_startMinimale Menge des Produktes, die im Warenkorb liegen muss, damit dieser Preis gilt.
quantity_endMaximale 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. 

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

idEindeutige UUID der Kategorie. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
parent_idEindeutige 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.
active1 für aktiv und 0 für inaktiv.
typeTrage hier den Kategorietyp ein. Page für eine normale Kategorie, folder für eine Strukturkategorie und link für den Kategorietyp Benutzerdefinierter Link. 
visibleTrage hier ein, ob die Kategorie in der Navigation ausgeblendet wird. 1 für sichtbar und 0 für ausgeblendet. 
nameName der Kategorie
external_linkTrage hier den externen Link ein, falls Du als Typ link gewählt hast. 
descriptionBeschreibung der Kategorie (optional)
meta_titleSEO Meta Titel (Optional)
meta_descriptionSEO Meta Beschreibung (Optional)
media_idWenn 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_urlURL zu dem Bild, welches Du als Vorschaubild verwenden möchtest.
media_folder_idOptional 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_typeDieses Feld enthält beim Export Eigenschaften des verwendeten Bildes. Für den Import kann dies aber leer gelassen werden.
media_titleWenn Du ein Bild importieren möchtest, trage hier den Titel des Bildes ein. Alternativ kannst Du das Feld auch leer lassen.
mediea_altWenn 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_idUUID 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. 

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

idEindeutige UUID der Medien Datei. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.
folder_idHier 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.
urlTrage hier die URL des Mediums an, welches Du importieren möchtest. Dies kann auch eine externe URL außerhalb der Shopware Installation sein. 
privateDieses Feld wird ggf. für Plugins verwendet. Für den Standard Import verwende hier "0". 
typeIn diesem Feld werden die Metadaten des Mediums für den Export hinterlegt. Für den Import kannst Du dieses Feld leer lassen. 
titleTitel des Bildes
altAlternative 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. 

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

idEindeutige UUID der Kunden Datei. Dieses Feld kann leer bleiben und wird im Rahmen des Imports automatisch vergeben.  
account_typeHier kannst Du den Account Tyoen des Kunden angeben. In der Beispiel CSV ist dies auf private, da es ein Privatkunde ist.  
salutationTrage hier die Anrede des Kunden ein.   
customer_numberDieses Feld wird für die Kundennummer genutzt.  
first_nameIn diesem Feld wird der Vorname des Kunden eingetragen.  
last_nameIn diesem Feld wird der Nachname des Kunden eingetragen.  
emailE-Mail Adresse des Kunden.  
guestHier muss ein Boolwert eingetragen werden. 0 wenn es sich nicht um einen Gastbesteller handelt und 1 wenn es sich um einen Gastbesteller handelt  
customer_groupDefiniert die Kundengruppe  
languageDefiniert die Sprache des Kunden  
sales_channelGibt an, aus welchem Verkaufskanal die Bestellung getätigt wurde.  
payment_methodZahlungsart  
billing_idRechnungs ID  
billing_salutationAndrede in der Rechnung  
billing_titleTItel der Rechnung  
billing_first_nameVorname des Rechnungsträgers  
billing_last_nameNachname des Rechnungsträgers  
billing_companyFirma des Rechnungsträgers  
billing_streetStraße der Rechnungsadresse  
billing_zipcodePostleitzahl der Rechnungsadresse  
billing_cityStadt der Rechnungsadresse  
billing_countryRechnungsland  
billing_phone_numberTelefonnummer des Rechnungsträgers  
shipping_idVersand ID  
shipping_salutationAnrede für den Versand  
shipping_titleTitel/Name der Versandart  
shipping_first_nameVorname für die Versandadresse  
shipping_last_nameNachname für die Versandadresse  
shipping_companyFirma des Versandträgers  
shipping_streetStraße der Versandadresse  
shipping_zipcodePostleitzahl der Versandadresse  
shipping_cityStadt der Versandadresse  
shipping_countryVersandland  
shipping_phone_numberTelefonnummer 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. 

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/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

FeldnameBeschreibung
translations.DEFAULT.productIdid des Produkts
translations.DEFAULT.languageIdid 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.

War dieser Artikel hilfreich?