> Continu verbeteren van processen > Creditmanagement en incasso > HighRadius > Datatemplate

Datatemplate voor kredietbeheer en incasso

HighRadius

Attributen voor kredietbeheer en incasso(21) Activiteiten voor kredietbeheer en incasso(15) Extractiegidsen(2)

Datatemplate voor kredietbeheer en incasso

Deze template helpt je de data te verzamelen die nodig is om het proces voor kredietbeheer en incasso te analyseren. Je ziet welke attributen je moet vastleggen en welke activiteiten je moet volgen. Ook vind je praktische uitleg over het ophalen van deze informatie uit HighRadius. Zo bereid je de data efficiënt voor op process mining.

Aanbevolen attributen om te verzamelen
Belangrijke activiteiten om te volgen voor inzicht in het proces
Extractie-instructies voor HighRadius

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

Template downloaden

Attributen voor kredietbeheer en incasso

Dit zijn de aanbevolen datavelden voor het event log, zodat je het proces voor kredietbeheer en incasso volledig kunt analyseren.

3 Verplicht 7 Aanbevolen 11 Optioneel

	Naam	Beschrijving
	Activiteitsnaam ActivityName	De naam van de specifieke bedrijfsgebeurtenis die op een bepaald moment voor een factuur plaatsvond.
Beschrijving De activiteitsnaam beschrijft een stap in het krediet- en incassoproces, zoals 'Factuur aangemaakt', 'Herinnering voor achterstallige betaling verzonden' of 'Betaling ontvangen'. Samen vormen deze activiteiten het procesverloop van elke case. Met dit attribuut kun je de werkelijke proceskaart ontdekken en in beeld brengen. Je vindt er bottlenecks, afwijkingen van de standaardprocedure en herstelwerk. De frequentie en volgorde van activiteiten zoals 'Incassogesprek vastgelegd' of 'Geschil geregistreerd' geven inzicht in de procesefficiëntie. Waarom dit belangrijk is Dit attribuut beschrijft de processtappen. Daarmee kun je het procesverloop van elke factuur reconstrueren en analyseren. Waar vind je dit? Dit wordt meestal afgeleid uit event logs, statuswijzigingen of specifieke actieregistraties in de verschillende modules van HighRadius. Voorbeelden Factuur naar klant verzondenAanmaningsprocedure gestartBetaling ontvangenGeschil opgelost
	Factuurnummer InvoiceNumber	De unieke identificatiecode van elke factuur en de belangrijkste case-ID voor het credit-to-cash-proces.
Beschrijving Het factuurnummer is de centrale sleutel die alle activiteiten rond één debiteurentransactie met elkaar verbindt. Hiermee kun je de volledige levenscyclus volgen, van het aanmaken van de factuur en verschillende activiteiten voor kredietbeheer en incasso tot de uiteindelijke betaling of afschrijving. Bij process mining is dit attribuut nodig om alle bijbehorende gebeurtenissen in één case te groeperen. Zo kun je het volledige procesverloop in beeld brengen, de duur van cases berekenen, zoals Days Sales Outstanding (DSO), en verschillende routes van een factuur analyseren, bijvoorbeeld via geschillenafhandeling of aanmaningsprocedures. Waarom dit belangrijk is Dit is de belangrijkste identificatiecode die alle processtappen met elkaar verbindt. Zo kun je het volledige traject van een factuur analyseren, van aanmaak tot afsluiting. Waar vind je dit? Dit is een belangrijk veld in HighRadius en staat meestal in de kerngegevens van facturen of debiteuren. Voorbeelden INV-2023-001239876543210SI-55482
	Tijdstip van gebeurtenis EventTime	De timestamp van de activiteit, met datum en tijd.
Beschrijving Het tijdstip van de gebeurtenis geeft voor elke procesactiviteit de exacte datum en tijd. Deze chronologische data vormt de basis van process mining: hiermee kun je gebeurtenissen in de juiste volgorde zetten en de tijd ertussen berekenen. Dit attribuut wordt gebruikt om alle tijdsgebonden KPI’s te berekenen, zoals de doorlooptijd van geschillenafhandeling, kredietgoedkeuring en betalingsboeking. Je kunt er ook procesprestaties door de tijd heen mee analyseren, activiteiten vinden die vertraging veroorzaken en controleren of service level agreements worden nageleefd. Waarom dit belangrijk is Dit geeft alle activiteiten een chronologische context. Die is nodig om doorlooptijden te berekenen, bottlenecks te vinden en te begrijpen hoe het proces verloopt. Waar vind je dit? Elke transactie of event log in HighRadius hoort een bijbehorend timestampveld te hebben, vaak met de naam 'Aanmaakdatum' of 'Timestamp'. Voorbeelden 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Betaalstatus PaymentStatus	De huidige financiële status van de factuur, bijvoorbeeld Open, Betaald, Achterstallig of Betwist.
Beschrijving De betaalstatus laat zien waar een factuur zich in de levenscyclus bevindt. Je ziet of de betaling nog openstaat, volledig of gedeeltelijk is voldaan, de vervaldatum is verstreken of de factuur vanwege een geschil wordt onderzocht. Dit attribuut staat centraal in het dashboard Betaalstatus en ouderdom van facturen. Je kunt er de debiteurenportefeuille snel mee indelen, de financiële situatie in kaart brengen en incassoacties voor achterstallige of betwiste facturen prioriteren. Waarom dit belangrijk is Het deelt facturen in groepen in waarop je actie kunt ondernemen. Zo zie je meteen wat de status van openstaande vorderingen is en kun je incassoacties prioriteren. Waar vind je dit? Dit is een kernstatusveld in het factuurrecord of de debiteurenadministratie van HighRadius. Voorbeelden OpenBetaaldAchterstalligBetwistAfgeboekt
	Betalingsvoorwaarden PaymentTerms	De afgesproken voorwaarden die bepalen wanneer een klant een factuur moet betalen.
Beschrijving De betalingsvoorwaarden leggen de betaalafspraken vast, zoals 'Netto 30', 'Netto 60' of 'Te betalen bij ontvangst'. Dit attribuut vormt de basis voor de berekening van de vervaldatum. Het is een belangrijk attribuut voor het dashboard en de KPI Naleving van betalingsvoorwaarden. Met een analyse zie je of de standaardvoorwaarden consequent worden toegepast en welke voorwaarden vaker samengaan met te late betalingen. Die informatie kan helpen bij het bepalen van het kredietbeleid en bij gesprekken met klanten. Waarom dit belangrijk is Het geeft de verwachte betalingstermijn aan en is daarmee belangrijk voor het berekenen van vervaldata en het meten van de naleving van betaalafspraken door klanten. Waar vind je dit? Dit staat meestal in de factuurkop of de klantstamgegevens in HighRadius of het bronsysteem. Voorbeelden Netto 30Netto 60Te betalen bij ontvangst
	Factuurbedrag InvoiceAmount	Het totale geldbedrag van de factuur.
Beschrijving Dit attribuut bevat het totale bedrag dat op de factuur openstaat. Het is een belangrijke financiële metriek om de waarde van elke case te bepalen. Bij process mining gebruik je het factuurbedrag om incassoacties te prioriteren, bijvoorbeeld door eerst facturen met een hoog bedrag aan te pakken. Het is een basis voor financiële KPI’s zoals Days Sales Outstanding (DSO) en wordt in het dashboard Analyse van afgeboekte facturen gebruikt om de financiële impact van oninbare vorderingen te bepalen. Waarom dit belangrijk is Het geeft elke case financiële context. Zo kun je op waarde analyseren, werk prioriteren en financiële gevolgen zoals afboekingen kwantificeren. Waar vind je dit? Dit is een standaardveld in de factuurkopgegevens in HighRadius. Voorbeelden 5000.001250.7525000.50
	Klant-ID CustomerId	De unieke identificatiecode van de klant bij de factuur.
