> Continue procesverbetering > Kredietbeheer en incasso > HighRadius > Datatemplate

Jouw datatemplate voor Credit Management & Collections

HighRadius

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

Jouw datatemplate voor Credit Management & Collections

Deze template biedt een gestructureerde leidraad voor het verzamelen van de data die je nodig hebt om je Credit Management & Collections-proces te analyseren. Je ziet welke attributen je moet vastleggen en welke activiteiten je moet volgen. Ook lees je hoe je deze informatie uit je HighRadius-systeem haalt. Met deze template bereid je je data efficiënt voor op process mining.

Aanbevolen attributen om te verzamelen
Belangrijke activiteiten voor inzicht in je proces
Specifieke extractie-instructies voor HighRadius

Nieuw met event logs? Leer hoe je een process mining-event log maakt.

Template downloaden

Attributen voor kredietbeheer en incasso

Dit zijn de aanbevolen datavelden voor je event log voor een volledige analyse van je proces voor kredietbeheer en incasso.

3 Verplicht 7 Aanbevolen 11 Optioneel

	Naam	Beschrijving
	Activiteitnaam ActivityName	De naam van de specifieke bedrijfsgebeurtenis die op een bepaald moment voor een factuur plaatsvond.
Beschrijving De activiteitnaam beschrijft een stap in het krediet- en incassoproces, zoals 'Invoice Generated', 'Overdue Reminder Sent' of 'Payment Received'. De reeks activiteiten vormt de procesflow van elke case. Door dit attribuut te analyseren, ontdek en visualiseer je de werkelijke proceskaart. Je ziet knelpunten, afwijkingen van de standaardprocedure en herstelrondes. De frequentie en volgorde van activiteiten zoals 'Collection Call Logged' of 'Dispute Registered' zijn belangrijk om de procesefficiëntie te begrijpen. Waarom dit belangrijk is Dit attribuut definieert de processtappen, zodat je de procesflow van elke factuur kunt reconstrueren en analyseren. Waar je het vindt Dit wordt meestal afgeleid uit event logs, statuswijzigingen of specifieke actieregistraties in de verschillende modules van het HighRadius-platform. Voorbeelden Factuur naar klant verzondenAanmaningsprocedure gestartBetaling ontvangenGeschil opgelost
	Factuurnummer InvoiceNumber	De unieke identificatie van elke factuur, die dient als primaire case-identificatie voor het credit-to-cash-proces.
Beschrijving Het factuurnummer is de centrale sleutel die alle activiteiten van één debiteurentransactie met elkaar verbindt. Hiermee volg je de volledige levenscyclus, van het genereren van de factuur via verschillende kredietbeheer- en incassoactiviteiten tot de uiteindelijke vereffening of afschrijving. In een process mining-analyse is dit attribuut essentieel om alle gerelateerde gebeurtenissen in één case te groeperen. Zo kun je end-to-end-procesflows visualiseren, de duur van cases zoals Days Sales Outstanding (DSO) berekenen en verschillende routes analyseren, bijvoorbeeld voor geschillenafhandeling of aanmaningsprocedures. Waarom dit belangrijk is Dit is de belangrijkste identificatie die alle processtappen met elkaar verbindt. Daardoor kun je de volledige route van een factuur, van aanmaak tot sluiting, analyseren. Waar je het vindt Dit is een primair veld in HighRadius en staat meestal in de kernobjecten voor facturen of debiteuren. Voorbeelden INV-2023-001239876543210SI-55482
	Tijdstip van gebeurtenis EventTime	De timestamp die aangeeft wanneer de activiteit plaatsvond, inclusief datum en tijd.
Beschrijving Event Time geeft de exacte datum en tijd van elke procesactiviteit. Deze chronologische data vormt de basis van process mining. Hiermee kun je gebeurtenissen in de juiste volgorde zetten en de tijd tussen gebeurtenissen berekenen. Dit attribuut wordt gebruikt voor alle tijdgebonden KPI's, zoals doorlooptijden voor geschillenafhandeling, kredietgoedkeuring en betalingsboeking. Je gebruikt het ook om procesprestaties door de tijd heen te analyseren, activiteiten te vinden die vertraging veroorzaken en naleving van service level agreements te meten. Waarom dit belangrijk is Het geeft alle activiteiten een chronologische context. Dat is essentieel voor het berekenen van doorlooptijden, het vinden van knelpunten en het begrijpen van de dynamiek van het proces. Waar je het vindt Elk transactierecord of event log in HighRadius hoort een bijbehorend timestampveld te hebben, vaak met de naam 'Creation Date' of 'Timestamp'. Voorbeelden 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Betalingsstatus PaymentStatus	De huidige financiële status van de factuur, zoals Open, Paid, Overdue of Disputed.
Beschrijving Payment Status geeft een momentopname van de fase waarin een factuur zich bevindt. Je ziet of de betaling nog openstaat, volledig of gedeeltelijk is voldaan, na de vervaldatum is betaald of vanwege een dispuut wordt onderzocht. Dit attribuut staat centraal in het dashboard 'Invoice Payment Status & Aging'. Je kunt er de portefeuille met openstaande vorderingen snel mee segmenteren, de financiële gezondheid beoordelen en incassowerk prioriteren voor achterstallige of betwiste posten. Waarom dit belangrijk is Het deelt facturen in in groepen waaraan je actie kunt koppelen. Zo zie je meteen wat de status van openstaande vorderingen is en kun je incassoactiviteiten prioriteren. Waar je het vindt Dit is een belangrijk statusveld in het factuurrecord of record met openstaande vorderingen binnen HighRadius. Voorbeelden OpenBetaaldAchterstalligBetwistAfgeboekt
	Betalingsvoorwaarden PaymentTerms	De afgesproken voorwaarden die bepalen wanneer een klant een factuur moet betalen.
