Shop-Bestellungen

Zweck

Shop-Bestellungen (ShopOrder) entstehen aus einem oder mehreren Warenkoerben (ShoppingCart) — typischerweise wenn ein Anwender im Shop auf „Bestellung erstellen" klickt. Pro Bestellung sehen Sie Status (pending, confirmed, shipped, delivered, cancelled), Summen und ggf. einen verknuepften Bestellbeleg (Convert-to-PurchaseDocument).

Voraussetzungen

- Mindestens ein Warenkorb mit Produkten. - Berechtigung `create:ShopOrder` zum Erstellen. - Für Convert-Action: `create:PurchaseDocument`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_ShopOrder, ShopOrder	Liste/Details aufrufbar	—
create/update	ShopOrder	Bestellungen anlegen, bestaetigen, stornieren	APP_SPEAMCORE_CREATE/UPDATE_SHOP_ORDER
view	ShoppingCart	Sub-Tab Warenkoerbe	APP_SPEAMCORE_VIEW_SHOPPING_CART
create	PurchaseDocument	Convert-Action	APP_SPEAMCORE_CREATE_PURCHASE_DOCUMENT

Schritt-für-Schritt-Anleitung

Bestellung anlegen

Wird typischerweise vom Shop ausgeloest:

1. Im Warenkorb (/shop/shopping-carts) Bestellung erstellen.
2. POST /api/shop-orders mit shoppingCartIds.
3. Bestellung wird mit Status pending angelegt.

Bestaetigen

1. Auf der Detail-Seite Bestaetigen klicken.
2. POST /api/shop-orders/:id/confirm — Status wechselt auf confirmed. Triggert ggf. E-Mail-Benachrichtigung.

In Bestellbeleg konvertieren

1. In Bestellbeleg umwandeln klicken — Modal fragt Lieferant ab.
2. POST /api/shop-orders/:id/to-purchase-document?supplierId=:id — erzeugt einen verknuepften PurchaseDocument.
3. Sie werden auf den neuen Bestellbeleg weitergeleitet.

UI-Elemente

Button: „Bestaetigen"

Detailseite. Erfordert update:ShopOrder. Statuswechsel pending → confirmed.

Button: „In Bestellbeleg umwandeln"

Detailseite. Erfordert create:PurchaseDocument. Erzeugt verknuepften Beleg.

Felder und Eingaben

Feldname	Pflicht	Datentyp	Wirkung beim Ausfuellen	Voraussetzung
status	—	Enum	pending, confirmed, shipped, delivered, cancelled. System-gesteuert über Custom-Endpoints.	—
totalPrice	—	Decimal	Aggregierter Wert aus den Warenkoerben. Read-only.	—
totalQuantity	—	Integer	Aggregierte Menge. Read-only.	—
shoppingCartIds	ja (beim Anlegen)	Array UUID	Verknuepft die Bestellung mit Warenkoerben.	view:ShoppingCart.

Workflows und Zustaende

Hinweis zur Validierung: Im Live-Walkthrough konnten die Status-Uebergaenge nicht reproduziert werden, weil der Demo-Mandant keine Bestellungen enthält. Stand BE-Code: die Statuswerte werden über dedizierte Endpoints gesetzt (/confirm, /ship, /cancel, ...), aber es gibt keinen zentralen State-Machine-Validator im Code, der z. B. cancelled → confirmed blockiert. Wer den Status manuell via PATCH setzt, kann theoretisch alle Uebergaenge fahren — der Workflow oben ist die erwartete Sequenz, nicht die erzwungene.

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Shop (/shop) — Quelle der Warenkoerbe.
• Bestellbelege (/purchase-documents) — Ziel der Convert-Aktion.
• Kunden — Bestellungs-Empfaenger.
• Zahlungen — Tab Payments zeigt Zahlungs-Verknuepfungen.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/shop-orders	Liste	view ShopOrder
GET	/api/shop-orders/:id	Detail	view ShopOrder
POST	/api/shop-orders	Anlegen	create ShopOrder
PATCH	/api/shop-orders/:id	Ändern	update ShopOrder
POST	/api/shop-orders/:id/confirm	Bestaetigen	update ShopOrder
POST	/api/shop-orders/:id/to-purchase-document	In Bestellbeleg umwandeln	create PurchaseDocument

Versionshinweise

• 2026-04-29: Initiale Veroeffentlichung mit FE-Tiefen-Standard.