Beschrijving De klant-ID koppelt een factuur aan de betreffende klant. Zo kun je procesdata vanuit het perspectief van de klant samenvoegen en analyseren. Dit attribuut is belangrijk om het betaalgedrag van verschillende klanten of klantsegmenten te analyseren. Welke klanten betalen vaak te laat? Welke klanten dienen de meeste geschillen in? Het ondersteunt dashboards zoals Naleving van betalingsvoorwaarden en maakt het mogelijk KPI’s per klant uit te splitsen. Waarom dit belangrijk is Hiermee kun je per klant het betaalgedrag, de frequentie van geschillen en de interactie met het proces analyseren en de incassostrategie daarop afstemmen. Waar vind je dit? Dit is een standaardveld in de factuurkop of klantgegevens in HighRadius. Voorbeelden CUST-001ACME-CORPGLOBEX-US
	Naam incassomedewerker CollectorName	De naam van de gebruiker of medewerker die verantwoordelijk is voor een incassoactiviteit.
Beschrijving Dit attribuut identificeert de incassomedewerker, kredietanalist of andere gebruiker die een handmatige activiteit heeft uitgevoerd, zoals 'Incassogesprek geregistreerd' of 'Geschil opgelost'. In analyses kun je hiermee de prestaties van verschillende medewerkers of teams vergelijken. Je ziet hoe het werk is verdeeld en hoe effectief individuele strategieën zijn, bijvoorbeeld aan de hand van het succespercentage van incassogesprekken per medewerker. Ook helpt dit bij het bepalen waar coaching nodig is en bij capaciteitsplanning. Waarom dit belangrijk is Het koppelt procesactiviteiten aan specifieke personen. Zo kun je de teamprestaties, werkverdeling en effectiviteit van handmatige acties analyseren. Waar vind je dit? Deze informatie staat meestal in activiteitenlogboeken of gebruikersactieregistraties in de Collections-module van HighRadius. Voorbeelden John SmithJane DoeEmily Jones
	Reden van geschil DisputeReason	De reden of omschrijving die een klant opgeeft wanneer deze een factuur betwist.
Beschrijving Wanneer een klant een geschil indient, geeft die meestal een reden op, zoals 'Onjuiste prijs', 'Beschadigde goederen' of 'Dubbele factuur'. Dit attribuut legt die reden vast. Een analyse van de geschilreden is belangrijk voor het dashboard Doorlooptijd van geschiloplossing. Je ziet hiermee wat de oorzaken van geschillen zijn en kunt structurele problemen met prijzen, verzending of facturering aanpakken. Door geschillen bij de bron te voorkomen, kan de cashflow aanzienlijk verbeteren. Waarom dit belangrijk is Het laat zien waardoor betalingen vertraging oplopen. Zo kun je gerichte procesverbeteringen doorvoeren en toekomstige geschillen voorkomen. Waar vind je dit? Deze informatie wordt vastgelegd in de module voor geschillenbeheer of inhoudingen van HighRadius wanneer een geschil wordt geregistreerd. Voorbeelden Onjuist aantalPrijsverschilBeschadigde goederenDubbele facturering
	Vervaldatum DueDate	De berekende datum waarop de factuur betaald moet zijn.
Beschrijving De vervaldatum is de kalenderdatum waarop een factuur betaald moet zijn om te voorkomen dat deze als achterstallig wordt beschouwd. De datum wordt meestal berekend op basis van de factuurdatum en de betalingsvoorwaarden. Dit attribuut is de basis voor analyses van achterstallige betalingen. Het wordt gebruikt om het aantal dagen achterstand te berekenen, aanmaningsprocedures te starten en de KPI Naleving van betalingsvoorwaarden te meten. Ook ondersteunt het dashboards over de ouderdom van facturen en de effectiviteit van aanmaningen. Waarom dit belangrijk is Deze datum bepaalt of een factuur op tijd of te laat is betaald en vormt de aanleiding voor vervolgacties en KPI-metingen rond incasso. Waar vind je dit? Dit is een standaardveld in het factuurrecord van HighRadius. Het kan afkomstig zijn uit het bronsysteem of in HighRadius worden berekend. Voorbeelden 2023-04-142023-05-312023-06-20
	Aanmaningsniveau DunningLevel	De fase of het niveau dat is bereikt in het geautomatiseerde aanmaningsproces voor een achterstallige factuur.
Beschrijving Het aanmaningsniveau geeft aan hoe intensief de incasso is. Vaak hoort daar een reeks automatische herinneringen of kennisgevingen bij. Niveau 1 kan bijvoorbeeld een vriendelijke herinnering zijn, terwijl niveau 3 een laatste aanmaning is. Dit attribuut is belangrijk voor het dashboard Effectiviteit van de aanmaningsstrategie. Door te analyseren bij welk niveau klanten het vaakst betalen, kunnen bedrijven hun aanmaningsworkflows verbeteren. Zo blijven ze effectief zonder onnodig streng te zijn en de klantrelatie te schaden. Waarom dit belangrijk is Het volgt de opschaling van incassoactiviteiten. Zo kun je analyseren welke aanmaningsstrategieën klanten het effectiefst tot betaling aanzetten. Waar vind je dit? Dit statusveld wordt beheerd door de geautomatiseerde incasso- of aanmaningsworkflow in HighRadius. Voorbeelden 123 - Laatste aanmaningJuridische incasso
	Bedrijfseenheid BusinessUnit	De interne bedrijfseenheid of divisie die verantwoordelijk is voor de verkoop of factuur.
Beschrijving Met het attribuut Bedrijfseenheid koppel je een factuur aan een specifiek onderdeel van de organisatie, zoals 'Detailhandel', 'Groothandel' of 'Dienstverlening'. Zo kun je prestaties per bedrijfssegment analyseren. Het management kan KPI’s zoals DSO, het aantal geschillen en afboekingen tussen bedrijfseenheden vergelijken om te zien wat goed gaat en waar verbetering nodig is. Ook wordt duidelijk welke onderdelen verantwoordelijk zijn voor de prestaties op het gebied van openstaande vorderingen. Waarom dit belangrijk is Hiermee kun je de prestaties van verschillende onderdelen van de organisatie vergelijken en zien welke divisies het krediet-tot-geldproces het effectiefst uitvoeren. Waar vind je dit? Dit zijn organisatiegegevens die meestal op de factuur staan of zijn afgeleid van de bijbehorende verkooporder of klantrekening in HighRadius of het ERP-systeem. Voorbeelden BU-Noord-AmerikaDienstendivisieProductie
	Bronsysteem SourceSystem	Het systeem waaruit de data afkomstig is.
Beschrijving Dit attribuut geeft aan uit welk systeem de gebeurtenisdata afkomstig is. Voor deze procesweergave is de waarde meestal 'HighRadius'. In een omgeving met meerdere systemen is dit veld belangrijk om de herkomst van data te begrijpen en informatie naar de bron terug te volgen. Het helpt processen te onderscheiden die meerdere platforms omvatten, zoals een ERP-systeem en een gespecialiseerde incassotool. Waarom dit belangrijk is Dit maakt duidelijk waar de data vandaan komt. Dat is belangrijk voor datagovernance, validatie en inzicht in de technologische omgeving van het proces. Waar vind je dit? Dit is meestal een vaste waarde die tijdens de data-extractie en -transformatie wordt toegevoegd om de dataset te labelen. Voorbeelden HighRadiusHighRadius-CollectionsHighRadius-CashApp
	Dagen achterstallig DaysOverdue	Het aantal dagen dat een factuur na de vervaldatum nog openstaat. De waarde is nul als de factuur nog niet vervallen is of op tijd is betaald.
