Parsurai Dokumentation
Die Entwicklerreferenz fuer Parsurai-Rechnungsextraktion, AP-Dokumententrennung, -zuschnitt und -klassifizierung, ZUGFeRD-Parsing, Duplikaterkennung, Kreditoren-Analysen und Buchhaltungsintegrationen.
Parsurai hilft Buchhaltungstools, ERP-Systemen und Unternehmenssoftware, strukturierte Rechnungsdaten aus Text, PDF-Uploads, Bild-Uploads und erreichbaren Dokument-URLs zu extrahieren. Es teilt zudem mehrseitige Stapel-Scans in einzelne Dokumente auf, schneidet mehrere Dokumente aus einer einzelnen gescannten Seite zu, klassifiziert AP-Dokumente nach Typ und verarbeitet Bestellungen, Lieferscheine und weitere AP-Dokumente ueber eine dedizierte Extraktions-API und einen Review-Workflow.
Neu hier? Starten Sie mit dem Schnellstart-Leitfaden und parsen Sie Ihre erste Rechnung mit der aktuellen Extraktions-API.
Parsurai entdecken
Schnellstart
Senden Sie Text-, Datei- und URL-Extraktionen und lesen Sie danach Antwortschema und Nutzung.
Authentifizierung
Nutzen Sie `X-API-Key`, rotieren Sie `sk_live_`-Schluessel und halten Sie API-Aufrufe serverseitig.
Rechnungsextraktion
Referenz fuer `POST /v1/extract`, `POST /v1/extract/file` und `POST /v1/extract/url` mit Felderklaerungen.
ZUGFeRD-Parsing
Liest unterstuetzte eingebettete XML-Anhaenge aus ZUGFeRD-, Factur-X- und XRechnung-Hybrid-PDFs auf Pro und Business.
SDKs & Bibliotheken
Verwenden Sie `invoiceextract` fuer Python und `@invoiceextract/sdk` fuer TypeScript-Clients.
MCP-Server
Stellen Sie `extract_invoice`, `check_duplicate` und `get_vendor_analytics` fuer MCP-kompatible Assistenten bereit.
Plattformuebersicht
Parsurai stellt wenige oeffentliche API-Oberflaechen bereit. Blenden Sie planpflichtige Workflows aus, bis der aktuelle Tarif sie unterstuetzt.
| Ebene | Funktion | Endpunkte |
|---|---|---|
| Dokumenten-Parsing | Extrahiert Parteien, Daten, Positionen, Steueraufschluesselung, Summen, Dokumenttyp und Konfidenz | /v1/extract, /v1/extract/file, /v1/extract/url |
| AP-Dokumentenverarbeitung | Trennt mehrseitige Stapel, schneidet Mehrfachdokument-Scans zu, klassifiziert den Dokumenttyp und extrahiert Bestellungen, Lieferscheine und weitere AP-Dokumente | /v1/documents/split, /v1/documents/crop, /v1/documents/classify, /v1/documents/extract, /v1/workflows/ap/process |
| Eingebettetes XML | Liest unterstuetzte ZUGFeRD / Factur-X / XRechnung XML-Anhaenge aus Hybrid-PDFs | /v1/extract/zugferd |
| Intelligenz | Bewertet Duplikate, liefert Anomalie-Flags und listet aggregierte Kreditorenmetriken | /v1/intelligence/*, /v1/analytics/vendors |
| Buchhaltungsexport | Laedt eine DATEV-kompatible CSV fuer einen Datumsbereich herunter | /v1/exports/datev |
| Stripe-Receiver | Empfaengt Stripe-Billing-Events fuer den Parsurai-Kontostatus | /webhooks/stripe |
| Ausgehende Webhooks | Signierte HMAC-Ereigniszustellung an Ihren eigenen HTTPS-Endpunkt (Pro- und Business-Plan) | /v1/webhooks |
API-Standards
Alle Parsurai-APIs folgen einheitlichen Konventionen:
- Basis-URL:
https://api.parsurai.com - Protokoll: Nur HTTPS.
- Authentifizierung:
X-API-Key-Header bei jeder Anfrage. - Anfrageformat:
application/jsonfuer JSON-Endpunkte;multipart/form-datafuer Datei-Uploads. - Antwortformat:
application/jsonmit UTF-8-Kodierung, ausser DATEV-Export mitapplication/octet-stream. - Fehler: Anwendungsfehler liefern
{ "error": { "code": "...", "message": "..." } }. - Versionierung: Aktuelle stabile Version ist
v1.
Unterstuetzte Dokumenttypen
| Format | Text-Endpunkt | Datei-Upload | URL-Eingabe | ZUGFeRD-Endpunkt |
|---|---|---|---|---|
| Klartext / E-Mail-Text | Ja | Nein | Nein | Nein |
| PDF-Rechnung | Nein | Ja | Ja | Nein |
| JPEG / PNG Rechnung | Nein | Ja | Ja | Nein |
| PDF/A-3 ZUGFeRD / Factur-X | Nein | Ja | Ja | Ja, wenn eingebettetes XML unterstuetzte Namen nutzt |
Funktionsuebersicht
AP-Dokumentextraktion
Bestellungen, Lieferscheine, Zahlungsavise und eigenstaendige E-Rechnungen ueber den AP-Dokument-Envelope parsen.
AP-Klassifizierung
Eingehende Dokumente vor dem Parsing mit `POST /v1/documents/classify` nach Typ und Konfidenz kategorisieren.
Automatischer Dokumentenzuschnitt
Mehrere physische Dokumente erkennen und isolieren, die zusammen auf einer Seite gescannt oder fotografiert wurden.
Automatische Dokumententrennung
Mehrseitige PDF-Stapel anhand von Dokumentgrenzen synchron oder als Poll-Job in logische Dokumente segmentieren.
AP-Dokumentenworkflow
AP-Dokumente durch eine feste achtstufige Pipeline mit Human-in-the-Loop-Review und Audit-Trails fuehren.
Duplikaterkennung
Bewertet moegliche Duplikate mit `{ score, reason, matching_invoice_ids }`; Scores `>= 0.85` gelten als wahrscheinliche Treffer.
Anomalieerkennung
Liefert `flags` fuer Kreditor-, Zahlungs-, Waehrungs-, Betrags-, Konditions-, Steuer- und Steuer-ID-Aenderungen.
Kreditoren-Analysen
Listet `items` mit Kreditorprofil-ID, Anzeigename, Rechnungszahl, Gesamtausgaben, Durchschnittsbetrag und letzter Aktivitaet.
Ausgehende Webhooks
Abonnieren Sie signierte, HMAC-verifizierte Ereigniszustellung fuer Extraktions-, Review- und Workflow-Ereignisse.
Stripe Webhook Receiver
Dokumentiert den internen `POST /webhooks/stripe` Receiver und die drei Stripe-Billing-Events, die der Router verarbeitet.
DATEV-Export
Laedt eine `windows-1252` kodierte CSV mit `POST /v1/exports/datev?from=YYYY-MM-DD&to=YYYY-MM-DD` herunter.
Ratenbegrenzungen & Fehler
Pruefen Sie Tarifkontingente, Request-Limits, Retry-Verhalten, Nutzung und aktuelle Fehlercodes.