Mortgage Documents · API

Document uploaden. Gestructureerde data terug.

Voor Nederlandse hypotheekdocumenten. De API geeft de relevante velden terug in een consistent formaat, elk met een eigen betrouwbaarheidsscore. Er zijn zeven documenttypen beschikbaar.

Neem contact op Bekijk de modules
PDF
Ik upload de pdf.
 leest · controleert · structureert
Klaar. 34 velden, elk met een betrouwbaarheidsscore.
Nu al?
Klaar.
Hoe het werkt

Een overzichtelijke flow in drie stappen.

  1. 01

    Insturen

    Eén aanroep met het document en het documenttype. U krijgt direct een document-ID terug.

  2. 02

    Even wachten

    De verwerking draait op de achtergrond. De API neemt de tijd om het resultaat te controleren voordat het wordt teruggestuurd.

  3. 03

    Ophalen

    Vraag het resultaat op met het ID en ontvang ieder veld als naam, waarde en betrouwbaarheid.

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 }
    ]
  }
Ingekort voorbeeld. Veldnamen en formaten zijn per module gedocumenteerd.
Modules

Zeven documenttypen, elk met een eigen module.

De manier van uitlezen verschilt per documenttype. Gestandaardiseerde formulieren gebruiken layoutmodellen; documenten met veel opmaakvarianten worden door meerdere taalmodellen gelezen en vergeleken. Het resultaat heeft steeds dezelfde eenvoudige vorm: een platte lijst velden.

01

Werkgeversverklaring

NHG-model
wgv74 velden
Ingevuld met een blauwe pen. Ondertekend met een zwarte. En iets doorgestreept.
Twee inktkleuren. Eén doorhaling. Allebei gemarkeerd.
Dat zag je?
Veld 73 en 74.
Wat erin gaat

Een gescande of digitale werkgeversverklaring, met de hand ingevuld of getypt.

Wat eruit komt

Gegevens van werknemer en werkgever, aard van het dienstverband, proeftijd, reorganisatie, de volledige inkomenstabel, onderhandse leningen en loonbeslag, het ondertekeningsblok en het NHG-modelnummer.

Het opmerken waard

De module voert ook twee visuele controles uit: of er doorhalingen of correcties zijn, en of het formulier met meer dan één inktkleur is ingevuld.

02

Legitimatie

Paspoort of identiteitskaart
legi17 velden
De paspoortscan, zoals gevraagd.
Zwart-wit. En de pagina met het geperforeerde nummer ontbreekt.
Ik vraag een nieuwe.
Wat erin gaat

Een scan van een paspoort of identiteitskaart, voor- en achterkant.

Wat eruit komt

Naam, geboortedatum en -plaats, nationaliteit als ISO-code, documentnummer, datum van afgifte en geldigheid, instantie van afgifte.

Het opmerken waard

Of het BSN zichtbaar is, of de scan in kleur is, en bij paspoorten of de tegenoverliggende pagina met het geperforeerde documentnummer is meegestuurd. De machineleesbare zone wordt met de eigen controlecijfers geverifieerd.

03

Koopovereenkomst

Getekende koopakte
kovk43 velden
€ 407.000 vierhonderdzevenduizend
Koopsom € 407.000. Voluit: vierhonderdzevenduizend.
Cijfers en woorden komen overeen. Betrouwbaarheid 0,99.
Lees je de woorden ook?
Altijd.
Wat erin gaat

Een getekende koopovereenkomst voor een woning, vaak twintig pagina’s of meer.

Wat eruit komt

Beide kopers, het object, de koopsom, roerende zaken, datum van levering, notaris, bankgarantie en het financieringsvoorbehoud.

Het opmerken waard

Bedragen staan twee keer in een koopovereenkomst: in cijfers en voluit geschreven. Beide worden uitgelezen en vergeleken, en die vergelijking telt mee in de betrouwbaarheidsscore.

04

Loonstrook

Salarisspecificatie
ls34 velden
Iedere werkgever heeft zijn eigen loonstrook.
Eén consistente set van 34 velden.
Wat erin gaat

Een loonstrook van welke werkgever of salarisverwerker dan ook, in welke opmaak dan ook.

Wat eruit komt

Werknemer en werkgever, IBAN, uren en deeltijdfactor, contractkenmerken, periode, salariscomponenten, pensioenpremie, eindejaarsuitkering, dertiende maand, individueel keuzebudget en netto uitbetaald.

Het opmerken waard

Loonstroken zijn het minst gestandaardiseerde document in de set. Meerdere modellen lezen iedere loonstrook onafhankelijk en stemmen per veld. Waar ze het over eens zijn wordt vervolgens bevestigd in de tekst van het document.

05

Taxatierapport

Woningtaxatie
taxrap112 velden
Zestig pagina’s.
Energielabel op pagina 12. Fundering op pagina 58. 112 velden.
Wat erin gaat

Een taxatierapport van een woning, meestal vijftig pagina’s of meer.

Wat eruit komt

Opdrachtgever, object, marktwaarde, waardepeildatum, erfpacht, VvE, energielabel, een verduurzamingsblok met isolatie, verwarming, energieopwekking en verbeterpotentieel, en het funderingsrapport.

Het opmerken waard

Velden verschijnen alleen waar ze van toepassing zijn: erfpachtgegevens bij erfpacht, VvE-gegevens bij appartementen. Het verduurzamingsblok is het nieuwste deel en wordt nog verfijnd.

06

DUO-overzicht studieschuld

Overzicht studieschuld
duo51 velden
Studieschuld?
Twee leningen. Saldo, rente en looptijd van elk.
Wat erin gaat