Beschrijving Dagen achterstallig is een berekende metriek die het verschil meet tussen de huidige datum (voor openstaande facturen) of de betaaldatum (voor betaalde facturen) en de vervaldatum van de factuur. Het is een belangrijke indicator van betalingsachterstanden. Dit attribuut vormt de basis van het dashboard Betaalstatus en ouderdom van facturen. Je gebruikt het om openstaande vorderingen in ouderdomscategorieën in te delen, bijvoorbeeld 1-30 dagen en 31-60 dagen. Het is ook een onderdeel van de berekening van Days Sales Outstanding (DSO) en helpt om incassoacties voor de meest achterstallige facturen te prioriteren. Waarom dit belangrijk is Deze metriek maakt betalingsachterstanden concreet en is belangrijk voor ouderdomsanalyses, het prioriteren van incasso en de berekening van DSO. Waar vind je dit? Dit is geen opgeslagen veld. Het wordt tijdens de datatransformatie berekend op basis van de vervaldatum en de betaaldatum of de huidige datum. Voorbeelden 1545092
	Datum betalingsbelofte PromiseToPayDate	De datum waarop een klant heeft beloofd een achterstallige factuur te betalen.
Beschrijving Wanneer een incassomedewerker contact opneemt met een klant, kan die een betalingsbelofte krijgen: de klant zegt dan toe vóór een bepaalde datum te betalen. Dit attribuut registreert die datum. Met deze data kun je beoordelen hoe betrouwbaar betalingsbeloften zijn en hoe goed medewerkers concrete toezeggingen krijgen. Je kunt er het percentage nagekomen beloften mee volgen, een belangrijke prestatie-indicator voor een incassoteam. Waarom dit belangrijk is Het legt een belangrijke uitkomst van incassoactiviteiten vast. Je kunt ermee meten hoe effectief opvolging is en hoe betrouwbaar betalingsbeloften van klanten zijn. Waar vind je dit? Deze datum wordt geregistreerd wanneer een activiteit voor een betalingsbelofte wordt vastgelegd in de Collections-module van HighRadius. Voorbeelden 2023-06-152023-07-012023-06-25
	Eindtijd EndTime	Het timestamp waarop een activiteit is afgerond.
Beschrijving De eindtijd geeft aan wanneer een activiteit is afgerond. Veel activiteiten in het incassoproces zijn momentopnamen waarbij de starttijd gelijk is aan de eindtijd. Andere activiteiten, zoals 'Geschil oplossen', kunnen een duidelijke doorlooptijd hebben. Als dit attribuut beschikbaar is, gebruik je het samen met de starttijd om de verwerkingstijd van afzonderlijke activiteiten te berekenen. Zo zie je welke stappen zelf de meeste tijd en middelen kosten, en niet alleen waar de wachttijd tussen stappen zit. Waarom dit belangrijk is Hiermee meet je de doorlooptijd van afzonderlijke activiteiten nauwkeurig en zie je beter waar in het proces tijd aan wordt besteed. Waar vind je dit? Raadpleeg de documentatie van HighRadius. Deze informatie is mogelijk beschikbaar voor bepaalde geregistreerde activiteiten met een begin- en eindstatus. Voorbeelden 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Geautomatiseerd IsAutomated	Een booleaanse aanduiding die aangeeft of een activiteit automatisch door het systeem of handmatig door een gebruiker is uitgevoerd.
Beschrijving Dit berekende attribuut maakt onderscheid tussen systeemgebeurtenissen, zoals een automatisch verstuurde herinnering bij een aanmaningsrun, en handmatige acties, zoals een geregistreerd incassogesprek. Deze aanduiding is nodig om de KPI Percentage geautomatiseerde incassoactiviteiten te berekenen. Je kunt ermee meten hoeveel van het incassoproces is geautomatiseerd, mogelijkheden voor verdere automatisering vinden en de effectiviteit van automatische en handmatige acties vergelijken. Waarom dit belangrijk is Hiermee meet je de mate van automatisering in het proces en kun je de efficiëntie en effectiviteit van geautomatiseerde systemen vergelijken met handmatig werk. Waar vind je dit? Dit wordt afgeleid tijdens de datatransformatie. Daarvoor moet je op basis van bedrijfskennis bepaalde activiteitsnamen als geautomatiseerd markeren. Voorbeelden truefalse
	Laatste data-update LastDataUpdate	Het timestamp waarop de data voor dit record voor het laatst vanuit het bronsysteem is vernieuwd.
Beschrijving Dit attribuut geeft aan hoe recent de data is. Het registreert de datum en tijd van de laatste data-extractie of update vanuit HighRadius. Bij analyses geeft dit veld context over hoe actueel de inzichten zijn. Dashboards en rapporten moeten laten zien hoe actueel de informatie is, zodat beslissingen op basis van recente data worden genomen. Waarom dit belangrijk is Zo zie je hoe actueel de data is. Dat is belangrijk om op de analyse te kunnen vertrouwen en goed onderbouwde beslissingen te nemen. Waar vind je dit? Dit timestamp wordt tijdens de extractie door de data-invoerketen gegenereerd en aan elk record toegevoegd. Voorbeelden 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Land Country	Het land van de klant bij de factuur.
Beschrijving Dit attribuut geeft aan in welk land de klant is gevestigd. Zo kun je het krediet- en incassoproces geografisch uitsplitsen. Een analyse per land kan regionale verschillen in betaalgedrag, de effectiviteit van incassostrategieën en veelvoorkomende redenen voor geschillen aan het licht brengen. Deze informatie helpt bij het afstemmen van regionaal beleid en bij managementrapportages voor internationale organisaties. Waarom dit belangrijk is Hiermee kun je regionale trends in betaalgedrag analyseren en incassostrategieën daarop afstemmen. Waar vind je dit? Deze informatie staat in de klantstamgegevens. Die zijn meestal beschikbaar in HighRadius of worden gesynchroniseerd vanuit een bronsysteem. Voorbeelden USADuitslandBrazilië
	Reden van afboeking WriteOffReason	De reden of toelichting waarom een factuur als oninbare vordering is afgeboekt.
Beschrijving Wanneer een factuur niet meer kan worden geïnd, wordt deze afgeboekt. Dit attribuut legt de reden vast, bijvoorbeeld 'Faillissement klant', 'Onopgelost geschil' of 'Afboeking klein saldo'. Dit attribuut is belangrijk voor het dashboard Analyse van afgeboekte facturen. Het helpt de oorzaken van financiële verliezen te achterhalen. De uitkomsten kunnen worden gebruikt om het kredietbeleid aan te scherpen, geschillen beter af te handelen of incassostrategieën aan te passen en zo toekomstige afboekingen te beperken. Waarom dit belangrijk is Het verklaart waarom omzet verloren gaat en levert informatie op waarmee je de kredietrisicobeoordeling en het incassobeleid kunt verbeteren. Waar vind je dit? Deze informatie wordt vastgelegd wanneer de activiteit 'Factuur afgeboekt' wordt verwerkt, meestal in de financiële of incassomodule van HighRadius. Voorbeelden FaillissementVerjaringstermijn verstrekenIncassokosten hoger dan de vordering
	Valuta Currency	De valutacode van het factuurbedrag.
Beschrijving Dit attribuut geeft de valuta van de factuur aan, zoals USD, EUR of JPY. Het biedt belangrijke context bij geldbedragen zoals het factuurbedrag. Voor internationale bedrijven is dit veld onmisbaar voor een correcte financiële analyse. Het zorgt ervoor dat geldbedragen juist worden geïnterpreteerd en maakt een correcte valutaomrekening mogelijk bij het samenvoegen van data voor internationale rapportages. Waarom dit belangrijk is Het is nodig om geldbedragen correct te interpreteren en voorkomt onjuiste berekeningen en rapportages in omgevingen met meerdere valuta. Waar vind je dit? Dit is een standaardveld in het factuurrecord, meestal naast het factuurbedrag. Voorbeelden USDEURGBP

