Kunden — Verkaufsbelege (Sub-Route)

Zweck

Sub-Route /customers/:id/sales-documents listet alle Verkaufsbelege, die mit dem Kunden verknuepft sind — Angebote, Auftrags-Bestaetigungen, Rechnungen, Gutschriften. Filter pro Belegtyp und Status möglich. Drill-Down fuehrt zur globalen Beleg-Detailseite.

Voraussetzungen

- Berechtigung `view:Customer` und `view:SalesDocument`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Customer, Customer, FE_SalesDocument, SalesDocument	Liste sichtbar	—

Schritt-für-Schritt-Anleitung

1. Kunde (/customers/:id) → Tab Verkaufsbelege.
2. DataGrid mit allen SalesDocument-Einträgen mit parentId = :id, parentType = Customer ODER parentType = Location mit locationId.customerId = :id (also Belege auf den Kunden direkt oder auf seine Standorte).
3. Filter nach Belegart (documentType) und Status.
4. Klick auf eine Belegzeile springt auf die globale Verkaufsbeleg-Detailseite (/sales-documents/:id).

**Lesende Sicht.** Neue Belege für den Kunden werden über [/sales-documents + Verkaufsbeleg hinzufuegen](/sales-documents) angelegt — dort wird der Empfaenger (`Customer` oder `Location`) im Beleg-Detail gewählt. Folgebelege via "Übernehmen in" laufen über die [Sales-Documents-Toolbar](/sales-documents#toolbar-detail-seite).

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Kunden — Eltern-Modul.
• Verkaufsbelege — Globale Sicht.
• Verkaufsbeleg-Positionen — Cross-Beleg-Sicht.
• Customer-Open-Items — Offene Posten aus Belegen.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/sales-documents?filter[customerId]	Aggregation pro Kunde	view SalesDocument

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.