Paperless-ngx Best Practices: Tags, Dokumenttypen und Workflows richtig einrichten

„Ich habe alles eingescannt, aber finde trotzdem nichts wieder.“ Wenn dir dieser Satz bekannt vorkommt, liegt das selten am Scanner und fast immer an der Taxonomie. Paperless-ngx zu installieren ist für Profis in einer halben Stunde gemacht. Eine saubere Struktur aufzubauen, die auch in zwei Jahren noch funktioniert, ist die eigentliche Aufgabe. Die gute Nachricht: Du musst das Rad nicht neu erfinden. Ein paar Grundregeln, drei, vier Beispiele und ein bisschen Disziplin am Anfang – dann wächst dein Archiv sauber mit.

In diesem Post schauen wir uns die vier Metadaten-Säulen von Paperless-ngx an, zeigen konkrete Taxonomie-Beispiele für Freelancer, KMU und Vereine, und bauen drei Workflows, die du direkt nachbauen kannst.

Das Wichtigste in Kürze

• Vier Metadaten-Säulen: Korrespondent (Wer), Dokumenttyp (Was), Tag (Querschnitt), Speicherpfade (Wohin auf der Platte). Hier sauber trennen, nicht mischen.
• Tags flach halten – keine Hierarchie durch übergeordnete Elemente erzwingen. Präfixe wie kunde/ oder projekt/ sind eine einfache Alternative.
• 1 Dokument = 1 Dokumenttyp, n Tags. Das ist die häufigste Verwechslung.
• Workflows / Arbeitsabläufe (seit Version 2.3) ersetzen die alten Verarbeitungs-Templates und können weit mehr: E-Mails versenden, benutzerdefinierte Felder setzen, Berechtigungen zuteilen, uvm.
• Weniger am Anfang, mehr mit der Zeit. Eine Handvoll Tags und rund zehn Dokumenttypen reichen für den Start. Unübersichtliche Tag-Friedhöfe entstehen nur, wenn du in „vorauseilendem Gehorsam“ vorab alles definierst.

Die vier Metadaten-Säulen

Paperless-ngx organisiert Dokumente über vier unterschiedliche Metadatentypen. Jeder beantwortet eine andere Frage:

Korrespondenten – Wer hat das Dokument geschickt?

Ein Korrespondent ist der Absender oder bei ausgehender Post der Empfänger. Beispiele: Finanzamt München, Allianz, Telekom, Hausverwaltung Müller. Bei deinen eigenen Ausgangsrechnungen wird dein Kunde zum Korrespondenten – nicht du selbst. Klassischer Anfänger-Fehler, der sich später heimzahlt.

Dokumenttypen – Was ist das Dokument?

Rechnung, Vertrag, Kontoauszug, Kündigung, Bescheid. Der Dokumenttyp beschreibt die Natur des Dokuments, nicht seinen Inhalt oder sein Projekt. Zehn Dokumenttypen reichen am Anfang locker.

Tags – Querschnittsthemen und Zustände

Tags sind das flexibelste Werkzeug. Ein Dokument darf beliebig viele Tags haben. Sinnvolle Tags beschreiben:

• Zustände: Posteingang, zu-zahlen, bezahlt, erledigt, freigabe-gf
• Jahres- oder Themenbezug: steuer-2026, kassenpruefung-2025
• Projekte oder Kunden: kunde/a-gmbh, projekt/digitalisierung
• Sichtbarkeit: vertraulich

Speicherpfade – Wo liegt die Datei auf der Platte?

Oft übersehen, aber wichtig für Export und Backup. SSpeicherpfade_ sind als Jinja-Templates wie {{ correspondent }}/{{ document_type }}/{{ created_year }} definiert und bestimmen, unter welchem Pfad die Datei „physisch" im Dateisystem“ liegt. Das ist keine Navigationsstruktur für den Browser, sondern für den Fall, dass du jemals einen sauber strukturierten Export brauchst – etwa für den Steuerberater, eine GoBD-Prüfung oder du doch nochmal von Paperless-ngx auf ein anderen Tool wechseln möchtest.