Verplicht Aanbevolen Optioneel

Activiteiten voor kredietbeheer en incasso

Leg deze belangrijke processtappen en mijlpalen vast in het event log om het proces voor kredietbeheer en incasso nauwkeurig in kaart te brengen en te analyseren.

7 Aanbevolen 8 Optioneel

	Activiteit	Beschrijving
	Betaling ontvangen	Deze activiteit markeert de ontvangst van een betaling van een klant, vaak op basis van een bankafschrift of lockboxbestand. Het geld is ontvangen, maar nog niet aan de betreffende factuur toegewezen.
Waarom dit belangrijk is Dit is een belangrijke mijlpaal die de incassotermijn vaak stopt. Het is het startpunt voor de KPI voor de vertraging tussen betalingsontvangst en -boeking. Zo worden vertragingen bij de verwerking van betalingen zichtbaar. Waar vind je dit? Dit wordt vastgelegd op basis van betalingsregistraties in HighRadius Cash Application Cloud. Elke betalingsbatch of transactie uit een bankbestand heeft een ontvangstdatum. Vastleggen Vastgelegd op basis van de timestamp van de betalingsregistratie wanneer deze wordt geïmporteerd of ingevoerd in de module voor betalingsverwerking. Gebeurtenistype explicit
	Factuur aangemaakt	Dit is het begin van de levenscyclus van een factuur binnen het incassoproces. De factuur is aangemaakt in het ERP-systeem en geïmporteerd in HighRadius voor debiteurenbeheer.
Waarom dit belangrijk is Deze activiteit is het belangrijkste startevent voor de analyse van het factuur-tot-betalingsproces. Alle doorlooptijden, zoals Days Sales Outstanding (DSO), worden meestal vanaf dit moment gemeten. Waar vind je dit? Dit is een expliciete gebeurtenis, vastgelegd op basis van de aanmaakdatum van de factuur in HighRadius. Die datum wordt meestal gesynchroniseerd vanuit het bronsysteem, zoals SAP of Oracle. Vastleggen Vastgelegd op basis van de aanmaaktimestamp van de factuur in de debiteurendata. Gebeurtenistype explicit
	Factuur afgeschreven	Dit is een alternatieve eindstatus van de levenscyclus van de factuur: de schuld wordt als oninbaar beschouwd en als dubieuze vordering afgeschreven. Dit is een ongewenste uitkomst.
Waarom dit belangrijk is Door afschrijvingen te volgen, kun je het afschrijvingspercentage van facturen berekenen en de oorzaken van financieel verlies analyseren. Zo vind je tekortkomingen in de kredietbeoordeling of het incassoproces. Waar vind je dit? Deze gebeurtenis wordt vastgelegd wanneer een transactie voor het afschrijven van het factuursaldo wordt geboekt of wanneer de factuurstatus verandert in 'Afgeschreven'. Vastleggen Afgeleid uit een statuswijziging naar 'Afgeschreven' of uit een specifieke transactie voor het afschrijven van de factuur. Gebeurtenistype inferred
	Factuur vereffend	Deze activiteit markeert het succesvolle einde van de levenscyclus van de factuur: de factuur is volledig betaald en afgesloten. Dit is de gewenste eindstatus van het proces.
Waarom dit belangrijk is Dit is het belangrijkste eindevent van de ideale route door het proces. Door de routes naar deze uitkomst te analyseren, vind je goede werkwijzen en effectieve incassostrategieën. Waar vind je dit? Dit is meestal geen expliciete gebeurtenis, maar wordt afgeleid wanneer de factuurstatus verandert in 'Gesloten' of 'Vereffend' en het saldo nul wordt. De timestamp van de laatste betalingsboeking geldt vaak als tijdstip van de gebeurtenis. Vastleggen Afgeleid uit een statuswijziging van de factuur naar 'Gesloten' of uit het moment waarop het factuursaldo nul wordt. Gebeurtenistype inferred
	Geschil geregistreerd	Deze activiteit markeert het moment waarop een klant een factuur betwist of een aftrekpost meldt en dit formeel in HighRadius wordt geregistreerd. Het standaardincassoproces voor het betwiste bedrag wordt hierdoor onderbroken.
Waarom dit belangrijk is Dit is het startevent voor het meten van de gemiddelde afhandelingstijd van geschillen. Door te achterhalen wanneer en waarom geschillen ontstaan, kun je oorzaken zoals factureringsfouten of problemen met verzending aanpakken. Waar vind je dit? Deze gebeurtenis wordt vastgelegd wanneer een gebruiker in HighRadius Deductions Cloud een geschilcase aanmaakt die aan een factuur is gekoppeld. Daarbij wordt een geschilregistratie met timestamp aangemaakt. Vastleggen Vastgelegd op basis van de aanmaaktimestamp van de geschilcase die aan de factuur is gekoppeld. Gebeurtenistype explicit
	Geschil opgelost	Dit markeert het einde van het geschillenbeheer: het probleem is onderzocht en er is een oplossing gevonden. De factuur kan nu worden betaald of afgeschreven.
Waarom dit belangrijk is Dit is het eindevent voor het meten van de gemiddelde afhandelingstijd van geschillen. Lange doorlooptijden kunnen de inning van betalingen flink vertragen en wijzen mogelijk op inefficiënte processen. Waar vind je dit? Dit wordt vastgelegd wanneer de status van de geschilcase verandert in 'Opgelost', 'Gesloten' of een vergelijkbare eindstatus. De timestamp van deze statuswijziging wordt gebruikt voor de activiteit. Vastleggen Afgeleid uit de timestamp waarop de status van de geschilcase wordt bijgewerkt naar de definitieve status 'Opgelost'. Gebeurtenistype inferred
	Vervaldatum van betaling verstreken	Een berekende gebeurtenis die plaatsvindt wanneer de huidige datum na de vervaldatum van de factuur valt. Dit is geen actie van een gebruiker of systeem, maar wel een belangrijke statuswijziging die het incassoproces start.
Waarom dit belangrijk is Deze activiteit is de belangrijkste aanleiding voor alle daaropvolgende aanmanings- en incassoactiviteiten. Zo kun je facturen die op tijd zijn betaald onderscheiden van achterstallige facturen en de effectiviteit van de incassostrategie analyseren. Waar vind je dit? Deze gebeurtenis wordt niet rechtstreeks opgeslagen. Ze wordt berekend door de vervaldatum van de factuur te vergelijken met de timestamp van andere gebeurtenissen. De gebeurtenis wordt afgeleid tijdens de datatransformatie voor process mining. Vastleggen Berekend door de due_date van de factuur te vergelijken met de huidige datum of de timestamp van een gebeurtenis (Timestamp > Due Date). Gebeurtenistype calculated
	Aanmaningsprocedure gestart	Deze activiteit markeert het begin van een formele aanmaningsprocedure of een specifiek niveau daarin voor een achterstallige factuur. Dit is een meer gestructureerde stap dan één losse herinnering.
Waarom dit belangrijk is Door de start van aanmaningsprocedures te volgen, kun je analyseren hoe effectief verschillende incassostrategieën en aanmaningsniveaus zijn om betaling te krijgen. Waar vind je dit? Deze gebeurtenis wordt meestal afgeleid uit een wijziging van het veld 'Aanmaningsniveau' of 'Incassostrategie' bij de factuur in HighRadius. Vastleggen Afgeleid uit een wijziging van het attribuut voor het aanmaningsniveau van de factuur, op basis van wijzigingslogs of een geschiedenis met timestamps. Gebeurtenistype inferred
	Betaling geboekt	Dit markeert de afronding van de betalingsverwerking: een ontvangen betaling is gekoppeld aan een specifieke factuur en daarop geboekt, zodat het openstaande saldo wordt vereffend.