Beschrijving Payment Terms beschrijven de betalingsvoorwaarden, zoals 'Net 30', 'Net 60' of 'Due on Receipt'. Dit attribuut vormt de basis voor het berekenen van de vervaldatum van de factuur. Dit is een belangrijk attribuut voor het dashboard en de KPI 'Payment Terms Adherence'. Met deze analyse zie je of standaardvoorwaarden consequent worden toegepast en welke betalingsvoorwaarden samenhangen met meer te late betalingen. Die informatie kan helpen bij het aanpassen van kredietbeleid en klantonderhandelingen. Waarom dit belangrijk is Het vormt de basis voor de verwachte betalingstermijn. Daarmee kun je vervaldatums berekenen en meten in hoeverre klanten zich aan betalingsafspraken houden. Waar je het vindt Je vindt dit meestal in de factuurkop of in de stamgegevens van de klant binnen HighRadius of het bronsysteem, zoals een ERP. Voorbeelden Netto 30Netto 60Te betalen bij ontvangst
	Factuurbedrag InvoiceAmount	De totale geldwaarde van de factuur.
Beschrijving Dit attribuut staat voor het totale bedrag dat op de factuur moet worden betaald. Het is een belangrijke financiële maatstaf om de waarde van elke case te begrijpen. In process mining wordt het factuurbedrag gebruikt om incassowerk te prioriteren, bijvoorbeeld door eerst facturen met een hoge waarde en een verstreken vervaldatum op te pakken. Het is een belangrijke basis voor financiële KPI's zoals Days Sales Outstanding (DSO) en wordt gebruikt in het dashboard Invoice Write-Off Analysis om de financiële impact van oninbare vorderingen te kwantificeren. Waarom dit belangrijk is Het geeft elke case financiële context. Daarmee kun je op waarde analyseren, werk prioriteren en financiële gevolgen zoals afschrijvingen kwantificeren. Waar je het vindt Dit is een standaardveld in de factuurgegevens binnen HighRadius. Voorbeelden 5000.001250.7525000.50
	Klant-ID CustomerId	De unieke identificatie van de klant die bij de factuur hoort.
Beschrijving De klant-ID koppelt een factuur aan de specifieke klant. Zo kun je procesdata vanuit klantperspectief samenvoegen en analyseren. Dit attribuut is belangrijk voor het analyseren van betaalgedrag van verschillende klanten of klantsegmenten. Je kunt er vragen mee beantwoorden als: welke klanten betalen vaak te laat? Welke klanten dienen de meeste disputen in? Het ondersteunt dashboards zoals Payment Terms Adherence en maakt het mogelijk om KPI's per klant te segmenteren. Waarom dit belangrijk is Hiermee kun je betaalgedrag, de frequentie van disputen en de interactie met het proces per klant analyseren. Zo kun je incassostrategieën beter afstemmen. Waar je het vindt Dit is een standaardveld in de factuurkop of klantaccountgegevens binnen HighRadius. Voorbeelden CUST-001ACME-CORPGLOBEX-US
	Naam incassomedewerker CollectorName	De naam van de gebruiker of agent die verantwoordelijk is voor het uitvoeren van een incassoactiviteit.
Beschrijving Dit attribuut identificeert de incassomedewerker, kredietanalist of andere gebruiker die een handmatige activiteit heeft uitgevoerd, zoals 'Collection Call Logged' of 'Dispute Resolved'. In analyses kun je hiermee de prestaties van verschillende incassomedewerkers of teams vergelijken. Je ziet hoe het werk is verdeeld, kunt de effectiviteit van individuele strategieën beoordelen, bijvoorbeeld de succesratio van geregistreerde incassogesprekken per medewerker, en mogelijkheden voor coaching vinden. Ook is dit belangrijk voor resourcebeheer en capaciteitsplanning. Waarom dit belangrijk is Het koppelt procesactiviteiten aan specifieke personen. Zo kun je teamprestaties, werkbelasting en de effectiviteit van handmatige interventies analyseren. Waar je het vindt Deze informatie staat meestal in activiteitenlogboeken of gebruikersactieregisters binnen de HighRadius Collections-module. Voorbeelden John SmithJane DoeEmily Jones
	Reden van dispuut DisputeReason	De reden of omschrijving die een klant opgeeft wanneer deze een factuur betwist.
Beschrijving Wanneer een klant een dispuut indient, geeft die meestal een reden op, zoals 'Incorrect Pricing', 'Damaged Goods' of 'Duplicate Invoice'. Dit attribuut legt die reden vast. De analyse van Dispute Reason is belangrijk voor het dashboard 'Invoice Dispute Resolution Time'. Je ziet er de onderliggende oorzaken van disputen mee en kunt structurele problemen in prijsstelling, verzending of facturatie aanpakken. Door disputen bij de bron te verminderen, kan de cashflow aanzienlijk sneller op gang komen. Waarom dit belangrijk is Het maakt de oorzaken van betalingsvertragingen zichtbaar. Zo kun je gerichte procesverbeteringen doorvoeren en toekomstige disputen voorkomen. Waar je het vindt Deze informatie wordt vastgelegd in de dispute management- of deductions-module van HighRadius wanneer een dispuut wordt geregistreerd. Voorbeelden Onjuiste hoeveelheidPrijsverschilBeschadigde goederenDubbele facturering
	Vervaldatum DueDate	De berekende datum waarop de factuur moet zijn betaald.
Beschrijving De vervaldatum is de specifieke kalenderdatum waarop een factuur uiterlijk moet zijn betaald om niet als achterstallig te worden beschouwd. Meestal wordt deze berekend op basis van de factuurdatum en de betalingsvoorwaarden. Dit attribuut vormt de basis voor alle analyses van achterstallige betalingen. Het is de belangrijkste invoer voor het berekenen van 'Days Overdue', het starten van aanmaningsprocedures en het meten van de KPI 'Payment Terms Adherence Rate'. Het ondersteunt rechtstreeks dashboards over factuurveroudering en de effectiviteit van aanmaningen. Waarom dit belangrijk is Deze datum bepaalt of een factuur op tijd of achterstallig is. Daarmee worden alle volgende incassoactiviteiten en KPI's gestart. Waar je het vindt Dit is een standaardveld in het factuurrecord van HighRadius. Het kan uit het bronsysteem, zoals een ERP, worden overgenomen of binnen HighRadius worden berekend. Voorbeelden 2023-04-142023-05-312023-06-20
	Aanmaningsniveau DunningLevel	De fase of het niveau van het geautomatiseerde aanmaningsproces dat voor een achterstallige factuur is bereikt.
