> Miglioramento continuo dei processi > Gestione del credito e recupero crediti > HighRadius > Template dei dati

Il Suo Template dei dati per la gestione del credito e il recupero crediti

HighRadius

Attributi della gestione del credito e recupero crediti (21) Attività di gestione del credito e recupero crediti (15) Guide all’estrazione (2)

Il Suo Template dei dati per la gestione del credito e il recupero crediti

Questo Template fornisce una guida strutturata alla raccolta dei dati necessari per analizzare il processo di gestione del credito e recupero crediti. Indica gli attributi essenziali da acquisire e le attività principali da monitorare, offrendo inoltre indicazioni pratiche su come estrarre queste informazioni dal Suo sistema HighRadius. L’utilizzo di questo Template La aiuterà a preparare i dati in modo efficiente per il Process Mining.

Attributi consigliati da raccogliere
Attività principali da monitorare per ottenere visibilità sul processo
Indicazioni specifiche per l’estrazione da HighRadius

Non conosce ancora gli Event Log? Scopra come creare un Event Log per il Process Mining.

Scarica il Template

Attributi della gestione del credito e recupero crediti

Questi sono i campi dati consigliati da includere nel Suo Event Log per un’analisi completa del processo di gestione del credito e recupero crediti.

3 Obbligatorio 7 Consigliato 11 Facoltativo

	Nome	Descrizione
	Nome attività ActivityName	Il nome dello specifico evento aziendale che si è verificato in un determinato momento per una fattura.
Descrizione Il Nome attività descrive una fase del processo di gestione del credito e degli incassi, come «Invoice Generated», «Overdue Reminder Sent» o «Payment Received». La sequenza di queste attività costituisce il flusso di processo di ciascun caso. L’analisi di questo attributo consente di individuare e visualizzare la mappa effettiva del processo. Aiuta a identificare colli di bottiglia, deviazioni dalla procedura standard e cicli di rilavorazione. La frequenza e l’ordine di attività come «Collection Call Logged» o «Dispute Registered» sono fondamentali per comprendere l’efficienza del processo. Perché è importante Questo attributo definisce le fasi del processo, consentendo di ricostruire e analizzare il flusso di processo per ciascuna fattura. Dove reperirlo In genere viene ricavato dagli Event Log, dalle modifiche di stato o da specifici record di azione all’interno dei diversi moduli della piattaforma HighRadius. Esempi Fattura inviata al clienteProcedura di sollecito avviataPagamento ricevutoContestazione risolta
	Numero fattura InvoiceNumber	L’identificativo univoco di ciascuna fattura, che funge da identificativo principale del caso per il processo credit-to-cash.
Descrizione Il Numero fattura è la chiave centrale che collega tutte le attività relative a una singola transazione di crediti commerciali. Consente di tracciare l’intero ciclo di vita, dalla generazione della fattura, passando per le diverse attività di gestione del credito e di incasso, fino al saldo finale o alla contabilizzazione della perdita. Nell’analisi di Process Mining, questo attributo è essenziale per raggruppare tutti gli eventi correlati in un unico caso. Ciò consente di visualizzare i flussi di processo end-to-end, calcolare la durata dei casi, come i Days Sales Outstanding (DSO), e analizzare i diversi percorsi che una fattura può seguire, ad esempio la risoluzione di una contestazione o le procedure di sollecito. Perché è importante È l’identificativo fondamentale che collega tutte le fasi del processo, rendendo possibile analizzare il percorso completo di una fattura dalla creazione alla chiusura. Dove reperirlo È un campo principale in HighRadius, generalmente presente negli oggetti dati principali delle fatture o dei crediti commerciali. Esempi INV-2023-001239876543210SI-55482
	Ora dell’evento EventTime	Il timestamp che indica quando si è verificata l’attività, includendo data e ora.
Descrizione Event Time fornisce la data e l’ora precise di ciascuna attività del processo. Questi dati cronologici costituiscono la base del Process Mining, consentendo di ordinare correttamente gli eventi e calcolare la durata tra di essi. Questo attributo viene utilizzato per calcolare tutti i KPI basati sul tempo, come i tempi di ciclo della risoluzione delle contestazioni, dell’approvazione del credito e della registrazione dei pagamenti. Viene inoltre utilizzato per analizzare le prestazioni del processo nel tempo, individuare le attività che causano ritardi e misurare il rispetto degli accordi sui livelli di servizio. Perché è importante Fornisce il contesto cronologico di tutte le attività, essenziale per calcolare i tempi di ciclo, individuare i colli di bottiglia e comprendere le dinamiche del processo. Dove reperirlo Ogni record transazionale o Event Log in HighRadius dovrebbe avere un campo timestamp corrispondente, spesso denominato «Creation Date» o «Timestamp». Esempi 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Condizioni di pagamento PaymentTerms	Le condizioni concordate che stabiliscono entro quando il cliente deve pagare una fattura.
Descrizione Payment Terms specifica le condizioni di pagamento, come «Net 30», «Net 60» o «Due on Receipt». Questo Attributo costituisce la base per calcolare la data di scadenza della fattura. È un Attributo fondamentale per la Dashboard e il KPI «Payment Terms Adherence». La sua analisi aiuta a verificare se le condizioni standard vengono applicate in modo coerente e quali condizioni di pagamento sono associate a una maggiore frequenza di ritardi. Queste informazioni possono orientare la politica del credito e le negoziazioni con i clienti. Perché è importante Stabilisce il riferimento per le tempistiche di pagamento previste, risultando quindi essenziale per calcolare le date di scadenza e misurare il rispetto degli accordi di pagamento da parte dei clienti. Dove reperirlo Questo dato si trova generalmente nell'intestazione della fattura o nei dati anagrafici del cliente all'interno di HighRadius o dell'ERP di origine. Esempi 30 giorni netti60 giorni nettiPagamento alla ricezione
	Data di scadenza DueDate	La data calcolata entro la quale deve essere effettuato il pagamento della fattura.
