n8n + Paperarchive: Dokumenten-Workflows automatisieren

n8n ist eine leistungsstarke Open-Source-Workflow-Automatisierungsplattform, die Hunderte von Apps und Diensten über einen visuellen, knotenbasierten Editor verbindet. Durch die Integration von n8n mit der Paperarchive API kannst du automatisierte Dokumentenverarbeitungs-Pipelines aufbauen, die rund um die Uhr laufen, ohne Code zu schreiben - von E-Mail-zu-Archiv-Workflows über Buchhaltungsintegrationen bis hin zu KI-gestützter Dokumentenanalyse.

Diese Anleitung führt dich durch das komplette Setup: n8n installieren, Paperarchive-Zugangsdaten konfigurieren, deinen ersten Automatisierungs-Workflow bauen und fortgeschrittene Anwendungsfälle für die Automatisierung von Dokumentenmanagement erkunden.

Warum n8n mit Paperarchive kombinieren?

Paperarchive bietet KI-gestützte Dokumentenspeicherung mit automatischer OCR, Kategorisierung und Volltextsuche. n8n fügt die Automatisierungsebene hinzu, die Paperarchive mit dem Rest deines digitalen Ökosystems verbindet:

  • E-Mail-zu-Archiv: Automatisch PDF-Anhänge aus eingehenden E-Mails extrahieren und zur sofortigen Verarbeitung und Kategorisierung zu Paperarchive hochladen.
  • Buchhaltungs-Synchronisation: Wenn Paperarchive ein Dokument als Rechnung kategorisiert, die extrahierten Daten (Betrag, Datum, Absender) an dein Buchhaltungstool wie Lexoffice, sevDesk oder QuickBooks weiterleiten.
  • Cloud-Speicher-Backup: Einen Google-Drive- oder Dropbox-Ordner auf neue Dateien überwachen und automatisch in Paperarchive mit KI-gestützter Metadatenextraktion archivieren.
  • Benachrichtigungs-Pipelines: Eine Slack- oder E-Mail-Benachrichtigung erhalten, wenn bestimmte Dokumenttypen hochgeladen werden, z.B. auslaufende Verträge oder steuerrelevante Rechnungen.
  • Massenverarbeitung: Hunderte von Dokumenten aus einem Ordner, einer CSV-Datei oder einem API-Endpunkt in einem einzigen automatisierten Durchlauf hochladen.

Voraussetzungen

Bevor du startest, brauchst du:

  • Ein Paperarchive-Konto mit einem aktiven Abo. Kostenlos registrieren, falls du noch keins hast.
  • Einen Paperarchive-API-Schlüssel. Erstelle einen unter Einstellungen > API-Schlüssel. Für Automatisierungs-Workflows empfohlene Scopes: documents:read, documents:write, search, spaces:read, categories:read, tags:read, senders:read.
  • Eine n8n-Instanz - entweder selbst gehostet oder n8n Cloud.

Schritt 1: n8n einrichten

Falls du n8n noch nicht betreibst, sind hier die schnellsten Wege zum Start:

n8n Cloud (am schnellsten)

Registriere dich bei n8n.io/cloud für eine gehostete Instanz ohne Setup. Eine kostenlose Testphase ist verfügbar.

Docker (selbst gehostet)

docker run -d --name n8n \
  -p 5678:5678 \
  -v n8n-data:/home/node/.n8n \
  n8nio/n8n

Öffne http://localhost:5678, um den n8n-Editor aufzurufen.

npm (selbst gehostet)

npm install -g n8n
n8n start

Schritt 2: Paperarchive-Zugangsdaten in n8n hinzufügen

Im n8n-Editor musst du Paperarchive als benutzerdefinierte API-Zugangsdaten einrichten, damit alle deine Workflows sich sicher authentifizieren können.

  1. Öffne den n8n-Editor und gehe zu Einstellungen > Zugangsdaten
  2. Klicke auf Zugangsdaten hinzufügen und wähle Header Auth
  3. Konfiguriere die Zugangsdaten:
    • Name: Paperarchive API
    • Header Name: Authorization
    • Header Value: Bearer pa_live_dein_key_hier
  4. Klicke auf Speichern

Diese Zugangsdaten stehen in allen HTTP-Request-Nodes in deinen Workflows zur Verfügung.

Schritt 3: Deinen ersten Workflow bauen - E-Mail zu Archiv

Die beliebteste Paperarchive-Automatisierung ist die E-Mail-zu-Archiv-Pipeline. So baust du sie Schritt für Schritt:

Workflow-Übersicht

