Warenwirtschaft: Doku — AP-13 abgeschlossen (Hinweise, Testleitfaden, Plan-Protokoll)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

resources/docs/hinweise.md

@@ -87,11 +87,27 @@
   Gramm (Rohstoff) bzw. Stück (Verpackung) und Datum. Jeder Ausgang reduziert
   sofort den Bestand – beim Rohstoffbestand also auch die „auf Null"-Prognose und
   den Kritisch-Status.
+- **Shop-Bestandsabzug beim Versand (neu 16.07.2026):** Wird eine Bestellung
+  auf **„versendet"** oder **„abgeschlossen"** gesetzt, bucht das System je
+  Bestellposition automatisch einen Abgang im **Produktbestand** (Grund
+  „Verkauf", mit Verweis auf die Bestellung). **Sets** werden dabei in ihre
+  Einzelprodukte aufgelöst (auch verschachtelt). Wird der Versandstatus
+  zurückgesetzt oder die Bestellung **storniert**, führt eine automatische
+  **Gegenbuchung** den Bestand zurück – auch beim automatischen Storno durch
+  die Zahlungserinnerung. Doppelte Statuswechsel buchen nie doppelt.
+- **API-Bestellungen (neu 16.07.2026):** Eigener Menüpunkt in der
+  Warenwirtschaft. Jede über die Partnercenter-API eingehende
+  Bestell-Übertragung (WooCommerce-Fulfillment) wird protokolliert – auch
+  abgelehnte. Kann eine Position **keinem Produkt zugeordnet** werden
+  (WP-Nummer/SKU unbekannt), ist der Eintrag **rot markiert**; ein Klick auf
+  **„Ansehen"** öffnet den Inhalt der Übertragung (SKU, Produkt, Menge, Preis,
+  Meldung je Position). Zusätzlich warnt die Seite bei **doppelten WP-Nummern**
+  aktiver Produkte und listet aktive Produkte **ohne WP-Nummer** auf.
 
 ### In Vorbereitung / geplant
 
-- **Shop-Anbindung** (Bestandsabzug beim Versand),
-  **Audit-Trail**, **blockbasierte Rechte**, **2FA für Admins**,
+- **Versand im System** (DHL-Etiketten per API, AP-32), **Audit-Trail**,
+  **blockbasierte Rechte**, **2FA für Admins**,
   **WaWi-Einstellungsseite** (Schwellwerte/Defaults zentral).
 - **Produktentwicklung:** Menüpunkt ist als Platzhalter angelegt – das genaue
   Briefing steht noch aus.
@@ -135,7 +151,17 @@
   vorbelegt wird und editierbar bleibt. Eine spätere Korrektur des Ergebnisses
   wird je Produkt als Differenz nachgebucht. Manuelle Korrekturen erfolgen
   ausschließlich über Gegenbuchungen (`+`/`−`) – Einträge der Historie werden
-  nicht gelöscht. Verkaufsabgänge folgen mit der Shop-Anbindung.
+  nicht gelöscht. **Verkaufsabgänge buchen automatisch beim Versand** (siehe
+  Shop-Bestandsabzug) und zählen in „Verbrauch/Monat" mit.
+- **Positionen ohne Produktzuordnung fehlen in Bestellung und Bestandsabzug:**
+  Überträgt WooCommerce eine SKU, die im Partnercenter keinem Produkt
+  zugeordnet ist, wird die Position **nicht** übernommen – die Bestellung
+  entsteht ohne sie. Solche Fälle sind unter **API-Bestellungen** rot markiert
+  und sollten zeitnah geprüft werden (WP-Nummer am Produkt ergänzen, Position
+  ggf. manuell nachpflegen).
+- **Partner-Eigenversand berührt das Lager nicht:** Bestellungen, die Partner
+  selbst versenden, übertragen keinen Warenkorb ins Partnercenter und erzeugen
+  bewusst keinen Bestandsabzug – der Partner versendet aus eigenem Bestand.
 - **Produktions-Maske:** zeigt die Hersteller-Rezeptur als **INCI-Liste** mit
   Alternativname, Qualität, Anteil %, Gesamt-Gramm und **Regal** (Lagerort);
   die Chargen-Zuordnung ist nach **Rezeptur-Phasen** gegliedert (inkl.
@@ -180,7 +206,8 @@ später erweitert werden:
   Eine echte **Kauf-Sperre** kann künftig optional ergänzt werden.
 - **Bestandsabzug im Shop** erfolgt **beim Versand** (erst mit gebuchtem Versand
   gilt die Ware als „aus dem Regal" entnommen). Stornos/Retouren werden als
-  Gegenbuchung abgebildet.
+  Gegenbuchung abgebildet. **So umgesetzt (16.07.2026)** – am Versand-Statuswechsel,
+  Sets werden über ihre Komponenten aufgelöst.
 - **Blockbasierte Rechte** gelten zunächst **nur für Warenwirtschaft und
   Produktmanagement**. Bei Bedarf können sie später auf weitere Bereiche
   ausgebaut werden.

resources/docs/testleitfaden.md

@@ -131,10 +131,22 @@
 
 ---
 
+## 9. Shop-Bestandsabzug beim Versand & API-Bestellungen (neu 16.07.2026)
+
+**Wo:** Menü **[Verkäufe](/admin/sales)** (Statuswechsel) und **[API-Bestellungen](/admin/inventory/api-orders)** (Warenwirtschaft)
+
+**Neu:**
+- Beim Setzen einer Bestellung auf **„versendet"** oder **„abgeschlossen"** bucht das System je Position automatisch einen **Abgang im Produktbestand** (Grund „Verkauf"). **Sets** werden in Einzelprodukte aufgelöst. Zurücksetzen oder **Storno** bucht automatisch zurück.
+- Menüpunkt **API-Bestellungen**: Protokoll aller über die Partnercenter-API übertragenen Bestellungen. Einträge mit **nicht zuordenbaren Positionen** (unbekannte WP-Nummer) sind **rot markiert**; **„Ansehen"** öffnet den Inhalt der Übertragung. Oben warnt die Seite bei **doppelten WP-Nummern** und listet aktive Produkte **ohne WP-Nummer**.
+
+**So testen:** Eine Bestellung mit bekanntem Produkt auf „versendet" setzen → im **[Produktbestand → Historie](/admin/inventory/product-stock/history)** erscheint der Abgang „Verkauf"; Status zurück auf „offen" → Gegenbuchung. Danach unter **API-Bestellungen** eine Übertragung mit unbekannter SKU suchen (rot markiert) und per „Ansehen" die Positionen prüfen.
+
+---
+
 ## Hinweis am Rande
 
 Die Listen **Einkauf & Wareneingang** und **Produktionen** zeigen aus Performance-Gründen die neuesten 500 Einträge; darüber erscheint ein Link **„Alle anzeigen"**. Offene Bestellungen sind immer vollständig gelistet.
 
 ## Was bewusst noch nicht dabei ist (nachgelagert)
 
-Shop-Bestandsabzug beim Versand (inkl. Sets), Audit-Trail, 2FA, blockbasierte Rechte und die WaWi-Einstellungsseite folgen in der nächsten Runde.
+Versand im System (DHL-Etiketten per API), Audit-Trail, 2FA, blockbasierte Rechte und die WaWi-Einstellungsseite folgen in der nächsten Runde.