docs: document checkout split API and payload in grand functions

This commit is contained in:
DanielS
2026-07-09 21:50:44 +02:00
parent f71fc7f88d
commit 5eef6c76ef

View File

@@ -39,3 +39,17 @@ graph TD
- **Bearbeiten**: Unvollständige Bestellungen (`status != 'completed'`) können von jedem Mitarbeiter der jeweiligen Firma nachträglich editiert werden.
- **Admin-Workflow**: Admins sehen in `/admin/orders` alle Bestellungen global, können den Status ändern (z.B. von *Eingegangen* auf *In Bearbeitung* oder *Abgeschlossen*) und PDF-Rechnungen manuell herunterladen.
- **Statusänderungs-Mails**: Bei jedem Statusübergang wird automatisch eine Benachrichtigungs-E-Mail an den Besteller geschickt.
---
### E. Multi-Kassen-Warenkorb & Checkout-Split
- **Endpunkt**: `POST /api/orders/checkout`
- **Funktionsweise**:
- Empfängt ein Array von `items` (Kassenkonfigurationen).
- Teilt die Konfigurationen nach `billingInterval` / `billingType` auf (Kauf vs. Abo).
- Erstellt separate Orders in der Datenbank:
- Typ `purchase`: Zahlungsart `invoice` (Rechnung).
- Typ `subscription`: Zahlungsart `sepa`.
- Friert für jede Order einen konsolidierten `order_snapshot` (JSONB) und `customer_snapshot` (JSONB) ein.
- Triggert die PDF-Rechnungserstellung und den E-Mail-Versand unabhängig für jede generierte Order.