Definieren Sie ein einheitliches Zeilenmodell und das Mapping jedes Feldes, verwenden Sie sowohl die interne Bestell-ID als auch eine stabile externe ID und exportieren Sie anhand des Änderungszeitpunkts mit einem gespeicherten Cursor. Nummerieren Sie jeden Batch, übergeben Sie ihn verschlüsselt, bestätigen Sie den Empfang und gleichen Sie Anzahl, Summen und fehlerhafte Zeilen ab. Versionieren Sie das Format zusammen mit einem Beispiel und einer Übergangsfrist. Vertrauen Sie dem Cursor erst, nachdem der gesamte Batch bestätigt wurde.
Ein Bestellexport aus WooCommerce kann eine einmalige Datei zur Kontrolle oder ein regelmäßiger Datenfluss an Lager, Buchhaltung und Analytics sein. Das größte Risiko ist nicht nur ein falsches Spaltenformat. Eine Bestellung ändert sich nach ihrer Erstellung, enthält mehrere Positionen, Erstattungen und benutzerdefinierte Felder, sodass ein einfacher Export nach Datum einen Datensatz auslassen oder wiederholt senden kann, ohne dass dies unterscheidbar ist.
Ein zuverlässiger Export benötigt einen klaren Zweck, einen Datenvertrag, stabile Identifikatoren und eine Empfangsbestätigung. Diese Anleitung zeigt, wie Sie sowohl manuelle als auch automatisierte Ausgaben, inkrementelle Batches, eine sichere Zustellung und eine Mengenkontrolle konzipieren. Sie befasst sich nicht mit der rechtlichen Bestimmung von Buchungsposten; Bedeutung und Umfang der Finanzdaten muss die zuständige Fachperson im Unternehmen genehmigen.
Praxisbeispiel: drei Testzeilen vor dem Live-Export
Öffentliche Verkaufsprojekte, zum Beispiel By You Shop und ZOPA, finden Sie in Webiant-Portfolio. Beim Export von Bestellungen muss jedoch die konkrete Art der Erfassung und Verbuchung geprüft werden. Die folgenden Zeilen sind künstliche Testdaten; sie enthalten weder Kundendaten noch Ergebnisse dieser Projekte.
order_id;external_id;created_at_utc;currency;total;status
1001;000042;2026-10-01T08:30:00Z;EUR;129.90;completed
1002;000043;2026-10-01T09:15:00Z;EUR;0.00;cancelled
1003;000044;2026-10-02T16:45:00Z;EUR;49.50;refunded| Risiko | Prüfung im Zielsystem |
|---|---|
| Verlust führender Nullen | external_id als Text importieren, nicht als Zahl |
| Unterschiedliche Trennzeichen und Dezimalzahlen | Punkt oder Komma und Feldtrennzeichen vereinbaren |
| Unklare Daten | UTC speichern oder die Zeitzone ausdrücklich angeben |
| Stornierungen und Rückerstattungen | Vereinbaren, ob sie einbezogen werden und wie sie abgerechnet werden |
| Erneuter Import | Stabile IDs verwenden und doppelte Schreibvorgänge verhindern |
Exportieren Sie zunächst eine kleine Kontrollstichprobe und vergleichen Sie Anzahl der Bestellungen, Währungen, Status und die Summe je Währung. Der Betrag stornierter oder erstatteter Bestellungen darf nicht automatisch als Umsatz gelten. Legen Sie die Regeln mit der Person fest, die die Daten verarbeitet.
Verwenden Sie bei größeren Datenmengen Batches und eine stabile Sortierung. Wenn sich Bestellungen während des Exports ändern, müssen Sie einen Zeitschnitt definieren oder Änderungen protokollieren, damit kein Datensatz zwischen den Seiten verloren geht. Testen Sie bei einer Datei für Excel UTF-8 und den Erhalt diakritischer Zeichen. Verarbeiten Sie Werte, die mit den Zeichen =, +, – oder @ beginnen, so, dass sie beim Öffnen nicht als Formeln ausgeführt werden.
Überprüfen Sie den Abschluss durch einen erneuten Import derselben Stichprobe: Die Anzahl der Datensätze darf sich nicht verdoppeln. Damit hängt zusammen API-Idempotenz und Vereinbarung über Systemintegration.
Beginnen Sie mit dem Zweck und dem Datenvertrag
Der Empfänger sollte angeben, für welche Entscheidung er jede Angabe verwendet. Ein Export für den Versand braucht Positionen und Adresse, eine Analyseauswertung benötigt eventuell Ereignisse und das Buchhaltungssystem eine freigegebene Finanzaufschlüsselung. Erstellen Sie nicht eine riesige Datei für alle; das erweitert den Datenzugriff und erschwert Änderungen.
Erfassen Sie für jedes Feld Quelle, Typ, Format, Pflichtstatus, zulässigen Leerwert und ein Beispiel. Unterscheiden Sie zwischen Bestell-ID, öffentlicher Bestellnummer und ID im Zielsystem. Übertragen Sie Beträge mit Währung und Bedeutung, einschließlich der Angabe, ob es sich um eine gespeicherte Position, die Bemessungsgrundlage, die Steuer oder das Ergebnis nach einer Rückerstattung handelt.
- Zweck und Verantwortlicher des Exports
- Eindeutige Bedeutung jedes Feldes
- Stabile Kennungen und Währung
- Formatversion und Änderungsregeln
Wählen Sie die richtige Struktur für Bestellung und Positionen
Eine Bestellung hat einen Kopf und mehrere Positionen. Eine breite CSV-Datei mit wiederholten Kopfdaten ist für eine Tabelle einfach, der Empfänger muss die Zeilen jedoch korrekt gruppieren. Zwei zusammenhängende Dateien verringern Wiederholungen, benötigen aber Referenz-IDs und eine atomare Zustellung. JSON bewahrt die Verschachtelung auf natürliche Weise, sofern das Ziel dies unterstützt.
Exportieren Sie nicht automatisch alle benutzerdefinierten Felder und Metadaten. Wählen Sie eine freigegebene Liste aus und transformieren Sie die inhaltlich relevanten Werte. Ein internes technisches Flag ist nicht unbedingt ein stabiler Vertrag. Übertragen Sie bei Varianten die Varianten-ID, die SKU und die in der Bestellung gespeicherten Attribute; das aktuelle Produkt kann sich inzwischen geändert haben oder gelöscht worden sein.
Entwerfen Sie einen inkrementellen Export ohne Lücken
Ein Export nach Erstellungszeitpunkt erfasst keine späteren Änderungen von Status, Adresse oder Rückerstattung. Verwenden Sie den Zeitpunkt der letzten relevanten Änderung, eine stabile Sortierung und einen Cursor, der erst nach bestätigter Verarbeitung des Batches gespeichert wird. Ergänzen Sie bei gleichem Zeitpunkt die ID als zweites Sortierkriterium, damit an der Grenze kein Datensatz ausgelassen wird.
Der Empfänger muss dieselbe Bestellung erneut als Aktualisierung und nicht als Duplikat annehmen können. Binden Sie den Upsert an einen stabilen Schlüssel und die Version des Datensatzes. Übertragen Sie Löschungen oder Stornierungen über einen expliziten Status, nicht durch das Fehlen in der nächsten Datei. Ein vollständiger Kontrollexport gleicht den Zustand nach inkrementellen Batches regelmäßig ab.
Schützen Sie Dateien und den Betriebszugang
Bestellungen enthalten personenbezogene und geschäftliche Daten. Speichern Sie Dateien außerhalb öffentlich zugänglicher Uploads, übertragen Sie sie über einen verschlüsselten Kanal und beschränken Sie den Zugriff rollenbasiert. Ein Dateiname mit geheimer Zufallszeichenfolge ist nicht der einzige Schutz. Richten Sie Ablauf, Löschung und Download-Audit entsprechend den genehmigten Anforderungen ein.
Zeigen Sie beim manuellen Export vor der Bestätigung den Datenumfang an und verwenden Sie bei großen Dateien eine Queue, statt die Administration zu blockieren. Der Download-Link sollte zeitlich begrenzt und an einen berechtigten Nutzer gebunden sein. Das Log speichert nicht den gesamten Inhalt der Zeilen; Batch, Umfang, Anzahl, Prüfsumme und Ergebnis genügen.
Gleichen Sie den Batch mit geschäftlichen Prüfungen ab
Vergleichen Sie nach jedem Lauf die Anzahl der Bestellungen und Positionen, die Summen je Währung und die Anzahl der Status zwischen Quelle und empfangenem Ergebnis. Erfassen Sie abgelehnte Zeilen gesondert mit Begründung. Null technische Fehler bedeuten keinen vollständigen Export, wenn ein Filter versehentlich einen leeren Bereich ausgewählt oder der Empfänger einen Teil der Datei übersprungen hat.
Testen Sie lange Namen, diakritische Zeichen, mehrere Positionen, Gastbestellungen, Rabatte, Rückerstattungen, benutzerdefinierte Status und Bestellungen, die während des Exports geändert werden. Veröffentlichen Sie eine Formatänderung als neue Version mit Übergangsfrist. Das Runbook beschreibt die sichere Wiederholung eines Batches und die Rekonstruktion des Cursors, ohne ein ungeprüftes Datum manuell zu überschreiben.
Häufige Fragen
Ist ein CSV- oder JSON-Export von Bestellungen besser?
Das hängt vom Empfänger ab. CSV ist für Tabellen leicht zugänglich, braucht aber ein klares Modell für wiederholte Zeilen. JSON bewahrt verschachtelte Einträge besser. Wichtiger als das Format sind ein versionierter Vertrag und eine Vollständigkeitsprüfung.
Nach welchem Datum sollen neue Bestellungen exportiert werden?
Bei einem regelmäßigen Datenfluss in der Regel nach der letzten relevanten Änderung, nicht nur nach der Erstellung. Verwenden Sie einen stabilen Cursor mit Zeitstempel und ID und speichern Sie ihn erst nach Bestätigung des gesamten Batches.
Wie lassen sich Duplikate nach wiederholtem Export vermeiden?
Übertragen Sie jeden Datensatz mit einem stabilen Schlüssel und einer Version. Der Empfänger führt einen idempotenten Upsert aus und der Batch hat eine eigene Kennung, sodass eine Wiederholung dasselbe Ergebnis wiederherstellt, statt einen weiteren Datensatz anzulegen.
Quellen und weiterführende Lektüre
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