Descrizione La Due Date è la data di calendario entro la quale una fattura deve essere pagata per evitare che venga considerata scaduta. Viene generalmente calcolata a partire dalla data della fattura e dalle condizioni di pagamento. Questo Attributo è fondamentale per tutte le analisi delle scadenze. Costituisce l'input principale per calcolare i «Days Overdue», attivare le procedure di sollecito e misurare il KPI «Payment Terms Adherence Rate». Supporta direttamente le Dashboard relative all'anzianità delle fatture e all'efficacia dei solleciti. Perché è importante È la data decisiva per stabilire se una fattura è stata pagata nei termini o è scaduta e per attivare tutte le successive attività di incasso e i relativi KPI. Dove reperirlo È un campo standard del record della fattura in HighRadius. Può essere valorizzato dall'ERP di origine oppure calcolato all'interno di HighRadius. Esempi 2023-04-142023-05-312023-06-20
	ID cliente CustomerId	L'identificativo univoco del cliente associato alla fattura.
Descrizione Il Customer ID collega una fattura alla specifica entità cliente. Ciò consente di aggregare e analizzare i dati di processo da una prospettiva incentrata sul cliente. Questo Attributo è essenziale per analizzare i comportamenti di pagamento di diversi clienti o segmenti di clientela. Aiuta a rispondere a domande come: quali clienti pagano frequentemente in ritardo? Quali clienti aprono il maggior numero di contestazioni? Supporta Dashboard come Payment Terms Adherence e consente di segmentare i KPI per cliente. Perché è importante Consente di analizzare a livello di cliente i comportamenti di pagamento, la frequenza delle contestazioni e l'interazione complessiva con il processo, contribuendo a personalizzare le strategie di incasso. Dove reperirlo Si tratta di un campo standard nell'intestazione della fattura o nei dati dell'account cliente all'interno di HighRadius. Esempi CUST-001ACME-CORPGLOBEX-US
	Importo fattura InvoiceAmount	Il valore monetario complessivo della fattura.
Descrizione Questo Attributo rappresenta l'importo totale dovuto per la fattura. È una metrica finanziaria fondamentale per comprendere il valore associato a ciascun caso. Nel Process Mining, Invoice Amount viene utilizzato per definire le priorità delle attività di incasso, ad esempio concentrandosi sulle fatture scadute di importo elevato. È essenziale per KPI finanziari come Days Sales Outstanding (DSO) e viene utilizzato nella Dashboard Invoice Write-Off Analysis per quantificare l'impatto finanziario dei crediti inesigibili. Perché è importante Fornisce il contesto finanziario di ciascun caso, consentendo analisi basate sul valore, la definizione delle priorità operative e la quantificazione di impatti finanziari come gli storni per inesigibilità. Dove reperirlo Si tratta di un campo standard nei dati dell'intestazione della fattura all'interno di HighRadius. Esempi 5000.001250.7525000.50
	Motivo della contestazione DisputeReason	Il codice o la descrizione del motivo forniti quando un cliente contesta una fattura.
Descrizione Quando un cliente apre una contestazione, generalmente ne indica il motivo, ad esempio «Incorrect Pricing», «Damaged Goods» o «Duplicate Invoice». Questo Attributo registra tale motivazione. L'analisi di Dispute Reason è fondamentale per la Dashboard «Invoice Dispute Resolution Time». Aiuta a individuare le cause alla radice delle contestazioni, consentendo all'azienda di intervenire su problemi sistemici relativi a prezzi, spedizioni o fatturazione. Ridurre le contestazioni alla fonte può accelerare significativamente il flusso di cassa. Perché è importante Fornisce informazioni sulle cause alla radice dei ritardi di pagamento, consentendo miglioramenti mirati del processo per prevenire contestazioni future. Dove reperirlo Queste informazioni vengono acquisite nel modulo di gestione delle contestazioni o delle deduzioni di HighRadius quando viene registrata una contestazione. Esempi Quantità errataDiscrepanza di prezzoMerce danneggiataFatturazione duplicata
	Nome dell'addetto agli incassi CollectorName	Il nome dell'utente o dell'agente responsabile dello svolgimento di un'attività di incasso.
Descrizione Questo Attributo identifica l'addetto agli incassi, l'analista del credito o l'altro utente che ha eseguito un'attività manuale, come «Collection Call Logged» o «Dispute Resolved». Nell'analisi, consente di confrontare le prestazioni di diversi addetti agli incassi o team. Aiuta a comprendere la distribuzione del carico di lavoro, a valutare l'efficacia delle singole strategie, ad esempio il tasso di successo delle chiamate di incasso per addetto, e a individuare opportunità di coaching. È inoltre fondamentale per la gestione delle risorse e la pianificazione della capacità. Perché è importante Collega le attività di processo a persone specifiche, consentendo di analizzare le prestazioni del team, il carico di lavoro e l'efficacia degli interventi manuali. Dove reperirlo Queste informazioni sono generalmente archiviate nei log delle attività o nei record delle azioni degli utenti all'interno del modulo Collections di HighRadius. Esempi John SmithJane DoeEmily Jones
	Stato del pagamento PaymentStatus	Lo stato finanziario corrente della fattura, ad esempio Open, Paid, Overdue o Disputed.
Descrizione Payment Status offre una fotografia della posizione della fattura nel suo ciclo di vita. Indica se il pagamento è ancora atteso, se la fattura è stata pagata integralmente o parzialmente, se ha superato la data di scadenza oppure se è oggetto di verifica a causa di una contestazione. Questo Attributo è centrale per la Dashboard «Invoice Payment Status & Aging». Consente di segmentare rapidamente il portafoglio crediti per comprendere lo stato finanziario complessivo e definire le priorità delle attività di incasso sulle posizioni scadute o contestate. Perché è importante Classifica le fatture in gruppi operativi, offrendo visibilità immediata sullo stato dei crediti e aiutando a definire le priorità delle attività di incasso. Dove reperirlo È un campo di stato fondamentale del record della fattura o dei crediti commerciali all'interno di HighRadius. Esempi ApertoPagatoScadutoContestatoStralciato
	Data promessa di pagamento PromiseToPayDate	La data entro la quale il cliente ha promesso di effettuare il pagamento di una fattura scaduta.
