Kunden — Offene Posten (Sub-Route)

Zweck

Sub-Route /customers/:id/open-items zeigt alle Forderungen aus den Verkaufsbelegen des Kunden mit Settlement-Status (open, partial, settled, overpaid). Die Liste ist filter- und sortierbar; Drill-Down zur Verarbeitungsoberflaeche /open-items ist möglich.

Voraussetzungen

- Berechtigung `view:Customer` und `view:OpenItem`. - Verkaufsbelege, die offene Posten erzeugt haben.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Customer, Customer, FE_OpenItem, OpenItem	Liste sichtbar	—

Schritt-für-Schritt-Anleitung

1. Kunde (/customers/:id) → Tab Offene Posten.
2. DataGrid filtert auf OpenItem-Einträge wo der zugehörige Beleg den Kunden referenziert. Spalten: Beleg-Nr., Datum, Brutto, Offen (Restbetrag), Faelligkeit (mit Faelligkeits-Indikator gruen/gelb/rot), Status.
3. Klick auf eine Zeile fuehrt zur globalen OP-Liste bzw. zur Belegdetail-Sicht. Zahlung erfassen erfolgt über das Transaktions-Cockpit (Match-Vorschlag) oder manuelle Allokation einer Transaktion.

**Reine Lese-Sicht.** Diese Sub-Route ist eine **gefilterte** Variante von [/customer-open-items](/customer-open-items), eingebettet im Kunden-Detail. Direktes Zahlung-Erfassen ist **nicht** möglich; das laeuft über Transaktion → Allokation. Das ist by-design um eine saubere Buchhaltung zu erzwingen: jede Zahlung muss von einer Bank-Transaktion ausgehen.

Wiederverwendbare Konzepte

• Buchhaltungskonten
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Kunden — Eltern-Modul.
• Customer-Open-Items — Globale Sicht der Customer-Open-Items.
• Open-Items — Verarbeitungsoberflaeche für Zahlungseingang.
• Verkaufsbelege — Quelle der offenen Posten.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/open-items?filter[customerId]	OPs pro Kunde	view OpenItem

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.