Waarom dit belangrijk is Met deze activiteit is de betalingsverwerking afgerond. De tijd tussen 'Betaling ontvangen' en 'Betaling geboekt' laat zien hoe efficiënt betalingen worden verwerkt. Waar vind je dit? Deze gebeurtenis wordt vastgelegd op basis van de boekingsdatum of vereffeningsdatum op de factuur. De timestamp wordt geregistreerd wanneer de betalingsverwerking is afgerond. Vastleggen Vastgelegd op basis van de timestamp van de 'boekingsdatum' of 'vereffeningsdatum' op de boekingsregel van de factuur. Gebeurtenistype explicit
	Betalingstoezegging aangemaakt	Deze activiteit vindt plaats wanneer een klant toezegt een factuur op een toekomstige datum te betalen en de incassomedewerker die toezegging in het systeem vastlegt. Dit is een positieve tussenuitkomst.
Waarom dit belangrijk is Door betalingstoezeggingen te volgen, kun je de cashflow voorspellen en de effectiviteit van medewerkers beoordelen. Je kunt ook toezeggingen analyseren die niet worden nagekomen, wanneer de betaling niet op de afgesproken datum binnenkomt. Waar vind je dit? Dit is een expliciete gebeurtenis in HighRadius. De medewerker maakt een registratie voor 'Betalingstoezegging' aan die aan een factuur is gekoppeld. De registratie heeft een eigen aanmaaktimestamp. Vastleggen Vastgelegd op basis van de aanmaaktimestamp van het object 'Betalingstoezegging' in HighRadius. Gebeurtenistype explicit
	Factuur naar klant verzonden	Deze activiteit markeert het moment waarop de factuur bij de klant is afgeleverd, meestal per e-mail of via een klantenportaal. HighRadius kan dit bericht automatisch versturen en vastleggen.
Waarom dit belangrijk is Door dit te volgen, controleer je of klanten facturen op tijd ontvangen. Vertraging tussen het aanmaken en versturen van een factuur kan de betalingstermijn en DSO direct beïnvloeden. Waar vind je dit? Dit wordt vaak expliciet vastgelegd in de correspondentie- of activiteitengeschiedenis van de factuur in de module Collections Cloud. Het kan ook worden afgeleid uit de status van een automatische correspondentieopdracht. Vastleggen Vastgelegd in de communicatiegeschiedenis van de factuur zodra deze per e-mail of via het portaal is verstuurd. Gebeurtenistype explicit
	Herinnering voor achterstallige betaling verzonden	Dit is een automatische of handmatige herinnering aan een klant over een achterstallige factuur. HighRadius kan dit automatiseren als onderdeel van de aanmaningsstrategie en de communicatie vastleggen.
Waarom dit belangrijk is Deze activiteit is nodig om het aanmaningspercentage te meten. Je kunt analyseren hoeveel herinneringen nodig zijn voordat een betaling binnenkomt. Waar vind je dit? Dit is een expliciete gebeurtenis in het activiteiten- of correspondentielog van de factuur in HighRadius Collections Cloud. Elke verstuurde herinnering heeft een bijbehorende registratie en timestamp. Vastleggen Vastgelegd op basis van de timestamp in het communicatielog van de factuur. Gebeurtenistype explicit
	Incassogesprek vastgelegd	Dit is een handmatig incassogesprek van een medewerker met een klant over een achterstallige factuur. De medewerker legt de details en uitkomst van het gesprek vast in HighRadius.
Waarom dit belangrijk is Deze activiteit is belangrijk om het succespercentage van incassogesprekken en de efficiëntie van incassoactiviteiten te beoordelen. Zo kun je automatische en handmatige incasso-inspanningen van elkaar onderscheiden. Waar vind je dit? Dit is een expliciete gebeurtenis die wordt aangemaakt wanneer een medewerker in HighRadius de functie 'Gesprek vastleggen' of 'Activiteit toevoegen' gebruikt bij een factuur of klantaccount. De registratie bevat een timestamp. Vastleggen Vastgelegd in de tabel met activiteitenlogs, waar medewerkers handmatige acties registreren. Gebeurtenistype explicit
	Kredietlimiet aangevraagd	Deze activiteit markeert het begin van een kredietbeoordeling voor een klant. Meestal gebeurt dit voordat een verkooporder definitief wordt. De activiteit wordt vastgelegd zodra een aanvraag voor een nieuwe of aangepaste kredietlimiet in het systeem wordt ingevoerd.
Waarom dit belangrijk is Door de tijd tussen aanvraag en goedkeuring te analyseren, vind je bottlenecks bij het onboarden van klanten en in de verkoopcyclus. Dit is een belangrijk startpunt om de efficiëntie van het kredietbeheerteam te meten. Waar vind je dit? Deze gebeurtenis wordt waarschijnlijk afgeleid uit een statuswijziging in het kredietprofiel van de klant of uit de aanmaakdatum van een aanvraag voor een kredietlimiet in de module Credit Management van HighRadius. Vastleggen Afgeleid uit de aanmaaktimestamp van een aanvraag voor een kredietlimiet of uit een statuswijziging naar 'In afwachting van goedkeuring'. Gebeurtenistype inferred
	Kredietlimiet goedgekeurd	Dit markeert de succesvolle afronding van de kredietbeoordeling: de klant krijgt officieel een kredietlimiet. De gebeurtenis wordt vastgelegd wanneer een kredietmanager de aanvraag goedkeurt in HighRadius.
Waarom dit belangrijk is Dit is een belangrijke mijlpaal die de verkoop weer op gang brengt. Door deze activiteit te volgen, kun je de totale KPI voor de doorlooptijd van kredietgoedkeuring berekenen. Waar vind je dit? Deze gebeurtenis wordt meestal vastgelegd wanneer de status van de aanvraag voor een kredietlimiet verandert in 'Goedgekeurd'. Het kan ook een aparte gebeurtenis zijn in het auditlog van het systeem. Vastleggen Afgeleid uit een statuswijziging van de kredietaanvraag naar 'Goedgekeurd' of uit het veld met de goedkeuringstimestamp. Gebeurtenistype inferred

Aanbevolen Optioneel

Extractiegidsen

Zo haal je data uit HighRadius

Stappen

