Dokumentation

AP-Dokumentextraktion

Bestellungen, Lieferdokumente, Zahlungsavis, Kontoauszuege und eigenstaendige E-Rechnungen ueber die AP-Dokument-API extrahieren.

POST/v1/documents/extractPro

AP-Dokumentextraktion ist von der Rechnungsextraktion getrennt. Bestehende Rechnungsendpunkte geben weiter die Top-Level-Huelle invoice zurueck; AP-Dokumentendpunkte geben die Top-Level-Huelle document zurueck.

Endpunkte

EndpunktEingabeTarif
POST /v1/documents/extractJSON-Body mit textPro und Business
POST /v1/documents/extract/fileMultipart-Datei mit PDF, Bild oder XMLPro und Business
POST /v1/documents/extract/urlJSON-Body mit urlPro und Business

Pro umfasst Bestellungen, Lieferscheine, Packzettel, Wareneingaenge, Rimesse und Zahlungsavis. Business umfasst zusaetzlich eigenstaendige XRechnung- und Peppol-E-Rechnungsanalyse sowie Kontoauszugs-Extraktion.

Document Type vs Source Format

document_type beschreibt das fachliche Dokument: purchase_order, delivery_note, remittance_advice, bank_statement, invoice, credit_note und verwandte AP-Familien.

source_format beschreibt, wie das Dokument eingegangen ist oder welcher strukturierte Standard gelesen wurde: text, pdf, image, url, zugferd, factur_x, xrechnung, peppol_bis_billing oder unknown_xml.

Strukturierte E-Rechnungen behalten normalerweise document_type als invoice oder credit_note und setzen source_format auf xrechnung, peppol_bis_billing, zugferd oder factur_x.

Datei-Upload

curl -X POST "https://api.parsurai.com/v1/documents/extract/file?locale=de" \
  -H "X-API-Key: $PARSURAI_API_KEY" \
  -F "document_type_hint=purchase_order" \
  -F "file=@purchase-order.pdf"

Antwort

{
  "document_id": "6ed32f61-f826-4ce1-8d0d-508fb68d1f12",
  "document_type": "purchase_order",
  "source_format": "pdf",
  "schema_version": 1,
  "document": {
    "po_number": "PO-2026-0042",
    "supplier": { "name": "Muster GmbH" },
    "buyer": { "name": "Buyer GmbH" },
    "line_items": [],
    "currency": "EUR",
    "total_amount": "2975.00"
  },
  "raw_structured_metadata": {},
  "confidence": 0.91,
  "field_confidence": {},
  "warnings": []
}

Verwenden Sie POST /v1/extract/file fuer die klassische Rechnungsantwort. Verwenden Sie POST /v1/documents/extract/file, wenn Sie die AP-Dokumenthuelle oder eigenstaendige XML-E-Rechnungen brauchen.

Verwandte Funktionen

Für spezialisierte Kreditoren-Workflows stehen Ihnen folgende Funktionen zur Verfügung: