Wie hänge ich Dateien an ein Asset an?

Ab Tarif Basic

Kurzantwort

Notory speichert Anhänge (Rechnungen, Lieferscheine, Fotos, Handbücher) zu einem beliebigen Objekt über dessen Typ und ID. Für Assets läuft das aktuell über die API (POST /api/v1/attachments mit entity_type=asset); in der Weboberfläche gibt es den Datei-Dialog derzeit bei Katalog-Datensätzen (Modul Daten → Büroklammer-Symbol „Dateien”). Die maximale Dateigröße beträgt standardmäßig 25 MB.

Voraussetzungen

Anhänge sind in allen Tarifen verfügbar (kein Feature-Gating).

Stand heute: Der Upload-Dialog der Weboberfläche ist an Katalog-Datensätze (Modul Daten) angebunden. Die Asset-Detailansicht hat noch keinen eigenen Datei-Bereich. Für Anhänge direkt an einem Asset nutze den API-Tab. So sieht der Dialog bei Datensätzen aus:

Modul „Daten” öffnen und den Objekttyp wählen. Klicke in der Zeile des Datensatzes auf das Büroklammer-Symbol (Dateien).

Screenshot ausstehend assets-anhaenge-01 Dialog 'Dateien' eines Datensatzes mit der Schaltfläche 'Datei hochladen' und einer Dateiliste

Der Datei-Dialog: hochladen, herunterladen, löschen, mit Dateigröße je Eintrag.
„Datei hochladen” klicken und die Datei auswählen. Sie erscheint sofort in der Liste, mit Name und Größe.
Herunterladen oder löschen. Über die Symbole rechts lädst du eine Datei herunter oder entfernst sie (mit Bestätigungsdialog).

Anhänge hängen an entity_type + entity_id, für Assets also asset + Asset-ID. Der Upload ist ein Multipart-Formular:

curl -X POST https://demo.notory.io/api/v1/attachments \
  -H "Authorization: Bearer inv_dein_token" \
  -F "file=@rechnung-thinkpad.pdf" \
  -F "entity_type=asset" \
  -F "entity_id=a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55"

{
  "id": "f7e2a1b8-3c4d-4e5f-9a0b-1c2d3e4f5a6b",
  "entity_type": "asset",
  "entity_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "filename": "rechnung-thinkpad.pdf",
  "content_type": "application/pdf",
  "size_bytes": 184227,
  "created_at": "2026-07-08T10:15:03+00:00"
}

Anhänge eines Assets auflisten:

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/attachments?entity_type=asset&entity_id=a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55"

Herunterladen und löschen:

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/attachments/f7e2a1b8-3c4d-4e5f-9a0b-1c2d3e4f5a6b/download \
  --output rechnung-thinkpad.pdf

curl -X DELETE -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/attachments/f7e2a1b8-3c4d-4e5f-9a0b-1c2d3e4f5a6b

Mögliche Fehler: 401 (Token fehlt/ungültig), 413 (Datei größer als das Limit, Standard 25 MB), 404 (Anhang gehört zu einem anderen Mandanten).

Was passiert dabei?

Mandanten-Zuordnung: Jeder Anhang gehört zu deinem Mandanten; andere Mandanten können ihn weder auflisten noch herunterladen (404).
Uploader wird vermerkt: Notory speichert, welcher Benutzer die Datei hochgeladen hat, samt Zeitstempel (created_at).
Größenlimit: Standardmäßig 25 MB pro Datei (Instanz-Einstellung MAX_ATTACHMENT_MB); größere Uploads werden mit 413 abgelehnt.
Beliebige Objekttypen: Dieselbe API versorgt auch Katalog-Datensätze (entity_type=record). Das nutzt der Datei-Dialog im Modul Daten.
Speicherung: Die Dateien liegen im Storage-Backend der Installation (Standard: lokales Dateisystem; alternativ S3/MinIO, je nach Server-Konfiguration).
Kein Gating: Anhänge zählen nicht gegen das Asset-Limit und sind tarifunabhängig.