Artikel-Dokumente
Mit Artikel-Dokumente verwalten Sie die Verknuepfungen zwischen einem ERP-Artikel und bestehenden Eintraegen im Dokumentenarchiv. Dies ist Verknuepfungs-Verwaltung, kein Datei-Upload — Sie verknuepfen Dokumente, die bereits im DocumentManager-Archiv liegen, ueber ihre ID.
Bereiche
- Verknuepfte Dokumente: verknuepfte Archiv-Dokumente des Artikels auflisten, sortieren und loesen.
- Dokument verknuepfen: das Dokumentenarchiv durchsuchen, ein bestehendes Dokument auswaehlen und verknuepfen.
- Hilfe: In-App-Hinweise.
Felder und Konzepte
- Artikel-Dokumentverknuepfung:
document_archive_id, optionaledisplay_label,doc_typeundsort_order. - Archiv-Dokument: ein bestehender Eintrag im DocumentManager-Archiv (ID, Name, MIME-Typ).
Backend-Vertrag
Alle Routen sind mandantenbezogen (aus dem Request aufgeloest).
GET /api/erp/items/{itemId}/documents— verknuepfte Dokumente auflisten.POST /api/erp/items/{itemId}/documents— bestehendes Dokument verknuepfen. Body:{document_archive_id, display_label?, doc_type?, sort_order?}. Liefert 201 bzw. 409 bei Konflikt.DELETE /api/erp/items/{itemId}/documents/{documentArchiveId}— Verknuepfung loesen.PATCH /api/erp/items/{itemId}/documents/order— sortieren. Body:{ordered: [document_archive_id, …]}.- Die Archiv-Auswahl liest aus
GET /api/document-manager?search=&page=&pageSize=(liefert{items: [...]}).
Die Authentifizierung erfolgt ueber httpOnly-Cookie + CSRF via @it-tremmel.de/platform-http authedFetch (credentials: 'include'); es werden keine Tokens aus localStorage gelesen.
Typischer Ablauf
- Dokument verknuepfen oeffnen und das Archiv durchsuchen.
- Ein Dokument auswaehlen und verknuepfen; es erscheint unter Verknuepfte Dokumente.
- Verknuepfte Dokumente mit den Pfeiltasten sortieren.
- Eine Verknuepfung loesen, wenn sie nicht mehr benoetigt wird — das zugrunde liegende Archiv-Dokument wird nicht geloescht.
Aktionen werden während der Bestätigung, Verarbeitung und des anschließenden Nachladens gesperrt. Mehrfaches Auslösen erzeugt keine zweite Anfrage. Nach Abschluss oder einem Fehler können Sie erneut versuchen.