Mortgage Documents · API

Dokument hochladen. Strukturierte Daten erhalten.

Für niederländische Hypothekendokumente. Die API gibt die relevanten Felder in einem einheitlichen Format zurück, jedes mit eigenem Konfidenzwert. Sieben Dokumenttypen sind verfügbar.

PDF
Ich lade das PDF hoch.
liest · prüft · strukturiert
Fertig. 34 Felder, jedes mit Konfidenzwert.
Schon fertig?
Fertig.
So funktioniert es

Ein übersichtlicher Ablauf in drei Schritten.

  1. 01

    Hochladen

    Ein Aufruf mit dem Dokument und seinem Typ. Sie erhalten sofort eine Dokument-ID zurück.

  2. 02

    Kurz warten

    Die Verarbeitung läuft im Hintergrund. Die API nimmt sich die nötige Zeit, das Ergebnis vor der Rückgabe zu prüfen.

  3. 03

    Abholen

    Mit der ID abfragen und jedes Feld als Name, Wert und Konfidenz erhalten.

POST /documents/DocumentsSend
document-type: ls
document-data: loonstrook.pdf

→ { "DocumentID": "f47ac10b-58cc-4372-a567-0e02b2c3d479" }

GET  /documents/GetResults?document-id=f47ac10b-…

→ {
    "Status": "Finished",
    "DocumentType": "ls",
    "FlowData": [
      { "name": "wn_naam", "value": "De Vries", "confidence": 0.98 },
      { "name": "wg_naam", "value": "Voorbeeld B.V.", "confidence": 0.97 },
      { "name": "deeltijdfactor", "value": 0.8, "confidence": 0.99 },
      { "name": "salaris_regulier", "value": 4667, "confidence": 0.97 },
      { "name": "netto_uitbetaald", "value": 3892.5, "confidence": 0.99 }
    ]
  }
Gekürztes Beispiel. Feldnamen und Formate sind je Modul dokumentiert.
Module

Sieben Dokumenttypen, jeder mit eigenem Modul.

Der Extraktionsansatz unterscheidet sich je nach Dokumenttyp. Standardisierte Formulare nutzen Layoutmodelle; Dokumente mit vielen Layoutvarianten werden von mehreren Sprachmodellen gelesen und verglichen. Das Ergebnis hat immer dieselbe einfache Form: eine flache Liste von Feldern.

01

Arbeitgeberbescheinigung

Werkgeversverklaring, NHG-Modell
wgv74 Felder
Mit blauem Stift ausgefüllt. Mit schwarzem unterschrieben. Und etwas durchgestrichen.
Zwei Tintenfarben. Eine Durchstreichung. Beides markiert.
Das ist dir aufgefallen?
Feld 73 und 74.
Was hineingeht

Eine gescannte oder digitale Arbeitgeberbescheinigung, handschriftlich ausgefüllt oder getippt.

Was herauskommt

Angaben zu Arbeitnehmer und Arbeitgeber, Vertragsart, Probezeit, Umstrukturierung, die vollständige Einkommenstabelle, Privatdarlehen und Lohnpfändung, der Unterschriftenblock und die NHG-Modellnummer.

Bemerkenswert

Das Modul führt außerdem zwei visuelle Prüfungen durch: ob es Durchstreichungen oder Korrekturen gibt und ob das Formular mit mehr als einer Tintenfarbe ausgefüllt wurde.

02

Ausweisdokument

Reisepass oder Personalausweis
legi17 Felder
Der Pass-Scan, wie gewünscht.
Schwarz-weiß. Und die Seite mit der perforierten Nummer fehlt.
Ich fordere einen neuen an.
Was hineingeht

Ein Scan eines Reisepasses oder Personalausweises, Vorder- und Rückseite.

Was herauskommt

Name, Geburtsdatum und -ort, Staatsangehörigkeit als ISO-Code, Dokumentnummer, Ausstellungs- und Ablaufdatum, ausstellende Behörde.

Bemerkenswert

Ob die Bürgerservicenummer sichtbar ist, ob der Scan farbig ist, und bei Reisepässen, ob die gegenüberliegende Seite mit der perforierten Dokumentnummer enthalten ist. Die maschinenlesbare Zone wird mit ihren eigenen Prüfziffern verifiziert.

03

Kaufvertrag

Koopovereenkomst
kovk43 Felder
€ 407.000 vierhonderdzevenduizend
Kaufpreis € 407.000. In Worten: vierhonderdzevenduizend.
Ziffern und Worte stimmen überein. Konfidenz 0,99.
Du liest auch die Worte?
Immer.
Was hineingeht