Dieser Workflow überwacht deinen E-Mail-Posteingang, erkennt Nachrichten mit PDF-Anhängen, lädt jeden Anhang zu Paperarchive hoch und sendet dir eine Bestätigungsbenachrichtigung.

Node 1: E-Mail-Trigger

Füge einen IMAP-E-Mail-Trigger-Node hinzu und konfiguriere ihn mit deinen E-Mail-Zugangsdaten. Stelle ihn so ein, dass er alle paar Minuten auf neue E-Mails prüft. Aktiviere Anhänge herunterladen, um Dateidaten zu erfassen.

Node 2: Anhänge filtern

Füge einen IF-Node hinzu, um zu prüfen, ob die E-Mail Anhänge enthält. Setze die Bedingung auf: {{ $json.attachments.length > 0 }}

Node 3: Zu Paperarchive hochladen

Füge einen HTTP Request-Node mit diesen Einstellungen hinzu:

Method: POST
URL: https://api.paperarchive.io/v1/documents
Authentication: Header Auth (wähle deine Paperarchive API-Zugangsdaten)
Content-Type: multipart/form-data
Body Parameters:
  - file: {{ $binary.attachment_0 }}
  - space_id: deine-space-uuid (optional)

Node 4: Bestätigung

Füge einen Slack-, E-Mail- oder Telegram-Node hinzu, um dir eine Benachrichtigung zu senden:

"Neues Dokument archiviert: {{ $json.data.name }} - Verarbeitung gestartet."

Aktiviere den Workflow und jede E-Mail mit einem PDF-Anhang fließt ab jetzt direkt in dein Paperarchive-Konto.

Schritt 4: Such- und Abruf-Workflows hinzufügen

Über das Hochladen hinaus kann n8n auch Dokumentensuchen und Datenabruf aus Paperarchive automatisieren.

Webhook-gesteuerte Dokumentensuche

Baue einen Workflow, der einen Webhook-Endpunkt zum Durchsuchen deines Dokumentenarchivs bereitstellt:

// Webhook-Node empfängt:
POST https://deine-n8n-instanz.com/webhook/paperarchive-search
{
  "query": "Stromrechnung Januar 2026"
}

// HTTP-Request-Node ruft auf:
POST https://api.paperarchive.io/v1/search
Headers: Authorization: Bearer pa_live_dein_key
Body: {
  "query": "Stromrechnung Januar 2026",
  "limit": 5
}

// Antwort wird an den Webhook-Aufrufer zurückgegeben

Das verwandelt dein Paperarchive in einen API-zugänglichen Suchdienst, den jedes andere Tool oder jede Automatisierung abfragen kann.

Praxisnahe Automatisierungsrezepte

Rezept 1: Rechnungsverarbeitungs-Pipeline

Eingehende Rechnungen automatisch End-to-End verarbeiten:

  1. Trigger: E-Mail mit Rechnungsanhang kommt an
  2. Hochladen: n8n sendet das PDF an POST /v1/documents
  3. Warten: 30 Sekunden Verzögerung, bis Paperarchive OCR und KI-Analyse abgeschlossen hat
  4. Abrufen: Verarbeitetes Dokument über GET /v1/documents/:id abrufen
  5. Extrahieren: KI-Zusammenfassung nach Rechnungsbetrag, Datum und Absender parsen
  6. Synchronisieren: Extrahierte Daten an dein Buchhaltungstool senden (Lexoffice, sevDesk, Xero)
  7. Benachrichtigen: Zusammenfassung in deinen Slack-Kanal posten
// Nach Abschluss der Dokumentenverarbeitung enthält die Antwort:
{
  "data": {
    "title": "Invoice #2026-0142",
    "ai_summary": "Invoice for web hosting services, EUR 29.99, due April 1, 2026",
    "ocr_text": "Invoice #2026-0142\nDate: March 7, 2026\n...",
    "category_id": "invoices-category-uuid"
  }
}

Rezept 2: Google Drive zu Paperarchive synchronisieren

Dateien in einem Google-Drive-Ordner automatisch archivieren:

  1. Trigger: Google-Drive-Trigger überwacht einen "Zu archivieren"-Ordner
  2. Herunterladen: Neue Datei von Google Drive herunterladen
  3. Hochladen: Datei über die API an Paperarchive senden
  4. Verschieben: Originaldatei in einen "Archiviert"-Ordner in Google Drive verschieben
  5. Protokollieren: Zeile in ein Google Sheet mit Dokument-ID und Zeitstempel hinzufügen

Das erstellt einen nahtlosen Ablegen-und-Vergessen-Workflow: Lege Dateien in einen Ordner auf deinem Handy oder Desktop, und sie werden automatisch verarbeitet und archiviert.

