> Continu verbeteren van processen > Hypotheekaanvragen > ICE Mortgage Technology > Datatemplate

Datatemplate voor leningaanvragen

ICE Mortgage Technology

Attributen voor leningaanvragen(21) Activiteiten bij leningaanvragen(16) Extractiegidsen(2)

Datatemplate voor leningaanvragen

Met deze template verzamel je de juiste data voor procesanalyse. Je ziet welke attributen je nodig hebt en welke belangrijke activiteiten je in het leningaanvraagproces moet volgen. Ook lees je hoe je deze data uit ICE Mortgage Technology haalt.

Aanbevolen attributen om te verzamelen
Belangrijke activiteiten om te volgen
Instructies voor data-extractie uit ICE Mortgage Technology

Nieuw met event logs? Lees hoe je een event log voor process mining maakt.

Template downloaden

Attributen voor leningaanvragen

Dit zijn de aanbevolen datavelden voor je event log, zodat je het leningaanvraagproces volledig kunt analyseren.

3 Verplicht 6 Aanbevolen 12 Optioneel

	Naam	Beschrijving
	Activiteitsnaam ActivityName	De naam van een specifieke gebeurtenis of stap in het proces voor het aanvragen van een lening, zoals 'Kredietcontrole afgerond' of 'Beoordeling gestart'.
Beschrijving De activiteitsnaam beschrijft een afzonderlijke taak of mijlpaal in de levenscyclus van een leningaanvraag. De gebeurtenissen worden op volgorde vastgelegd, zodat je de stappen van elke aanvraag kunt volgen. Samen vormen deze activiteiten de basis voor de proceskaart. Bij analyses gebruik je de activiteitsnaam om de processtroom weer te geven, bottlenecks tussen stappen te vinden en de frequentie en volgorde van gebeurtenissen te analyseren. Zo zie je wat er tijdens het proces gebeurt, kun je overgangstijden meten en herken je herstelwerk waarbij activiteiten worden herhaald. Waarom dit belangrijk is Dit attribuut beschrijft de processtappen. Daarmee kun je de proceskaart weergeven, de processtroom analyseren en bottlenecks of afwijkingen herkennen. Waar vind je dit? Meestal afkomstig uit event logs, statuswijzigingen of mijlpaaldata in het leningdossier in ICE Mortgage Technology. Voorbeelden Eerste informatieverstrekking verzondenBeslissing over kredietbeoordeling genomenHypotheekbedrag uitbetaaldAanvraag ingetrokken
	Leningaanvraag-ID LoanApplicationId	Een unieke identificatiecode voor elke leningaanvraag. Deze code is de primaire sleutel waarmee het hele aanvraagproces wordt gevolgd, van indiening tot afronding.
Beschrijving De leningaanvraag-ID identificeert elke afzonderlijke leningaanvraag gedurende de hele levenscyclus. De ID is de centrale sleutel waarmee alle bijbehorende activiteiten en data worden gegroepeerd. Zo kun je het volledige aanvraagtraject van een lening volgen. Bij process mining is deze ID de Case-ID. De ID koppelt alle bijbehorende gebeurtenissen, zoals 'Aanvraag ingediend', 'Beoordeling gestart' en 'Geld uitbetaald', aan één procesinstantie. Zo kun je het volledige traject van elke lening reconstrueren en analyseren. Dat is nodig om doorlooptijden te berekenen, varianten te herkennen en processtromen te begrijpen. Waarom dit belangrijk is Dit is de Case-ID die alle bijbehorende activiteiten aan één procesinstantie koppelt. Zo kun je het volledige traject van de leningaanvraag analyseren. Waar vind je dit? Dit is de primaire identificatiecode voor leningen in ICE Mortgage Technology. In het systeem wordt deze vaak Loan Number of Loan ID genoemd. Voorbeelden 300185624530029947123004512388
	Tijdstempel van gebeurtenis EventTimestamp	De exacte datum en tijd waarop een activiteit of gebeurtenis in het systeem is vastgelegd.