Descrizione Quando un addetto agli incassi contatta un cliente, può ottenere una «Promise to Pay», ovvero l'impegno del cliente a pagare entro una determinata data. Questo Attributo registra la data promessa. L'analisi di questi dati è importante per valutare l'affidabilità delle promesse dei clienti e l'efficacia degli addetti agli incassi nell'ottenere impegni concreti. Può essere utilizzata per monitorare il tasso di promesse mantenute, un indicatore chiave delle prestazioni del team di incasso. Perché è importante Registra un risultato fondamentale delle attività di incasso e viene utilizzato per misurare l'efficacia dei solleciti e l'affidabilità degli impegni assunti dai clienti. Dove reperirlo Questa data viene registrata quando nel modulo Collections di HighRadius viene acquisita un'attività «Promise to Pay». Esempi 2023-06-152023-07-012023-06-25
	È automatizzato IsAutomated	Un flag booleano che indica se un'attività è stata eseguita automaticamente dal sistema o manualmente da un utente.
Descrizione Questo Attributo calcolato distingue tra eventi generati dal sistema, ad esempio «Overdue Reminder Sent» durante un'esecuzione automatica dei solleciti, e azioni svolte da persone, come «Collection Call Logged». Questo flag è fondamentale per calcolare il KPI «Automated Collection Activity Rate». Aiuta a misurare il livello di automazione del processo di incasso, a individuare opportunità per aumentare ulteriormente l'automazione e ad analizzare l'efficacia relativa dei contatti automatici rispetto a quelli manuali. Perché è importante Aiuta a misurare il grado di automazione del processo, consentendo di analizzare l'efficienza e l'efficacia dei sistemi automatici rispetto alle attività manuali. Dove reperirlo Viene derivato durante la trasformazione dei dati. È necessario creare una mappatura che contrassegni determinati Activity Names come automatizzati sulla base delle conoscenze aziendali. Esempi truefalse
	Giorni di ritardo DaysOverdue	Il numero di giorni trascorsi dalla data di scadenza della fattura. È pari a zero se la fattura non è ancora scaduta o è stata pagata nei termini.
Descrizione Days Overdue è una metrica calcolata che misura la differenza tra la data corrente, per le fatture aperte, o la data di pagamento, per quelle pagate, e la data di scadenza della fattura. È un indicatore chiave della morosità nei pagamenti. Questo Attributo costituisce la base della Dashboard «Invoice Payment Status & Aging», nella quale viene utilizzato per raggruppare i crediti in fasce di anzianità, ad esempio 1-30 giorni e 31-60 giorni. È inoltre una componente del calcolo dei Days Sales Outstanding (DSO) e aiuta a definire le priorità delle attività di incasso sulle posizioni con il maggior ritardo. Perché è importante Questa metrica quantifica direttamente i ritardi di pagamento, risultando quindi essenziale per l'analisi dell'anzianità dei crediti, la definizione delle priorità di incasso e il calcolo del DSO. Dove reperirlo Non è un campo memorizzato. Viene calcolato durante la trasformazione dei dati utilizzando Due Date e Payment Date oppure la data corrente. Esempi 1545092
	Livello di sollecito DunningLevel	La fase o il livello raggiunto dal processo automatizzato di sollecito per una fattura scaduta.
Descrizione Dunning Level indica l'intensità dell'attività di incasso e spesso corrisponde a una sequenza di promemoria o comunicazioni automatiche inviate al cliente. Ad esempio, il livello 1 può consistere in un promemoria bonario, mentre il livello 3 può rappresentare una comunicazione finale. Questo Attributo è essenziale per la Dashboard «Dunning Strategy Effectiveness». Analizzando quali livelli di sollecito portano più frequentemente al pagamento, le aziende possono ottimizzare i propri Workflow di sollecito, assicurandone l'efficacia senza adottare modalità eccessivamente aggressive che potrebbero compromettere il rapporto con il cliente. Perché è importante Tiene traccia dell'escalation delle attività di incasso, consentendo di analizzare quali strategie di sollecito sono più efficaci nel favorire il pagamento. Dove reperirlo È un campo di stato gestito dal motore di Workflow automatizzato per gli incassi o i solleciti all'interno di HighRadius. Esempi 123 - Sollecito finaleRecupero crediti legale
	Motivo dello storno WriteOffReason	Il codice o la spiegazione del motivo per cui una fattura è stata stornata come credito inesigibile.
Descrizione Quando una fattura viene considerata inesigibile, viene stornata. Questo Attributo registra il motivo dello storno, ad esempio «Customer Bankruptcy», «Unresolved Dispute» o «Small Balance Write-Off». È un Attributo fondamentale per la Dashboard «Invoice Write-Off Analysis». Aiuta ad analizzare le cause alla radice delle perdite finanziarie, fornendo informazioni utili per perfezionare le politiche del credito, migliorare la gestione delle contestazioni o adeguare le strategie di incasso, così da ridurre al minimo gli storni futuri. Perché è importante Spiega le cause della perdita di ricavi, fornendo indicazioni essenziali per migliorare la valutazione del rischio di credito e le politiche di incasso. Dove reperirlo Queste informazioni vengono registrate quando viene elaborata un'attività «Invoice Written Off», generalmente nel modulo finanziario o Collections di HighRadius. Esempi FallimentoTermine di prescrizione scadutoCosti di recupero superiori al debito
	Ora di fine EndTime	Il timestamp che indica quando un’attività è stata completata.