Beschrijving Het aanmaningsniveau geeft aan hoe intensief de incasso is, vaak gekoppeld aan een reeks automatische herinneringen of berichten aan de klant. Niveau 1 kan bijvoorbeeld een vriendelijke herinnering zijn, terwijl niveau 3 een laatste aanmaning is. Dit attribuut is belangrijk voor het dashboard 'Dunning Strategy Effectiveness'. Door te analyseren bij welk aanmaningsniveau klanten meestal betalen, kunnen bedrijven hun aanmaningsworkflows verbeteren. Zo blijven ze effectief zonder onnodig hard over te komen en klantrelaties te schaden. Waarom dit belangrijk is Het volgt de escalatie van incassoactiviteiten. Zo kun je analyseren welke aanmaningsstrategieën het beste tot betaling leiden. Waar je het vindt Dit is een statusveld dat wordt beheerd door de geautomatiseerde collections- of dunning-workflowengine binnen HighRadius. Voorbeelden 123 - Laatste aanmaningJuridische incasso
	Bedrijfsonderdeel BusinessUnit	Het interne bedrijfsonderdeel of de divisie die verantwoordelijk is voor de verkoop of factuur.
Beschrijving Het attribuut Business Unit koppelt de factuur aan een specifiek onderdeel van de organisatie, zoals 'Retail', 'Wholesale' of 'Services'. Zo kun je prestaties per bedrijfssegment analyseren. Het management kan KPI's zoals DSO, dispuutpercentages en afschrijvingen tussen bedrijfsonderdelen vergelijken om sterke punten en verbeterpunten te vinden. Ook wordt duidelijk welk onderdeel verantwoordelijk is voor de prestaties van de openstaande vorderingen. Waarom dit belangrijk is Je kunt prestaties tussen verschillende onderdelen van de organisatie vergelijken. Zo zie je welke divisies de effectiefste credit-to-cash-processen hebben. Waar je het vindt Dit zijn organisatiegegevens die meestal op de factuur staan of worden afgeleid van de bijbehorende verkooporder of klantaccount in HighRadius of het ERP-systeem. Voorbeelden BU-Noord-AmerikaDienstendivisieProductie
	Bronsysteem SourceSystem	Het systeem waaruit de data afkomstig is.
Beschrijving Dit attribuut identificeert het bronsysteem waarin de eventdata is gegenereerd. Voor deze procesweergave is de waarde meestal 'HighRadius'. In omgevingen met meerdere systemen is dit veld belangrijk om de herkomst van data te begrijpen en informatie naar de bron terug te leiden. Je kunt er processen mee onderscheiden die over verschillende platforms lopen, zoals een ERP-systeem en een gespecialiseerde incassotool. Waarom dit belangrijk is Het maakt duidelijk waar de data vandaan komt. Dat is belangrijk voor datagovernance, validatie en inzicht in de technologische omgeving van het proces. Waar je het vindt Dit is meestal een statische 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 niet is betaald. De waarde is nul als de factuur nog niet vervallen is of op tijd is betaald.
Beschrijving Days Overdue is een berekende maatstaf voor het verschil tussen de huidige datum, bij openstaande facturen, of de betaaldatum, bij betaalde facturen, en de vervaldatum van de factuur. Het is een belangrijke indicator voor betalingsachterstanden. Dit attribuut vormt de basis van het dashboard 'Invoice Payment Status & Aging'. Je gebruikt het om openstaande vorderingen in ouderdomscategorieën in te delen, bijvoorbeeld 1-30 dagen en 31-60 dagen. Het is ook onderdeel van de berekening van Days Sales Outstanding (DSO) en helpt om incassowerk voor de meest achterstallige accounts te prioriteren. Waarom dit belangrijk is Deze maatstaf maakt betalingsvertragingen concreet. Daarmee is hij belangrijk voor ouderdomsanalyses, het prioriteren van incasso en het berekenen van DSO. Waar je het vindt Dit is geen opgeslagen veld. Het wordt tijdens de data-transformatie berekend met 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 'Promise to Pay' vastleggen. De klant belooft dan om vóór een bepaalde datum te betalen. Dit attribuut registreert die datum. Met deze data kun je beoordelen hoe betrouwbaar betalingsbeloftes zijn en hoe effectief incassomedewerkers vaste toezeggingen verkrijgen. Je kunt er ook het percentage nagekomen beloftes mee volgen, een belangrijke KPI voor een incassoteam. Waarom dit belangrijk is Het legt een belangrijk resultaat van incassoactiviteiten vast. Je gebruikt het om de effectiviteit van opvolging en de betrouwbaarheid van klanttoezeggingen te meten. Waar je het vindt Deze datum wordt geregistreerd wanneer een 'Promise to Pay'-activiteit wordt vastgelegd in de HighRadius Collections-module. Voorbeelden 2023-06-152023-07-012023-06-25
	Eindtijd EndTime	De timestamp die aangeeft wanneer een activiteit is afgerond.
