From 0e4c9219bfaff8557b3d4991f04efdbe6b940ae5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mathias=20Gla=CC=88ser?= Date: Wed, 12 Aug 2026 17:33:54 +0200 Subject: [PATCH] Dokumentiere Shopify Delta Dry Run --- .../shopify-umstellung-checkliste.md | 27 ++++++++++--------- 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/docs/modules/erp/import-integration/shopify-umstellung-checkliste.md b/docs/modules/erp/import-integration/shopify-umstellung-checkliste.md index d61ed28..3db2166 100644 --- a/docs/modules/erp/import-integration/shopify-umstellung-checkliste.md +++ b/docs/modules/erp/import-integration/shopify-umstellung-checkliste.md @@ -70,12 +70,12 @@ Fachliche Übergabe: `erp/bestellungen` ## 3. Shopify-Datenmapping -- [ ] Shopify Order-GID als stabile externe Identität festlegen. -- [ ] Shopify-Bestellnummer separat speichern. +- [x] Shopify Order-GID als stabile externe Identität festlegen und eindeutig indizieren. +- [x] Shopify-Bestellnummer separat speicherbar machen. - [ ] Wix-Bestellnummer als historische Referenz speichern. -- [ ] Kunden- und Shopify-Customer-ID abbilden. +- [x] Shopify-Customer-ID über `party_external_identity` speicherbar machen. - [ ] Liefer- und Rechnungsadresse abbilden. -- [ ] Produkt-, Varianten- und SKU-Referenzen abbilden. +- [x] Produkt-, Varianten- und SKU-Referenzen in Bestellpositionen und Artikel-Alias speicherbar machen. - [x] Shopify-Katalog read-only mit ERP-Produkten und `sellable_item` verglichen. - [x] ERP-Produkt `006` für Cordyceps ergänzt. - [x] Zwölf Shopify-SKU-Aliase im ERP angelegt; historische Wix-Aliase erhalten. @@ -92,25 +92,25 @@ Fachliche Übergabe: `erp/bestellungen` ## 4. Ziel-Datenmodell -- [ ] `sales_order` um Shopify-Identitäten erweitern. -- [ ] `order_source` um `shopify` erweitern. +- [x] `sales_order` um Shopify-Identitäten, Zeitstempel und Quellstatus erweitern. +- [x] `order_source` um `shopify` erweitern. - [ ] `external_ref` von der bisher gemischten Wix-/Direktverkaufssemantik entkoppeln. -- [ ] Zahlungsstatus über den bisherigen ausschliesslichen Wert `paid` hinaus modellieren. -- [ ] Fulfillment-Status modellieren. +- [x] Zahlungsstatus über den bisherigen ausschliesslichen Wert `paid` hinaus modellieren. +- [x] Shopify-Fulfillment-Status separat modellieren. - [ ] Storno- und Refund-Status modellieren. -- [ ] Shopify-Kunden-, Produkt- und Variantenreferenzen ergänzen. +- [x] Shopify-Kunden-, Produkt- und Variantenreferenzen ergänzen. - [ ] Synchronisations- und Reconciliation-Status ergänzen. - [ ] Shopify-Rohdaten versioniert oder nachvollziehbar speichern. -- [ ] Datenbank-Constraints und Indizes definieren. +- [x] Datenbank-Constraints und Indizes definieren. - [ ] Bestehende Wix-Daten und Direktverkaufsdaten rückwärtskompatibel erhalten. -- [ ] DB-Ownership für alle neuen Artefakte dokumentieren. +- [x] DB-Ownership für `party_external_identity` dokumentieren. - [ ] Zielmodell als verbindlich abnehmen. ## 5. Prozess- und Modulgrenzen - [x] `erp/bestellungen` als Eigentümer der Bestellfachlichkeit bestätigt. - [x] `erp/import-integration` als Eigentümer der technischen Eingangsschnittstellen bestätigt. -- [ ] Prozess `shopify.orders.migrate` definieren. +- [x] Verbindlichen Prozess `erp.import-integration.shopify_delta_order_import` für den Delta-Import definieren. - [ ] Prozess `shopify.orders.receive` definieren. - [ ] Prozess `shopify.orders.reconcile` definieren. - [x] Verbindlichen Webhook-Sync-Prozess dokumentieren. @@ -222,6 +222,9 @@ Fachliche Übergabe: `erp/bestellungen` - [ ] Excel-/n8n-Weiterleitungen vom Migrationslauf trennen. - [ ] Aktuelle Nebenwirkungen in `order-import.php` entfernen oder explizit sperren. - [ ] Wiederholter Import ohne doppelte Lagerbewegung nachweisen. +- [x] Read-only Delta-Dry-Run durchgeführt: vier stornierte/erstattete Shopify-Bestellungen übersprungen, `#1541` als einzige qualifizierte Bestellung bestätigt. +- [x] Dry-Run belegt: SKU `003.02` ist auf zwei Reishi-Einheiten aus der aktuellen Charge `2601.3` gemappt; verfügbar sind 194 Einheiten. +- [x] Dry-Run belegt: Es existiert noch keine Shopify-Bestellung im ERP. ## 10. Ausführliche Verifikation