Open de rapportage- en analysemodule: Meld je aan bij HighRadius met een gebruikersaccount dat de benodigde rechten heeft om aangepaste rapporten te maken en uit te voeren. Open het onderdeel Rapportage en analyse via het hoofddashboard of het applicatiemenu.
Maak een nieuw aangepast rapport: Start het maken van een rapport. Kies een basisobject als uitgangspunt voor je data, zoals het object Facturen of Openstaande debiteuren. Geef het rapport een duidelijke naam, bijvoorbeeld ProcessMind_Credit_Collections_Log.
Definieer de belangrijkste factuurattributen: Voeg de belangrijkste factuurvelden toe aan de rapportindeling. Het gaat om InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate en PaymentStatus. Deze vormen de basis voor de kolommen van elke gebeurtenis.
Voeg data uit gerelateerde objecten toe (gebeurtenissen): Dit is de belangrijkste stap. Je moet data uit verschillende HighRadius-objecten samenvoegen om alle 15 vereiste activiteiten vast te leggen. Gebruik de rapportbouwer om gerelateerde databronnen toe te voegen. Maak voor elke activiteit kolommen aan met de details van de gebeurtenis.
Stel het rapport in op de indeling van een event log: Configureer het rapport zo dat elke gebeurtenis één rij krijgt. Meestal betekent dit dat je verschillende datablocks onder elkaar samenvoegt, in plaats van ze als kolommen aan elkaar te koppelen. Koppel in elk samengevoegd blok het relevante datumveld aan de gemeenschappelijke kolom EventTime en vul ActivityName in met de bijbehorende activiteit.
Configureer de gebeurtenis 'Payment Due Date Passed': Deze gebeurtenis is afhankelijk van een voorwaarde. Maak in het rapport een apart datablock voor facturen waarvan de DueDate in het verleden ligt en waarvan de PaymentStatus nog 'Open' of 'Overdue' is. Stel voor deze records ActivityName in op 'Payment Due Date Passed' en gebruik de DueDate als EventTime.
Voeg informatie over incassomedewerkers en geschillen toe: Neem data uit de modules Collections en Geschillen op. Koppel objecten zoals CollectorNotes of ActivityHistory om CollectorName op te halen. Koppel het object Geschillen om waar nodig DisputeReason op te halen.
Stel rapportfilters in: Bepaal met filters welke data je ophaalt. Stel een specifieke periode in voor EventTime, bijvoorbeeld de afgelopen 6 maanden, zodat de dataset beheersbaar blijft. Afhankelijk van de organisatiestructuur kun je ook filteren op specifieke bedrijfscodes of bedrijfseenheden.
Voer het rapport uit en bekijk een voorbeeld: Voer het rapport uit om de data te bekijken. Controleer of de indeling overeenkomt met het vereiste event log, met één rij per activiteit en kolommen voor InvoiceNumber, ActivityName, EventTime en andere attributen.
Exporteer de rapportdata: Exporteer het volledige rapport zodra je tevreden bent met het voorbeeld. Kies CSV als exportformaat, zodat process mining-tools de data eenvoudig kunnen inlezen. Stel UTF-8-codering in om problemen met tekens te voorkomen.
Controleer de data: Open het geëxporteerde CSV-bestand in een spreadsheetprogramma. Controleer voordat je de data uploadt naar ProcessMind of alle 15 activiteiten aanwezig zijn, de timestamps correct zijn opgemaakt en de belangrijkste attributen zijn ingevuld.

Configuratie

Rapporttype: Een aangepast rapport dat data uit meerdere modules combineert. Afhankelijk van de HighRadius-versie heet dit mogelijk een 'Joined Report' of moet je meerdere datablocks samenvoegen.
Primair dataobject: Begin met het object Facturen of Accounts Receivable als basis voor het rapport.
Secundaire dataobjecten: Koppel aanvullende objecten, zoals CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase en CashApplication.
Filter op datumbereik: Pas een filter toe op het timestampveld van de primaire gebeurtenis. Haal bij voorkeur data op over een periode van 3 tot 6 maanden. Zo blijft er voldoende detail over en blijft de verwerking vlot. Bijvoorbeeld: EventTime binnen de afgelopen 180 dagen.
Statusfilters: Overweeg irrelevante factuurstatussen, zoals 'Cancelled' of 'Draft', uit te sluiten, tenzij ze deel uitmaken van het proces dat je wilt analyseren.
Rechten: Het gebruikersaccount waarmee je het rapport uitvoert, moet leesrechten hebben voor alle relevante modules, waaronder Credit, Collections, Geschillen en Cash Application. Zo haal je een volledige dataset op.

Voorbeeldquery sql

/*
 This is a configuration model for a HighRadius custom report. 
 It is not an executable SQL script but a blueprint for building the report in the UI.
 The report should be configured to UNION the following data blocks to create a single event log.
*/

// Report Name: ProcessMind_Credit_Collections_Log
// Report Output Format: CSV