Beschrijving De tijdstempel van de gebeurtenis geeft aan wanneer een processtap plaatsvond. De tijdstempel bepaalt de chronologische volgorde waarmee je de processtroom reconstrueert en is nodig voor alle tijdsanalyses. Bij de meeste activiteiten is dit de starttijd van de gebeurtenis. Met dit attribuut bereken je duur en doorlooptijden, bijvoorbeeld de tijd tussen 'Beoordeling gestart' en 'Beoordeling afgerond'. Je kunt er de procesprestaties mee analyseren, vertragingen en bottlenecks opsporen en controleren of service level agreements (SLA's) worden nagekomen. Waarom dit belangrijk is Deze tijdstempel bepaalt de volgorde van alle activiteiten en vormt de basis voor berekeningen van duur, doorlooptijd en prestaties. Waar vind je dit? Bij elke mijlpaal of gebeurtenis in ICE Mortgage Technology hoort een tijdstempel dat aangeeft wanneer deze is afgerond of vastgelegd. Voorbeelden 2023-04-15T10:22:15Z2023-04-18T14:05:00Z2023-05-01T09:30:45Z
	Aanvraagkanaal ApplicationChannel	Het kanaal of de manier waarop de leningaanvraag oorspronkelijk is ingediend.
Beschrijving Dit attribuut geeft aan waar de leningaanvraag vandaan komt, bijvoorbeeld via een 'Onlineportaal', 'Tussenpersoon' of 'Filiaal'. De datakwaliteit, volledigheid en klantprofielen kunnen per kanaal verschillen. Dat kan gevolgen hebben voor de rest van het proces. Het aanvraagkanaal is een nuttige dimensie om procesprestaties te vergelijken. Uit de analyse kan blijken welke kanalen het efficiëntst zijn, het minste herstelwerk opleveren of tot de meeste goedkeuringen leiden. Zo kan de organisatie de kanaalstrategie aanpassen en bronnen doelgericht inzetten. Waarom dit belangrijk is Hiermee vergelijk je de prestaties en efficiëntie van verschillende aanvraagkanalen. Zo zie je welke kanalen goed werken en waar procesverbeteringen nodig zijn. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Dit kan zijn opgeslagen in een veld als 'Herkomst van de aanvraag'. Voorbeelden TussenpersoonOnlineportaalFiliaalMobiele app
	Besluituitkomst DecisionOutcome	De uiteindelijke uitkomst van een besluitvormingsactiviteit, meestal het besluit over de kredietbeoordeling.
Beschrijving Dit attribuut legt de uitkomst van belangrijke beslismomenten in het proces vast, zoals 'Goedgekeurd', 'Afgewezen', 'Ingetrokken' of 'Goedgekeurd onder voorwaarden'. Het geeft de eindstatus van een leningaanvraag of de uitkomst van een tussentijdse beoordeling weer. Door de besluituitkomst te analyseren, zie je hoe effectief het proces is. Je kunt goedkeurings- en afwijzingspercentages berekenen en de uitkomst vergelijken met de 'Reden van besluit' om de belangrijkste oorzaken van negatieve uitkomsten te vinden. Inzicht in deze uitkomsten helpt de kwaliteit van aanvragen en de procesefficiëntie te verbeteren. Waarom dit belangrijk is Dit attribuut is nodig om de effectiviteit van het proces te meten, bijvoorbeeld aan de hand van goedkeuringspercentages, en om te analyseren waarom leningen worden afgewezen of ingetrokken. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Deze informatie is meestal gekoppeld aan de mijlpaal voor het kredietbesluit of aan de uiteindelijke leningstatus. Voorbeelden GoedgekeurdAfgewezenIngetrokken door aanvragerGoedgekeurd onder voorwaarden
	Eindtijd van gebeurtenis EventEndTime	De datum en tijd waarop een activiteit is afgerond. Samen met de starttijd gebruik je deze om de actieve verwerkingstijd van een gebeurtenis te berekenen.
Beschrijving De eindtijd van een gebeurtenis geeft aan wanneer een specifieke taak is afgerond. Bij gebeurtenissen die direct plaatsvinden, kan de eindtijd gelijk zijn aan de starttijd. Bij activiteiten met een meetbare duur, zoals 'Beoordeling van de lening', is de tijdstempel anders. Met dit attribuut kun je de procesprestaties nauwkeuriger analyseren, omdat je wachttijd (de tijd tussen activiteiten) onderscheidt van verwerkingstijd (de duur van een activiteit). Het is nodig om de metriek 'ProcessingTime' te berekenen en het gebruik van bronnen te analyseren. Waarom dit belangrijk is Hiermee bereken je de werkelijke verwerkingstijd van activiteiten. Zo kun je actieve werktijd onderscheiden van wachttijd en bottlenecks nauwkeuriger analyseren. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Deze tijdstempel is mogelijk beschikbaar voor bepaalde vastgelegde gebeurtenissen. Bij mijlpaalgebeurtenissen kan de eindtijd gelijk zijn aan de StartTime. Voorbeelden 2023-04-15T11:45:10Z2023-04-18T17:30:00Z2023-05-01T09:30:45Z
	Leningbedrag LoanAmount	Het totale bedrag dat de aanvrager leent.
Beschrijving Het leningbedrag is de hoofdsom van de leningaanvraag. Dit bedrag kan veel invloed hebben op het proces. Voor grotere leningen of leningen die niet aan de standaardvoorwaarden voldoen, is mogelijk extra controle, een ander goedkeuringsniveau of meer documentatie nodig. Daardoor kan de doorlooptijd oplopen. Je kunt dit attribuut gebruiken om analyses te filteren en te segmenteren. Door bedragen in categorieën in te delen (bijvoorbeeld <$250k, $250k-$500k, >$500k) kunnen analisten de procesprestaties voor verschillende leningbedragen vergelijken. Het bedrag is ook een basisgegeven voor financiële berekeningen, zoals de 'Kosten per leningaanvraag'. Waarom dit belangrijk is Hiermee kun je het proces segmenteren en zien of het leningbedrag invloed heeft op de verwerkingstijd, herstelwerk of het goedkeuringspercentage. Dat geeft context bij de analyse van prestaties. Waar vind je dit? Dit is een basisveld in de leningaanvraagdata in ICE Mortgage Technology. Voorbeelden 350000.00750000.00215500.50
	Toegewezen leningadviseur AssignedLoanOfficer	De naam of ID van de leningadviseur of kredietbeoordelaar die verantwoordelijk is voor een activiteit of deze uitvoert.
Beschrijving Dit attribuut geeft aan welke medewerker bij een processtap betrokken is. Het kan gaan om degene die de taak heeft afgerond, de huidige eigenaar van het leningdossier of het belangrijkste aanspreekpunt voor de aanvraag. Door het proces te analyseren op toegewezen leningadviseur zie je hoe het werk is verdeeld. Je kunt prestaties tussen medewerkers of teams vergelijken en bepalen waar coaching nuttig kan zijn. Dit attribuut is belangrijk voor dashboards over bronprestaties, zoals 'Verdeling van activiteiten onder leningadviseurs' en 'SLA-prestaties van kredietbeoordelingen'. Waarom dit belangrijk is Dit attribuut is belangrijk voor analyses per medewerker. Je kunt prestaties meten, werk verdelen en de efficiëntie van leningadviseurs en teams vergelijken. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Gebruikersinformatie is meestal gekoppeld aan records van afgeronde mijlpalen of velden voor de eigenaar van een lening. Voorbeelden j.doer.browns.smithm.jones
	Type leningproduct LoanProductType	Het specifieke type leningproduct waarvoor de aanvraag is ingediend, zoals 'Conventionele lening met vaste rente voor 30 jaar' of 'FHA-lening'.
Beschrijving Dit attribuut deelt elke leningaanvraag in op basis van het aangeboden financiële product. Voor verschillende leningproducten gelden vaak andere procesvereisten, complexiteitsniveaus en wettelijke regels. Daardoor kan het aanvraagproces per product verschillen. Bij analyses is het type leningproduct een belangrijke dimensie om op te segmenteren. Je kunt doorlooptijden, herstelwerkpercentages en procesroutes voor verschillende producten vergelijken en zien of bepaalde producten minder efficiënt worden verwerkt. Die informatie helpt om verbeteringen gericht aan te pakken en realistische prestatiedoelen vast te stellen. Waarom dit belangrijk is Hiermee vergelijk je de prestaties van verschillende leningtypen en zie je of bepaalde producten een complexer of minder efficiënt proces hebben. Waar vind je dit? Deze basisinformatie hoort bij elke lening en staat in ICE Mortgage Technology in het gedeelte met de belangrijkste leninggegevens. Voorbeelden Conventionele lening met vaste rente voor 30 jaarConventionele lening met vaste rente voor 15 jaarVariabele rente, eerste 5 jaar vast, daarna jaarlijks aangepastFHA-leningVA-lening
	Afdeling kredietbeoordeling UnderwritingDepartment	Het team of de afdeling die de leningaanvraag beoordeelt.
Beschrijving Dit attribuut geeft aan welke organisatie-eenheid verantwoordelijk is voor de kredietbeoordeling van de lening. Bij grote organisaties kunnen afdelingen gespecialiseerd zijn in een regio, leningtype of risiconiveau. Net als het attribuut voor de toegewezen leningadviseur kun je hiermee prestaties per team of afdeling analyseren. Je kunt werkbelasting, efficiëntie en het nakomen van SLA's tussen kredietbeoordelingsteams vergelijken. Zo kan het management goed presterende teams herkennen en hun werkwijzen delen. Waarom dit belangrijk is Hiermee kun je prestaties per team of afdeling analyseren en vergelijken. Dat is nuttig voor het beheer van bronnen en om structurele problemen binnen specifieke groepen te vinden. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Dit kan deel uitmaken van de gebruikersgegevens van de kredietbeoordelaar of in een apart routeringsveld staan. Voorbeelden Kredietbeoordeling OostKredietbeoordeling WestKredietbeoordeling grote leningenKredietbeoordeling overheidsleningen
	Automatisch uitgevoerd IsAutomated	Een booleaanse waarde die aangeeft of een activiteit automatisch door een systeem of handmatig door een gebruiker is uitgevoerd.
Beschrijving Dit attribuut maakt onderscheid tussen taken die software uitvoert, zoals een automatische kredietcontrole of het versturen van systeemgegenereerde documenten, en taken waarvoor een medewerker nodig is. Deze informatie is belangrijk voor automatiseringsinitiatieven. Met dit attribuut kun je het automatiseringsniveau meten en mogelijkheden voor verdere verbetering vinden. Je gebruikt het om KPI's zoals 'Frequentie van handmatige activiteiten' te berekenen. Ook kunnen handmatige bottlenecks zichtbaar worden die geschikt zijn voor automatisering. Het doel is om kosten te verlagen en het proces te versnellen. Waarom dit belangrijk is Hiermee meet je hoeveel van het proces is geautomatiseerd en vind je handmatige activiteiten die bottlenecks vormen. Dat geeft aanknopingspunten voor toekomstige automatisering. Waar vind je dit? Dit wordt vaak afgeleid door activiteitsnamen of gebruikers-ID's (bijvoorbeeld 'System') aan een automatiseringsstatus te koppelen. Waarschijnlijk is dit geen rechtstreeks veld in het bronsysteem. Voorbeelden truefalse
	Bronsysteem SourceSystem	Geeft aan uit welk systeem of platform de data afkomstig is.
Beschrijving Dit attribuut geeft aan welke software of applicatie de procesdata heeft gegenereerd, bijvoorbeeld 'ICE Mortgage Technology Encompass' of een gekoppeld CRM-systeem. Dit is vooral nuttig wanneer data uit meerdere bronnen wordt samengevoegd. Bij analyses helpt SourceSystem om data te valideren en geeft het context over de herkomst van een gebeurtenis. Je kunt hiermee analyses filteren op een specifiek systeem of datakwaliteitsproblemen onderzoeken die alleen bij één bron voorkomen. Waarom dit belangrijk is Geeft belangrijke context over de herkomst van data. Dat helpt bij datavalidatie, probleemoplossing en het begrijpen van procesverschillen tussen systemen. Waar vind je dit? Je kunt deze waarde tijdens de data-extractie handmatig toevoegen. Soms staat de waarde in de dataheaders als de export uit een datawarehouse komt. Voorbeelden ICE Mortgage Technology EncompassICE Mortgage Technology VelocifyIntern CRM-systeem
	Doorlooptijd lening LoanCycleTime	De totale berekende tijd tussen de eerste en de laatste gebeurtenis van een leningaanvraag.
Beschrijving De totale tijd vanaf het begin tot het einde van een leningaanvraagcase. Je berekent deze door de tijdstempel van de eerste gebeurtenis, bijvoorbeeld 'Leningaanvraag aangemaakt', af te trekken van die van de laatste gebeurtenis, bijvoorbeeld 'Geld uitbetaald' of 'Lening afgewezen'. Dit is een belangrijke KPI voor de totale procesefficiëntie. De metriek laat op hoofdlijnen zien hoe lang het duurt om een lening van begin tot eind te verwerken. Analisten gebruiken deze om prestaties door de tijd heen te volgen, met sectornormen te vergelijken en de invloed van procesverbeteringen te meten. Door de gemiddelde doorlooptijd uit te splitsen naar dimensies zoals leningproducttype of aanvraagkanaal, zie je welke procesvarianten efficiënter zijn. Waarom dit belangrijk is Deze KPI meet rechtstreeks de efficiëntie van het hele proces voor leningaanvragen. Zo kun je prestaties volgen en de dienstverlening versnellen. Waar vind je dit? Bereken dit voor elke leningaanvraag-ID door de tijdstempel van de eerste gebeurtenis af te trekken van die van de laatste gebeurtenis. Voorbeelden 259200038880004752000
	Herstelwerk IsRework	Een berekende booleaanse waarde die aangeeft of een activiteit binnen dezelfde case wordt herhaald.
Beschrijving Een booleaanse waarde die aangeeft of een activiteit voor de tweede of volgende keer binnen dezelfde leningaanvraag wordt uitgevoerd. Dit wordt meestal vastgesteld wanneer een activiteit volgt op een latere stap in het standaardproces, bijvoorbeeld wanneer 'Ondersteunende documenten opgevraagd' plaatsvindt na 'Kredietbesluit genomen'. Analyse van herstelwerk is nodig om inefficiëntie in het proces te begrijpen. Door te filteren op activiteiten waarvoor IsRework waar is, kunnen analisten de frequentie en impact van herstelwerk meten. Zo vinden ze de oorzaken, zoals onvolledige documentatie bij de eerste indiening of onduidelijke vereisten. Dit is belangrijk voor het berekenen van de KPI voor herstelwerk bij aanvragen en het vereenvoudigen van processen. Waarom dit belangrijk is Maakt inefficiëntie zichtbaar door herhaald werk te markeren. Zo kun je eenvoudig meten hoe vaak herstelwerk voorkomt en de oorzaken onderzoeken. Waar vind je dit? Dit attribuut staat niet in het bronsysteem. Process mining-software berekent het door herhaalde activiteiten of teruggaande lussen in de processtroom van een case te herkennen. Voorbeelden truefalse
	Klanttype CustomerType	Een indeling van de aanvrager, zoals 'Koopt voor het eerst een woning' of 'Herfinanciering'.
Beschrijving Dit attribuut deelt klanten in op basis van hun profiel of relatie met de kredietverstrekker. De behoeften en benodigde documentatie van iemand die voor het eerst een woning koopt, kunnen sterk verschillen van die van een belegger of iemand die een lening herfinanciert. Daardoor kunnen ook de procesroutes verschillen. Door het proces op klanttype te analyseren, kun je verschillen in klantervaring en procesefficiëntie vinden. Je kunt bijvoorbeeld nagaan of mensen die voor het eerst een woning kopen langer op hun lening wachten, of aanvragen voor herfinanciering sneller worden verwerkt. Deze inzichten helpen bij het bepalen van de klantenserviceaanpak en het aanpassen van processen. Waarom dit belangrijk is Hiermee analyseer je het proces vanuit het perspectief van de klant en zie je of verschillende klanttypen andere efficiëntieproblemen of uitdagingen ervaren. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Dit kan worden afgeleid uit het leendoel of andere gegevens van de aanvrager. Voorbeelden Koopt voor het eerst een woningHerfinancieringBeleggerBestaande klant
	Kredietscore CreditScore	De kredietscore van de hoofdaanvrager op het moment van de kredietcontrole.
Beschrijving De kredietscore van de aanvrager speelt een belangrijke rol bij de leenbeslissing en kan invloed hebben op de complexiteit van de kredietbeoordeling. Aanvragen met een lagere kredietscore vereisen mogelijk een grondigere beoordeling en meer documentatie. Dit attribuut is een nuttige dimensie voor risicoanalyses. Door aanvragen in categorieën op basis van kredietscore in te delen, kunnen analisten onderzoeken of de kredietscore samenhangt met verwerkingstijden, herstelwerkpercentages of uiteindelijke besluituitkomsten. Dit helpt om risicobeoordelingen te verfijnen en bronnen doelgerichter in te zetten. Waarom dit belangrijk is Geeft een risicodimensie voor de analyse. Zo kun je nagaan of kredietrisico samenhangt met procescomplexiteit, doorlooptijd of besluituitkomsten. Waar vind je dit? Deze data is meestal afkomstig van een kredietinformatiebureau en staat bij de gegevens van de aanvrager in ICE Mortgage Technology. Voorbeelden 785692740810
	Laatste data-update LastDataUpdate	De tijdstempel die aangeeft wanneer de data voor dit record voor het laatst is vernieuwd of uit het bronsysteem is opgehaald.
Beschrijving Dit attribuut bevat de datum en tijd waarop de data voor het laatst is opgehaald. Zo zie je hoe actueel de geanalyseerde data is en kun je vernieuwingsschema's beheren. Dit attribuut wordt meestal niet gebruikt om het proces zelf te analyseren, maar is wel belangrijk voor dashboardrapportages en datagovernance. Het laat zien hoe actueel de analyse is en helpt problemen met verouderde informatie op te sporen. Waarom dit belangrijk is Laat zien hoe actueel de data is, zodat je kunt controleren of analyses en dashboards op recente informatie zijn gebaseerd. Waar vind je dit? Deze tijdstempel wordt meestal tijdens het ETL-proces voor data-extractie en -laden aan de dataset toegevoegd. Voorbeelden 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	Reden van besluit ReasonForDecision	Een code of tekst die de reden voor een besluituitkomst toelicht, bijvoorbeeld waarom een lening is afgewezen.
Beschrijving Dit attribuut geeft context bij de 'DecisionOutcome'. Als een lening wordt afgewezen of herstelwerk nodig is, vermeldt dit veld de reden, bijvoorbeeld 'Hoge verhouding tussen schulden en inkomen' of 'Onvolledige documentatie'. Deze informatie is waardevol voor oorzaakanalyse. Door de meest voorkomende redenen voor afwijzingen of herstelwerk te analyseren, kan de organisatie structurele problemen in het proces of in de kwaliteit van aanvragen vinden. Op basis daarvan zijn gerichte verbeteringen mogelijk, zoals duidelijkere instructies voor aanvragers of extra training voor leningadviseurs. Waarom dit belangrijk is Geeft aan waarom leningen worden afgewezen of herstelwerk nodig is. Met oorzaakanalyse kun je structurele problemen aanpakken en het percentage aanvragen dat in één keer goed gaat verhogen. Waar vind je dit? Raadpleeg de documentatie van ICE Mortgage Technology. Deze informatie staat vaak in velden met redencodes of in notities bij een beslismijlpaal. Voorbeelden Kredietscore onder de grenswaardeAanvraagdocumenten onvolledigHoge verhouding tussen schulden en inkomenTaxatiewaarde te laag
	SLA-doel voor kredietbeoordeling UnderwritingSlaTarget	De vooraf vastgestelde streeftijd voor de kredietbeoordelingsfase volgens de service level agreement (SLA).
Beschrijving Dit attribuut bepaalt de maximale verwachte tijd voor de kredietbeoordeling, van 'Beoordeling gestart' tot 'Beoordeling afgerond'. Het is de norm waarmee je de werkelijke prestaties vergelijkt. Deze waarde is nodig om te berekenen of de SLA wordt nagekomen. Je kunt er een attribuut 'SLAState' mee maken dat kredietbeoordelingstaken markeert als 'Op tijd' of 'Te laat'. Dashboards over SLA-prestaties gebruiken dit doel om managers te laten zien of de serviceafspraken worden nagekomen. Waarom dit belangrijk is Biedt de norm om de prestaties van kredietbeoordelingen objectief te meten en te volgen aan de hand van service level agreements. Waar vind je dit? Dit veld staat mogelijk niet in het bronsysteem. Het kan bedrijfskennis zijn die tijdens de transformatie aan de data wordt gekoppeld. De waarde kan verschillen per leningtype of regio. Voorbeelden 259200432000
	SLA-status SLAState	Een berekende status die aangeeft of een activiteit of case aan de service level agreement (SLA) heeft voldaan.
Beschrijving Geeft aan of een activiteit of de hele case binnen de streeftijd van de service level agreement is afgerond. Meestal wordt dit bepaald door de werkelijke doorlooptijd te vergelijken met een vooraf vastgesteld SLA-doel, zoals de UnderwritingSlaTarget. Dit attribuut is belangrijk om prestaties en compliance te volgen. Dashboards gebruiken SLAState vaak om het percentage leningen te tonen dat binnen de streeftijd is afgerond. Zo kunnen managers de prestaties volgen aan de hand van belangrijke doelen. Door SLA-prestaties per leningadviseur, producttype of kanaal te bekijken, vind je sterke punten en mogelijkheden voor verbetering. Zo kan de organisatie haar serviceafspraken nakomen. Waarom dit belangrijk is Geeft in één oogopslag aan hoe de prestaties zich verhouden tot belangrijke tijdsdoelen. Zo kun je eenvoudig de naleving van SLA's volgen en rapporteren. Waar vind je dit? Dit attribuut staat niet in het bronsysteem. Het wordt berekend door de werkelijke duur van een procesdeel te vergelijken met het bijbehorende SLA-doel. Voorbeelden Op tijdRisicoTe laat
	Staat waar het onroerend goed ligt PropertyState	De Amerikaanse staat waarin het onroerend goed van de leningaanvraag ligt.
Beschrijving Dit attribuut geeft de geografische locatie van het onroerend goed aan. Leenregels, marktomstandigheden en verwerkingsvereisten kunnen per staat sterk verschillen en zo het aanvraagproces beïnvloeden. De staat waar het onroerend goed ligt, is een nuttige dimensie voor geografische analyses. Je kunt procesprestaties, zoals doorlooptijden en goedkeuringspercentages, tussen regio's vergelijken. Zo vind je regionale bottlenecks of zie je welke invloed regels van een specifieke staat op het proces hebben. Waarom dit belangrijk is Hiermee kun je het proces geografisch analyseren en regionale verschillen in prestaties vinden die mogelijk samenhangen met marktomstandigheden of regels van een specifieke staat. Waar vind je dit? Dit is een standaardveld in het gedeelte met vastgoedgegevens van de leningaanvraag in ICE Mortgage Technology. Voorbeelden CATXFLNYIL

Verplicht Aanbevolen Optioneel

Activiteiten bij leningaanvragen

Dit zijn de belangrijke processtappen en mijlpalen die je in het event log vastlegt voor een nauwkeurige procesanalyse.

5 Aanbevolen 11 Optioneel

	Activiteit	Beschrijving
	Beslissing over kredietbeoordeling genomen	Deze activiteit markeert het einde van de eerste kredietbeoordeling. De uitkomst kan bijvoorbeeld goedgekeurd, opgeschort of afgewezen zijn. Dit is een belangrijke mijlpaal in de levenscyclus van de hypotheek.
Waarom dit belangrijk is Met dit event eindigt de meting van de doorlooptijd van de kredietbeoordeling. Het is ook een belangrijk beslismoment. Door de uitkomsten en de benodigde tijd te analyseren, kun je de prestaties van de kredietbeoordeling beoordelen en oorzaken van herstelwerk vinden. Waar vind je dit? Dit is een belangrijke mijlpaal in Encompass, vastgelegd met de voltooiingsdatum van de fase voor kredietbeoordeling. De beslissing zelf staat in een apart veld. Vastleggen Afgeleid van de voltooiingstimestamp van de mijlpaal 'Underwriting' of een statuswijziging naar 'Approved', 'Suspended' of 'Denied'. Gebeurtenistype inferred
	Goedkeuring voor afsluiting afgegeven	Dit is de officiële melding dat aan alle voorwaarden is voldaan en de kredietverstrekker de afsluiting kan plannen en de hypotheek kan uitbetalen. Deze belangrijke mijlpaal geeft aan dat de hypotheek klaar is voor de laatste fase.
Waarom dit belangrijk is Dit is een belangrijk beslismoment in het proces. Het markeert het einde van de kredietbeoordeling en verwerking en maakt het mogelijk de tijd tussen de aanvraag en de definitieve goedkeuring te meten. Waar vind je dit? Afgeleid van de voltooiingsdatum van de mijlpaal 'Clear to Close' (CTC) in Encompass. Dit is een vaste, duidelijk omschreven fase in de workflow. Vastleggen Afgeleid van de invulling van het datumveld 'Clear to Close' in de mijlpaalregistratie van de hypotheek. Gebeurtenistype inferred
	Hypotheekaanvraag aangemaakt	Deze activiteit markeert de officiële start van het proces voor het afsluiten van een hypotheek. Een hypotheekadviseur maakt hiervoor een nieuw hypotheekdossier aan in het systeem. Dit event wordt vastgelegd wanneer het dossier voor het eerst wordt opgeslagen en krijgt een unieke hypotheekaanvraag-ID.
Waarom dit belangrijk is Als eerste event is deze activiteit nodig om de totale doorlooptijd van een hypotheek te berekenen en het aantal binnenkomende aanvragen te analyseren. De activiteit vormt de basis voor alle volgende procesmetingen en analyses van de doorvoer. Waar vind je dit? Dit is meestal een expliciet event in de hypotheekgeschiedenis of het auditlog. Je kunt het ook afleiden uit de aanmaaktimestamp van het hypotheekdossier dat bij de hypotheekaanvraag-ID hoort. Vastleggen Afgeleid van de aanmaakdatum van het hypotheekdossier of de eerste vermelding in het auditspoor van de hypotheek. Gebeurtenistype explicit
	Hypotheekbedrag uitbetaald	Dit markeert de succesvolle afronding en het einde van het proces voor het afsluiten van de hypotheek: het hypotheekbedrag wordt uitbetaald. Hiermee is de weg van aanvraag tot uitbetaling voltooid.
Waarom dit belangrijk is Als afsluitend event bij een succesvolle aanvraag is dit nodig om de totale doorlooptijd van afgesloten hypotheken te berekenen. Het wordt ook gebruikt om de verwerkingssnelheid van aanvragen te meten. Waar vind je dit? Dit wordt vastgelegd in het veld 'Funding Date' of 'Disbursement Date' in Encompass. De datum wordt ingevuld zodra de overboeking is bevestigd. Vastleggen Afgeleid van de invulling van het veld 'Funding Date' in de hypotheekgegevens. Gebeurtenistype inferred
	Kredietbeoordeling gestart	Dit markeert de officiële start van de kredietbeoordeling. Een kredietbeoordelaar begint met de formele beoordeling van de hypotheekaanvraag en alle bijbehorende documenten. Het dossier wordt officieel naar de wachtrij voor kredietbeoordeling gestuurd of aan een kredietbeoordelaar toegewezen.
Waarom dit belangrijk is Dit is het startpunt voor het meten van de doorlooptijd van de kredietbeoordeling, een belangrijke KPI voor de efficiëntie van de bedrijfsvoering. Je kunt hiermee de werkdruk van kredietbeoordelaars analyseren en bottlenecks vóór de kredietbeoordeling vinden. Waar vind je dit? Meestal afgeleid van de timestamp waarop het hypotheekdossier aan de mijlpaal 'Underwriting' wordt toegewezen of de status verandert naar 'In Underwriting'. Vastleggen Afgeleid van het datumveld 'Submitted to Underwriting' of een statuswijziging naar 'Underwriting in Progress'. Gebeurtenistype inferred
	Aanvraag ingetrokken	Dit markeert een mislukte afloop van het proces waarbij de aanvrager besluit de aanvraag in te trekken. Dit is een andere eindstatus voor het hypotheekdossier.
Waarom dit belangrijk is Dit is een afsluitend event bij een mislukte aanvraag, op initiatief van de klant. Door te analyseren wanneer en waarom aanvragen worden ingetrokken, krijg je inzicht in klanttevredenheid, concurrentie en obstakels in het proces. Waar vind je dit? Dit wordt vastgelegd wanneer de definitieve hypotheekstatus op 'Withdrawn' wordt gezet. De datum van deze statuswijziging staat in de systeemlogs of in een datumveld voor mijlpalen. Vastleggen Afgeleid van de definitieve status 'Withdrawn' en de timestamp van die statuswijziging. Gebeurtenistype inferred
	Bewijsstukken aangevraagd	Deze activiteit vindt plaats wanneer de hypotheekverwerker of -adviseur de aanvrager officieel om benodigde documenten vraagt, zoals loonstroken of bankafschriften. Dit gebeurt vaak nadat de eerste beoordeling is afgerond.
Waarom dit belangrijk is Hiermee begint de fase waarin documenten worden verzameld. Door de tijd tussen het verzoek en de ontvangst van de documenten te analyseren, zie je bottlenecks door vertragingen bij de aanvrager of onduidelijke communicatie. Waar vind je dit? Je kunt dit event afleiden uit statuswijzigingen in het hypotheekdossier, de voltooiingsdatum van een specifieke mijlpaal of communicatielogs in Encompass. Vastleggen Afgeleid van een statuswijziging naar 'Pending Documents' of een timestamp op een template voor documentverzoeken. Gebeurtenistype inferred
	Bewijsstukken ontvangen	Dit betekent dat alle aanvankelijk opgevraagde bewijsstukken van de aanvrager zijn ontvangen en aan het hypotheekdossier zijn toegevoegd. Dit event is nodig voordat de aanvraag naar de kredietbeoordeling kan.
Waarom dit belangrijk is Met deze activiteit eindigt de fase waarin documenten worden verzameld. De tijd tussen 'Supporting Documents Requested' en dit event is een belangrijke KPI voor de efficiëntie van de aanvrager en de hypotheekverwerker. Waar vind je dit? Meestal afgeleid van de voltooiing van de mijlpaal 'Documents Received' of 'Ready for Underwriting'. Je kunt dit ook afleiden uit de timestamp waarop het laatste vereiste document is geüpload. Vastleggen Afgeleid van de timestamp waarop de hypotheekstatus verandert naar 'Processing' of 'Ready for Underwriting'. Gebeurtenistype inferred
	Definitieve afsluitingsinformatie verzonden	Dit is het moment waarop de definitieve Closing Disclosure (CD) ter beoordeling naar de aanvrager wordt gestuurd. Dit is een verplichte stap voor compliance en moet een vastgesteld aantal dagen vóór de afsluiting plaatsvinden.
Waarom dit belangrijk is Door deze activiteit te volgen, kun je controleren of je voldoet aan TRID. Hiermee begint een verplichte wachttijd. Vertraging kan de geplande afsluitingsdatum direct beïnvloeden. Waar vind je dit? Afgeleid van de voltooiingsdatum van de mijlpaal 'Closing Disclosure Sent' of een specifiek datumveld in het compliancegedeelte van het hypotheekdossier in Encompass. Vastleggen Afgeleid van de timestamp bij de mijlpaal 'CD Sent' of een vergelijkbare mijlpaal. Gebeurtenistype inferred
	Eerste informatieverstrekking verzonden	Dit is het moment waarop de eerste compliance-informatie, zoals de Loan Estimate, naar de aanvrager wordt gestuurd. Dit is een wettelijke stap die binnen een bepaalde termijn na de aanvraag moet plaatsvinden.
Waarom dit belangrijk is Door deze activiteit te volgen, kun je controleren of je voldoet aan regelgeving zoals TRID. De tijd tussen het aanmaken van de aanvraag en deze stap kan wijzen op vertragingen aan het begin van de verwerking. Waar vind je dit? Afgeleid van de voltooiingsdatum van de mijlpaal 'Initial Disclosures' in Encompass. Meestal is dit een datumveld dat wordt ingevuld wanneer de documenten zijn opgesteld en verzonden. Vastleggen Afgeleid van de timestamp bij de voltooiing van de mijlpaal of status 'Initial Disclosures Sent'. Gebeurtenistype inferred
	Hypotheek afgewezen	Deze activiteit markeert een mislukte afloop van het proces: de kredietverstrekker wijst de hypotheekaanvraag officieel af. Dit is een eindstatus voor het hypotheekdossier.
Waarom dit belangrijk is Dit is een afsluitend event bij een mislukte aanvraag. Door hypotheken met deze uitkomst en de bijbehorende redenencodes te analyseren, kun je kansen vinden om de kwaliteit van aanvragen of de criteria voor kredietbeoordeling te verbeteren. Waar vind je dit? Dit wordt vastgelegd wanneer de definitieve hypotheekstatus op 'Denied' wordt gezet. De datum van deze statuswijziging staat in het auditlog van de hypotheek of in een specifiek datumveld voor mijlpalen. Vastleggen Afgeleid van de definitieve status 'Denied' en de timestamp van die statuswijziging. Gebeurtenistype inferred
	Hypotheek goedgekeurd onder voorwaarden	Dit gebeurt wanneer de kredietbeoordelaar de hypotheek goedkeurt onder specifieke voorwaarden waaraan vóór de afsluiting moet worden voldaan. Dit is een veelvoorkomende uitkomst van de eerste kredietbeoordeling.
Waarom dit belangrijk is Met deze activiteit begint de fase waarin de voorwaarden worden afgehandeld. Door dit te volgen, kun je herstelwerk en vertragingen tussen de eerste goedkeuring en de definitieve goedkeuring voor afsluiting analyseren. Waar vind je dit? Dit wordt meestal vastgelegd wanneer de beslisstatus van de kredietbeoordeling verandert naar 'Approved with Conditions' of 'Suspended'. De timestamp van deze statuswijziging staat in het auditspoor van de hypotheek. Vastleggen Afgeleid van de statuswijziging naar 'Approved with Conditions' en de bijbehorende timestamp in het mijlpaallog. Gebeurtenistype inferred
	Hypotheekdocumenten ondertekend	Deze activiteit vindt plaats wanneer de kredietnemer tijdens de afsluiting de definitieve hypotheekdocumenten ondertekent. Hiermee bevestigt de kredietnemer akkoord te gaan met de voorwaarden van de hypotheek. Daarna wordt de hypotheek uitbetaald.
Waarom dit belangrijk is Dit is de laatste belangrijke stap waarbij de kredietnemer betrokken is voordat de hypotheek wordt uitbetaald. De ondertekening bevestigt dat de hypotheek doorgaat en maakt het mogelijk de doorlooptijd van de afsluitingsfase te meten. Waar vind je dit? Dit wordt vastgelegd in het veld 'Documents Signed' of 'Closing Date' in het hypotheekdossier in Encompass. De afsluitingsagent of hypotheekadviseur vult deze datum in. Vastleggen Afgeleid van de invulling van het veld 'Signing Date' of 'Closing Date' in de hypotheekgegevens. Gebeurtenistype inferred
	Kredietcontrole afgerond	Deze activiteit betekent dat het kredietrapport van de aanvrager is opgevraagd en beoordeeld. De uitkomst is belangrijke input voor de kredietbeoordeling.
Waarom dit belangrijk is De kredietcontrole is een belangrijke voorwaarde voor de kredietbeoordeling. Vertraging bij deze stap kan het hele proces stilleggen. De uitkomst heeft bovendien direct invloed op de beslissing over de hypotheek. Waar vind je dit? Dit wordt meestal vastgelegd via een koppeling met een kredietinformatiebureau. Wanneer het kredietrapport binnenkomt en aan het dossier wordt toegevoegd, wordt doorgaans een timestamp vastgelegd. Vastleggen Afgeleid van het datumveld 'Credit Report Ordered' of 'Credit Report Received' in het hypotheekdossier. Gebeurtenistype explicit
	Taxatierapport ontvangen	Dit is het moment waarop het taxatierapport van de taxateur binnenkomt en aan het hypotheekdossier wordt toegevoegd. Deze stap is belangrijk voor de waardebepaling van het pand en is een voorwaarde voor de definitieve goedkeuring van de hypotheek.
Waarom dit belangrijk is De taxatie zorgt vaak voor flinke vertragingen. Door bij te houden wanneer de taxatie wordt aangevraagd en ontvangen, kun je deze externe afhankelijkheid goed volgen en beheren. Waar vind je dit? Dit event wordt meestal vastgelegd wanneer het taxatiedocument wordt geüpload en het bijbehorende datumveld voor de mijlpaal 'Appraisal Received' in Encompass wordt ingevuld. Vastleggen Afgeleid van de invulling van het veld 'Appraisal Received Date' of een bijbehorende statuswijziging. Gebeurtenistype inferred
	Voorwaarden afgehandeld	Dit event betekent dat aan alle voorwaarden van de kredietbeoordeling is voldaan en dat het team ze heeft gecontroleerd en goedgekeurd. De hypotheek is nu klaar voor de laatste stappen van de afsluiting.
Waarom dit belangrijk is Hiermee eindigt eventueel herstelwerk na de kredietbeoordeling. De tijd tussen 'Loan Approved with Conditions' en dit event laat zien hoe efficiënt openstaande punten worden afgehandeld. Waar vind je dit? Afgeleid van de timestamp waarop de hypotheekstatus wordt bijgewerkt om aan te geven dat aan alle voorwaarden is voldaan. Dit gebeurt vaak bij de mijlpaal 'Final Approval' in Encompass. Vastleggen Afgeleid van de voltooiingsdatum van de mijlpaal 'Conditions Cleared' of 'Final Approval'. Gebeurtenistype inferred

Aanbevolen Optioneel

Extractiegidsen

Zo haal je data uit ICE Mortgage Technology

Stappen

Log in op de ICE Encompass-desktopclient met een gebruikersaccount met rapportagerechten.
Ga in de applicatie naar de rapportagesectie. Die staat meestal onder een hoofdmenuoptie zoals Services, Tools of Reporting.
Zoek de rapportbouwer of de functie voor aangepaste rapporten en open deze. Kies de optie om een nieuw rapport vanaf nul te maken.
Selecteer als primaire databron voor het rapport Milestone Log of een vergelijkbaar object met de geschiedenis van mijlpalen in leningdossiers.
Voeg in de rapportbouwer de benodigde kolommen toe om het event log samen te stellen. Voeg de velden toe die horen bij LoanApplicationId, ActivityName (naam van de mijlpaal) en EventTimestamp (datum waarop de mijlpaal is voltooid).
Voeg de aanbevolen attribuutkolommen toe door de bijbehorende leningsvelden te selecteren, zoals LoanProductType, LoanAmount en AssignedLoanOfficer. Deze velden zijn doorgaans gekoppeld aan het hoofdrecord van de lening.
Stel de rapportfilters in. Het belangrijkste filter betreft het veld Milestone Name. Stel een filter in dat alleen de specifieke mijlpaalnamen bevat die bij de vereiste activiteiten horen. Raadpleeg de sectie Query voor de lijst met mijlpalen.
Voeg een tweede filter toe voor EventTimestamp (datum waarop de mijlpaal is voltooid) om de data-extractie te beperken tot een bepaalde periode, bijvoorbeeld de afgelopen 3 tot 6 maanden. Zo houd je de export beheersbaar.
Voer het rapport uit in Encompass om de data te bekijken. Controleer of de structuur klopt en de verwachte records erin staan.
Is het rapportvoorbeeld in orde, gebruik dan de exportfunctie. Exporteer de data als CSV- of Microsoft Excel-bestand (XLSX).
Open het geëxporteerde bestand voor een laatste kwaliteitscontrole. Controleer of de kolomkoppen overeenkomen met de vereiste attribuutnamen: LoanApplicationId, ActivityName, EventTimestamp enzovoort. Pas ze zo nodig aan.
Het bestand is klaar om te uploaden. Sla de definitieve versie op als CSV-bestand met UTF-8-codering.

Configuratie

Databron voor het rapport: Gebruik als primaire databron de Milestone Log of een vergelijkbare tabel met de leninggeschiedenis, waarin de voltooiing van belangrijke processtappen wordt vastgelegd.
Datumbereik: Filter op de datum waarop de mijlpaal is voltooid (EventTimestamp). Voor een analyse is 3 tot 6 maanden aan data meestal geschikt. Zo blijft het bestand beheersbaar en zijn de procesinzichten relevant.
Mijlpaalfilter: Stel een specifiek filter in voor het veld ActivityName (naam van de mijlpaal), zodat alleen de 16 vereiste activiteiten worden opgenomen. Encompass bevat veel technische of kleine mijlpalen die je beter uitsluit om ruis te beperken.
Filter op leningstatus: Overweeg testleningen en leningen met een inactieve status uit te sluiten als die niet relevant zijn voor de procesanalyse.
Veldselectie: Selecteer alle vereiste en aanbevolen velden. Sommige velden, zoals LoanAmount, komen uit het hoofdrecord van de lening en niet uit de mijlpaallog. In de rapportbouwer kun je deze velden koppelen of opnemen.
Vereisten: De gebruiker die het rapport uitvoert, heeft in Encompass voldoende rechten nodig om de rapportageservices te gebruiken en alle geselecteerde leningsvelden in verschillende leningdossiers te bekijken.

Voorbeeldquery config

This extraction is configured using the Encompass report builder UI, not a script. The configuration below describes the fields and filters to apply.

**Report Type**: Custom Report
**Primary Data Source**: Milestone Log

**Columns to Include (Field ID in brackets are examples):**
*   `LoanApplicationId`: [Loan.LoanNumber]
*   `ActivityName`: [Milestone.Name]
*   `EventTimestamp`: [Milestone.CompletedDate]
*   `EventEndTime`: [Milestone.CompletedDate] (Note: Milestone logs typically only provide a completion timestamp, which can be used for both start and end if granular duration is not available.)
*   `AssignedLoanOfficer`: [Loan.LoanOfficer]
*   `LoanProductType`: [Loan.LoanProgram]
*   `LoanAmount`: [Loan.LoanAmount]
*   `DecisionOutcome`: [Underwriting.Decision]
*   `ApplicationChannel`: [Loan.ApplicationSource]

**Filters to Apply:**
1.  **Date Range Filter:**
    *   Field: `[Milestone.CompletedDate]`
    *   Operator: `is between`
    *   Value: `[Specify Start Date]` and `[Specify End Date]`

2.  **Activity Name Filter:**
    *   Field: `[Milestone.Name]`
    *   Operator: `is one of`
    *   Values (Map the required activities to your organization's specific Encompass Milestone names. The following are common examples):
        *   'File Started' (for Loan Application Created)
        *   'Initial Disclosures Sent' (for Initial Disclosures Sent)
        *   'Processing Docs Requested' (for Supporting Documents Requested)
        *   'Processing Docs Received' (for Supporting Documents Received)
        *   'Credit Ordered' (for Credit Check Completed)
        *   'Appraisal Received' (for Appraisal Received)
        *   'Submitted to Underwriting' (for Underwriting Commenced)
        *   'Underwriting Decision Complete' (for Underwriting Decision Rendered)
        *   'Approved with Conditions' (for Loan Approved with Conditions)
        *   'Conditions Cleared' (for Conditions Cleared)
        *   'Clear to Close' (for Clear To Close Issued)
        *   'Closing Disclosure Sent' (for Closing Disclosures Sent)
        *   'Docs Signed' (for Loan Documents Signed)
        *   'Funded' (for Funds Disbursed)
        *   'Denied' (for Loan Denied)
        *   'Withdrawn' (for Application Withdrawn)

Stappen

Vereisten: API-inloggegevens aanvragen
- Maak een account aan op het Encompass Developer Connect-portaal van ICE Mortgage Technology.
- Maak een nieuwe API-applicatie aan om een unieke Client ID en Client Secret te krijgen.
- Controleer of de API-gebruiker bij deze inloggegevens voldoende rechten heeft in Encompass om leningsdata te bekijken, waaronder pipelineweergaven, mijlpalen en velddata.
Python-omgeving instellen
- Installeer Python op je computer. Versie 3.7 of hoger wordt aanbevolen.
- Installeer de benodigde Python-bibliotheken voor API-verzoeken en dataverwerking. Open de terminal of opdrachtprompt en voer de volgende opdrachten uit: pip install requests pip install pandas
Het extractiescript instellen
- Sla het meegeleverde Python-script op in een bestand, bijvoorbeeld encompass_extractor.py.
- Open het script en vervang de tijdelijke waarden voor CLIENT_ID, CLIENT_SECRET en API_BASE_URL door je eigen inloggegevens en de URL van je omgeving.
Koppelingen en filters aanpassen
- Controleer het woordenboek MILESTONE_TO_ACTIVITY_MAPPING in het script. De sleutels zijn de namen van mijlpalen in je Encompass-instantie. Pas ze aan zodat ze exact overeenkomen met de mijlpaalnamen van je organisatie. Zo worden de activiteiten correct vastgelegd.
- Pas het woordenboek FIELD_IDS aan als je instantie andere veld-ID’s gebruikt voor de aanbevolen attributen.
- Stel START_DATE en END_DATE in om de periode te bepalen waaruit je leningaanvragen wilt ophalen.
Het Python-script uitvoeren
- Voer het script uit via de terminal of opdrachtprompt met de opdracht: python encompass_extractor.py.
- Het script meldt zich eerst aan bij de API en haalt een toegangstoken op. Daarna bevraagt het de leningpipeline voor het opgegeven datumbereik.
De extractie volgen
- Het script toont voortgang in de console, waaronder het aantal verwerkte leningen.
- Voor elke lening haalt het de mijlpaalgeschiedenis en relevante velddata op, zet deze om naar een event log en voegt de gegevens aan een lijst toe.
Mogelijke fouten afhandelen
- Het script bevat eenvoudige foutafhandeling voor API-verzoeken. Bij een fout, bijvoorbeeld ongeldige inloggegevens of netwerkproblemen, verschijnt er een melding. Houd de console tijdens de uitvoering in de gaten.
Het uitvoerbestand ophalen
- Na afloop maakt het script in dezelfde map een CSV-bestand met de naam encompass_loan_origination_event_log.csv.
Klaarmaken voor upload
- Dit CSV-bestand is het definitieve event log. Controleer of de verwachte data erin staat. Het bestand bevat de vereiste kolommen (LoanApplicationId, ActivityName, EventTimestamp) en kan rechtstreeks naar ProcessMind worden geüpload.

Configuratie

API-inloggegevens: Voor authenticatie heb je een geldige Client ID en Client Secret nodig van een applicatie die is geregistreerd in het Encompass Developer Connect-portaal.
Gebruikersrechten: De API-gebruiker moet in Encompass de benodigde rechten hebben om de leningpipeline te bekijken en gedetailleerde veld- en mijlpaaldata van de betreffende leningen op te halen.
Datumbereik: Het script gebruikt START_DATE en END_DATE om de eerste query op de leningpipeline te filteren. Voor een eerste extractie wordt een periode van 3 tot 6 maanden aanbevolen. Zo houd je de balans tussen de hoeveelheid data en de prestaties.
Mijlpaalkoppeling: De instelling MILESTONE_TO_ACTIVITY_MAPPING is het belangrijkst. Koppel de specifieke Encompass-mijlpaalnamen aan de gestandaardiseerde activiteitsnamen voor het event log. Deze koppeling verschilt per kredietverstrekker.
Field ID’s: Het script gebruikt een vooraf ingesteld woordenboek met Encompass-FIELD_IDS om attributen zoals het leenbedrag op te halen. Deze ID’s zijn meestal standaard, maar kunnen zijn aangepast. Controleer ze aan de hand van je Encompass-configuratie.
URL van het API-eindpunt: Stel API_BASE_URL in op de juiste URL van je Encompass-instantie, bijvoorbeeld https://api.elliemae.com.

Voorbeeldquery python

import requests
import pandas as pd
import json
import time
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your actual credentials and API endpoint
CLIENT_ID = class="hl-string">'[Your_Client_ID]'
CLIENT_SECRET = class="hl-string">'[Your_Client_Secret]'
API_BASE_URL = class="hl-string">'https://api.elliemae.com' 

class=class="hl-string">"hl-comment"># Set the date range for the loan search
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'

class=class="hl-string">"hl-comment"># --- Mappings and Field Definitions --- #
class=class="hl-string">"hl-comment"># CRITICAL: Update keys to match the milestone names in your Encompass instance
MILESTONE_TO_ACTIVITY_MAPPING = {
    class="hl-string">'Application': class="hl-string">'Loan Application Created',
    class="hl-string">'Initial Disclosures Sent': class="hl-string">'Initial Disclosures Sent',
    class="hl-string">'Docs Requested': class="hl-string">'Supporting Documents Requested',
    class="hl-string">'Docs Received': class="hl-string">'Supporting Documents Received',
    class="hl-string">'Credit Ordered': class="hl-string">'Credit Check Completed',
    class="hl-string">'Appraisal Received': class="hl-string">'Appraisal Received',
    class="hl-string">'Submitted': class="hl-string">'Underwriting Commenced',
    class="hl-string">'Approved': class="hl-string">'Underwriting Decision Rendered',
    class=class="hl-string">"hl-comment"># Note: class="hl-string">'Loan Approved with Conditions' is often the same as the class="hl-string">'Approved' milestone.
    class=class="hl-string">"hl-comment"># The class="hl-string">'DecisionOutcome' attribute will provide the specific status.
    class="hl-string">'Approved with Conditions': class="hl-string">'Loan Approved with Conditions',
    class="hl-string">'Conditions Cleared': class="hl-string">'Conditions Cleared',
    class="hl-string">'Clear to Close': class="hl-string">'Clear To Close Issued',
    class="hl-string">'Closing Disclosure Sent': class="hl-string">'Closing Disclosures Sent',
    class="hl-string">'Docs Signed': class="hl-string">'Loan Documents Signed',
    class="hl-string">'Funded': class="hl-string">'Funds Disbursed',
    class="hl-string">'Denied': class="hl-string">'Loan Denied',
    class="hl-string">'Withdrawn': class="hl-string">'Application Withdrawn'
}

class=class="hl-string">"hl-comment"># Encompass Field IDs for recommended attributes. Verify these for your instance.
FIELD_IDS = {
    class="hl-string">'AssignedLoanOfficer': class="hl-string">'3',       class=class="hl-string">"hl-comment"># Loan Officer Name
    class="hl-string">'LoanProductType': class="hl-string">'19',      class=class="hl-string">"hl-comment"># Loan Program
    class="hl-string">'LoanAmount': class="hl-string">'1109',     class=class="hl-string">"hl-comment"># Base Loan Amount
    class="hl-string">'DecisionOutcome': class="hl-string">'3183',  class=class="hl-string">"hl-comment"># Underwriting Decision
    class="hl-string">'ApplicationChannel': class="hl-string">'4009'  class=class="hl-string">"hl-comment"># Application Method
}

def get_access_token():
    class="hl-string">"""Authenticates with the API and returns an access token."""
    token_url = fclass="hl-string">'{API_BASE_URL}/oauth2/v1/token'
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/x-www-form-urlencoded'}
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    try:
        response = requests.post(token_url, headers=headers, data=payload)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error obtaining access token: {e}")
        return None

def get_loan_guids(token):
    class="hl-string">"""Fetches a list of loan GUIDs within the specified date range."""
    pipeline_url = fclass="hl-string">'{API_BASE_URL}/v3/loanPipeline'
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}
    payload = {
        class="hl-string">'filter': {
            class="hl-string">'operator': class="hl-string">'and',
            class="hl-string">'terms': [
                {class="hl-string">'canonicalName': class="hl-string">'Loan.LastModified', class="hl-string">'matchType': class="hl-string">'greaterThanOrEquals', class="hl-string">'value': START_DATE},
                {class="hl-string">'canonicalName': class="hl-string">'Loan.LastModified', class="hl-string">'matchType': class="hl-string">'lessThanOrEquals', class="hl-string">'value': END_DATE}
            ]
        },
        class="hl-string">'fields': [class="hl-string">'Loan.GUID']
    }
    try:
        response = requests.post(pipeline_url, headers=headers, json=payload)
        response.raise_for_status()
        return [loan[class="hl-string">'Loan.GUID'] for loan in response.json()]
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error fetching loan pipeline: {e}")
        return []

def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    print(class="hl-string">"Starting Encompass data extraction...")
    token = get_access_token()
    if not token:
        return

    print(fclass="hl-string">"Fetching loan GUIDs between {START_DATE} and {END_DATE}...")
    loan_guids = get_loan_guids(token)
    if not loan_guids:
        print(class="hl-string">"No loans found in the specified date range.")
        return

    print(fclass="hl-string">"Found {len(loan_guids)} loans. Processing each one...")
    all_events = []
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}

    for i, guid in enumerate(loan_guids):
        print(fclass="hl-string">"Processing loan {i + 1}/{len(loan_guids)} (GUID: {guid[:8]}...)")
        
        class=class="hl-string">"hl-comment"># Fetch attributes
        fields_url = fclass="hl-string">'{API_BASE_URL}/v3/loans/{guid}/fieldReader'
        field_values = {}
        try:
            field_ids_list = list(FIELD_IDS.values())
            response = requests.post(fields_url, headers=headers, json=field_ids_list)
            response.raise_for_status()
            fields_data = response.json()
            field_id_to_key = {v: k for k, v in FIELD_IDS.items()}
            for item in fields_data:
                key = field_id_to_key.get(item[class="hl-string">'fieldId'])
                if key:
                    field_values[key] = item[class="hl-string">'value']
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch fields for loan {guid}: {e}")

        class=class="hl-string">"hl-comment"># Fetch milestones
        milestones_url = fclass="hl-string">'{API_BASE_URL}/v3/loans/{guid}/milestones'
        try:
            response = requests.get(milestones_url, headers=headers)
            response.raise_for_status()
            milestones = response.json()

            for milestone in milestones:
                milestone_name = milestone.get(class="hl-string">'milestoneName')
                activity_name = MILESTONE_TO_ACTIVITY_MAPPING.get(milestone_name)
                completed_date = milestone.get(class="hl-string">'completedDate')

                if activity_name and completed_date:
                    event = {
                        class="hl-string">'LoanApplicationId': guid,
                        class="hl-string">'ActivityName': activity_name,
                        class="hl-string">'EventTimestamp': completed_date,
                        class="hl-string">'EventEndTime': completed_date,  class=class="hl-string">"hl-comment"># For point-in-time events
                        class="hl-string">'AssignedLoanOfficer': field_values.get(class="hl-string">'AssignedLoanOfficer'),
                        class="hl-string">'LoanProductType': field_values.get(class="hl-string">'LoanProductType'),
                        class="hl-string">'LoanAmount': field_values.get(class="hl-string">'LoanAmount'),
                        class="hl-string">'DecisionOutcome': field_values.get(class="hl-string">'DecisionOutcome'),
                        class="hl-string">'ApplicationChannel': field_values.get(class="hl-string">'ApplicationChannel')
                    }
                    all_events.append(event)
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch milestones for loan {guid}: {e}")
        
        class=class="hl-string">"hl-comment"># Small delay to respect API rate limits
        time.sleep(0.1)

    if not all_events:
        print(class="hl-string">"No events were generated. Check milestone mappings and API responses.")
        return

    print(class="hl-string">"Extraction complete. Creating CSV file...")
    df = pd.DataFrame(all_events)
    df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp'])
    df[class="hl-string">'EventEndTime'] = pd.to_datetime(df[class="hl-string">'EventEndTime'])
    
    output_filename = class="hl-string">'encompass_loan_origination_event_log.csv'
    df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Successfully created '{output_filename}'.")

if __name__ == class="hl-string">"__main__":
    main()

Klaar om aan de slag te gaan?

Haal meer uit het leningaanvraagproces met deze datatemplate. Begin vandaag met het verbeteren van je processen.

Terug naar de verbetergids

Template downloaden

Verbeter het leningaanvraagproces en rond leningen sneller af

Verkort de beslistermijn met 50% en werk achterstanden en risico’s weg.

Start je gratis proefperiode

Geen creditcard nodig. Je kunt binnen enkele minuten aan de slag.

Datatemplate voor leningaanvragen

Datatemplate voor leningaanvragen

Attributen voor leningaanvragen

Activiteiten bij leningaanvragen

Extractiegidsen

Standaardrapportage en CSV-/Excel-export in ICE Encompass

Stappen

Configuratie

Voorbeeldquery config

Data-extractie met Python via de Encompass Developer Connect-API’s

Stappen

Configuratie

Voorbeeldquery python

Klaar om aan de slag te gaan?

Verbeter het leningaanvraagproces en rond leningen sneller af