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.

❓ FAQ¶

🔧 Installation¶

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

🧩 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.

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.

🗂️ Exportformate & ERP-Vorlagen¶

Zusätzlich zum Standardformat CSV können Sie Ihre Exportprofile auch als Excel (XLSX), JSON oder XML ausgeben.

Das Exportformat wird pro Profil im Reiter Konfiguration über das Feld „Dateiformat" festgelegt und serverseitig für alle Exportwege (manuell, Schnell-Export, Zeitplan, Flow Builder und CLI) durchgesetzt. Ist der In-App-Kauf nicht aktiv, fällt der Export automatisch auf CSV zurück.

Ein Pro-Format freischalten¶

1. Öffnen Sie ein Profil unter Bestellungen > CSV-Export > Profile und wechseln Sie in den Reiter Konfiguration.
2. Wählen Sie unter Dateiformat ein Pro-Format (XLSX, JSON oder XML). Ist der Kauf noch nicht aktiv, erscheint ein Hinweis mit der Schaltfläche „Freischalten".
3. Nach dem Kauf steht das Format sofort zur Verfügung und wird beim Speichern übernommen.

ERP-Vorlagen anwenden¶

ERP-Vorlagen belegen mit einem Klick die passende Feldauswahl sowie die Trennzeichen-, Zahlen-, Datums- und Encoding-Einstellungen für das jeweilige Zielsystem vor:

So wenden Sie eine Vorlage an:

1. Stellen Sie sicher, dass der In-App-Kauf „Pro-Formate & ERP-Vorlagen" aktiv ist.
2. Wählen Sie im Profil unter ERP-Vorlage das gewünschte System und klicken Sie auf „Vorlage anwenden".
3. Die Feldauswahl und die Formateinstellungen werden übernommen. Das gewählte Dateiformat bleibt dabei erhalten – Sie können also z. B. eine DATEV-Feldauswahl auch als XLSX ausgeben.

💡 Das Anwenden einer Vorlage überschreibt die aktuelle Feldauswahl des Profils. Passen Sie die Felder anschließend bei Bedarf an und speichern Sie das Profil.

🔄 Inkrementeller / Delta-Export¶

Mit dem Delta-Export werden bei jedem Lauf nur die Bestellungen exportiert, die seit dem letzten erfolgreichen Export erstellt oder geändert wurden. Das hält eine Warenwirtschaft oder Buchhaltung ohne Duplikate synchron und spart – besonders bei großen Bestellmengen – Zeit und Datenvolumen.

• Pro Profil aktivierbar über den Schalter „Delta-/Inkrementeller Export" im Reiter Konfiguration.
• Berücksichtigt Bestellungen anhand von Erstellungs- oder Änderungsdatum (createdAt/updatedAt), sodass auch nachträglich geänderte Bestellungen erneut exportiert werden.
• Der Delta-Stand (Wasserzeichen) wird nur nach einem erfolgreichen Export fortgeschrieben – schlägt ein Lauf fehl, gehen keine Bestellungen verloren.
• Funktioniert über alle Exportwege: Zeitplan, Flow Builder und CLI (Config-Profil).

Delta-Export einrichten¶

1. Öffnen Sie ein Profil und wechseln Sie in den Reiter Konfiguration.
2. Aktivieren Sie den Schalter „Delta-/Inkrementeller Export". Ist der Kauf noch nicht aktiv, erscheint ein Hinweis mit der Schaltfläche „Freischalten".
3. Speichern Sie das Profil. Ab dem nächsten Lauf werden nur noch neue oder geänderte Bestellungen exportiert.

Delta-Stand zurücksetzen¶

Möchten Sie erneut alle Bestellungen exportieren (z. B. für einen vollständigen Erst-Abgleich), setzen Sie das Wasserzeichen zurück:

1. Öffnen Sie das Profil im Reiter Konfiguration.
2. Klicken Sie im Delta-Hinweis auf „Zurücksetzen" und speichern Sie das Profil.
3. Der nächste Lauf exportiert wieder alle passenden Bestellungen und setzt anschließend ein neues Wasserzeichen.

💡 Der Delta-Export nutzt den Startzeitpunkt des Exports als Wasserzeichen. Dadurch werden im Grenzfall lieber wenige Bestellungen doppelt exportiert als übersprungen – ideal für idempotente Importe (Upserts) in der Warenwirtschaft.

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¶

📦 Bestellpositionen¶

👤 Kundendaten¶

🚚 Lieferadresse¶

🧾 Rechnungsadresse¶

🛒 Produkt-Daten¶

🧬 Positionsdetails (Payload)¶

Snapshot-Daten, die zum Kaufzeitpunkt an der Bestellposition gespeichert werden.

📄 Dokumente¶

Felder aus erzeugten Dokumenten (Rechnung, Lieferschein und – sofern das Pickware-Plugin installiert ist – Pickware Pickliste / POS-Beleg). Die Werte sind erst gefüllt, sobald das jeweilige Dokument zur Bestellung erstellt wurde.

Rechnung¶

Lieferschein¶

Pickware ERP-Pickliste¶

Pickware POS-Beleg¶

⚡ Schnell-Export über die Bestellübersicht¶

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

• Auswahl eines Profils im Dropdown

🔁 Jobs (Automatisierung)¶

• Erklärung: Scheduled Task / Cronjob
• Konfigurierbare Optionen:
  • Zeitintervall oder feste Wochentage + Uhrzeit
  • FTP / E-Mail-Ziel
  • Profilwahl (inkl. Format, ERP-Vorlage und Delta-Export des gewählten Profils)

📊 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

• Das Ergebnis sieht wie folgt aus

🖥️ Kommandozeilen-Export (CLI)¶

Schneller Export laufender Aktivitäten¶

Der Export großer Datenmengen – auch über 10.000 Bestellungen – ist möglich.
Ein integrierter Fortschrittsbalken zeigt dabei den Exportfortschritt an.

Um nicht auf die Queue zu warten, kann man den Export manuell anstoßen – z.B. für sofortigen CSV-Download nach dem Erstellen eines Exports:

#[AsCommand(
    name: 'cnk:csv-order-log:consume',
    description: 'Export all the activities in progress',
)]

Der Export kann anschließend direkt über die Konsole gestartet werden:

bin/console cnk:csv-order-log:consume

Dieser Befehl startet alle laufenden Exporte direkt über die Konsole.

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)