Descrizione L'End Time indica la conclusione di un'attività. Sebbene molte attività nella gestione degli incassi siano eventi istantanei, per i quali Start Time coincide con End Time, alcune attività, come «Dispute Resolution», possono avere una durata distinta. Quando disponibile, questo Attributo viene utilizzato insieme a Start Time per calcolare il Processing Time delle singole attività. Ciò consente di identificare quali passaggi specifici, e non soltanto gli intervalli tra un'attività e l'altra, assorbono la maggior parte del tempo e delle risorse. Perché è importante Consente di misurare con precisione la durata delle singole attività, offrendo una visione più dettagliata di come viene impiegato il tempo all'interno del processo. Dove reperirlo Consulti la documentazione di HighRadius. Questo dato potrebbe essere disponibile per alcune attività registrate che prevedono uno stato iniziale e uno stato finale. Esempi 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Paese Country	Il Paese del cliente associato alla fattura.
Descrizione Questo Attributo specifica il Paese in cui si trova il cliente. Consente di segmentare geograficamente il processo di gestione del credito e degli incassi. L'analisi dei dati per Paese può evidenziare differenze regionali nei comportamenti di pagamento, nell'efficacia delle strategie di incasso e nei motivi più comuni delle contestazioni. Queste informazioni sono fondamentali per adattare le politiche regionali e la reportistica direzionale nelle organizzazioni globali. Perché è importante Consente di effettuare analisi geografiche, che possono mettere in luce tendenze regionali nei comportamenti di pagamento e aiutare ad adattare di conseguenza le strategie di incasso. Dove reperirlo Queste informazioni fanno parte dei dati anagrafici del cliente, generalmente disponibili in HighRadius o sincronizzati da un ERP di origine. Esempi USAGermaniaBrasile
	Sistema di origine SourceSystem	Il sistema da cui provengono i dati.
Descrizione Questo attributo identifica il sistema di origine in cui sono stati generati i dati dell’evento. Per questa vista di processo, il valore sarà generalmente «HighRadius». Negli ambienti con più sistemi, questo campo è fondamentale per comprendere la provenienza dei dati e ricondurre le informazioni alla loro origine. Aiuta a distinguere i processi che si estendono su piattaforme diverse, come un ERP e uno strumento specializzato per gli incassi. Perché è importante Chiarisce l’origine dei dati, un aspetto importante per la governance dei dati, la convalida e la comprensione dell’ecosistema tecnologico del processo. Dove reperirlo In genere si tratta di un valore statico aggiunto durante il processo di estrazione e trasformazione dei dati per identificare il dataset. Esempi HighRadiusHighRadius-CollectionsHighRadius-CashApp
	Ultimo aggiornamento dei dati LastDataUpdate	Il timestamp dell’ultimo aggiornamento dei dati relativi a questo record dal sistema di origine.
Descrizione Questo attributo indica l’attualità dei dati. Registra la data e l’ora dell’ultima estrazione o dell’ultimo aggiornamento dei dati da HighRadius. Nell’analisi, questo campo fornisce il contesto sulla freschezza degli insight. È fondamentale affinché Dashboard e report mostrino quanto siano aggiornate le informazioni, garantendo che le decisioni aziendali si basino su dati attuali. Perché è importante Offre trasparenza sulla tempestività dei dati, un elemento fondamentale per creare fiducia nell’analisi e prendere decisioni consapevoli. Dove reperirlo Questo timestamp viene generato e aggiunto a ciascun record dalla pipeline di acquisizione dei dati durante il processo di estrazione. Esempi 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Unità aziendale BusinessUnit	L'unità aziendale o divisione interna responsabile della vendita o della fattura.
Descrizione L'Attributo Business Unit assegna la fattura a una specifica area dell'organizzazione, come «Retail», «Wholesale» o «Services». Ciò consente di suddividere l'analisi delle prestazioni per diversi segmenti aziendali. La direzione può confrontare KPI come DSO, tassi di contestazione e storni per inesigibilità tra le diverse unità aziendali, così da individuare le aree di eccellenza e quelle che richiedono interventi. Aiuta inoltre ad attribuire alle diverse parti dell'organizzazione la responsabilità dei risultati nella gestione dei crediti. Perché è importante Consente di confrontare le prestazioni delle diverse aree dell'organizzazione, aiutando a individuare le divisioni con i processi credit-to-cash più efficaci. Dove reperirlo Si tratta di dati organizzativi, generalmente presenti nella fattura o derivati dal relativo ordine di vendita o account cliente in HighRadius o nell'ERP. Esempi BU-North AmericaDivisione ServiziProduzione
	Valuta Currency	Il codice della valuta dell'importo della fattura.
Descrizione Questo Attributo specifica la valuta della fattura, ad esempio USD, EUR o JPY. Fornisce il contesto essenziale per tutti i valori monetari, come Invoice Amount. In qualsiasi azienda multinazionale, questo campo è indispensabile per un'analisi finanziaria accurata. Garantisce la corretta interpretazione dei valori monetari e consente di effettuare conversioni valutarie appropriate quando si aggregano i dati per la reportistica globale. Perché è importante È essenziale per interpretare correttamente tutti i valori monetari, evitando calcoli finanziari e reportistica inaccurati negli ambienti multivaluta. Dove reperirlo È un campo standard del record della fattura, generalmente collocato accanto a Invoice Amount. Esempi USDEURGBP

Obbligatorio Consigliato Facoltativo

Attività di gestione del credito e recupero crediti

Queste sono le principali fasi del processo e le tappe fondamentali da acquisire nel Suo Event Log per individuare e analizzare con precisione il processo di gestione del credito e recupero crediti.

7 Consigliato 8 Facoltativo

	Attività	Descrizione
	Contestazione registrata	Questa attività indica il momento in cui un cliente solleva una contestazione o una deduzione su una fattura, che viene quindi registrata formalmente in HighRadius. Ciò sospende il normale processo di incasso per l’importo contestato.
Perché è importante Questo è l’evento iniziale per misurare il tempo medio di risoluzione delle contestazioni. Identificare quando e perché vengono sollevate le contestazioni è fondamentale per affrontare le cause alla radice, come errori di fatturazione o problemi di spedizione. Dove reperirlo L’evento viene acquisito quando un utente crea un caso di contestazione collegato a una fattura in HighRadius Deductions Cloud. Questa azione crea un record della contestazione con timestamp. Acquisizione Acquisito dal timestamp di creazione del record del caso di contestazione associato alla fattura. Tipo di evento explicit
	Contestazione risolta	Rappresenta la conclusione del processo di gestione della contestazione, dopo l’analisi del problema e il raggiungimento di una soluzione. La fattura può quindi procedere verso il pagamento o la contabilizzazione della perdita.