Rezept 3: Wöchentlicher Dokumentenbericht

Eine wöchentliche Zusammenfassung aller neuen Dokumente in deinem Archiv erhalten:

  1. Trigger: Cron-Node wird jeden Montag um 9 Uhr ausgelöst
  2. Abrufen: GET /v1/documents?sort_by=created_at&sort_order=desc&limit=50 aufrufen
  3. Filtern: Nach Dokumenten filtern, die in den letzten 7 Tagen erstellt wurden
  4. Gruppieren: Dokumente nach Kategorie gruppieren
  5. Formatieren: Formatierte HTML-E-Mail mit Dokumentenanzahl pro Kategorie erstellen
  6. Senden: Den Bericht an dich selbst mailen

Rezept 4: Scan-Ordner-Überwachung

Wenn du einen Netzwerkscanner verwendest (z.B. Brother, Fujitsu ScanSnap), richte einen Workflow ein, der den Scan-Ausgabeordner überwacht und neue Dateien hochlädt:

  1. Trigger: Local-File-Trigger überwacht /scans/-Ordner
  2. Hochladen: Jedes neue PDF an POST /v1/documents senden
  3. Archivieren: Gescannte Datei in einen /verarbeitet/-Ordner verschieben

Kombiniert mit Paperarchives automatischer KI-Kategorisierung entsteht eine vollständig freihändige Scan-zu-Archiv-Pipeline.

Rezept 5: Dokumenten-Ablaufwarnungen

Verträge oder Dokumente überwachen, die bald ablaufen:

  1. Trigger: Täglicher Cron um 8 Uhr
  2. Suchen: POST /v1/search mit Suchanfrage "Vertrag" oder "läuft ab" aufrufen
  3. Abrufen: Vollständige Dokumentdetails abrufen und document_date prüfen
  4. Filtern: Dokumente finden, die in den nächsten 30 Tagen ablaufen
  5. Warnen: Benachrichtigung per E-Mail, Slack oder Push-Nachricht senden

Mit der Paperarchive API in n8n arbeiten

HTTP-Request-Node-Konfiguration

Alle Paperarchive-API-Aufrufe nutzen den HTTP Request-Node mit diesen gemeinsamen Einstellungen:

EinstellungWert
Basis-URLhttps://api.paperarchive.io/v1
AuthentifizierungHeader Auth (Paperarchive API-Zugangsdaten)
Content-Type (JSON)application/json
Content-Type (Upload)multipart/form-data

Paginierung handhaben

Verwende beim Auflisten von Dokumenten Paginierung, um große Archive zu verarbeiten:

// Erste Anfrage
GET /v1/documents?limit=50&offset=0

// Nutze das 'total'-Feld aus der Antwort für die Schleife
// Nächste Anfrage
GET /v1/documents?limit=50&offset=50

// Fortfahren bis offset >= total

In n8n nutze einen Loop Over Items-Node oder SplitInBatches-Node, um paginierte Ergebnisse zu verarbeiten.

Auf Dokumentenverarbeitung warten

Nach dem Hochladen eines Dokuments verarbeitet Paperarchive es asynchron (OCR, KI-Analyse). Wenn dein Workflow die verarbeiteten Daten benötigt, füge einen Wait-Node (15-60 Sekunden je nach Dokumentkomplexität) ein, bevor du die Dokumentdetails abrufst:

1. POST /v1/documents       → Hochladen, Dokument-ID erhalten
2. Wait 30 seconds           → Verarbeitung abwarten
3. GET /v1/documents/:id    → Mit OCR-Text und KI-Zusammenfassung abrufen

Fehlerbehandlung

Nutze n8ns integrierte Fehlerbehandlung, um API-Fehler elegant zu handhaben:

  • Füge einen Error Trigger-Node hinzu, um Workflow-Fehler abzufangen und Warnungen zu senden
  • Nutze IF-Nodes, um in API-Antworten auf success: false zu prüfen
  • Implementiere Retry-Logik für 429 Too Many Requests-Fehler mit einem Wait-Node
  • Protokolliere Fehler in einem Google Sheet oder einer Datenbank zur Fehlersuche

Deine Automatisierung skalieren

Rate-Limiting

Die Paperarchive API erlaubt 100 Anfragen pro Minute und 1.000 pro Stunde pro API-Schlüssel. Bei der Verarbeitung großer Mengen:

  • Nutze n8ns SplitInBatches-Node, um jeweils 10 Dokumente zu verarbeiten
  • Füge einen Wait-Node (1-2 Sekunden) zwischen den Batches ein
  • Überwache den X-RateLimit-Remaining-Header in den Antworten