Beschrijving De eindtijd markeert het einde van een activiteit. Veel activiteiten in het incassoproces zijn momentopnames waarbij de starttijd gelijk is aan de eindtijd. Sommige activiteiten, zoals 'Dispute Resolution', hebben echter een eigen doorlooptijd. Dit attribuut wordt, als het beschikbaar is, samen met de starttijd gebruikt om de verwerkingstijd van afzonderlijke activiteiten te berekenen. Zo zie je welke specifieke stappen de meeste tijd en bronnen kosten, in plaats van alleen waar de tussenliggende wachttijden ontstaan. Waarom dit belangrijk is Hiermee kun je de doorlooptijd van afzonderlijke activiteiten nauwkeurig meten. Zo krijg je een gedetailleerder beeld van waar binnen het proces tijd wordt besteed. Waar je het vindt Raadpleeg de documentatie van HighRadius. Deze informatie is mogelijk beschikbaar voor bepaalde gelogde activiteiten met een begin- en eindstatus. Voorbeelden 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Is geautomatiseerd IsAutomated	Een booleaanse vlag die aangeeft of een activiteit automatisch door het systeem of handmatig door een gebruiker is uitgevoerd.
Beschrijving Dit berekende attribuut maakt onderscheid tussen systeemgegenereerde gebeurtenissen, zoals 'Overdue Reminder Sent' tijdens een automatische dunning-run, en handmatige acties, zoals 'Collection Call Logged'. Deze vlag is belangrijk voor het berekenen van de KPI 'Automated Collection Activity Rate'. Je kunt ermee meten hoe ver de automatisering van het incassoproces is gevorderd, kansen voor verdere automatisering vinden en de relatieve effectiviteit van automatische en handmatige contactmomenten analyseren. Waarom dit belangrijk is Het helpt om de mate van automatisering in het proces te meten. Zo kun je de efficiëntie en effectiviteit van automatische systemen vergelijken met handmatig werk. Waar je het vindt Dit wordt afgeleid tijdens de data-transformatie. Je hebt hiervoor een mapping nodig die bepaalde Activity Names op basis van bedrijfskennis als geautomatiseerd markeert. Voorbeelden truefalse
	Laatste data-update LastDataUpdate	De timestamp waarop de data voor dit record voor het laatst vanuit het bronsysteem is vernieuwd.
Beschrijving Dit attribuut geeft aan hoe actueel de data is. Het registreert de datum en tijd van de laatste data-extractie of update vanuit HighRadius. Voor de analyse geeft dit veld context bij de actualiteit van de inzichten. Dashboards en rapporten kunnen hiermee laten zien hoe recent de informatie is, zodat beslissingen op actuele data worden gebaseerd. Waarom dit belangrijk is Het maakt transparant hoe actueel de data is. Dat is belangrijk om vertrouwen in de analyse op te bouwen en goed onderbouwde beslissingen te nemen. Waar je het vindt Deze timestamp wordt tijdens de extractie door de data-ingestiepijplijn 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 die bij de factuur hoort.
Beschrijving Dit attribuut geeft aan in welk land de klant is gevestigd. Zo kun je het krediet- en incassoproces geografisch segmenteren. Een analyse per land kan regionale verschillen in betaalgedrag, de effectiviteit van incassostrategieën en veelvoorkomende redenen voor disputen zichtbaar maken. Deze informatie helpt bij het afstemmen van regionaal beleid en managementrapportages in internationale organisaties. Waarom dit belangrijk is Hiermee kun je geografische analyses uitvoeren. Zo ontdek je regionale trends in betaalgedrag en kun je incassostrategieën daarop afstemmen. Waar je het vindt Deze informatie maakt deel uit van de stamgegevens van de klant. Je vindt die meestal in HighRadius of gesynchroniseerd vanuit een bronsysteem, zoals een ERP. Voorbeelden USADuitslandBrazilië
	Reden van afschrijving WriteOffReason	De reden of code waarom een factuur als oninbare vordering is afgeschreven.
Beschrijving Wanneer een factuur oninbaar wordt geacht, wordt deze afgeschreven. Dit attribuut legt de reden vast, zoals 'Customer Bankruptcy', 'Unresolved Dispute' of 'Small Balance Write-Off'. Dit is een belangrijk attribuut voor het dashboard 'Invoice Write-Off Analysis'. Het helpt bij het analyseren van de oorzaken van financiële verliezen. Met die inzichten kun je kredietbeleid aanscherpen, dispuutafhandeling verbeteren of incassostrategieën aanpassen om toekomstige afschrijvingen te beperken. Waarom dit belangrijk is Het verklaart waardoor omzet verloren gaat. Die informatie helpt bij het verbeteren van kredietrisicobeoordeling en incassobeleid. Waar je het vindt Deze informatie wordt geregistreerd wanneer de activiteit 'Invoice Written Off' wordt verwerkt, meestal in de financiële of collections-module van HighRadius. Voorbeelden FaillissementVerjaringstermijn verstrekenIncassokosten hoger dan de schuld
	Valuta Currency	De valutacode van het factuurbedrag.
Beschrijving Dit attribuut geeft aan in welke valuta de factuur is opgesteld, zoals USD, EUR of JPY. Het biedt de nodige context voor geldbedragen zoals Invoice Amount. Voor internationale bedrijven is dit veld noodzakelijk 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 wereldwijde rapportages. Waarom dit belangrijk is Het is nodig om alle geldbedragen correct te interpreteren. Zo voorkom je onjuiste financiële berekeningen en rapportages in omgevingen met meerdere valuta. Waar je het vindt Dit is een standaardveld in het factuurrecord, meestal naast Invoice Amount. Voorbeelden USDEURGBP

Verplicht Aanbevolen Optioneel

Activiteiten voor kredietbeheer en incasso

Dit zijn de belangrijkste processtappen en mijlpalen die je in je event log vastlegt voor een nauwkeurige ontdekking en analyse van je proces voor kredietbeheer en incasso.

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 lockbox-bestand. Het geld is ontvangen, maar nog niet aan de specifieke factuur toegewezen.
Waarom dit belangrijk is Dit is een belangrijke mijlpaal die de incassoklok vaak stopt. Het is het startpunt voor de KPI Payment Receipt to Posting Lag en maakt vertragingen bij het toewijzen van betalingen zichtbaar. Waar je het vindt 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 in de cash application-module wordt geïmporteerd of ingevoerd. Eventtype explicit
	Factuur afgeschreven	Dit staat voor een alternatief einde van de levenscyclus van de factuur. De schuld wordt als oninbaar beschouwd en als oninbare vordering afgeschreven. Dit is een ongewenste uitkomst.