Ein unterschriebener Kaufvertrag für eine Wohnimmobilie, oft zwanzig Seiten oder mehr.

Was herauskommt

Beide Käufer, das Objekt, Kaufpreis, bewegliche Sachen, Übergabetermin, Notar, Bankgarantie und Finanzierungsvorbehalt.

Bemerkenswert

Beträge stehen in einem niederländischen Kaufvertrag zweimal: in Ziffern und ausgeschrieben. Beide werden extrahiert und verglichen, und der Vergleich fließt in den Konfidenzwert ein.

04

Gehaltsabrechnung

Loonstrook
ls34 Felder
Jeder Arbeitgeber hat sein eigenes Abrechnungslayout.
Ein einheitlicher Satz von 34 Feldern.
Was hineingeht

Eine Gehaltsabrechnung von beliebigem Arbeitgeber oder Lohnbüro, in beliebigem Layout.

Was herauskommt

Arbeitnehmer und Arbeitgeber, IBAN, Stunden und Teilzeitfaktor, Vertragsmerkmale, Abrechnungszeitraum, Gehaltsbestandteile, Pensionsbeitrag, Jahresendzulage, dreizehntes Gehalt, individuelles Wahlbudget und Nettoauszahlung.

Bemerkenswert

Gehaltsabrechnungen sind das am wenigsten standardisierte Dokument der Reihe. Mehrere Modelle lesen jede Abrechnung unabhängig und stimmen je Feld ab. Worin sie sich einig sind, wird anschließend im Text des Dokuments bestätigt.

05

Wertgutachten

Taxatierapport
taxrap112 Felder
Sechzig Seiten.
Energielabel auf Seite 12. Fundament auf Seite 58. 112 Felder.
Was hineingeht

Ein Wertgutachten für eine Wohnimmobilie, meist fünfzig Seiten oder mehr.

Was herauskommt

Auftraggeber, Objekt, Marktwert, Bewertungsstichtag, Erbpacht, Eigentümergemeinschaft, Energielabel, ein Nachhaltigkeitsblock mit Dämmung, Heizung, Energieerzeugung und Verbesserungspotenzial sowie der Fundamentbericht.

Bemerkenswert

Felder erscheinen nur dort, wo sie zutreffen: Erbpachtangaben bei Erbpacht, Angaben zur Eigentümergemeinschaft bei Wohnungen. Der Nachhaltigkeitsblock ist der neueste Teil und wird noch verfeinert.

06

DUO-Studienkreditübersicht

Overzicht studieschuld
duo51 Felder
Studienschulden?
Zwei Darlehen. Saldo, Zins und Laufzeit für jedes.
Was hineingeht

Eine DUO-Übersicht als PDF, Screenshot oder weitergeleitete E-Mail.

Was herauskommt

Angaben zum Kreditnehmer, Gesamtsaldo, und für jedes von bis zu fünf Darlehen Art, Anfangs- und aktueller Saldo, Zins, Restlaufzeit und Tilgungsregeln.

Bemerkenswert

Eine Übersicht, die ausdrücklich sagt, dass keine Studienschulden bestehen, wird als solche erkannt. Das ist etwas anderes als eine Übersicht, in der die Darlehensfelder einfach leer sind.

07

Handelsregisterauszug

KVK-uittreksel
kvk29 Felder
Wer darf für dieses Unternehmen unterschreiben?
Drei Personen, jede mit ihrer Rolle.
Was hineingeht

Ein KVK-Auszug für ein Unternehmen oder ein Einzelunternehmen.

Was herauskommt

Handelsname, Rechtsform, KVK- und RSIN-Nummer, SBI-Codes, Gründungsdatum, Gesellschafter und Geschäftsführer sowie bis zu fünf natürliche Personen mit ihrer Rolle.

Bemerkenswert

Rollen kommen so zurück, wie sie im Auszug stehen: Inhaber, Gesellschafter, Anteilseigner, Geschäftsführer. Das braucht ein Kreditgeber, um zu wissen, wer unterschreiben darf.

Was es zuverlässig macht

Erst extrahieren. Dann prüfen. Zuletzt normalisieren.