Perché è importante Questo è l’evento finale per misurare il tempo medio di risoluzione delle contestazioni. Cicli lunghi in questa fase possono ritardare significativamente l’incasso e indicare inefficienze di processo. Dove reperirlo Viene acquisito quando lo stato del caso di contestazione passa a «Resolved», «Closed» o a uno stato terminale analogo. Per l’attività viene utilizzato il timestamp della modifica di stato. Acquisizione Deducibile dal timestamp della modifica dello stato del caso di contestazione allo stato finale «Resolved». Tipo di evento inferred
	Data di scadenza del pagamento superata	Un evento calcolato che si verifica quando la data corrente supera la data di scadenza del pagamento della fattura. Questa attività non rappresenta un’azione dell’utente o del sistema, ma una modifica di stato fondamentale che attiva il processo di incasso.
Perché è importante Questa attività costituisce il principale evento di attivazione per tutte le successive attività di sollecito e incasso. Distingue le fatture pagate puntualmente da quelle scadute, consentendo di analizzare l’efficacia della strategia di incasso. Dove reperirlo L’evento non viene memorizzato direttamente, ma calcolato confrontando il campo della data di scadenza della fattura con il timestamp di altri eventi. Viene derivato durante la trasformazione dei dati per il Process Mining. Acquisizione Calcolato confrontando il campo due_date della fattura con la data corrente o il timestamp dell’evento (Timestamp > Due Date). Tipo di evento calculated
	Fattura contabilizzata come perdita	Rappresenta una conclusione alternativa del ciclo di vita della fattura, in cui il credito è considerato inesigibile e contabilizzato come perdita su crediti. Si tratta di un risultato indesiderato.
Perché è importante Il monitoraggio delle perdite è fondamentale per calcolare il tasso di fatture contabilizzate come perdite e analizzare le cause alla radice della perdita finanziaria. Aiuta a individuare carenze nella valutazione del credito o nelle attività di incasso. Dove reperirlo L’evento viene acquisito quando viene registrata una specifica transazione per stornare il saldo della fattura o quando lo stato della fattura viene modificato in «Written-Off». Acquisizione Deducibile da una modifica dello stato a «Written-Off» o dalla registrazione sulla fattura di uno specifico tipo di transazione di storno. Tipo di evento inferred
	Fattura generata	Questo è il punto di partenza del ciclo di vita di una fattura nel processo di incasso. Indica che una fattura è stata creata nel sistema ERP e importata in HighRadius per la gestione dei crediti commerciali.
Perché è importante Questa attività costituisce l’evento iniziale principale per l’analisi del processo invoice-to-cash. Tutti i tempi di ciclo, come i Days Sales Outstanding (DSO), vengono generalmente misurati a partire da questo momento. Dove reperirlo Si tratta di un evento esplicito acquisito dalla data di creazione del record della fattura in HighRadius, normalmente sincronizzato dal sistema ERP di origine, come SAP o Oracle. Acquisizione Acquisito dal timestamp di creazione del record della fattura nei dati dei crediti commerciali. Tipo di evento explicit
	Fattura saldata	Questa attività indica la conclusione positiva del ciclo di vita della fattura, che risulta interamente pagata e chiusa. È lo stato finale desiderato del processo.
Perché è importante Costituisce il principale evento finale del percorso ottimale. L’analisi dei percorsi che conducono a questo risultato aiuta a individuare le best practice e le strategie di incasso più efficaci. Dove reperirlo In genere non si tratta di un evento esplicito, ma di un evento dedotto dalla modifica dello stato della fattura a «Closed» o «Cleared» e dall’azzeramento del saldo. Il timestamp dell’ultima registrazione del pagamento viene spesso utilizzato come orario dell’evento. Acquisizione Deducibile dalla modifica dello stato della fattura a «Closed» o dall’azzeramento del campo del saldo della fattura. Tipo di evento inferred
	Pagamento ricevuto	Questa attività indica la ricezione del pagamento da parte di un cliente, spesso registrata a partire da un estratto conto bancario o da un file lockbox. Significa che i fondi sono stati ricevuti, ma non ancora associati alla specifica fattura.
Perché è importante Si tratta di una tappa fondamentale che spesso arresta il conteggio del ciclo di incasso. Costituisce il punto di partenza per misurare il KPI del ritardo tra ricezione e registrazione del pagamento, mettendo in evidenza i ritardi nell’applicazione degli incassi. Dove reperirlo L’evento viene acquisito dai record dei pagamenti in HighRadius Cash Application Cloud. Ogni lotto o transazione di pagamento proveniente da un file bancario presenta una data di ricezione. Acquisizione Acquisito dal timestamp del record del pagamento al momento dell’importazione o dell’inserimento nel modulo di applicazione degli incassi. Tipo di evento explicit
	Chiamata di incasso registrata	Rappresenta una chiamata manuale effettuata da un agente degli incassi al cliente in merito a una fattura scaduta. Gli agenti registrano direttamente in HighRadius i dettagli e l’esito della chiamata.
Perché è importante Questa attività è fondamentale per valutare il tasso di successo delle chiamate di incasso e l’efficienza delle attività di incasso. Aiuta a distinguere tra attività di incasso automatiche e manuali. Dove reperirlo Si tratta di un evento esplicito creato quando un addetto agli incassi utilizza la funzione «Log Call» o «Add Activity» sull’account della fattura o del cliente nell’interfaccia HighRadius. La voce include un timestamp. Acquisizione Acquisito dalla tabella del log delle attività in cui gli addetti registrano le azioni manuali. Tipo di evento explicit
	Fattura inviata al cliente	Questa attività indica il momento in cui la fattura è stata consegnata al cliente, generalmente tramite e-mail o portale clienti. HighRadius può automatizzare e registrare questo evento di comunicazione.