Waarom dit belangrijk is Het volgen van afschrijvingen is belangrijk voor het berekenen van het Invoice Write-Off Rate en het analyseren van de oorzaken van financieel verlies. Zo zie je waar kredietbeoordeling of incasso tekortschiet. Waar je het vindt Deze gebeurtenis wordt vastgelegd wanneer een specifieke transactie om het factuursaldo af te schrijven wordt geboekt of wanneer de factuurstatus verandert in 'Written-Off'. Vastleggen Afgeleid uit een statuswijziging naar 'Written-Off' of uit het boeken van een specifiek transactietype voor afschrijving op de factuur. Eventtype inferred
	Factuur gegenereerd	Dit is het startpunt van de levenscyclus van een factuur binnen het incassoproces. Het betekent dat een factuur in het ERP-systeem is aangemaakt en in HighRadius is geïmporteerd voor debiteurenbeheer.
Waarom dit belangrijk is Deze activiteit is de belangrijkste startgebeurtenis voor de analyse van het invoice-to-cash-proces. Alle doorlooptijden, zoals Days Sales Outstanding (DSO), worden meestal vanaf dit punt gemeten. Waar je het vindt Dit is een expliciete gebeurtenis die wordt vastgelegd op basis van de aanmaakdatum van de factuur in HighRadius. Die wordt meestal gesynchroniseerd vanuit het bronsysteem, zoals SAP of Oracle. Vastleggen Vastgelegd op basis van de aanmaaktimestamp van de factuur in de debiteurendata. Eventtype explicit
	Factuur vereffend	Deze activiteit betekent dat de levenscyclus van de factuur succesvol is afgerond. De factuur is volledig betaald en gesloten. Dit is de gewenste eindstatus van het proces.
Waarom dit belangrijk is Dit is de belangrijkste eindgebeurtenis voor de 'happy path' van het proces. Door de routes naar deze uitkomst te analyseren, zie je best practices en succesvolle incassostrategieën. Waar je het vindt Dit is meestal geen expliciete gebeurtenis, maar wordt afgeleid uit een statuswijziging van de factuur naar 'Closed' of 'Cleared' en een saldo van nul. De timestamp van de laatste betalingsboeking wordt vaak als tijdstip van de gebeurtenis gebruikt. Vastleggen Afgeleid uit een statuswijziging van de factuur naar 'Closed' of wanneer het factuursaldoveld nul wordt. Eventtype inferred
	Geschil geregistreerd	Deze activiteit markeert het moment waarop een klant een factuur betwist of een aftrekpost indient en dit formeel in HighRadius wordt vastgelegd. Het standaardincassoproces voor het betwiste bedrag wordt hierdoor gepauzeerd.
Waarom dit belangrijk is Dit is de startgebeurtenis voor het meten van de gemiddelde doorlooptijd van geschillenafhandeling. Door te zien wanneer en waarom geschillen ontstaan, kun je oorzaken zoals factureringsfouten of problemen met verzending aanpakken. Waar je het vindt Deze gebeurtenis wordt vastgelegd wanneer een gebruiker in HighRadius Deductions Cloud een geschilcase aanmaakt die aan een factuur is gekoppeld. Daarbij ontstaat een geschilregistratie met timestamp. Vastleggen Vastgelegd op basis van de aanmaaktimestamp van de geschilcase die aan de factuur is gekoppeld. Eventtype explicit
	Geschil opgelost	Dit staat voor het einde van het geschillenbeheerproces. Het probleem is onderzocht en er is een oplossing gevonden. De factuur kan nu verder naar betaling of afschrijving.
Waarom dit belangrijk is Dit is de eindgebeurtenis voor het meten van de gemiddelde doorlooptijd van geschillenafhandeling. Lange doorlooptijden kunnen de ontvangst van geld flink vertragen en wijzen op inefficiënties in het proces. Waar je het vindt Dit wordt vastgelegd wanneer de status van de geschilcase verandert in 'Resolved', 'Closed' of een vergelijkbare eindstatus. De timestamp van deze statuswijziging wordt voor de activiteit gebruikt. Vastleggen Afgeleid uit de timestamp waarop de status van de geschilcase wordt bijgewerkt naar de definitieve status 'Resolved'. Eventtype inferred
	Vervaldatum van betaling verstreken	Een berekende gebeurtenis die plaatsvindt zodra de huidige datum na de vervaldatum van de factuur ligt. Deze activiteit staat niet voor een actie van een gebruiker of systeem, maar is wel een belangrijke statuswijziging die het incassoproces start.
Waarom dit belangrijk is Deze activiteit is de belangrijkste trigger voor alle daaropvolgende aanmanings- en incassoactiviteiten. Ze maakt onderscheid tussen op tijd betaalde en achterstallige facturen, zodat je de effectiviteit van je incassostrategie kunt analyseren. Waar je het vindt Deze gebeurtenis wordt niet rechtstreeks opgeslagen. Ze wordt berekend door het vervaldatumveld van de factuur te vergelijken met de timestamp van andere gebeurtenissen. De gebeurtenis wordt afgeleid tijdens de transformatie van process mining-data. Vastleggen Berekend door due_date van de factuur te vergelijken met de huidige datum of event-timestamp (Timestamp > Due Date). Eventtype calculated
	Aanmaningsprocedure gestart	Deze activiteit markeert de start van een formele aanmaningsprocedure of van een specifiek niveau binnen die procedure voor een achterstallige factuur. Het is een meer systematische 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 bij het stimuleren van betaling. Waar je het vindt Deze gebeurtenis wordt meestal afgeleid uit een wijziging in het veld 'Dunning Level' of 'Collection Strategy' dat aan de factuur is gekoppeld in HighRadius. Vastleggen Afgeleid uit een wijziging in het attribuut voor het aanmaningsniveau van de factuur, vastgelegd via wijzigingslogs of een geschiedenis met timestamps. Eventtype inferred
	Betaling geboekt	Dit staat voor de afronding van het cash application-proces. Een ontvangen betaling is succesvol gekoppeld aan een specifieke factuur en daarop afgeboekt, waardoor het openstaande saldo wordt vereffend.