Een DUO-overzicht als pdf, schermafbeelding of doorgestuurde e-mail.

Wat eruit komt

Gegevens van de lener, het totale saldo, en per lening, tot vijf afzonderlijke leningen, het type, begin- en huidig saldo, rente, resterende looptijd en aflossingsregels.

Het opmerken waard

Een overzicht dat expliciet meldt dat er geen studieschuld is, wordt als zodanig herkend. Dat is iets anders dan een overzicht waarin de leningvelden gewoon leeg zijn.

07

KVK-uittreksel

Uittreksel Handelsregister
kvk29 velden
Wie mag er tekenen voor dit bedrijf?
Drie personen, elk met hun rol.
Wat erin gaat

Een KVK-uittreksel van een onderneming of eenmanszaak.

Wat eruit komt

Handelsnaam, rechtsvorm, KVK- en RSIN-nummer, SBI-codes, startdatum, aandeelhouders en bestuurders, en tot vijf natuurlijke personen met hun rol.

Het opmerken waard

Rollen komen terug zoals ze op het uittreksel staan: eigenaar, vennoot, aandeelhouder, bestuurder. Dat is wat een geldverstrekker nodig heeft om te weten wie mag tekenen.

Wat het betrouwbaar maakt

Eerst uitlezen. Dan verifiëren. Als laatste normaliseren.

De uitvoer van een model is een beginpunt. De controles eromheen maken het resultaat bruikbaar in een documentproces.

  1. 01

    Letterlijk uitlezen

    Waarden worden overgenomen precies zoals ze in het document staan. Er wordt nog niets geïnterpreteerd.

  2. 02

    Kruiselings controleren

    Waar een document hetzelfde twee keer zegt, worden beide vergeleken: een bedrag in cijfers en in woorden, een datum hier en een datum daar.

  3. 03

    Stemmen

    Bij documenten met veel opmaakvarianten lezen meerdere modellen hetzelfde document onafhankelijk. De mate van overeenstemming telt mee in de betrouwbaarheid.

  4. 04

    Bevestigen

    Iedere uitgelezen waarde wordt teruggezocht in de ruwe tekst van het document. Een waarde die daar niet te vinden is, verliest betrouwbaarheid.

  5. 05

    Als laatste normaliseren

    Pas aan het eind worden datums, landcodes, postcodes en namen in een vast formaat gezet, zodat vervolgsystemen consistente waarden ontvangen.

Eén betrouwbaarheidsscore per veld

  • 0,95 en hoger. Meerdere methoden waren het eens en de waarde is in de documenttekst teruggevonden.
  • Rond 0,80. De meeste methoden waren het eens. Geschikt voor de meeste geautomatiseerde processen.
  • 0,60 en lager. De methoden spraken elkaar tegen. Laat er iemand naar kijken.
Voor wie

Adviseurs, ketens en geldverstrekkers.

Adviseurs en ketens

Bereid een complete aanvraag sneller voor, en zie al bij intake welke documenten niet voldoen: een zwart-witte paspoortscan, een loonstrook uit de verkeerde periode, een niet-ondertekende verklaring.

Geldverstrekkers

Ondersteun controles, beoordeling en acceptatie met velden die u naast de aanvraag kunt leggen, elk met een betrouwbaarheid waar u drempels op kunt zetten.

De API verwerkt één document tegelijk en geeft terug wat dat document zegt. Documenten onderling en met de aanvraag vergelijken blijft in uw proces, waar uw bedrijfsregels leven.

Praktisch

Een kleine, voorspelbare API.

  • Gehost in de Europese Unie.
  • Eén API-sleutel per klant, meegestuurd als header. Er zijn altijd twee sleutels geldig, dus een sleutelrotatie vraagt geen onderhoudsvenster.
  • Resultaten zijn tot één uur na verwerking op te halen; daarna geeft de API ze niet meer terug. Dat beperkt wat een gelekte sleutel waard zou zijn.
  • Volumes in overleg. Een SLA is op aanvraag beschikbaar.
Privacy en AVG

Zorgvuldig met persoonsgegevens.

U houdt de regie

U blijft verwerkingsverantwoordelijke en wij zijn uw verwerker, met een verwerkersovereenkomst die deel uitmaakt van onze voorwaarden. Vraagt u ons uw documenten te verwijderen, dan worden ze verwijderd.

Alleen in de EER

Documenten worden verwerkt en opgeslagen in datacenters van Microsoft Azure binnen de Europese Economische Ruimte. Microsoft is onze enige sub-verwerker.

Minder blootgesteld, by design

API-sleutels bewaren we alleen als hash, iedere klant ziet alleen de eigen documenten, en resultaten zijn één uur op te halen. Van een identiteitsbewijs meldt de API of het BSN zichtbaar is, nooit het nummer zelf.

Heldere afspraken

Bewaartermijnen, verwijdering, beveiligingsmaatregelen en het melden van datalekken zijn schriftelijk vastgelegd. We kunnen documenten onder strikte voorwaarden gebruiken om de dienst te verbeteren; met één e-mail zegt u daar nee tegen.

De voorwaarden en de verwerkersovereenkomst gelden ook bij een proef. Lees de voorwaarden en de verwerkersovereenkomst

Probeer het

Wilt u het zelf proberen?

Stuur ons een bericht. We kunnen een sleutel en documentatie beschikbaar stellen en helpen met een kleine test op eigen materiaal.

info@smart-backoffice.nl

Op ieder gebruik van Mortgage Documents, ook op een proef, zijn onze algemene voorwaarden met de verwerkersovereenkomst van toepassing. Door een document in te sturen aanvaardt u deze namens uw organisatie.

Lees de voorwaarden