Zum Inhalt

CSV-Export für Bestellungen

Das Plugin ermöglicht den flexiblen Export von Shopware 6-Bestellungen als CSV-Datei – wahlweise vollständig oder gefiltert nach Zeitraum, Status, Zahlungsart und mehr. Mithilfe individueller Profile können Felder frei definiert und Exporte auf spezifische Anforderungen zugeschnitten werden.

Highlights

  • Bestellungen als CSV exportieren – flexibel, filterbar, automatisierbar
  • 🔁 Vollautomatischer Export via Zeitplan (Scheduled Task / Cronjob)
  • ✉️ Versand per E-Mail oder Upload per FTP
  • 🧩 Frei definierbare Exportfelder mit Sortierung und Filtern
  • 🛠️ CSV-Format vollständig konfigurierbar (Trennzeichen, Datum, Encoding etc.)

❓ FAQ

Kann ich den Export automatisieren?

Ja, das Plugin unterstützt den automatischen Export über Shopware Scheduled Tasks (Cronjobs).
Die CSV-Datei kann automatisch erstellt und per E-Mail oder FTP versendet werden.

Kann ich eigene Exportprofile erstellen?

Ja, Sie können individuelle Exportprofile anlegen und bestimmen, welche Felder exportiert werden sollen und in welcher Reihenfolge.

Werden auch Zusatzfelder (Custom Fields) unterstützt?

Ja, das Plugin unterstützt Zusatzfelder für Bestellungen, Kunden, Produkte und Bestellpositionen.

Wie viele Bestellungen kann ich gleichzeitig exportieren?

Die maximale Anzahl an Bestellungen ist in der Plugin-Konfiguration einstellbar.
Über CLI lassen sich auch sehr große Datenmengen exportieren.

order-2.png

🔧 Installation

  • Voraussetzungen (CNK Foundation)
  • Installation via Store oder ZIP
  • Aktivierung & Sichtbarkeit im Backend install.png activate.png

🧩 Profile verwalten

Exportprofile definieren, welche Daten in der CSV-Datei enthalten sind und in welcher Reihenfolge sie erscheinen.
Die Profile befinden sich im Shopware-Adminbereich unter Bestellungen > CSV-Export > Profile.

settings-1.png profile-1.png

Innerhalb eines Profils kannst du gezielt festlegen, welche Felder in die exportierte CSV-Datei aufgenommen werden sollen.
Über die Schaltfläche „Feld hinzufügen“ lassen sich Bestell-, Kunden-, Produkt- und Adressfelder individuell auswählen und anordnen.
Die Reihenfolge der Felder im Profil entspricht der Spaltenreihenfolge in der CSV-Datei.

profile-2.png

Variablen

💡 Die Feldnamen müssen exakt so übernommen werden, wie sie in der linken Spalte angegeben sind.

Die folgende Übersicht zeigt alle verfügbaren Variablen, die in einem Exportprofil verwendet werden können.
Diese bestimmen, welche Daten in der CSV-Datei erscheinen – zum Beispiel allgemeine Bestelldaten, Kundeninformationen, Adressfelder oder Produktdetails.
Die Feldnamen in der linken Spalte werden im Profil konfiguriert, die rechte Spalte beschreibt den Inhalt.

🧾 Allgemeine Bestelldaten

Feldname Beschreibung
order_number Bestellnummer
order_date Bestelldatum
order_date_time Bestelldatum und Uhrzeit
sales_channel Verkaufskanal
payment_method Zahlart
shipping_method Liefermethode
amount_total Gesamtbetrag
amount_net Netto-Betrag
position_price Bruttopreis der Position
currency_name Währung
currency_short_name Währung (kurz)
shipping_total Lieferkosten
customer_comment Kundenkommentar
transactions_state_machine_state Zahlungsstatus
deliveries_state_machine_state Versandstatus

📦 Bestellpositionen

Feldname Beschreibung
line_items_label Name
line_items_description Beschreibung
line_items_quantity Menge
line_items_unit_price Einzelpreis
line_items_total_price Gesamtpreis

👤 Kundendaten

Feldname Beschreibung
company Firma
salutation Anrede
first_name Vorname
last_name Name
email E-Mail-Adresse
birthday Geburtsdatum
order_count Anzahl Bestellungen

🚚 Lieferadresse

Feldname Beschreibung
shipping_address_company Firma
shipping_address_department Abteilung
shipping_address_salutation Anrede
shipping_address_title Titel
shipping_address_first_name Vorname
shipping_address_last_name Nachname
shipping_address_street Straße
shipping_address_zipcode PLZ
shipping_address_city Stadt
shipping_address_phone_number Telefonnummer
shipping_address_country_name Land
shipping_address_country_iso Land (ISO)

🧾 Rechnungsadresse

Feldname Beschreibung
billing_address_company Firma
billing_address_department Abteilung
billing_address_salutation Anrede
billing_address_title Titel
billing_address_first_name Vorname
billing_address_last_name Nachname
billing_address_street Straße
billing_address_zipcode PLZ
billing_address_city Stadt
billing_address_country_name Land
billing_address_country_iso Land (ISO)

🛒 Produkt-Daten

Feldname Beschreibung
line_items_product_number Produktnummer
line_items_product_name Produktname
line_items_product_description Beschreibung
line_items_product_manufacturer_number Herstellernummer
line_items_product_ean EAN
line_items_product_stock Bestand
line_items_product_available_stock Verfügbarer Bestand
line_items_product_max_purchase Max. Menge
line_items_product_min_purchase Min. Menge
line_items_product_purchase_prices Kaufpreis
line_items_product_shipping_free Gratis Lieferung
line_items_product_weight Gewicht
line_items_product_width Breite
line_items_product_height Höhe
line_items_product_length Länge
line_items_product_category_ids Kategorie-IDs
line_items_product_category_names Kategorie-Namen
line_items_product_release_date Veröffentlichungsdatum
line_items_product_manufacturer_name Herstellername

⚡ Schnell-Export über die Bestellübersicht

  • Direkt-Export von selektierten Bestellungen
  • Direkt-Export von gefilterten Bestellungen

order-1.png

  • Auswahl eines Profils im Dropdown order-2.png

🔁 Jobs (Automatisierung)

  • Erklärung: Scheduled Task / Cronjob
  • Konfigurierbare Optionen:
    • Zeitintervall
    • FTP / E-Mail-Ziel
    • Profilwahl

job-1.png job-2.png job-3.png job-4.png job-5.png

📊 Aktivität & Protokollierung

  • Exporthistorie & Status (Success/Error)
  • CSV-Log: Empfänger, FTP-Pfad, Zeitstempel
  • Die Logs sind unter Bestellungen > CSV-Export > Aktivität zu finden activity-1.png

  • Das Ergebnis sieht wie folgt aus activity-2.png

🖥️ Kommandozeilen-Export (CLI)

  • Befehl mit Argumenten
  • Unterschied sw_profile vs. config
  • Verwendung in Cronjobs

Export mit Shopware Profil

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType sw_profile --mode order --profileName "Default orders" --limit 500

Export mit eigenem Profil

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType config --mode line_items --profileName "WAWI" --limit 500
  • fromDate: Bestellungen von, format Y-m-d
  • toDate: Bestellungen bis, format Y-m-d
  • exportType: Auswahl zwischen sw_profile und config
  • mode: Auswahl zwischen order und line_items
  • profileName: Standardprofil oder vom Benutzer angelegtes Profil
  • limit: Limit der zu exportierenden Bestellungen (Standardwert: 100)