CSV-Export für Produktdaten – E-Mail- & FTP-Versand¶
Das Plugin ermöglicht den flexiblen Export von Shopware 6-Produkten und -Varianten als CSV-Datei – wahlweise direkt aus der Produktübersicht (inkl. aktiver Filter und Mehrfachauswahl), über individuelle Profile, per Shopware Flow Builder oder vollautomatisch mit Versand per E-Mail und FTP. Mithilfe von Exportprofilen lassen sich die exportierten Felder und deren Spaltenreihenfolge frei definieren.
Highlights
- ✅ Produkte & Varianten als CSV exportieren – flexibel und konfigurierbar
- 🖱️ Export direkt aus der Produktübersicht – inkl. aktiver Filter und Mehrfachauswahl
- 🔀 Optional alle Varianten eines Hauptprodukts einbeziehen (Profil-Schalter)
- ✉️ Versand per E-Mail oder Upload per FTP
- ⚙️ Auslösung über den Shopware Flow Builder oder manuell im Admin
- 🧩 Frei definierbare Exportfelder mit Spaltenreihenfolge
- 🛠️ CSV-Format konfigurierbar (Trennzeichen, Dezimal-/Tausendertrennzeichen, Datum, Zeitzone, Encoding)
- 🗃️ Preise, Bestand, Kategorien, Hersteller, Eigenschaften, SEO & Custom Fields
- 📊 Export-Historie mit erneutem Download erzeugter Dateien und Fortschrittsanzeige
❓ FAQ¶
Kann ich Exporte per E-Mail oder FTP versenden?
Ja. Über den Shopware Flow Builder kann die erzeugte CSV-Datei per E-Mail versendet oder per FTP hochgeladen werden – zum Beispiel, um die bestellten Produkte bei Bestelleingang automatisch auszuliefern. Exporte lassen sich außerdem manuell im Admin oder über die CLI ausführen.
Kann ich direkt aus der Produktliste exportieren?
Ja. In der Produktübersicht können Sie die aktuell gefilterte Liste oder eine Mehrfachauswahl von Produkten direkt mit einem gewählten Profil exportieren.
Kann ich Produktvarianten exportieren?
Ja. Über einen Profil-Schalter können optional alle Varianten eines Hauptprodukts in den Export einbezogen werden.
Kann ich eigene Exportprofile erstellen?
Ja. Sie können individuelle Exportprofile anlegen und bestimmen, welche Felder in welcher Reihenfolge exportiert werden.
Werden auch Zusatzfelder (Custom Fields) unterstützt?
Ja. Das Plugin unterstützt Produkt- und Variant-Custom-Fields zusätzlich zum integrierten Feldkatalog.
Wie viele Produkte kann ich gleichzeitig exportieren?
Die maximale Anzahl an Produkten ist in der Plugin-Konfiguration einstellbar (Standard 50.000). Über die CLI lassen sich auch sehr große Datenmengen exportieren.
In welchem Format kann ich exportieren?
Produkte werden als CSV exportiert. Das CSV-Format ist vollständig konfigurierbar (Trennzeichen, Dezimal- und Tausendertrennzeichen, Datumsformat, Zeitzone, Encoding).
🔧 Installation¶
- Voraussetzung: CNK Foundation Plugin
- Installation über den Shopware Store oder per ZIP-Upload
- Plugin im Shopware-Admin aktivieren
- Erfordert Shopware 6.7
🧩 Profile verwalten¶
Exportprofile legen fest, welche Daten in welcher Reihenfolge in der CSV-Datei enthalten sind. Die Profile finden Sie im Shopware-Admin unter Kataloge > CSV-Product-Export > Profile.
Innerhalb eines Profils bestimmen Sie gezielt, welche Felder in die exportierte CSV-Datei aufgenommen werden. Über die Feldauswahl lassen sich Produktfelder einzeln auswählen und anordnen – die Reihenfolge der Felder im Profil entspricht der Spaltenreihenfolge in der CSV-Datei.
Ein Profil enthält außerdem den Schalter „Varianten einbeziehen", mit dem optional alle Varianten eines Hauptprodukts exportiert werden.
⚙️ Standard-Einstellungen¶
Globale CSV-Formatierungs-Standards werden in der Plugin-Konfiguration festgelegt und gelten für jeden Export (ein Profil kann weiterhin auf den jeweiligen Anwendungsfall zugeschnitten werden):
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Feld-Trennzeichen | CSV-Trennzeichen (Komma oder Semikolon) | ; |
| Dezimaltrennzeichen für Preise | Dezimaltrennzeichen in Preiswerten | . |
| Tausendertrennzeichen für Preise | Tausendertrennzeichen in Preiswerten | , |
| Datumsformat | Format für Datumsfelder (z. B. d.m.Y, Y-m-d) | d.m.Y |
| Zeitzone | Zeitzone für Datums-/Zeitwerte | Europe/Berlin |
| Leere Anrede-Felder | Leere Anrede statt „Keine Angabe" ausgeben | Aus |
| Export-Grenze pro Schleife | Anzahl der pro Durchlauf verarbeiteten Datensätze | 100 |
| Maximale Anzahl der zu exportierenden Produkte | Obergrenze der Produkte pro Export | 50000 |
🗂️ Variablen¶
💡 Die Feldnamen müssen exakt wie in der linken Spalte angegeben verwendet werden.
Die folgende Übersicht listet alle integrierten Variablen, die in einem Exportprofil verwendet werden können. Die Feldnamen in der linken Spalte werden im Profil konfiguriert; die rechte Spalte beschreibt den Inhalt. Zusätzlich zeigt die Feldauswahl automatisch die in Ihrem Shop definierten Custom Fields für Produkte und Varianten an.
🧾 Allgemeine Produktdaten¶
| Feldname | Beschreibung |
|---|---|
id | Produkt-ID |
active | Aktiv-Status |
product_number | Artikelnummer / SKU |
name | Produktname |
description | Beschreibung |
ean | EAN / GTIN |
release_date | Erscheinungsdatum |
rating_average | Durchschnittliche Bewertung |
mark_as_topseller | Als Topseller markiert |
shipping_free | Versandkostenfrei |
sales | Anzahl Verkäufe |
canonical_product_id | Kanonische Produkt-ID |
canonical_product_name | Kanonischer Produktname |
🔀 Varianten¶
| Feldname | Beschreibung |
|---|---|
variation | Variationsdaten |
display_group | Varianten-Anzeigegruppe |
variant_restrictions | Varianten-Einschränkungen |
options | Varianten-Optionen |
💶 Preise & Steuer¶
| Feldname | Beschreibung |
|---|---|
price_net | Netto-Verkaufspreis |
price_gross | Brutto-Verkaufspreis |
purchase_price_net | Netto-Einkaufspreis |
purchase_price_gross | Brutto-Einkaufspreis |
tax_name | Steuersatz-Name |
tax_rate | Steuersatz (%) |
📦 Bestand, Mengen & Abmessungen¶
| Feldname | Beschreibung |
|---|---|
stock | Physischer Bestand |
available_stock | Verfügbarer Bestand |
available | Verfügbarkeit |
is_closeout | Abverkauf / Ausverkauf |
min_purchase | Mindestabnahmemenge |
max_purchase | Maximale Abnahmemenge |
purchase_steps | Abnahme-Intervall |
purchase_unit | Verkaufseinheit |
reference_unit | Grundeinheit |
pack_unit | Verpackungseinheit |
pack_unit_plural | Verpackungseinheit (Plural) |
unit_name | Maßeinheit |
weight | Gewicht |
width | Breite |
height | Höhe |
length | Länge |
delivery_time_names | Lieferzeit |
🗂️ Kategorien, Hersteller & Eigenschaften¶
| Feldname | Beschreibung |
|---|---|
category_ids | Kategorie-IDs |
category_names | Kategorie-Namen |
manufacturer_id | Hersteller-ID |
manufacturer_number | Hersteller-Artikelnummer |
manufacturer_name | Herstellername |
properties | Produkteigenschaften |
tags_names | Tags |
streams | Dynamische Produktgruppen |
🖼️ Medien & Downloads¶
| Feldname | Beschreibung |
|---|---|
cover_id | Cover-Bild-ID |
downloads | Downloads digitaler Produkte |
🔎 SEO & Suche¶
| Feldname | Beschreibung |
|---|---|
meta_title | Meta-Titel |
meta_description | Meta-Beschreibung |
keywords | SEO-Keywords |
custom_search_keywords | Eigene Such-Keywords |
slot_config | CMS-Layout-Konfiguration |
🧬 Custom Fields & Feature-Sets¶
| Feldname | Beschreibung |
|---|---|
custom_field_set_selection_active | Custom-Field-Set-Auswahl aktiv |
feature_set_id | Produkt-Feature-Set-ID |
Zusatzfelder (Custom Fields)
Zusätzlich zu den oben aufgeführten Feldern zeigt die Feldauswahl automatisch die in Ihrem Shop definierten Custom Fields für Produkte und Varianten an.
⚡ Schnell-Export über die Produktübersicht¶
- Die aktuell gefilterte Produktliste direkt exportieren
- Eine Mehrfachauswahl von Produkten exportieren (Bulk-Export)
- Ein Profil aus dem Dropdown wählen, um Felder und Format des Exports zu bestimmen
✉️ E-Mail- & FTP-Versand¶
Über den Shopware Flow Builder kann ein Export automatisch per E-Mail versendet oder per FTP hochgeladen werden. Ein typischer Aufbau fügt einen Flow hinzu, der die bestellten Produkte bei Bestelleingang exportiert und per E-Mail oder FTP versendet.
Format und Feldauswahl der Auslieferung richten sich nach dem im Flow gewählten Export-Profil.
📊 Aktivität & Protokollierung¶
- Export-Historie & Status (Erfolg / Fehler)
- Erneuter Download bereits erzeugter Dateien
- Fortschrittsanzeige für laufende Exporte
- Zu finden unter Kataloge > CSV-Product-Export > Aktivität
🖥️ Kommandozeilen-Export (CLI)¶
Laufende Aktivitäten verarbeiten¶
Alle laufenden Exporte direkt anstoßen, ohne auf die Queue zu warten:
Ein integrierter Fortschrittsbalken zeigt den Export-Fortschritt – auch für sehr große Datenmengen geeignet.
Export mit Profil¶
Export mit dem Shopware-Standardprofil für Produkte:
bin/console cnk:csv-products:export --exportType sw_profile --profileName "Default products" --fromDate 2024-01-01 --toDate 2025-02-01
Export mit einem in diesem Plugin erstellten Profil:
bin/console cnk:csv-products:export --exportType config --profileName "PIM feed" --fromDate 2024-01-01 --toDate 2025-02-01
- fromDate: Produkte erstellt ab diesem Datum, Format
Y-m-d - toDate: Produkte erstellt bis zu diesem Datum, Format
Y-m-d(Standard: heute) - exportType:
sw_profile(Shopware Import/Export-Profil) oderconfig(Profil dieses Plugins) - profileName: Name des zu verwendenden Profils (Standard:
Default products)
Abgelaufene Dateien löschen¶
Abgelaufene Export-Dateien und ihre Protokolleinträge entfernen:
Abgelaufene Dateien werden zusätzlich einmal täglich automatisch über den Scheduled Task cnk_product_export_file.cleanup bereinigt.