Perché è importante Il monitoraggio di questa attività aiuta a garantire che i clienti ricevano tempestivamente le fatture. I ritardi tra la generazione e l’invio della fattura possono incidere direttamente sui tempi di pagamento e sul DSO. Dove reperirlo Spesso viene registrata esplicitamente nella cronologia delle comunicazioni o delle attività associata alla fattura nel modulo Collections Cloud. Può inoltre essere dedotta dallo stato di un Workflow di comunicazione automatizzato. Acquisizione Registrato nella cronologia delle comunicazioni della fattura quando viene eseguita la consegna tramite e-mail o portale. Tipo di evento explicit
	Limite di credito approvato	Rappresenta il completamento positivo del processo di revisione del credito, con la concessione ufficiale di un limite di credito al cliente. L’evento viene registrato quando un credit manager approva la richiesta nella piattaforma HighRadius.
Perché è importante Si tratta di una tappa fondamentale che sblocca il processo di vendita. Il monitoraggio di questa attività è essenziale per calcolare il KPI relativo al tempo complessivo del ciclo di approvazione del credito. Dove reperirlo L’evento viene generalmente acquisito da una modifica dello stato della richiesta di limite di credito, che passa ad «Approved». Può inoltre essere registrato esplicitamente nell’audit log del sistema. Acquisizione Deducibile da una modifica dello stato della richiesta di credito ad «Approved» o dal campo del timestamp di approvazione. Tipo di evento inferred
	Limite di credito richiesto	Questa attività segna l’avvio della valutazione del credito di un cliente. In genere viene attivata prima della finalizzazione di un ordine di vendita e viene registrata quando nel sistema viene inserita una richiesta di nuovo limite di credito o di aggiornamento di un limite esistente.
Perché è importante L’analisi del tempo che intercorre tra la richiesta e l’approvazione aiuta a individuare i colli di bottiglia nell’onboarding dei clienti e nei cicli di vendita. Si tratta di un punto di partenza fondamentale per misurare l’efficienza del team di gestione del credito. Dove reperirlo Questo evento è probabilmente dedotto da una modifica dello stato nel profilo di credito del cliente o dalla data di creazione di una richiesta di limite di credito nel modulo Credit Management di HighRadius. Acquisizione Deducibile dal timestamp di creazione di una richiesta di limite di credito o dalla modifica dello stato in «Pending Approval». Tipo di evento inferred
	Pagamento registrato	Rappresenta il completamento del processo di applicazione dell’incasso, quando un pagamento ricevuto viene associato e applicato correttamente a una specifica fattura, azzerandone il saldo aperto.
Perché è importante Questa attività conclude il ciclo di elaborazione del pagamento. Il tempo tra «Payment Received» e «Payment Posted» rivela l’efficienza del processo di applicazione degli incassi. Dove reperirlo L’evento viene acquisito dal campo della data di registrazione o di compensazione nel record della fattura. Il timestamp viene registrato quando l’applicazione dell’incasso è finalizzata. Acquisizione Acquisito dal timestamp della «posting date» o della «clearing date» nella voce contabile della fattura. Tipo di evento explicit
	Procedura di sollecito avviata	Questa attività indica l’avvio di una procedura formale di sollecito o di uno specifico livello della procedura per una fattura scaduta. Rappresenta un passaggio più strutturato rispetto a un singolo sollecito.
Perché è importante Il monitoraggio dell’avvio delle procedure di sollecito aiuta ad analizzare l’efficacia delle diverse strategie e dei diversi livelli di sollecito nel favorire il pagamento. Dove reperirlo L’evento viene generalmente dedotto da una modifica del campo «Dunning Level» o «Collection Strategy» associato al record della fattura in HighRadius. Acquisizione Deducibile da una modifica dell’attributo relativo al livello di sollecito della fattura, acquisita tramite log delle modifiche o cronologia con timestamp. Tipo di evento inferred
	Promessa di pagamento creata	Questa attività si verifica quando un cliente si impegna a pagare una fattura in una data futura e l’agente degli incassi registra la promessa nel sistema. Si tratta di un risultato intermedio positivo.
Perché è importante Il monitoraggio delle promesse di pagamento aiuta a prevedere il flusso di cassa e a valutare l’efficacia degli addetti agli incassi. Consente inoltre di analizzare le promesse non mantenute, quando il pagamento non viene ricevuto entro la data promessa. Dove reperirlo Si tratta di un evento esplicito registrato in HighRadius quando un agente crea un record «Promise to Pay» collegato a una fattura. Il record dispone di un proprio timestamp di creazione. Acquisizione Acquisito dal timestamp di creazione dell’oggetto «Promise to Pay» in HighRadius. Tipo di evento explicit
	Sollecito per scaduto inviato	Rappresenta un sollecito automatico o manuale inviato a un cliente in merito a una fattura scaduta. HighRadius automatizza questa attività nell’ambito delle strategie di sollecito, creando un log della comunicazione.
Perché è importante Questa attività è fondamentale per misurare il tasso di efficacia dei solleciti. Consente di analizzare quanti solleciti sono necessari prima di ricevere un pagamento. Dove reperirlo Si tratta di un evento esplicito registrato nel log delle attività o delle comunicazioni della fattura all’interno di HighRadius Collections Cloud. Ogni sollecito inviato presenta una voce e un timestamp corrispondenti. Acquisizione Acquisito dal log delle comunicazioni associato alla fattura, con relativo timestamp. Tipo di evento explicit

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i Suoi dati da HighRadius

Passaggi