Waarom dit belangrijk is Deze activiteit sluit de betalingscyclus af. De tijd tussen 'Payment Received' en 'Payment Posted' laat zien hoe efficiënt het cash application-proces verloopt. Waar je het vindt Deze gebeurtenis wordt vastgelegd op basis van het veld met de boekingsdatum of vereffeningsdatum op de factuur. De timestamp wordt geregistreerd wanneer de cash application is afgerond. Vastleggen Vastgelegd op basis van de timestamp van de 'posting date' of 'clearing date' op de boekingsregel van de factuur. Eventtype explicit
	Betalingsbelofte aangemaakt	Deze activiteit vindt plaats wanneer een klant toezegt een factuur op een toekomstige datum te betalen en de incassomedewerker deze belofte in het systeem vastlegt. Dit is een positieve tussenuitkomst.
Waarom dit belangrijk is Door betalingsbeloftes te volgen, kun je de cashflow voorspellen en de effectiviteit van incassomedewerkers beoordelen. Je ziet ook welke beloftes niet worden nagekomen, omdat de betaling niet op de afgesproken datum binnenkomt. Waar je het vindt Dit is een expliciete gebeurtenis in HighRadius wanneer een medewerker een 'Promise to Pay'-registratie aanmaakt die aan een factuur is gekoppeld. Deze registratie heeft een eigen aanmaaktimestamp. Vastleggen Vastgelegd op basis van de aanmaaktimestamp van het 'Promise to Pay'-object in HighRadius. Eventtype explicit
	Factuur naar klant verzonden	Deze activiteit markeert het moment waarop de factuur bij de klant is afgeleverd, meestal via e-mail of een klantenportaal. HighRadius kan deze communicatie automatisch uitvoeren en vastleggen.
Waarom dit belangrijk is Door dit te volgen, controleer je of klanten hun facturen op tijd ontvangen. Vertraging tussen het genereren en verzenden van een factuur kan de betalingstijd en DSO rechtstreeks beïnvloeden. Waar je het vindt Dit wordt vaak expliciet vastgelegd in de correspondentie- of activiteitengeschiedenis van de factuur in de Collections Cloud-module. Je kunt het ook afleiden uit de status van een geautomatiseerde correspondentiejob. Vastleggen Vastgelegd in de communicatiegeschiedenis van de factuur wanneer een e-mail of portaalaflevering is uitgevoerd. Eventtype explicit
	Herinnering voor achterstallige betaling verzonden	Dit staat voor een automatische of handmatige herinnering aan een klant over een achterstallige factuur. HighRadius automatiseert dit als onderdeel van aanmaningsstrategieën en legt de communicatie vast.
Waarom dit belangrijk is Deze activiteit is belangrijk voor het meten van de Dunning Effectiveness Rate. Je kunt ermee analyseren hoeveel herinneringen nodig zijn voordat een betaling binnenkomt. Waar je het vindt Dit is een expliciete gebeurtenis in het activiteiten- of correspondentielog van de factuur binnen HighRadius Collections Cloud. Elke verzonden herinnering krijgt een bijbehorende registratie en timestamp. Vastleggen Vastgelegd op basis van de communicatie met timestamp die aan de factuur is gekoppeld. Eventtype explicit
	Incassogesprek vastgelegd	Dit staat voor een handmatig incassogesprek van een incassomedewerker met de klant over een achterstallige factuur. Medewerkers leggen de details en uitkomst van het gesprek rechtstreeks vast in HighRadius.
Waarom dit belangrijk is Deze activiteit is belangrijk voor het beoordelen van de Collection Call Success Rate en Collection Activity Efficiency. Je kunt hiermee onderscheid maken tussen automatische en handmatige incasso-inspanningen. Waar je het vindt Dit is een expliciete gebeurtenis die ontstaat wanneer een incassomedewerker de functie 'Log Call' of 'Add Activity' gebruikt bij de factuur of klantrekening in de HighRadius-interface. De registratie bevat een timestamp. Vastleggen Vastgelegd in de tabel met activiteitenlogs waarin medewerkers handmatige acties registreren. Eventtype explicit
	Kredietlimiet aangevraagd	Deze activiteit markeert de start van een kredietbeoordeling voor een klant. Meestal gebeurt dit voordat een verkooporder definitief wordt gemaakt. 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, zie je knelpunten in klantonboarding en verkoopcycli. Dit is een belangrijk startpunt om de efficiëntie van het kredietmanagementteam te meten. Waar je het vindt 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 Credit Management-module van HighRadius. Vastleggen Afgeleid uit de aanmaaktimestamp van een aanvraagobject voor een kredietlimiet of uit een statuswijziging naar 'In afwachting van goedkeuring'. Eventtype inferred
	Kredietlimiet goedgekeurd	Dit staat voor de succesvolle afronding van het kredietbeoordelingsproces. De kredietlimiet wordt officieel aan de klant toegekend. De gebeurtenis wordt vastgelegd wanneer een kredietmanager de aanvraag in het HighRadius-platform goedkeurt.
