Shopware 6

Alle Schlüssel dieser Seite stehen in der config.json im Abschnitt sw6. Was der Artikelexport im Regelfall überträgt, steht im Handbuch für Shopware 6.

Artikeltexte und Bezeichnungen

Schlüssel Typ Wirkung
titleField Feldname Extrafeld, dessen Inhalt als Produktname übertragen wird — statt der Artikelbezeichnung.
descriptionField Feldname Extrafeld, dessen Inhalt als Beschreibung übertragen wird — statt des Artikeltexts. Zeilenumbrüche werden zu <br>.
disableDescription Schalter überträgt keine Beschreibung. Vorhandene Texte im Shop bleiben unangetastet.
disableManufacturerDescription Schalter überträgt keine Beschreibung zum Hersteller.
customSearchKeywordsField Feldname Artikelfeld, aus dessen Inhalt die Suchworte des Produkts gebildet werden.
zusatzInTitleSeparator Wert Trennzeichen zwischen Bezeichnung und Zusatz, Vorgabe " - ". Wirkt nur, wenn Zusatz im Titel eingeschaltet ist.

disableDescription ist der übliche Weg, wenn die Beschreibungen im Shop redaktionell gepflegt werden. Ohne diesen Schalter überschreibt jeder Artikelexport den Text im Shop mit dem Artikeltext aus der SelectLine — die redaktionelle Arbeit wäre beim nächsten Lauf weg.

titleField und descriptionField lesen Extrafelder über die SelectLine-API, customSearchKeywordsField liest eine Spalte der Tabelle ART direkt per SQL. Für customSearchKeywordsField ist deshalb der Spaltenname anzugeben, für die anderen beiden der Name des Extrafelds.

Preise, Grundpreise und Datumsfelder

Schlüssel Typ Wirkung
disableSafeguardPriceField Feldname Artikelfeld; ist es True, wird ein Artikel ohne Preis mit Preis 0 übertragen, statt übersprungen zu werden.
grundpreisMengumField Feldname Feld in den Mengeneinheiten (MENGUM); die so markierte Mengeneinheit liefert Grundpreis-Einheit und Faktor.
grundpreisReferenceField Feldname Artikelfeld mit der Bezugsmenge des Grundpreises. Vorgabe FreierText2.
grundpreisUnitField Feldname Artikelfeld mit der Einheit des Grundpreises. Vorgabe FreieZahl3.
releaseDateField Feldname Extrafeld, dessen Datum als Erscheinungsdatum übertragen wird. Ohne die Angabe gilt das Anlagedatum des Artikels.
restockTimeField Feldname Extrafeld mit der Wiederauffüllzeit in Tagen.

Die drei grundpreis-Schlüssel wirken nur, wenn der Grundpreis-Export überhaupt eingeschaltet ist. Ist grundpreisMengumField gesetzt, hat es Vorrang; erst ohne dieses Feld werden die beiden Artikelfelder gelesen. Die Vorgaben FreierText2 und FreieZahl3 greifen also auch dann, wenn nichts eingetragen ist — was zu Grundpreisen aus einem Feld führen kann, das für etwas anderes genutzt wird.

Ohne disableSafeguardPriceField übergeht FINN.ghost Artikel ohne gültigen Preis absichtlich und schreibt eine Meldung ins Protokoll. Der Schalter ist für Artikel gedacht, die im Shop bewusst mit 0 stehen sollen — er sollte nicht dazu dienen, fehlende Preise zu verdecken.

Zusatzfelder umbenennen

Schlüssel Typ Wirkung
extrafeldMapping Liste benennt Zusatzfelder beim Übertragen um.
extrafeldMappingDelete Schalter Vorgabe true: das Ursprungsfeld wird nach dem Umbenennen entfernt. Mit false bleiben beide Felder erhalten.
{
  "sw6": {
    "extrafeldMapping": [
      { "old": "custom_sl_artikel_FreierText1", "new": "custom_meine_farbe" }
    ],
    "extrafeldMappingDelete": false
  }
}

Die Umbenennung greift auch in den Übersetzungen, sofern Sprachen eingerichtet sind. Das Zielfeld muss in Shopware als Zusatzfeld existieren — angelegt wird es dabei nicht.

Artikelgruppen und Kategorien