Taxonomie-Beispiele aus der Praxis

Theorie ist schön. Hier drei „Starter-Packs“, die wir empfehlen.

Freelancer (Einzelunternehmerin, UI-Design)

• Korrespondenten: Finanzamt, Krankenkasse, DATEV, Hausverwaltung, Kunde A GmbH, Kunde B AG, eigene Firma (für Ausgangsrechnungen, falls sie gespeichert werden)
• Dokumenttypen: Ausgangsrechnung, Eingangsrechnung, Quittung, Vertrag, Angebot, Steuerbescheid, Kontoauszug, Gehaltsabrechnung, Versicherungspolice, Mahnung
• Tags: Posteingang, steuer-2026, zu-zahlen, bezahlt, kunde/a-gmbh, kunde/b-ag, privat, firma, reisekosten

KMU (10–30 Mitarbeitende)

• Korrespondenten: Lieferanten (z.B. Würth, Amazon Business), Stammkunden, Finanzamt, Krankenkassen (AOK, TK, Barmer), Berufsgenossenschaft, IHK, Banken, Steuerberater, Leasinggeber
• Dokumenttypen: Eingangsrechnung, Ausgangsrechnung, Lieferschein, Bestellung, Vertrag, Arbeitsvertrag, Kündigung, Zeugnis, Gehaltsabrechnung, Personalakte, Protokoll, Handelsregisterauszug, Versicherung, Bescheid
• Tags: Posteingang, freigabe-gf, freigabe-buchhaltung, bezahlt, offen, abteilung/hr, abteilung/vertrieb, abteilung/einkauf, projekt/digitalisierung-2026, standort/muenchen, vertraulich

Verein

• Korrespondenten: Finanzamt, Amtsgericht, Bank, Versicherung, Sponsor A, Vermieter, Vereinsregister, einzelne Mitglieder nur bei Bedarf
• Dokumenttypen: Protokoll, Satzung, Spendenbescheinigung, Zuwendungsbescheid, Kassenbericht, Mitgliedsantrag, Beitragsrechnung, Bank-Kontoauszug, Vertrag, Versicherungspolice
• Tags: Posteingang, vorstand, kassenpruefung-2025, gemeinnuetzigkeit, projekt/sommerfest-2026, projekt/jugendcamp, foerderantrag, archiv

Tags sinnvoll anlegen

Flach statt hierarchisch – mit Präfixen arbeiten

Paperless-ngx bietet verschachtelte Tags (bis zu 5 Ebenen tief). Fügt man einem Dokument einen Tag hinzu, werden automatisch alle darüberliegenden Tags ebenfalls zugeordnet. Entfernt man einen Tag, werden alle darunterliegenden Tags mit entfernt. Diese Kaskadierung ist häufig Monate nach dem initialen Anlegen wieder vergessen, was dann zu unerwünschten Effekten führt. Zudem bringt sie aus unserer Sicht eine Komplexität in ein eigentlich so simples System. Wenn du trotzdem Gruppen bilden willst, empfehlen wir Präfixe: kunde/a-gmbh, kunde/b-ag, projekt/digitalisierung. In der Suche und in Dropdowns sortieren sich solche Tags automatisch zusammen.

Farbkodierung und Posteingang-Tag

Ein roter Posteingang-Tag auf allen frisch reingekommenen Dokumenten ist der wichtigste Workflow-Anker überhaupt. Gelb für „offen / zu bearbeiten“, grün für „erledigt / bezahlt“ – mehr Farben brauchst du selten.

Typische Fehler, die du vermeiden solltest

• Tag-Friedhof: 80 Tags vorab anlegen, die nie benutzt werden. Lieber mit 5–10 starten und Tags bei Bedarf anlegen.
• Projektnamen als Dokumententyp: Projektnamen als Dokumenttyp zu verwenden vermischt zwei unabhängige Ordnungsdimensionen (Form und Thema) in einem Feld und lässt die Dokumenttyp-Liste mit weitgehend leeren Einträgen zuwuchern. Projekte gehören stattdessen in Tags.
• Korrespondenten als Tags: Wenn „Telekom“ bereits Korrespondent ist, braucht es keinen Tag telekom.
• Speicherpfad als Navigation: Dafür sind Tags da. Speicherpfade sind die Antwort auf „Wo liegt die Datei im Dateisystem?“, nicht „Wo finde ich sie?“