Waarom dit belangrijk is Dit is een belangrijk mijlpaal die het verkoopproces vrijgeeft. Door deze activiteit te volgen, kun je de totale KPI voor de doorlooptijd van kredietgoedkeuring berekenen. Waar je het vindt Deze gebeurtenis wordt meestal vastgelegd via een statuswijziging van de aanvraag voor de kredietlimiet naar 'Goedgekeurd'. Het kan ook een expliciete gebeurtenis in het auditlog van het systeem zijn. Vastleggen Afgeleid uit een statuswijziging van de kredietaanvraag naar 'Goedgekeurd' of uit het veld met de goedkeuringstimestamp. Eventtype inferred

Aanbevolen Optioneel

Extractiegidsen

Zo haal je je data uit HighRadius

Stappen

De module Reporting and Analytics openen: Log in op je HighRadius-instantie met een gebruiker die de benodigde rechten heeft om aangepaste rapporten te maken en uit te voeren. Ga vanuit het hoofddashboard of het applicatiemenu naar de sectie Reporting and Analytics.
Een nieuw aangepast rapport maken: Start het proces om een nieuw rapport te bouwen. Selecteer een basisobject als primaire basis voor je data, zoals het object Facturen of Open A/R. Geef het rapport een duidelijke naam, bijvoorbeeld ProcessMind_Credit_Collections_Log.
Belangrijkste factuurattributen definiëren: Voeg de primaire factuurvelden toe aan de rapportindeling. Dit zijn InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate en PaymentStatus. Deze vormen de basis voor elke gebeurtenis.
Data uit gerelateerde objecten toevoegen (gebeurtenissen): Dit is de belangrijkste stap. Je moet data uit verschillende HighRadius-objecten koppelen of samenvoegen om alle 15 vereiste activiteiten vast te leggen. Gebruik de functies van de rapportbouwer om gerelateerde databronnen toe te voegen. Maak voor elke activiteit een set kolommen met de details van de gebeurtenis.
Het rapport structureren voor de indeling van een event log: Configureer het rapport zodat het één rij per gebeurtenis oplevert. Dit betekent meestal dat je verschillende datablokken samenvoegt in plaats van ze als kolommen aan elkaar te koppelen. Koppel in elk samengevoegd blok het relevante datumveld aan een gemeenschappelijke kolom EventTime en vul de bijbehorende ActivityName als vaste waarde in.
De gebeurtenis 'Payment Due Date Passed' configureren: Deze gebeurtenis is voorwaardelijk. Maak een apart datablok voor facturen waarvan DueDate in het verleden ligt en waarvan PaymentStatus nog 'Open' of 'Overdue' is. Stel voor deze records ActivityName in op 'Payment Due Date Passed' en gebruik DueDate zelf als EventTime.
Informatie over incassomedewerkers en geschillen toevoegen: 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.
Rapportfilters instellen: Pas filters toe om de omvang van de extractie te bepalen. Stel een periode voor EventTime in, bijvoorbeeld de afgelopen 6 maanden, zodat de dataset beheersbaar blijft. Afhankelijk van je organisatiestructuur moet je mogelijk ook filteren op specifieke bedrijfscodes of bedrijfseenheden.
Rapport uitvoeren en voorbeeld bekijken: Voer het rapport uit om de data te bekijken. Controleer of de structuur overeenkomt met de vereiste indeling van het event log, met één rij per activiteit en kolommen voor InvoiceNumber, ActivityName, EventTime en andere attributen.
Rapportdata exporteren: Exporteer het volledige rapport zodra je tevreden bent met het voorbeeld. Selecteer CSV als exportindeling, omdat process mining-tools dit formaat eenvoudig kunnen inlezen. Gebruik UTF-8-codering om problemen met tekens te voorkomen.
Definitieve datacontrole: Open het geëxporteerde CSV-bestand in een spreadsheetprogramma. Controleer tot slot of alle 15 activiteiten aanwezig zijn, timestamps de juiste notatie hebben en belangrijke attributen correct zijn gevuld voordat je het bestand naar ProcessMind uploadt.

Configuratie

Rapporttype: een aangepast rapport dat data uit meerdere modules combineert. Afhankelijk van de versie van HighRadius heet dit mogelijk een 'Joined Report' of werk je met meerdere datablokken die je samenvoegt.
Primair dataobject: begin met het object Facturen of Accounts Receivable als basis van 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 primaire timestampveld van de gebeurtenis. Het is aan te raden data over een periode van 3 tot 6 maanden te extraheren, zodat detail en prestaties in balans blijven. Bijvoorbeeld EventTime binnen de afgelopen 180 dagen.
Statusfilters: overweeg irrelevante factuurstatussen, zoals 'Cancelled' of 'Draft', uit te sluiten, tenzij ze onderdeel zijn van het proces dat je wilt analyseren.
Rechten: het gebruikersaccount waarmee het rapport wordt uitgevoerd, moet leestoegang hebben tot alle relevante modules, waaronder Credit, Collections, Disputes en Cash Application, zodat een volledige dataset kan worden geëxtraheerd.

