Verkaufsbeleg — Anhänge (Sub-Route)

Zweck

Sub-Route /sales-documents/:id/documents listet alle Anhänge, die über DocumentParent mit parentType = SalesDocument und parentId = :id verknuepft sind — typischerweise unterschriebene Verträge, Lieferscheine, Korrespondenz. Standard-Pattern siehe Dokumente und Anhaenge.

Voraussetzungen

- Berechtigung `view:SalesDocument`, `view:Document`, `view:DocumentParent`. - Für Upload: `create:Document`/`create:DocumentParent`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_SalesDocument, SalesDocument	Detail aufrufbar	—
view/create	Document, DocumentParent	Anhänge pflegen	APP_SPEAMCORE_VIEW/CREATE_DOCUMENT, DOCUMENT_PARENT

Schritt-für-Schritt-Anleitung

1. Verkaufsbeleg (/sales-documents/:id) → Tab Anhänge.
2. Hochladen — Datei wählen oder Drag-and-Drop.
3. Drill-Down via Klick auf eine Zeile zu /documents/:id.

Anlege-Pattern (Standard-Document)

Standard-Dokument-Upload (siehe Dokumente und Anhaenge). Erzeugt Document + DocumentParent mit parentType = SalesDocument, parentId = :id.

Typische Inhalte:

• Eingehende Bestellung des Kunden (PDF)
• Lieferschein-Scan
• E-Mail-Korrespondenz zur Beleg-Klaerung
• Auftrags-bestätigte Skizzen, Zeichnungen, Specs

Bei einem Beleg mit Parent „eingegangenes Dokument" (siehe Sales-Documents-Toolbar) erscheint die Quelldatei automatisch in diesem Tab.

Wiederverwendbare Konzepte

• Dokumente und Anhaenge
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Verkaufsbelege — Eltern-Modul.
• Document-Center — globale Sicht.
• Documents — Detail.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/document-parents?filter[parentType=SalesDocument]	Anhänge	view DocumentParent
POST	/api/documents	Upload	create Document

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.