Historische Shopify-Bestellungen in Alva importieren

Bevor Sie starten

Ordnen Sie jedem Shopify-Produkt, das jemals eine digitale Datei verkauft hat, vor dem Import eine Datei oder einen Pack in Alva zu. Nicht zugeordnete Produkte werden zeilenweise übersprungen und in einer Zusammenfassung zurückgemeldet — der saubere Weg ist jedoch, zuerst zuzuordnen und dann einmal zu importieren.

• Dateien Produkten zuordnen. Öffnen Sie Files in Alva und prüfen Sie, dass an jedem digitalen Produkt mindestens eine Datei oder ein Pack hängt. Variantenspezifische Zuordnungen funktionieren ebenfalls.
• Datumsbereich festlegen. Übliche Wahl: die letzten 90 Tage für einen aktiven Shop oder der gesamte Zeitraum für eine Migration aus einer anderen Auslieferungs-App.
• Eine kleine Test-CSV bereithalten. Exportieren Sie zuerst eine einzelne aktuelle Woche, um die Zuordnung zu prüfen, und exportieren Sie anschließend den vollen Bereich, sobald der Probelauf stimmig aussieht.

Bestellungen-CSV aus dem Shopify-Admin exportieren

Shopify stellt den Bestellexport unter Bestellungen → Exportieren bereit. Der Importer erwartet die Standard-Spaltennamen der CSV — benennen Sie keine Spalten um und bearbeiten Sie die Datei nicht von Hand.

1. Shopify-Admin → Bestellungen öffnen. Grenzen Sie mit den Filtern auf den Datumsbereich ein, den Sie nachladen möchten.
2. Auf Exportieren klicken. Wählen Sie Reine CSV-Datei (nicht Für Excel, Numbers oder andere Tabellenkalkulationen) und wählen Sie Bestellungen, Transaktionen und Erstattungen.
3. Den richtigen Umfang wählen. „Aktuelle Seite", „Ausgewählte Bestellungen", „Alle Bestellungen" oder „Bestellungen, die Ihrer Suche entsprechen" funktionieren alle. Der Importer wirkt nur auf Zeilen, deren Zahlungsstatus paid ist.
4. Die von Shopify gesendete E-Mail herunterladen. Bei großen Exporten sendet Shopify den CSV-Link an die E-Mail-Adresse des Shop-Inhabers. Speichern Sie sie lokal — nicht entpacken und neu zippen.

Den Importer ausführen

Der Importer befindet sich unter Bestellungen → Historische Bestellungen importieren in der Alva-Admin-Seitenleiste. Große CSVs werden automatisch in Blöcken verarbeitet — eine Zeilenanzahl-Grenze, um die Sie sich kümmern müssten, gibt es nicht.

1. Bestellungen in Alva öffnen, dann im Seitenkopf auf die sekundäre Aktion Historische Bestellungen importieren klicken.
2. CSV in die Upload-Zone ziehen. Alva validiert die Spalten-Header sofort und weist die Datei ab, falls eine Pflichtspalte fehlt.
3. Auf die Vorschau warten. Alva ordnet Kunden per E-Mail zu, ordnet Produkte per SKU und dann per Titel zu und zeigt Zähler an: Bestellungen gesamt, geeignete Bestellungen, übersprungen (storniert / nicht bezahlt / keine E-Mail), gefundene vs. fehlende Kunden, zugeordnete vs. nicht zugeordnete Produkte und Bestellungen, die in einem vorherigen Lauf bereits importiert wurden.
4. Nicht zugeordnete Produkte prüfen. Wenn die Vorschau nicht zugeordnete Produkttitel meldet, brechen Sie den Import ab, ordnen Sie sie unter Files → Produkte zu und laden Sie dieselbe CSV erneut hoch. Bereits importierte Bestellungen werden automatisch übersprungen.
5. Bestätigen und starten. Klicken Sie auf Import starten. Der Fortschritt wird in der Oberfläche gestreamt, sobald jeder Block abgeschlossen ist. Das Schließen des Browser-Tabs bricht den Import nicht ab — er läuft serverseitig zu Ende, und Sie können die Seite erneut öffnen, um das Ergebnis zu sehen.

Was der Importer tut (und überspringt)

Der Importer ist bewusst minimal. Er schreibt nur die kleinste Menge an Zeilen, die nötig ist, damit ein Kunde seine eigenen Download-Links erneut anfordern kann, und überspringt jede Nebenwirkung, die einen wiederkehrenden Kunden überraschen würde.

Unter der Haube wird jede importierte Purchase-Zeile mit fraudCheckEnabled: false, fraudCheckPassed: false und accessEnabled: true erzeugt. Genau das sorgt dafür, dass die Kundenkonto-Seite die Datei sofort anzeigt, ohne jemals eine Liefer-E-Mail oder eine Lizenzschlüssel-Zuweisung auszulösen.