Schlüssel Typ Wirkung
shopaktivArtikelGruppenFeld Feldname Feld an der Artikelgruppe; nur Gruppen mit True werden als Kategorie übertragen.
artikelgruppenNichtAktualisieren Schalter bestehende Kategorien werden nicht mehr aktualisiert. Neue werden weiter angelegt.

artikelgruppenNichtAktualisieren ist für Shops gedacht, deren Kategoriebaum in Shopware weitergepflegt wird — mit eigenen Bezeichnungen, eigener Sortierung oder eigener Einordnung. Ohne den Schalter zieht jeder Lauf die Kategorien wieder auf den Stand der SelectLine.

Varianten und Bilder

Schlüssel Typ Wirkung
auffaechernDefault Schalter alle Variantenartikel werden in der Storefront aufgefächert, unabhängig vom dafür eingerichteten Artikelfeld.
useHashAsFilename Schalter Bilddateien werden unter einem Prüfsummennamen abgelegt statt unter Hersteller-Bezeichnung.

Ist auffaechernDefault gesetzt, greift die Einstellung Erste Variante in der Storefront anzeigen nicht mehr — beides zusammen ergibt keinen Sinn.

useHashAsFilename hilft, wenn Bezeichnungen Zeichen enthalten, die als Dateiname Probleme machen. Nach dem Umstellen entstehen für bereits übertragene Bilder neue Dateien; die alten bleiben in der Shopware-Medienverwaltung liegen und müssen dort aufgeräumt werden.

Makro vor dem Artikelexport

Schlüssel Typ Wirkung
preExportArticles Wert Dateiname eines SelectLine-Makros, das vor jedem einzelnen Artikel ausgeführt wird. Übergeben wird der Parameter Nummer mit der Artikelnummer.

Das Makro läuft je Artikel — bei einem Vollexport also zehntausende Male. Seine Laufzeit bestimmt damit die Dauer des ganzen Laufs. Eingetragen wird der Dateiname des Makros, nicht seine Bezeichnung; siehe Makros.

Bei Shopify und FINN.webshop gibt es dasselbe Makro in den Einstellungen der Oberfläche. Nur bei Shopware 6 fehlt die Maske dafür.

Kunden

Schlüssel Typ Wirkung
kdfeld Feldname Kundenfeld, in dem die Shop-Kundennummer steht. Vorgabe Shopnummer.
disableCustomerCreate Schalter im Shop werden keine neuen Kunden angelegt. Bestehende werden weiter aktualisiert.
onlyUpdateZahlungsbedingung Schalter überträgt von bestehenden Kunden nur die Zahlungsbedingung, sonst nichts.

Die Kombination aus beiden Schaltern ist der Weg für Shops, in denen die Kundenpflege im Shop stattfindet und aus der SelectLine nur die Zahlungsbedingung nachgeführt werden soll.

Belege

Schlüssel Typ Wirkung
defaultWarehouseLocationNumber Wert Lagerplatz, der in jeden importierten Beleg geschrieben wird.
slPriceToleranceField Feldname Belegfeld, in das bei einer Preisabweichung zwischen Shop und SelectLine der Hinweistext geschrieben wird.

Eine Preisabweichung landet in jedem Fall als Fehler im Protokoll. slPriceToleranceField macht sie zusätzlich am Beleg sichtbar, damit sie in der SelectLine auffällt und nicht nur im Protokoll steht.

Technische Sonderfälle

Schlüssel Typ Wirkung
index Schalter Vorgabe false: FINN.ghost bittet Shopware, die Indizierung während der Übertragung auszusetzen. Mit true indiziert Shopware bei jedem Schreibzugriff mit.
oldSWVersion Schalter schreibt die Zeiträume von Preisregeln im Format älterer Shopware-Versionen.
appServerUrl Wert Adresse, die Shopware zur Bestätigung der App zurückruft. Vorgabe https://localhost:8080.

Bei index ist die Vorgabe false die richtige Einstellung: Bei einem Vollexport mit vielen Artikeln würde die laufende Indizierung den Shop erheblich ausbremsen. Nach einem großen Lauf gehört im Shop einmal neu indiziert, damit Suche und Kategorien vollständig sind.

appServerUrl wird nur für die App-Registrierung gebraucht und muss die Adresse sein, unter der Shopware diese FINN.ghost-Installation erreicht.

Nächster Schritt

Shopify


Created 2026-09-07 11:28:23 UTC by API
Updated 2026-09-07 11:28:54 UTC by API