Automatische Zuweisung: So lernt Paperless deine Ablage

Jeder Tag, Korrespondent und Dokumenttyp kennt ein Feld Zuweisungsalgorithmus mit den Optionen „Keiner“, „Irgendein Wort“, „Alle“, „Exakt“, „Regex“, „Ungenau“ und „Auto“. Die spannendste Option ist Auto: Paperless trainiert im Hintergrund einen Textklassifizierer (ein neuronales Netz mithilfe der scikit-learn Bibliothek) und lernt aus deinen bereits klassifizierten Dokumenten.

In der Praxis greift das Training nachdem eine Handvoll Beispieldokumente pro Label existiert. Davor wird der Klassifizierer übersprungen und schreibt einen entsprechenden Log-Hinweis. Details dazu findest du in der offiziellen Doku zum Automatic Matching. Wer mehr Kontextverständnis braucht, kombiniert das eingebaute Matching mit einem LLM – dazu schreiben wir in einem Folge-Post in Kürze mehr.

Workflows / Arbeitsabläufe: Automatisierung seit Version 2.3

Seit Version 2.3 gibt es in Paperless-ngx ein echtes Workflow-System, das die alten Verarbeitungs-Templates abgelöst hat. Im deutschen wird Workflows mit Arbeitsabläufe übersetzt. Wir benutzen im Folgenden beide Begriffe synonym. Ein Arbeitsablauf besteht aus drei Teilen:

• Trigger: Verarbeitung gestartet, Dokument hinzugefügt, Dokument aktualisiert oder Geplant
• Filter: Bedingungen wie Korrespondent, Dokumenttyp, Tags, Dateipfad, Filter auf benutzerdefinierten Feldern
• Aktionen: Tags/Korrespondent/Typ zuweisen, Berechtigungen setzen, benutzerdefinierte Felder füllen, E-Mail versenden, Webhook auslösen (je nach Version)

Beispiel 1: DATEV-PDFs automatisch taggen und an Steuerberater mailen

• Trigger: Verarbeitung gestartet
• Filter: Dateiname matcht *datev*.pdf oder Korrespondent = „DATEV“
• Aktionen: Tag steuerberater-weiterleitung setzen, Dokumenttyp „Steuerunterlage“, E-Mail an stb@kanzlei.example mit Anhang

Voraussetzung ist ein konfigurierter SMTP-Server in Paperless-ngx.

Beispiel 2: Rechnungen über 1.000 € markieren

• Trigger: Dokument aktualisiert
• Filter: Dokumenttyp = „Eingangsrechnung“ UND benutzerdefiniertes Feld Betrag > 1000
• Aktionen: Tag freigabe-gf setzen, optional Webhook an einen internen Mattermost-Channel

Voraussetzung ist ein benutzerdefiniertes Feld Betrag vom Typ „Währung”.

Beispiel 3: Routing nach Verarbeitungs-Unterordner

Mit PAPERLESS_CONSUMER_RECURSIVE=true (bei server.camp-gehosteten Paperless-ngx-Instanzen standardmäßig aktiviert) und PAPERLESS_CONSUMER_SUBDIRS_AS_TAGS=true (über unser Dashboard für deine Instanz aktivierbar) werden Unterordner im „Consume“-Verzeichnis automatisch zu Tags. So kannst du mehrere Scanner oder mobile Uploader auf dieselbe Paperless-Instanz zeigen lassen – jeder bekommt seinen Unterordner und damit ein Routing-Kriterium.

Beispiel-Struktur:

consume/
  scanner-empfang/
  scanner-buchhaltung/
  scan-mobile/

Ein Workflow mit Filter „Beliebige Tags = scanner-buchhaltung“ kann dann Dokumenttyp und Besitzer (Gruppe „Buchhaltung“) direkt zuweisen.

Benutzerdefinierte Felder für strukturierte Daten