Acceda al modulo di reportistica e analisi: acceda alla Sua istanza HighRadius con un utente che disponga delle autorizzazioni necessarie per creare ed eseguire report personalizzati. Acceda alla sezione Reporting and Analytics dalla Dashboard principale o dal menu dell’applicazione.
Crei un nuovo report personalizzato: avvii la procedura per creare un nuovo report. Selezioni un oggetto di base che funga da riferimento principale per i dati, ad esempio l’oggetto Fatture o Open A/R. Assegni al report un nome descrittivo, ad esempio ProcessMind_Credit_Collections_Log.
Definisca gli attributi principali della fattura: aggiunga al layout del report i campi principali della fattura. Includa InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate e PaymentStatus. Questi costituiranno le colonne di base per ogni evento.
Aggiunga i dati dagli oggetti correlati, cioè gli eventi: questo è il passaggio più importante. Dovrà unire o combinare i dati provenienti da diversi oggetti HighRadius per acquisire tutte le 15 attività richieste. Utilizzi le funzioni del generatore di report per aggiungere origini dati correlate. Per ogni attività, crei un insieme di colonne che rappresenti i dettagli dell’evento.
Strutturi il report nel formato Event Log: configuri il report affinché produca una riga per evento. In genere ciò richiede di combinare blocchi di dati diversi invece di unirli come colonne. Per ogni blocco combinato, associ il campo data pertinente a una colonna comune EventTime e imposti il relativo ActivityName.
Configuri l’evento Payment Due Date Passed: questo evento è condizionale. Crei un blocco di dati specifico per le fatture la cui DueDate è trascorsa e il cui PaymentStatus è ancora Open o Overdue. Per questi record, imposti ActivityName su Payment Due Date Passed e utilizzi la DueDate stessa come EventTime.
Aggiunga le informazioni sugli addetti alla riscossione e sulle contestazioni: includa i dati dei moduli Collections e Contestazioni. Esegua l’unione con oggetti come CollectorNotes o ActivityHistory per ottenere CollectorName. Esegua l’unione con l’oggetto Contestazioni per recuperare DisputeReason, quando applicabile.
Imposti i filtri del report: applichi i filtri per definire l’ambito dell’estrazione. Imposti un intervallo di date specifico per EventTime, ad esempio gli ultimi 6 mesi, per mantenere gestibile il set di dati. Potrebbe inoltre essere necessario filtrare per specifici Company Codes o unità aziendali, in base alla struttura della Sua organizzazione.
Esegua e visualizzi in anteprima il report: esegua il report per visualizzare un’anteprima dei dati. Verifichi che la struttura corrisponda al formato Event Log richiesto, con una riga per attività e colonne per InvoiceNumber, ActivityName, EventTime e gli altri attributi.
Esporti i dati del report: quando l’anteprima è soddisfacente, esporti il report completo. Selezioni CSV come formato di esportazione, poiché può essere acquisito facilmente dagli strumenti di Process Mining. Verifichi che nelle impostazioni di esportazione sia utilizzata la codifica UTF-8, per evitare problemi con i caratteri.
Riveda i dati finali: apra il file CSV esportato in un’applicazione per fogli di calcolo. Esegua un controllo finale per verificare che siano presenti tutte le 15 attività, che le indicazioni temporali siano formattate correttamente e che gli attributi principali siano valorizzati come previsto prima del caricamento in ProcessMind.

Configurazione

Tipo di report: un report personalizzato che combina dati provenienti da più moduli. A seconda della versione specifica di HighRadius, potrebbe essere denominato 'Joined Report' oppure richiedere più 'Blocks' da accorpare.
Oggetto dati principale: inizi con l’oggetto Fatture o Accounts Receivable come base del report.
Oggetti dati secondari: dovrà collegarsi a oggetti aggiuntivi, come CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase e CashApplication.
Filtro per intervallo di date: applichi un filtro al campo del timestamp dell’evento principale. È consigliabile estrarre i dati relativi a un periodo di 3-6 mesi, così da bilanciare livello di dettaglio e prestazioni. Ad esempio, EventTime negli ultimi 180 giorni.
Filtri per stato: valuti l’esclusione degli stati delle fatture non pertinenti, come 'Cancelled' o 'Draft', a meno che non facciano parte del processo che desidera analizzare.
Autorizzazioni: l’account utente che esegue il report deve disporre dell’accesso in lettura a tutti i moduli pertinenti, inclusi Credit, Collections, Disputes e Cash Application, per garantire l’estrazione di un dataset completo.

a Query di esempio 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
  }
}

Passaggi

