Zum Inhalt springen

App-Dokumentation · DE

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, optionale display_label, doc_type und sort_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

  1. Dokument verknuepfen oeffnen und das Archiv durchsuchen.
  2. Ein Dokument auswaehlen und verknuepfen; es erscheint unter Verknuepfte Dokumente.
  3. Verknuepfte Dokumente mit den Pfeiltasten sortieren.
  4. 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.