Automatische Dokumententrennung

Trennen Sie mehrseitige Dokumentenstapel automatisch in logische Seitenbereiche auf.

POST/v1/documents/splitPro

GET/v1/documents/split/{job_id}Pro

Die automatische Dokumententrennung (Auto-Split) gruppiert Seiten eines mehrseitigen Stapeldokuments in logische Teilmengen (z. B. das Trennen eines 20-seitigen PDFs mit 5 verschiedenen Rechnungen in 5 logische Einzeldokumente).

Synchrone vs. Asynchrone Verarbeitung

Um die Performance zu sichern, verzweigt die Dokumententrennung automatisch basierend auf der Seitenzahl der hochgeladenen Datei:

Synchroner Pfad (Dateien unter 20 Seiten): Die API gibt sofort eine 200 OK Antwort mit dem vollständigen Trennungs-Manifest zurück.
Asynchroner Pfad (Dateien ab 20 Seiten): Die API gibt eine 202 Accepted Antwort mit einer job_id zurück. Der Client fragt den Status-Endpunkt ab, bis das Manifest verfügbar ist.

Limitierungen

Pro: Bis zu 25 Seiten pro Stapeldatei.
Business: Bis zu 100 Seiten pro Stapeldatei.

Trennungs-Manifest

Das Manifest enthält:

splits: Logische Dokumenttrennlinien, einschließlich Seitenbereichen (start, end, Liste der Seitenindizes), Typenklassifizierung (doc_type) und Überprüfungsstatus.
unassigned_pages: Seiten, die übersprungen wurden oder nicht klassifiziert werden konnten.
warnings: Betriebliche Warnungen (z. B. genutzte Fallback-Heuristiken).
metrics: Ausführungs-Metriken (z. B. verarbeitete Seiten pro Sekunde).

Dashboard

Die automatische Trennung steht für Pro- und Business-Konten auch im Trennen-Tab des Parsurai-Dashboards zur Verfügung.

PDF-Download der Trennung

Bei synchronen Trennungsantworten können Sie zusätzlich zum Manifest optional PDF-Dateien pro Trennsegment als eingebettete Base64-Ausgabe anfordern. Diese Ausgabe ist ausschließlich synchron verfügbar — sie steht auf dem asynchronen Pfad mit Statusabfrage nicht zur Verfügung — und bei großen Paketen kann die Antwort zu groß für eine Inline-Rückgabe sein. Ist die Antwort zu groß, fordern Sie stattdessen nur das Manifest an.

Manuelle Überprüfung der Trennung

Pro- und Business-Konten können Trennungsergebnisse direkt im Dashboard überprüfen und anpassen: Seitenbereiche zusammenführen oder aufteilen, Dokumenttypen neu klassifizieren, Seiten ignorieren und akzeptierte Segmente extrahieren. Dies ist ein Dashboard-Prüfwerkzeug für Konten mit Zugriff auf die automatische Trennung, keine eigene Preisstufe.