a 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 libraries pandas en requests. Je kunt deze installeren met pip: pip install pandas requests. Vraag ook API-inloggegevens aan, bestaande uit een Client ID en Client Secret, bij je HighRadius-beheerder. Deze gebruiker moet leesrechten hebben voor de benodigde dataobjecten, zoals facturen, collections, disputes en betalingen.
Initialiseer het script: Maak een nieuw Python-scriptbestand, bijvoorbeeld extract_hr_data.py. Importeer eerst de benodigde libraries (requests, pandas, datetime) en definieer placeholders voor de basis-URL van je HighRadius-API, de clientgegevens en de gewenste extractieperiode.
Implementeer authenticatie: Schrijf een functie voor de authenticatie. Deze functie gebruikt je Client ID en Secret, stuurt een POST-request naar het HighRadius-authenticatie-endpoint, bijvoorbeeld /auth/v1/token, en haalt een bearer token op. Gebruik dit token in de header van alle volgende datarequests.
Haal de primaire factuurdata op: Ontwikkel een functie die het belangrijkste factuur-endpoint bevraagt, bijvoorbeeld /invoices/v1/search. Deze functie moet paginering ondersteunen, zodat alle records binnen de opgegeven periode worden opgehaald. Laat de functie de API herhaaldelijk aanroepen en factuurdata verzamelen tot er geen pagina's meer zijn. Bewaar deze primaire data in een lijst met dictionaries.
Haal data uit gerelateerde objecten op: Maak voor elke kernentiteit, zoals Disputes, Collection Notes en Payments, een aparte functie voor het ophalen van data. Deze functies bevragen hun eigen endpoints, bijvoorbeeld /disputes/v1/search, /collections/v1/notes en /cashapp/v1/payments, en halen efficiënt alle relevante data voor de gekozen periode op. Meestal werkt het beter om deze datasets in bulk op te halen dan per factuur een query uit te voeren.
Structureer het event log: 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 eventrij. Elke dictionary bevat sleutels voor InvoiceNumber, ActivityName, EventTime en alle andere vereiste attributen.
Genereer events voor de factuurlevenscyclus: Doorloop de primaire factuurlijst. Maak voor elke factuur events voor 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' en 'Invoice Written Off', op basis van de aanmaakdatum, correspondentielogboeken, sluitingsdatum en statusvelden. Bewaar deze als eventdictionaries.
Bereken 'Payment Due Date Passed': Voeg binnen dezelfde factuurlus logica toe om een event 'Payment Due Date Passed' te maken. Dit is een berekend event. Controleer of de vervaldatum van de factuur is verstreken, de factuur nog niet is betaald en er nog geen event 'Payment Due Date Passed' voor bestaat. Gebruik de vervaldatum zelf als EventTime voor deze activiteit.
Genereer Collections- en Disputes-events: Verwerk de data uit de endpoints voor collections en disputes. Maak voor elke notitie, betalingsbelofte, dunningactie of dispute-record een bijbehorende event-logrij: 'Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered' of 'Dispute Resolved'. Koppel relevante details, zoals CollectorName en DisputeReason, aan het eventrecord.
Genereer betalingsevents: Verwerk de betalingsdata uit de cash application-module. Maak events 'Payment Received' op basis van de aanmaakdatum van de betaling of de datum op het bankafschrift. Maak events 'Payment Posted' op basis van de datum waarop de betaling succesvol aan de factuur is gekoppeld.
Combineer en formatteer de data: Zet de lijst met eventdictionaries na verwerking van alle databronnen om in een pandas DataFrame. Zo kun je de data eenvoudig sorteren en de datatypen definitief instellen. Zorg dat de kolom EventTime één consistente timestampindeling gebruikt: YYYY-MM-DD HH:MI:SS.
Exporteer naar CSV: Gebruik de pandas-functie to_csv om het definitieve DataFrame naar een CSV-bestand te exporteren. Geef het bestand een duidelijke naam, bijvoorbeeld highradius_event_log.csv. Stel de parameter index=False in, zodat de index van het DataFrame niet als kolom wordt opgeslagen. Het bestand is nu klaar om naar ProcessMind te uploaden.

Configuratie

API-inloggegevens: Je hebt een speciale API-gebruiker nodig met een Client ID en Client Secret. Deze gebruiker moet leesrechten hebben voor alle relevante API-endpoints, waaronder facturen, klanten, collectionsactiviteiten, disputes en cash application.
Datumbereik: Het Python-script bevat de variabelen START_DATE en END_DATE. Stel een specifieke en redelijke periode in, bijvoorbeeld 3 tot 6 maanden, om de hoeveelheid data te beperken en te voorkomen dat het script onnodig lang draait. Filter op een geïndexeerd datumveld, zoals de aanmaakdatum of wijzigingsdatum van de factuur.
Endpoint-URL's: De specifieke paden van API-endpoints, bijvoorbeeld /invoices/v1/search, zijn placeholders. Controleer de juiste endpoint-URL's in de HighRadius-API-documentatie van je organisatie.
Paginering: Het script moet de pagineringsmethode van de API correct verwerken. Meestal gebruik je hiervoor limit- en offset-parameters of 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 heeft een server de voorkeur boven een lokale computer.
Aangepaste velden: Als je proces gebruikmaakt van aangepaste velden in HighRadius, moet je het script aanpassen om deze velden op te vragen en aan de uitvoer toe te voegen.

a 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 de gestructureerde basis die je nodig hebt om waardevolle inzichten in je Credit Management & Collections-proces te krijgen. Begin vandaag nog met het optimaliseren van je HighRadius-bedrijfsvoering voor een snellere cashflow.

Terug naar de verbetergids Template downloaden

Begin met het optimaliseren van Credit Management & Collections

Elimineer knelpunten, verkort de doorlooptijd met 30% en werk efficiënter.

Start je gratis proefperiode

Je hebt geen creditcard nodig. Je kunt binnen enkele minuten beginnen.

Jouw datatemplate voor Credit Management & Collections

Jouw datatemplate voor Credit Management & Collections

Attributen voor kredietbeheer en incasso

Activiteiten voor kredietbeheer en incasso

Extractiegidsen

Export uit de Reporting and Analytics Module van HighRadius

Stappen

Configuratie

a Voorbeeldquery sql

Python-script voor extractie via HighRadius REST API's

Stappen

Configuratie

a Voorbeeldquery python

Klaar om aan de slag te gaan?

Begin met het optimaliseren van Credit Management & Collections

Jouw datatemplate voor Credit Management & Collections

Jouw datatemplate voor Credit Management & Collections

Attributen voor kredietbeheer en incasso

Activiteiten voor kredietbeheer en incasso

Extractiegidsen

Export uit de Reporting and Analytics Module van HighRadius

Stappen

Configuratie

a Voorbeeldquery sql

Python-script voor extractie via HighRadius REST API's

Stappen

Configuratie

a Voorbeeldquery python

Klaar om aan de slag te gaan?

Begin met het optimaliseren van Credit Management & Collections

We respecteren je privacy