Seit Version 2.0 bietet Paperless-ngx benutzerdefinierte Felder. Typen: Text, Zahl, Datum, Wahrheitswert (true, false), URL, Select, Währung und Dokumentenverknüpfung. Sinnvoll sind sie für alles, was du strukturiert abfragen willst:

• Rechnungsnummer (Text)
• Betrag (Währung – erwartet ISO-4217-Code, z.B. EUR1234.56)
• Fälligkeitsdatum (Datum)
• Status (Select mit Optionen „offen“, „bezahlt“, „in Klärung“)
• Gehört zu Vertrag (Dokumentenverknüpfung – erzeugt automatisch eine symmetrische Rückverlinkung)

In Kombination mit Workflows wirst du sehen, warum das Feature so unterschätzt ist: „Wenn Status = offen und Fälligkeitsdatum in den nächsten 7 Tagen, dann Tag mahnung-droht.“

Speicherpfade mit Template-Variablen

Speicherpfade sind Jinja-Templates, die den physischen Dateipfad bestimmen. Beispiele:

• Rechnungen/{{ created_year }}/{{ correspondent }}
• Verein/Protokolle/{{ created_year }}
• Kunde/{{ tag_list | select("match", "^kunde/") | first | default("sonstige") }}/{{ document_type }}

Wenn du keine Speicherpfade definierst, greift der globale PAPERLESS_FILENAME_FORMAT. Für Backup, Export und den Fall eines Umzugs ist eine saubere Struktur Gold wert.

Quickstart in 5 Schritten

1. Posteingang-Tag anlegen und rot färben. Automatisch gesetzt für alle neuen Dokumente.
2. 5–10 Dokumenttypen definieren (Rechnung, Vertrag, Quittung, Kontoauszug, Bescheid, Protokoll). Mehr brauchst du am Anfang nicht.
3. Die 10 häufigsten Absender als Korrespondenten anlegen – nicht auf Vorrat, sondern beim ersten Kontakt.
4. Matching-Algorithmus „Auto“ für alle neuen Tags und Korrespondenten wählen, 4–5 Dokumente manuell zuordnen, dann übernimmt Paperless.
5. Einen einzigen Workflow bauen: „Alle neuen Dokumente bekommen Tag Posteingang.“ Den Rest organisch wachsen lassen.

Häufige Fragen

Kann ich Tags später umbenennen, ohne alle Dokumente neu zu taggen? Ja. Paperless-ngx speichert Tags als Referenz. Wenn du den Tag-Namen änderst, ändert er sich automatisch überall.

Wie viele Tags sind zu viele? Eine gute Faustregel: Wenn du in der Tag-Liste scrollen musst, hast du zu viele. Präfixe helfen, weil sie Tags optisch gruppieren.

Sollte ich ASN-Labels von Anfang an nutzen? Nur, wenn du Papier-Originale aufbewahren musst. Für rein digitale Workflows bringen ASN-Labels wenig. Details dazu haben wir im Paperless-ngx Einsteiger-Post beschrieben.

Kann ich Workflows auch rückwirkend auf bestehende Dokumente anwenden? Ja. Der Workflow-Trigger „Geplant“ und der Massenbearbeitungs-Dialog decken die meisten nachträglichen Anpassungen ab.

Was, wenn ich mich vertue? Paperless-ngx hat eine Massenbearbeitung, Zurück und einen Papierkorb. Und Tags kannst du jederzeit umbenennen oder zusammenführen. Perfektion ist nicht das Ziel, Ordnung schon.

Fazit

Gute Taxonomie ist keine Wissenschaft, sondern Disziplin. Drei Regeln, an die du dich halten solltest: Trenne die vier Metadatentypen sauber, halte Tags flach und starte mit wenig. Der Rest ergibt sich aus deinem Alltag – die Dokumente, die dir am häufigsten begegnen, werden dir zeigen, welche Tags du wirklich brauchst.

Wenn du dir das Setup-Thema komplett sparen willst und lieber direkt strukturiert loslegst, lohnt sich ein Blick auf Managed Hosting. Damit bist du in nur 3 Minuten startklar!