Rechnungen

EN-16931-Daten aus einer PDF-Rechnung auslesen (Abo oder 1 Credit)

Liest eine PDF-Rechnung mit derselben Pipeline aus wie das Web-Formular (Textpfad oder Vision-Modell, Reparaturschleife, deterministische Backfills für IBAN und USt-IdNr.) und liefert die EN-16931-Felder plus offene Probleme. Enthält die PDF bereits eine eingebettete E-Rechnung (ZUGFeRD/Factur-X), kommen die Felder deterministisch aus der XML (source='xml'), ohne Sprachmodell. Gedacht als Vorstufe zu POST /invoices: Felder prüfen, korrigieren, dann erzeugen. Erfordert ein aktives Abo oder 1 Credit je Aufruf; das kostenlose Tageskontingent von /invoices gilt hier NICHT. Rate-Limit 10 Aufrufe pro Minute und Credential. Wichtig: Felder, die das Modell nicht sicher lesen konnte, kommen als Platzhalter zurück ('KORRIGIEREN' für Text, '1900-01-01' für Datum, 0 für Beträge) und stehen in 'repairedPaths'. Diese Werte müssen vor dem Aufruf von /invoices ersetzt werden: Text- und Datums-Platzhalter blockieren dort als EXTRACTION_UNCERTAIN, ein 0-Betrag dagegen kann unbemerkt durchlaufen.

post/extractions

Request

  • Base URL: https://finisma.de/api/v1
  • URL: https://finisma.de/api/v1/extractions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://finisma.de/api/oauth/authorize, token URL https://finisma.de/api/oauth/token, scopes: invoice:verify, invoice:create)

Response

Ausgelesene Rechnungsdaten.

repairedPathsstring[] required

Punkt-Pfade der Felder, die mit einem Platzhalter gefüllt wurden, z. B. "seller.name" oder "lines.0.lineNetAmount". Vor dem Erzeugen prüfen und ersetzen.

source'xml' | 'llm' required

Herkunft der Felder: 'xml' = deterministisch aus der in der PDF eingebetteten E-Rechnung übernommen, 'llm' = per Sprachmodell aus dem Druckbild extrahiert.

Changes

No recorded changes to this operation across all 1 revision of this API.