// === BLOCK 1: Credit Limit Requested ===
{
  "ActivityName": "Credit Limit Requested",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Requested",
    "EventTime": "CreditRequests.RequestTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 2: Credit Limit Approved ===
{
  "ActivityName": "Credit Limit Approved",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Approved",
    "EventTime": "CreditRequests.ApprovalTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 3: Invoice Generated ===
{
  "ActivityName": "Invoice Generated",
  "Source Object": "Invoices",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Generated",
    "EventTime": "Invoices.CreationTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 4: Invoice Sent to Customer ===
{
  "ActivityName": "Invoice Sent to Customer",
  "Source Object": "CustomerCommunications",
  "Filter": "CustomerCommunications.Type = 'Invoice Delivery'",
  "Columns": {
    "InvoiceNumber": "CustomerCommunications.InvoiceNumber",
    "ActivityName": "Invoice Sent to Customer",
    "EventTime": "CustomerCommunications.SentTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 5: Payment Due Date Passed ===
{
  "ActivityName": "Payment Due Date Passed",
  "Source Object": "Invoices",
  "Filter": "Invoices.DueDate < CURRENT_DATE AND Invoices.PaymentStatus = 'Open'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Payment Due Date Passed",
    "EventTime": "Invoices.DueDate",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 6: Overdue Reminder Sent ===
{
  "ActivityName": "Overdue Reminder Sent",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Reminder'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Overdue Reminder Sent",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 7: Dunning Procedure Initiated ===
{
  "ActivityName": "Dunning Procedure Initiated",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Dunning Level 1'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Dunning Procedure Initiated",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 8: Collection Call Logged ===
{
  "ActivityName": "Collection Call Logged",
  "Source Object": "CollectorActivityLog",
  "Filter": "CollectorActivityLog.Type = 'Call'",
  "Columns": {
    "InvoiceNumber": "CollectorActivityLog.InvoiceNumber",
    "ActivityName": "Collection Call Logged",
    "EventTime": "CollectorActivityLog.ActivityTimestamp",
    "CollectorName": "CollectorActivityLog.CollectorName",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 9: Promise to Pay Created ===
{
  "ActivityName": "Promise to Pay Created",
  "Source Object": "PromiseToPay",
  "Columns": {
    "InvoiceNumber": "PromiseToPay.InvoiceNumber",
    "ActivityName": "Promise to Pay Created",
    "EventTime": "PromiseToPay.CreationTimestamp",
    "CollectorName": "PromiseToPay.CreatedByCollector",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 10: Dispute Registered ===
{
  "ActivityName": "Dispute Registered",
  "Source Object": "DisputeCase",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Registered",
    "EventTime": "DisputeCase.CreationTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "Disputed",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 11: Dispute Resolved ===
{
  "ActivityName": "Dispute Resolved",
  "Source Object": "DisputeCase",
  "Filter": "DisputeCase.Status = 'Closed' OR DisputeCase.Status = 'Resolved'",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Resolved",
    "EventTime": "DisputeCase.ResolutionTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 12: Payment Received ===
{
  "ActivityName": "Payment Received",
  "Source Object": "CashApplication.Payments",
  "Columns": {
    "InvoiceNumber": null, // Often matched later
    "ActivityName": "Payment Received",
    "EventTime": "CashApplication.Payments.PaymentDate",
    "CollectorName": null,
    "CustomerId": "CashApplication.Payments.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 13: Payment Posted ===
{
  "ActivityName": "Payment Posted",
  "Source Object": "CashApplication.AppliedPayments",
  "Columns": {
    "InvoiceNumber": "CashApplication.AppliedPayments.InvoiceNumber",
    "ActivityName": "Payment Posted",
    "EventTime": "CashApplication.AppliedPayments.ApplicationTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 14: Invoice Settled ===
{
  "ActivityName": "Invoice Settled",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Paid'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Settled",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Paid",
    "DisputeReason": null
  }
}

// === BLOCK 15: Invoice Written Off ===
{
  "ActivityName": "Invoice Written Off",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Write-Off'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Written Off",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Written Off",
    "DisputeReason": null
  }
}

Stappen

Vereisten: Zorg dat Python 3.6 of hoger is geïnstalleerd, samen met de bibliotheken pandas en requests. Installeer deze met pip: pip install pandas requests. Vraag bij de HighRadius-beheerder ook API-inloggegevens aan (Client ID en Client Secret), met leesrechten voor de benodigde dataobjecten, zoals facturen, incasso, geschillen en betalingen.
Initialiseer het script: Maak een nieuw Python-scriptbestand, bijvoorbeeld extract_hr_data.py. Importeer de benodigde bibliotheken (requests, pandas, datetime) en definieer tijdelijke constanten voor de basis-URL van de HighRadius-API, de inloggegevens en de gewenste extractieperiode.
Stel de authenticatie in: Schrijf een functie voor de authenticatie. Deze functie gebruikt je Client ID en Secret om een POST-verzoek naar het authenticatie-eindpunt van HighRadius te sturen, bijvoorbeeld /auth/v1/token, en een bearer-token op te halen. Dit token wordt opgenomen in de header van alle volgende data-aanvragen.
Haal de belangrijkste factuurdata op: Maak een functie die het belangrijkste factuureindpunt bevraagt, bijvoorbeeld /invoices/v1/search. De functie moet paginering afhandelen, zodat alle records binnen de opgegeven periode worden opgehaald. Roep de API herhaaldelijk aan en verzamel de factuurdata totdat er geen pagina’s meer beschikbaar zijn. Sla deze data op in een lijst met dictionaries.
Haal data van gerelateerde objecten op: Maak voor elke belangrijke data-entiteit, zoals geschillen, incassonotities en betalingen, een aparte functie om data op te halen. Deze functies bevragen de bijbehorende eindpunten, bijvoorbeeld /disputes/v1/search, /collections/v1/notes en /cashapp/v1/payments, en halen alle relevante data voor de opgegeven periode efficiënt op. Meestal is het beter om deze datasets in één keer op te halen dan elke factuur afzonderlijk op te vragen.
Stel het event log samen: Maak een lege lijst voor alle rijen van het event log. Het script doorloopt de opgehaalde data en zet elke relevante actie of statuswijziging om in een gestandaardiseerde dictionary voor één gebeurtenis. Elke dictionary bevat sleutels voor InvoiceNumber, ActivityName, EventTime en alle overige vereiste attributen.
Genereer gebeurtenissen voor de levenscyclus van facturen: Doorloop de lijst met facturen. Maak voor elke factuur gebeurtenissen aan voor 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' en 'Invoice Written Off', op basis van de aanmaakdatum, correspondentiegegevens, sluitingsdatum en statusvelden. Sla deze op als gebeurtenis-dictionaries.
Bereken de gebeurtenis 'Payment Due Date Passed': Voeg in dezelfde factuurlus logica toe om deze gebeurtenis aan te maken. Dit is een berekende gebeurtenis. Controleer of de vervaldatum van de factuur is verstreken, de factuur nog niet is betaald en er nog geen gebeurtenis 'Payment Due Date Passed' voor is aangemaakt. Gebruik de vervaldatum zelf als EventTime.
Genereer incasso- en geschilgebeurtenissen: Verwerk de data van de incasso- en geschilleneindpunten. Maak voor elke notitie, betalingsbelofte, aanmaningsactie of geschilrecord de bijbehorende rijen in het event log aan ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Koppel relevante gegevens, zoals CollectorName en DisputeReason, aan de gebeurtenis.
Genereer betalingsgebeurtenissen: Verwerk de betalingsdata uit de module voor betalingsverwerking. Maak gebeurtenissen 'Payment Received' aan op basis van de aanmaakdatum van de betaling of de datum op het bankafschrift. Gebruik voor gebeurtenissen 'Payment Posted' de datum waarop de betaling succesvol aan de factuur is toegewezen.
Voeg de data samen en maak deze op: Zet de lijst met gebeurtenis-dictionaries na verwerking van alle databronnen om in een pandas DataFrame. Zo kun je de data eenvoudig sorteren en de datatypen aanpassen. Zorg dat de kolom EventTime een consistent timestamp-formaat gebruikt (YYYY-MM-DD HH:MI:SS).
Exporteer naar CSV: Gebruik de functie to_csv van pandas om het uiteindelijke DataFrame naar een CSV-bestand te exporteren. Geef het bestand een duidelijke naam, bijvoorbeeld highradius_event_log.csv. Stel de parameter index=False in om te voorkomen dat de DataFrame-index als kolom wordt toegevoegd. Het bestand is nu klaar om naar ProcessMind te uploaden.

Configuratie

API-inloggegevens: Je hebt een aparte API-gebruiker nodig met een Client ID en Client Secret. Deze gebruiker moet leesrechten hebben voor alle relevante API-eindpunten, waaronder facturen, klanten, incassoactiviteiten, geschillen en betalingsverwerking.
Datumbereik: Het Python-script bevat de variabelen START_DATE en END_DATE. Stel een specifieke, redelijke periode in, bijvoorbeeld 3 tot 6 maanden. Zo beperk je de hoeveelheid data en voorkom je dat het script onnodig lang draait. Filter op een geïndexeerd datumveld, zoals de aanmaak- of wijzigingsdatum van de factuur.
Eindpunt-URL’s: De specifieke API-eindpunten, zoals /invoices/v1/search, zijn tijdelijke aanduidingen. Controleer de juiste URL’s in de API-documentatie van HighRadius binnen je organisatie.
Paginering: Het script moet de pagineringsmethode van de API correct afhandelen. Dit gebeurt meestal met de parameters limit en offset of via een cursor. Een paginagrootte van 100 tot 500 is doorgaans een goed uitgangspunt.
Omgeving: Voer het script uit in een stabiele omgeving met voldoende geheugen voor de DataFrames, vooral bij grote extracties. Voor extracties op productieschaal is een server geschikter dan een lokale computer.
Aangepaste velden: Als het proces afhankelijk is van aangepaste velden in HighRadius, moet je het script aanpassen zodat het deze velden opvraagt en aan de uitvoer toevoegt.

Voorbeeldquery python

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

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
HIGH RADIUS_BASE_URL = class="hl-string">"https://[your-highradius-instance].highradius.com/api"
CLIENT_ID = class="hl-string">"[Your_Client_ID]"
CLIENT_SECRET = class="hl-string">"[Your_Client_Secret]"
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-06-30"

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def get_auth_token():
    class="hl-string">"""Authenticates with HighRadius and returns a bearer token."""
    auth_url = fclass="hl-string">"{HIGH RADIUS_BASE_URL}/auth/v1/token"
    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
    }
    response = requests.post(auth_url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

def fetch_paginated_data(endpoint, params, headers):
    class="hl-string">"""Fetches all pages of data from a given HighRadius endpoint."""
    all_data = []
    page = 0
    limit = 200 class=class="hl-string">"hl-comment"># Records per page
    while True:
        params[class="hl-string">'offset'] = page * limit
        params[class="hl-string">'limit'] = limit
        response = requests.get(fclass="hl-string">"{HIGH RADIUS_BASE_URL}{endpoint}", headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        records = data.get(class="hl-string">'data', []) class=class="hl-string">"hl-comment"># Adjust based on actual API response structure
        if not records:
            break
        all_data.extend(records)
        page += 1
    return all_data

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    class="hl-string">"""Main function to extract, transform, and save the event log."""
    print(class="hl-string">"Starting HighRadius data extraction...")
    auth_token = get_auth_token()
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {auth_token}'}
    events = []

    class=class="hl-string">"hl-comment"># 1. Fetch all relevant invoices in the date range
    print(class="hl-string">"Fetching invoice data...")
    invoice_params = {class="hl-string">'creationDate_gte': START_DATE, class="hl-string">'creationDate_lte': END_DATE}
    invoices = fetch_paginated_data(class="hl-string">"/invoices/v1/search", invoice_params, headers)

    class=class="hl-string">"hl-comment"># Fetch related data in bulk to reduce API calls
    invoice_ids = [inv[class="hl-string">'invoiceNumber'] for inv in invoices]
    print(fclass="hl-string">"Fetching related data for {len(invoice_ids)} invoices...")

    notes = fetch_paginated_data(class="hl-string">"/collections/v1/notes", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    disputes = fetch_paginated_data(class="hl-string">"/disputes/v1/search", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    payments = fetch_paginated_data(class="hl-string">"/cashapp/v1/applications", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    credit_requests = fetch_paginated_data(class="hl-string">"/credit/v1/requests", {class="hl-string">'requestDate_gte': START_DATE, class="hl-string">'requestDate_lte': END_DATE}, headers)

    class=class="hl-string">"hl-comment"># Create dictionaries for quick lookups
    notes_by_invoice = {k: [n for n in notes if n[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    disputes_by_invoice = {k: [d for d in disputes if d[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    payments_by_invoice = {k: [p for p in payments if p[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    
    class=class="hl-string">"hl-comment"># Process each invoice to create events
    print(class="hl-string">"Transforming data into event log...")
    for invoice in invoices:
        common_attrs = {
            class="hl-string">'InvoiceNumber': invoice.get(class="hl-string">'invoiceNumber'),
            class="hl-string">'CustomerId': invoice.get(class="hl-string">'customer', {}).get(class="hl-string">'id'),
            class="hl-string">'InvoiceAmount': invoice.get(class="hl-string">'invoiceAmount'),
            class="hl-string">'PaymentTerms': invoice.get(class="hl-string">'paymentTerms'),
            class="hl-string">'DueDate': invoice.get(class="hl-string">'dueDate'),
            class="hl-string">'PaymentStatus': invoice.get(class="hl-string">'paymentStatus'),
            class="hl-string">'CollectorName': invoice.get(class="hl-string">'collector', {}).get(class="hl-string">'name'),
            class="hl-string">'DisputeReason': None
        }

        class=class="hl-string">"hl-comment"># Invoice Generated
        events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Generated', class="hl-string">'EventTime': invoice.get(class="hl-string">'creationDate')})
        
        class=class="hl-string">"hl-comment"># Invoice Sent to Customer (example from correspondence log)
        if invoice.get(class="hl-string">'sentDate'):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Sent to Customer', class="hl-string">'EventTime': invoice.get(class="hl-string">'sentDate')})

        class=class="hl-string">"hl-comment"># Payment Due Date Passed (calculated)
        due_date_obj = datetime.strptime(invoice.get(class="hl-string">'dueDate'), class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ').date()
        if due_date_obj < datetime.today().date() and invoice.get(class="hl-string">'paymentStatus') not in [class="hl-string">'PAID', class="hl-string">'CLOSED']:
            event_time_at_due_date = datetime.combine(due_date_obj, time(23, 59, 59)).isoformat()
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Due Date Passed', class="hl-string">'EventTime': event_time_at_due_date})

        class=class="hl-string">"hl-comment"># Invoice Settled / Written Off
        if invoice.get(class="hl-string">'closeDate'):
            if invoice.get(class="hl-string">'paymentStatus') == class="hl-string">'PAID':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Settled', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})
            elif invoice.get(class="hl-string">'statusReason') == class="hl-string">'WRITTEN_OFF':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Written Off', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})

        class=class="hl-string">"hl-comment"># Process related notes for this invoice
        for note in notes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            activity_map = {
                class="hl-string">'REMINDER_SENT': class="hl-string">'Overdue Reminder Sent',
                class="hl-string">'DUNNING_STARTED': class="hl-string">'Dunning Procedure Initiated',
                class="hl-string">'COLLECTION_CALL': class="hl-string">'Collection Call Logged',
                class="hl-string">'PROMISE_TO_PAY': class="hl-string">'Promise to Pay Created'
            }
            activity_name = activity_map.get(note.get(class="hl-string">'noteType'))
            if activity_name:
                events.append({**common_attrs, class="hl-string">'ActivityName': activity_name, class="hl-string">'EventTime': note.get(class="hl-string">'creationDate'), class="hl-string">'CollectorName': note.get(class="hl-string">'createdBy')})

        class=class="hl-string">"hl-comment"># Process related disputes for this invoice
        for dispute in disputes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Registered', class="hl-string">'EventTime': dispute.get(class="hl-string">'creationDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
            if dispute.get(class="hl-string">'resolutionDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Resolved', class="hl-string">'EventTime': dispute.get(class="hl-string">'resolutionDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
        
        class=class="hl-string">"hl-comment"># Process related payments for this invoice
        for payment in payments_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            if payment.get(class="hl-string">'paymentReceivedDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Received', class="hl-string">'EventTime': payment.get(class="hl-string">'paymentReceivedDate')})
            if payment.get(class="hl-string">'applicationDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Posted', class="hl-string">'EventTime': payment.get(class="hl-string">'applicationDate')})

    class=class="hl-string">"hl-comment"># Process credit requests (linked by customer ID)
    for request in credit_requests:
        class=class="hl-string">"hl-comment"># Note: Linking to a specific invoice is often not possible. Here we create a case-level event.
        class=class="hl-string">"hl-comment"># A more advanced logic could try to link based on customer and time proximity to an invoice.
        credit_attrs = {**common_attrs, class="hl-string">'InvoiceNumber': fclass="hl-string">"CREDIT-{request.get('customerId')}", class="hl-string">'CustomerId': request.get(class="hl-string">'customerId')}
        events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Requested', class="hl-string">'EventTime': request.get(class="hl-string">'requestDate')})
        if request.get(class="hl-string">'status') == class="hl-string">'APPROVED' and request.get(class="hl-string">'approvalDate'):
            events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Approved', class="hl-string">'EventTime': request.get(class="hl-string">'approvalDate')})

    class=class="hl-string">"hl-comment"># Finalize DataFrame
    if not events:
        print(class="hl-string">"No events found for the specified criteria.")
        return

    df = pd.DataFrame(events)
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'], errors=class="hl-string">'coerce')
    df.dropna(subset=[class="hl-string">'InvoiceNumber', class="hl-string">'ActivityName', class="hl-string">'EventTime'], inplace=True)
    df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'highradius_event_log.csv'
    df.to_csv(output_file, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_file}")

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

Klaar om aan de slag te gaan?

Deze template biedt een gestructureerde basis voor de data die je nodig hebt om inzicht te krijgen in het proces voor kredietbeheer en incasso. Begin vandaag met het verbeteren van de HighRadius-bedrijfsvoering en versnel de cashflow.

Terug naar de verbetergids

Template downloaden

Verbeter kredietbeheer en incasso

Verwijder bottlenecks, verkort de doorlooptijd met 30% en verhoog de efficiëntie.

Start je gratis proefperiode

Geen creditcard nodig. Je kunt binnen enkele minuten beginnen.

Datatemplate voor kredietbeheer en incasso

Datatemplate voor kredietbeheer en incasso

Attributen voor kredietbeheer en incasso

Activiteiten voor kredietbeheer en incasso

Extractiegidsen

Export uit de rapportage- en analysemodule van HighRadius

Stappen

Configuratie

Voorbeeldquery sql

Data-extractie met een Python-script via de REST API’s van HighRadius

Stappen

Configuratie

Voorbeeldquery python

Klaar om aan de slag te gaan?

Verbeter kredietbeheer en incasso