Die Ausgabe eines Modells ist ein Ausgangspunkt. Die Prüfungen darum herum machen das Ergebnis für einen Dokumentprozess brauchbar.

  1. 01

    Wörtlich extrahieren

    Werte werden genau so übernommen, wie sie im Dokument stehen. Noch wird nichts interpretiert.

  2. 02

    Gegenprüfen

    Wo ein Dokument dasselbe zweimal sagt, werden beide verglichen: ein Betrag in Ziffern und in Worten, ein Datum hier und ein Datum dort.

  3. 03

    Abstimmen

    Bei Dokumenten mit vielen Layouts lesen mehrere Modelle dasselbe Dokument unabhängig voneinander. Der Grad ihrer Übereinstimmung fließt in die Konfidenz ein.

  4. 04

    Bestätigen

    Jeder extrahierte Wert wird im Rohtext des Dokuments gesucht. Ein Wert, der dort nicht zu finden ist, verliert Konfidenz.

  5. 05

    Zuletzt normalisieren

    Erst am Ende werden Daten, Ländercodes, Postleitzahlen und Namen in ein festes Format gebracht, damit nachgelagerte Systeme konsistente Werte erhalten.

Ein Konfidenzwert je Feld

  • 0,95 und höher. Mehrere Methoden waren sich einig und der Wert wurde im Dokumenttext gefunden.
  • Um 0,80. Die meisten Methoden waren sich einig. Für die meisten automatisierten Abläufe geeignet.
  • 0,60 und darunter. Die Methoden widersprachen sich. Lassen Sie jemanden draufschauen.
Für wen

Berater, Vermittler und Kreditgeber.

Berater und Vermittler

Einen vollständigen Antrag schneller vorbereiten und schon bei der Aufnahme sehen, welche Dokumente nicht taugen: ein Schwarz-weiß-Pass-Scan, eine Gehaltsabrechnung aus dem falschen Zeitraum, eine nicht unterschriebene Bescheinigung.

Kreditgeber

Kontrollen, Prüfung und Annahme mit Feldern unterstützen, die Sie mit dem Antrag abgleichen können, jedes mit einer Konfidenz, auf die Sie Schwellenwerte setzen können.

Die API verarbeitet ein Dokument nach dem anderen und gibt zurück, was dieses Dokument sagt. Der Abgleich von Dokumenten untereinander und mit dem Antrag bleibt in Ihrem Prozess, wo Ihre Geschäftsregeln leben.

Praktisches

Eine kleine, vorhersehbare API.

  • Gehostet in der Europäischen Union.
  • Ein API-Schlüssel je Kunde, als Header gesendet. Zwei Schlüssel sind jederzeit gültig, sodass eine Schlüsselrotation kein Wartungsfenster braucht.
  • Ergebnisse sind bis eine Stunde nach der Verarbeitung abrufbar; danach gibt die API sie nicht mehr zurück. Das begrenzt, was ein geleakter Schlüssel wert wäre.
  • Volumen nach Vereinbarung. Ein Service Level Agreement ist auf Anfrage erhältlich.
Datenschutz und DSGVO

Sorgfältig mit personenbezogenen Daten.

Sie behalten die Kontrolle

Sie bleiben Verantwortlicher, wir sind Ihr Auftragsverarbeiter, mit einem Auftragsverarbeitungsvertrag als Teil unserer AGB. Bitten Sie uns, Ihre Dokumente zu löschen, werden sie gelöscht.

Nur im EWR

Dokumente werden in Rechenzentren von Microsoft Azure im Europäischen Wirtschaftsraum verarbeitet und gespeichert. Microsoft ist unser einziger Unterauftragsverarbeiter.

Weniger angreifbar durch Design

API-Schlüssel speichern wir nur als Hash, jeder Kunde sieht nur seine eigenen Dokumente, und Ergebnisse sind eine Stunde lang abrufbar. Bei einem Ausweis meldet die API, ob die Bürgerservicenummer sichtbar ist, nie die Nummer selbst.

Klare Vereinbarungen

Aufbewahrung, Löschung, Sicherheitsmaßnahmen und die Meldung von Datenpannen sind schriftlich geregelt. Wir können Dokumente unter strengen Bedingungen zur Verbesserung des Dienstes nutzen; mit einer E-Mail widersprechen Sie.

AGB und Auftragsverarbeitungsvertrag gelten auch bei einer Testnutzung. AGB und Auftragsverarbeitungsvertrag lesen

Ausprobieren

Möchten Sie es selbst ausprobieren?

Schreiben Sie uns. Wir können einen Schlüssel und die Dokumentation bereitstellen und Sie bei einem kleinen Test mit eigenem Material unterstützen.

info@smart-backoffice.nl

Für jede Nutzung von Mortgage Documents, auch zum Test, gelten unsere Allgemeinen Geschäftsbedingungen einschließlich des Auftragsverarbeitungsvertrags. Mit dem Einreichen eines Dokuments akzeptieren Sie diese im Namen Ihrer Organisation.

Zu den AGB