Mehrere Workflows

Erstelle separate Workflows für verschiedene Automatisierungsaufgaben statt eines monolithischen Workflows. Das vereinfacht die Fehlersuche und ermöglicht es, einzelne Automatisierungen ein- und auszuschalten.

Zugangsdaten-Verwaltung

Erstelle für Produktiv-Setups separate Paperarchive-API-Schlüssel für jeden Workflow, damit du den Zugriff auf einzelne Automatisierungen widerrufen kannst, ohne andere zu beeinträchtigen.

Sicherheitshinweise

  • Minimale Scopes verwenden: Erstelle API-Schlüssel nur mit den Scopes, die jeder Workflow braucht. Ein Nur-Lese-Berichts-Workflow sollte keinen documents:write-Zugriff haben.
  • Spaces einschränken: Wenn ein Workflow nur Dokumente in einem bestimmten Space verarbeitet, beschränke den API-Schlüssel auf diesen Space.
  • n8n-Instanz absichern: Nutze HTTPS, starke Passwörter und schränke den Netzwerkzugriff auf deinen n8n-Editor ein.
  • API-Schlüssel rotieren: Rotiere regelmäßig die in automatisierten Workflows verwendeten Paperarchive-API-Schlüssel.
  • Workflows prüfen: Überprüfe aktive Workflows regelmäßig, ob sie noch benötigt werden und korrekt funktionieren.

Fehlerbehebung

ProblemLösung
HTTP Request gibt 401 zurückPrüfe, ob deine Header-Auth-Zugangsdaten den korrekten API-Schlüssel mit dem Präfix Bearer enthalten (beachte das Leerzeichen).
Datei-Upload schlägt fehl mit 400Stelle sicher, dass du als multipart/form-data sendest und die Datei im Feld file liegt. Unterstützte Formate: PDF, JPEG, PNG, TIFF.
Dokument hat nach dem Upload keinen OCR-TextDie Verarbeitung läuft asynchron. Füge einen Wait-Node (30+ Sekunden) ein, bevor du die Dokumentdetails abrufst.
Rate-Limit-Fehler (429)Füge Verzögerungen zwischen Anfragen mit Wait-Nodes ein. Nutze SplitInBatches für Massenoperationen.
Workflow wird nicht ausgelöstPrüfe, ob der Workflow aktiviert ist (Schalter oben rechts). Bei E-Mail-Triggern die IMAP-Zugangsdaten und das Abfrageintervall überprüfen.
Probleme mit BinärdatenWenn du Dateien von anderen Diensten herunterlädst, nutze den Ausdruck {{ $binary }}, um Binärdaten im HTTP-Request-Body zu referenzieren.

Häufig gestellte Fragen

Ist n8n kostenlos?

n8n ist Open Source und kostenlos zum Selbsthosten. n8n Cloud bietet kostenpflichtige gehostete Tarife mit einer kostenlosen Testphase. Beide Optionen funktionieren mit der Paperarchive API.

Brauche ich Programmierkenntnisse, um n8n mit Paperarchive zu nutzen?

Nein. n8ns visueller Editor ermöglicht es, komplette Automatisierungs-Workflows durch Verbinden von Nodes und Konfigurieren von Einstellungen zu bauen - ganz ohne Code. Für fortgeschrittene Anwendungsfälle kannst du JavaScript-Ausdrücke und Code-Nodes hinzufügen.

Wie viele Dokumente kann ich automatisch verarbeiten?

Es gibt kein hartes Limit auf der n8n-Seite. Paperarchives API-Rate-Limit von 100 Anfragen pro Minute bedeutet, dass du etwa 100 Dokumente pro Minute hochladen kannst. Für große Massenimporte nutze Paginierung und Verzögerungen, um innerhalb der Limits zu bleiben.

Kann ich n8n-Workflows von Paperarchive aus auslösen?

Ja. Erstelle einen Webhook-gesteuerten Workflow in n8n und rufe diese Webhook-URL von jedem System auf, das ausgehende HTTP-Anfragen unterstützt. Das ermöglicht eine bidirektionale Integration.

Welche n8n-Version brauche ich?

Jede aktuelle Version von n8n (1.x oder neuer) unterstützt HTTP-Request-Nodes mit Header Auth, was alles ist, was du für die Paperarchive-Integration brauchst. Es werden keine benutzerdefinierten n8n-Nodes benötigt.

Kann ich das mit n8n Cloud nutzen?

Absolut. Die Paperarchive API ist eine öffentliche REST-API, die von jeder n8n-Instanz aus erreichbar ist, egal ob selbst gehostet oder Cloud-basiert.

Nächste Schritte