Prerequisiti: verifichi di avere installato Python 3.6 o versione successiva, insieme alle librerie pandas e requests. Può installarle con pip: pip install pandas requests. Dovrà inoltre ottenere dall’amministratore HighRadius le credenziali API (Client ID e Client Secret), con accesso in lettura agli oggetti dati necessari, come fatture, collections, controversie e pagamenti.
Inizializzazione dello script: crei un nuovo file di script Python, per esempio extract_hr_data.py. Inizi importando le librerie necessarie (requests, pandas, datetime) e definendo costanti segnaposto per l’URL di base delle API HighRadius, le credenziali client e l’intervallo di date desiderato per l’estrazione.
Implementazione dell’autenticazione: scriva una funzione per gestire l’autenticazione. Questa funzione utilizzerà il Client ID e il Secret, invierà una richiesta POST all’endpoint di autenticazione HighRadius, ad esempio /auth/v1/token, e recupererà un bearer token. Il token verrà utilizzato nell’intestazione di tutte le successive richieste di dati.
Recupero dei dati principali delle fatture: sviluppi una funzione per interrogare l’endpoint principale delle fatture, ad esempio /invoices/v1/search. La funzione dovrà gestire la paginazione per garantire il recupero di tutti i record compresi nell’intervallo di date specificato. Dovrà richiamare iterativamente l’API, raccogliendo i dati delle fatture fino a quando non saranno disponibili altre pagine. Memorizzi questi dati principali in un elenco di dizionari.
Recupero dei dati degli oggetti correlati: per ogni entità dati principale, come Disputes, Collection Notes e Payments, crei funzioni separate per il recupero dei dati. Queste funzioni interrogheranno i rispettivi endpoint, ad esempio /disputes/v1/search, /collections/v1/notes e /cashapp/v1/payments, e dovranno essere progettate per recuperare in modo efficiente tutti i dati pertinenti al periodo specificato. In genere è preferibile recuperare questi dataset in blocco anziché interrogare un’unica fattura alla volta.
Strutturazione dell’Event Log: inizializzi un elenco vuoto che conterrà tutte le righe dell’Event Log. Lo script analizzerà i dati recuperati e trasformerà ogni azione o modifica di stato pertinente in un dizionario standardizzato che rappresenta una singola riga evento. Ogni dizionario dovrà contenere le chiavi InvoiceNumber, ActivityName, EventTime e tutti gli altri attributi richiesti.
Generazione degli eventi del ciclo di vita della fattura: analizzi l’elenco principale delle fatture. Per ogni fattura, crei gli eventi 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' e 'Invoice Written Off' sulla base della data di creazione, dei log di corrispondenza, della data di chiusura e dei campi di stato. Memorizzi questi elementi come dizionari evento.
Calcolo di 'Payment Due Date Passed': all’interno dello stesso ciclo sulle fatture, aggiunga la logica per creare un evento 'Payment Due Date Passed'. Si tratta di un evento calcolato. La logica dovrà verificare che la data di scadenza della fattura sia trascorsa, che la fattura non sia ancora stata pagata e che per essa non sia già stato generato un evento 'Payment Due Date Passed'. Per questa attività, EventTime dovrà corrispondere alla data di scadenza.
Generazione degli eventi di collections e controversie: elabori i dati recuperati dagli endpoint di collections e controversie. Per ogni nota, promessa di pagamento, azione di Dunning o record di controversia, crei le righe corrispondenti dell’Event Log ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Associ all’evento i dettagli pertinenti, come CollectorName e DisputeReason.
Generazione degli eventi di pagamento: elabori i dati dei pagamenti provenienti dal modulo cash application. Crei gli eventi 'Payment Received' sulla base della data di creazione del pagamento o della data dell’estratto conto bancario, quindi gli eventi 'Payment Posted' sulla base della data in cui il pagamento è stato applicato correttamente alla fattura.
Consolidamento e formattazione dei dati: dopo aver elaborato tutte le origini dati e generato gli eventi, converta l’elenco dei dizionari evento in un DataFrame pandas. Questo consentirà di ordinare facilmente i dati e di convertire i tipi di dati finali. Verifichi che la colonna EventTime utilizzi un formato timestamp coerente (YYYY-MM-DD HH:MI:SS).
Esportazione in CSV: utilizzi la funzione to_csv di pandas per esportare il DataFrame finale in un file CSV. Assegni al file un nome chiaro, per esempio highradius_event_log.csv. Imposti il parametro index=False per evitare di scrivere l’indice del DataFrame come colonna. Il file sarà quindi pronto per essere caricato in ProcessMind.

Configurazione

Credenziali API: è necessario un utente API dedicato con Client ID e Client Secret. L’utente deve disporre delle autorizzazioni di lettura per tutti gli endpoint API pertinenti, inclusi fatture, clienti, attività di collections, controversie e cash application.
Intervallo di date: lo script Python include le variabili START_DATE e END_DATE. È fondamentale impostare un intervallo specifico e ragionevole, ad esempio 3-6 mesi, per limitare il volume dei dati ed evitare tempi di esecuzione eccessivamente lunghi. Applichi il filtro a un campo data indicizzato, come la data di creazione o di modifica della fattura.
URL degli endpoint: i percorsi specifici degli endpoint API, ad esempio /invoices/v1/search, sono segnaposto. Dovrà verificare gli URL corretti nella documentazione delle API HighRadius della Sua organizzazione.
Parametri di paginazione: lo script deve gestire correttamente il meccanismo di paginazione dell’API. In genere ciò richiede l’utilizzo dei parametri limit e offset oppure di un approccio basato su cursore. Una dimensione di pagina compresa tra 100 e 500 è generalmente un buon punto di partenza.
Ambiente: lo script dovrebbe essere eseguito in un ambiente stabile, con memoria sufficiente per gestire i DataFrame, soprattutto per le estrazioni di grandi dimensioni. Per le estrazioni su scala produttiva è preferibile eseguirlo su un server anziché su una macchina locale.
Campi personalizzati: se il Suo processo utilizza campi personalizzati in HighRadius, sarà necessario modificare lo script affinché li interroghi e li includa nell’output.

a Query di esempio 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()

È pronto per iniziare?

Questo Template Le offre la base dati strutturata necessaria per ottenere insight approfonditi sul processo di gestione del credito e recupero crediti. Inizi oggi stesso a ottimizzare le operazioni HighRadius per accelerare il flusso di cassa.

Torna alla guida al miglioramento Scarica il Template

Inizi a ottimizzare la gestione del credito e il recupero crediti

Elimini i colli di bottiglia, riduca del 30% il tempo di ciclo e aumenti l’efficienza.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito: inizi in pochi minuti.

Il Suo Template dei dati per la gestione del credito e il recupero crediti

Il Suo Template dei dati per la gestione del credito e il recupero crediti

Attributi della gestione del credito e recupero crediti

Attività di gestione del credito e recupero crediti

Guide all’estrazione

Esportazione dal modulo Reporting and Analytics di HighRadius

Passaggi

Configurazione

a Query di esempio sql

Estrazione tramite script Python usando le API REST HighRadius

Passaggi

Configurazione

a Query di esempio python

È pronto per iniziare?

Inizi a ottimizzare la gestione del credito e il recupero crediti

Il Suo Template dei dati per la gestione del credito e il recupero crediti

Il Suo Template dei dati per la gestione del credito e il recupero crediti

Attributi della gestione del credito e recupero crediti

Attività di gestione del credito e recupero crediti

Guide all’estrazione

Esportazione dal modulo Reporting and Analytics di HighRadius

Passaggi

Configurazione

a Query di esempio sql

Estrazione tramite script Python usando le API REST HighRadius

Passaggi

Configurazione

a Query di esempio python

È pronto per iniziare?

Inizi a ottimizzare la gestione del credito e il recupero crediti

La Sua privacy è importante