> 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 per la gestione del credito e il 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 offre indicazioni strutturate per raccogliere i dati necessari ad analizzare i processi di gestione del credito e recupero crediti. Descrive gli attributi essenziali da acquisire e le attività chiave da monitorare, oltre a fornire indicazioni pratiche su come estrarre queste informazioni dal sistema HighRadius. L’utilizzo del template La aiuta a preparare i dati in modo efficiente per il Process Mining.

Attributi consigliati da raccogliere
Attività chiave da monitorare per avere visibilità sul processo
Indicazioni per l’estrazione dei dati specifiche per HighRadius

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

Scarica il template

Attributi per la gestione del credito e il recupero crediti

Questi sono i campi dati consigliati da includere nell’Event Log per analizzare in modo completo i processi di gestione del credito e recupero crediti.

3 Obbligatorio 7 Consigliato 11 Facoltativo

	Nome	Descrizione
	Data e ora dell’evento EventTime	Data e ora che indicano quando si è verificata l’attività.
Descrizione La data e ora dell’evento indicano con precisione quando si è verificata ciascuna attività del processo. Questi dati cronologici sono alla base del Process Mining: consentono di ordinare correttamente gli eventi e calcolare gli intervalli tra loro. Questo attributo serve a calcolare tutti i KPI basati sul tempo, come i tempi di ciclo per la risoluzione delle contestazioni, l’approvazione del credito e la registrazione dei pagamenti. Viene inoltre utilizzato per analizzare nel tempo le prestazioni del processo, 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 reperirli Ogni record transazionale o Event Log in HighRadius dovrebbe avere un campo con la data e ora corrispondente, spesso denominato «Creation Date» o «Timestamp». Esempi 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Nome dell’attività ActivityName	Nome dello specifico evento aziendale che si è verificato in un determinato momento per una fattura.
Descrizione Il nome dell’attività descrive una fase del processo di gestione del credito e recupero crediti, come «Fattura generata», «Promemoria di pagamento scaduto inviato» o «Pagamento ricevuto». La sequenza di attività costituisce il flusso del processo per ciascun caso. Analizzare questo attributo consente di individuare e visualizzare la mappa effettiva del processo. Aiuta a rilevare colli di bottiglia, scostamenti dalla procedura standard e cicli di rilavorazione. La frequenza e l’ordine di attività come «Chiamata di recupero registrata» o «Contestazione registrata» sono fondamentali per comprendere l’efficienza del processo. Perché è importante Questo attributo definisce le fasi del processo e consente di ricostruire e analizzare il flusso per ciascuna fattura. Dove reperirli In genere, viene ricavato dagli Event Log, dalle modifiche di stato o dai record di azioni specifiche nei diversi moduli della piattaforma HighRadius. Esempi Fattura inviata al clienteProcedura di sollecito avviataPagamento ricevutoContestazione risolta
	Numero della fattura InvoiceNumber	Identificativo univoco di ogni fattura, utilizzato come identificativo principale del caso nel processo dal credito all’incasso.
Descrizione Il numero della fattura è la chiave centrale che collega tutte le attività relative a una singola transazione di crediti verso clienti. Consente di seguire l’intero ciclo di vita, dalla generazione della fattura alle diverse attività di gestione del credito e recupero, fino al saldo finale o allo stralcio. Nell’analisi di Process Mining, questo attributo è essenziale per raggruppare tutti gli eventi correlati in un unico caso. In questo modo è possibile visualizzare i flussi di processo end-to-end, calcolare la durata dei casi, come i giorni medi di incasso (DSO), e analizzare i diversi percorsi che può seguire una fattura, per esempio la risoluzione di una contestazione o le procedure di sollecito. Perché è importante È l’identificativo fondamentale che collega tutte le fasi del processo e permette di analizzare l’intero percorso della fattura, dalla creazione alla chiusura. Dove reperirli È un campo principale di HighRadius, che si trova in genere negli oggetti dati centrali relativi alle fatture o ai crediti. Esempi INV-2023-001239876543210SI-55482
	Condizioni di pagamento PaymentTerms	Condizioni concordate che stabiliscono entro quando il cliente deve pagare una fattura.
Descrizione Le condizioni di pagamento specificano i termini, ad esempio «30 giorni netti», «60 giorni netti» o «pagamento alla ricezione». Questo attributo costituisce la base per calcolare la data di scadenza della fattura. È un attributo fondamentale per la Dashboard e l’indicatore «Rispetto delle condizioni di pagamento». La sua analisi aiuta a verificare se le condizioni standard vengono applicate in modo coerente e quali termini sono associati a una maggiore frequenza di ritardi. Queste informazioni possono orientare la politica del credito e le trattative con i clienti. Perché è importante Definisce le tempistiche previste per il pagamento ed è quindi essenziale per calcolare le date di scadenza e misurare il rispetto degli accordi da parte dei clienti. Dove reperirli In genere si trova nell’intestazione della fattura o nei dati dell’anagrafica cliente di HighRadius o dell’ERP di origine. Esempi 30 giorni netti60 giorni nettiPagamento alla ricezione
	Data di scadenza DueDate	Data entro la quale deve essere pagata la fattura, calcolata in base alle condizioni concordate.
Descrizione La data di scadenza è il giorno entro il quale la fattura deve essere pagata per non risultare scaduta. In genere viene calcolata a partire dalla data della fattura e dalle condizioni di pagamento. Questo attributo è fondamentale per tutte le analisi delle fatture scadute. È il dato principale per calcolare i «giorni di ritardo», avviare le procedure di sollecito e misurare l’indicatore «Tasso di rispetto delle condizioni di pagamento». Alimenta direttamente le Dashboard dedicate all’anzianità delle fatture e all’efficacia dei solleciti. Perché è importante È la data fondamentale per stabilire se una fattura è stata pagata puntualmente o è scaduta, e determina l’avvio delle successive attività di recupero crediti e il calcolo dei relativi indicatori. Dove reperirli È un campo standard del record della fattura in HighRadius. Può essere importato dall’ERP di origine o calcolato direttamente in HighRadius. Esempi 2023-04-142023-05-312023-06-20
	ID cliente CustomerId	Identificativo univoco del cliente associato alla fattura.
Descrizione L’ID cliente collega una fattura al cliente specifico a cui si riferisce, permettendo di aggregare e analizzare i dati del processo dal punto di vista del cliente. Questo attributo è essenziale per analizzare le abitudini di pagamento dei diversi clienti o segmenti di clientela. Aiuta a rispondere a domande come: quali clienti pagano spesso in ritardo? Quali clienti presentano più contestazioni? Consente di alimentare Dashboard come «Rispetto delle condizioni di pagamento» e di suddividere gli indicatori per cliente. Perché è importante Consente di analizzare per cliente le abitudini di pagamento, la frequenza delle contestazioni e le interazioni con il processo nel suo complesso, contribuendo a definire strategie di recupero crediti mirate. Dove reperirli È un campo standard nell’intestazione della fattura o nei dati dell’anagrafica cliente di HighRadius. Esempi CUST-001ACME-CORPGLOBEX-US
	Importo della fattura InvoiceAmount	Importo monetario totale della fattura.
Descrizione Questo attributo rappresenta l’importo totale dovuto per la fattura. È un indicatore finanziario fondamentale per comprendere il valore associato a ciascun caso. Nel Process Mining, l’importo della fattura serve a definire le priorità delle attività di recupero crediti, ad esempio concentrandosi sulle fatture scadute di importo elevato. È essenziale per indicatori finanziari come i giorni medi di incasso (DSO) e viene utilizzato nella Dashboard «Analisi delle fatture stralciate» per quantificare l’impatto finanziario dei crediti inesigibili. Perché è importante Fornisce il contesto finanziario di ciascun caso e consente di analizzare i dati in base al valore, stabilire le priorità del lavoro e quantificare gli impatti finanziari, come gli stralci. Dove reperirli È un campo standard nei dati dell’intestazione della fattura in HighRadius. Esempi 5000.001250.7525000.50
	Motivo della contestazione DisputeReason	Codice o descrizione del motivo indicato dal cliente per contestare una fattura.
Descrizione Quando presenta una contestazione, il cliente ne indica in genere il motivo, ad esempio «Prezzo errato», «Merce danneggiata» o «Fattura duplicata». Questo attributo registra tale motivazione. L’analisi dei motivi di contestazione è fondamentale per la Dashboard «Tempi di risoluzione delle contestazioni sulle fatture». Aiuta a individuare le cause profonde delle contestazioni, così che l’azienda possa intervenire sui problemi ricorrenti relativi a prezzi, spedizioni o fatturazione. Ridurre le contestazioni alla fonte può accelerare notevolmente i flussi di cassa. Perché è importante Aiuta a comprendere le cause profonde dei ritardi nei pagamenti e a migliorare il processo con interventi mirati, prevenendo contestazioni future. Dove reperirli Queste informazioni vengono registrate nel modulo di gestione delle contestazioni o delle detrazioni di HighRadius quando viene inserita una contestazione. Esempi Quantità errataDifferenza di prezzoMerce danneggiataFatturazione duplicata
	Nome dell’addetto al recupero crediti CollectorName	Nome dell’utente o dell’agente responsabile di un’attività di recupero crediti.
Descrizione Questo attributo identifica l’addetto al recupero crediti, l’analista del credito o un altro utente che ha eseguito un’attività manuale, come «Chiamata di recupero crediti registrata» o «Contestazione risolta». L’analisi consente di confrontare i risultati dei diversi addetti o team, comprendere come è distribuito il carico di lavoro, valutare l’efficacia delle strategie individuali, ad esempio il tasso di successo delle chiamate di recupero per addetto, e individuare opportunità di formazione. È inoltre un dato essenziale per la gestione delle risorse e la pianificazione della capacità. Perché è importante Collega le attività del processo a persone specifiche, consentendo di analizzare i risultati dei team, il carico di lavoro e l’efficacia degli interventi manuali. Dove reperirli Queste informazioni sono in genere registrate nei registri delle attività o nei record delle azioni degli utenti del modulo Collections di HighRadius. Esempi John SmithJane DoeEmily Jones
	Stato del pagamento PaymentStatus	Stato finanziario corrente della fattura, ad esempio aperta, pagata, scaduta o contestata.
Descrizione Lo stato del pagamento mostra a che punto del ciclo di vita si trova una fattura: indica se è ancora in attesa di pagamento, se è stata pagata interamente o in parte, se è scaduta oppure se è oggetto di verifica a seguito di una contestazione. Questo attributo è centrale nella Dashboard «Stato e anzianità dei pagamenti delle fatture». Permette di suddividere rapidamente il portafoglio dei crediti verso clienti per comprenderne la situazione finanziaria complessiva e dare priorità alle attività di recupero relative alle fatture scadute o contestate. Perché è importante Suddivide le fatture in gruppi che richiedono interventi diversi, offrendo una visione immediata dello stato dei crediti e aiutando a definire le priorità delle attività di recupero. Dove reperirli È un campo di stato fondamentale del record della fattura o del credito verso clienti in HighRadius. Esempi ApertaPagataScadutaContestataStralciata
	Data promessa di pagamento PromiseToPayDate	Data entro la quale il cliente si è impegnato a pagare una fattura scaduta.
Descrizione Quando contatta un cliente, l’addetto al recupero crediti può ottenere una «promessa di pagamento», ovvero l’impegno del cliente a pagare entro una certa 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 nel concordare impegni precisi. Permette di monitorare il tasso di promesse mantenute, un indicatore chiave per un team di recupero crediti. Perché è importante Registra un esito importante delle attività di recupero crediti e consente di misurare l’efficacia dei solleciti e l’affidabilità degli impegni presi dai clienti. Dove reperirli Questa data viene registrata quando nel modulo Collections di HighRadius si inserisce un’attività di «Promessa di pagamento». Esempi 2023-06-152023-07-012023-06-25
	È automatizzata IsAutomated	Indicatore booleano che specifica se un’attività è stata eseguita automaticamente dal sistema o manualmente da un utente.
Descrizione Questo attributo calcolato distingue gli eventi generati dal sistema, ad esempio «Promemoria di scadenza inviato» da una procedura automatizzata di sollecito, dalle azioni svolte da una persona, come «Chiamata di recupero crediti registrata». L’indicatore è fondamentale per calcolare il KPI «Tasso di attività automatizzate di recupero crediti». Aiuta a misurare il livello di automazione del processo, individuare ulteriori opportunità di automazione e confrontare l’efficacia degli interventi automatici e manuali. Perché è importante Aiuta a misurare il grado di automazione del processo e consente di analizzare l’efficienza e l’efficacia dei sistemi automatizzati rispetto alle attività manuali. Dove reperirli Viene ricavato durante la trasformazione dei dati. Per calcolarlo è necessario creare una mappatura che, in base alle conoscenze aziendali, contrassegni come automatizzati determinati nomi di attività. Esempi truefalse
	Giorni di ritardo DaysOverdue	Numero di giorni trascorsi dalla data di scadenza della fattura. Il valore è zero se la fattura non è ancora scaduta o è stata pagata puntualmente.
Descrizione I giorni di ritardo sono un indicatore calcolato 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 dei ritardi di pagamento. Questo attributo è alla base della Dashboard «Stato e anzianità dei pagamenti delle fatture», che lo utilizza per suddividere i crediti per fasce di anzianità, ad esempio da 1 a 30 giorni e da 31 a 60 giorni. Rientra inoltre nel calcolo dei giorni medi di incasso e aiuta a dare priorità alle attività di recupero relative ai crediti con i ritardi più lunghi. Perché è importante Questo indicatore quantifica direttamente i ritardi di pagamento ed è quindi essenziale per analizzare l’anzianità dei crediti, definire le priorità di recupero e calcolare i giorni medi di incasso. Dove reperirli Non è un campo memorizzato. Viene calcolato durante la trasformazione dei dati utilizzando la data di scadenza e la data di pagamento oppure la data corrente. Esempi 1545092
	Livello di sollecito DunningLevel	Fase o livello raggiunto dalla procedura automatizzata di sollecito per una fattura scaduta.
Descrizione Il livello di sollecito indica l’intensità delle attività di recupero crediti e spesso corrisponde a una sequenza di promemoria o avvisi automatici inviati al cliente. Ad esempio, il livello 1 può corrispondere a un promemoria cortese, mentre il livello 3 a un avviso finale. Questo attributo è essenziale per la Dashboard «Efficacia della strategia di sollecito». Analizzando quali livelli di sollecito portano più spesso al pagamento, le aziende possono ottimizzare i flussi di lavoro dei solleciti, rendendoli efficaci senza risultare eccessivamente insistenti e compromettere il rapporto con i clienti. Perché è importante Tiene traccia dell’intensificarsi delle attività di recupero crediti e consente di analizzare quali strategie di sollecito sono più efficaci nel favorire il pagamento. Dove reperirli È un campo di stato gestito dal motore dei flussi di lavoro automatizzati per il recupero crediti o i solleciti di HighRadius. Esempi 123 - Avviso finaleRecupero crediti legale
	Motivo dello stralcio WriteOffReason	Codice o spiegazione del motivo per cui una fattura è stata stralciata come credito inesigibile.
Descrizione Quando una fattura è considerata inesigibile, viene stralciata. Questo attributo registra il motivo dello stralcio, ad esempio «Fallimento del cliente», «Contestazione irrisolta» o «Stralcio di un importo esiguo». È un attributo fondamentale per la Dashboard «Analisi delle fatture stralciate». Aiuta ad analizzare le cause profonde delle perdite finanziarie e fornisce informazioni utili per rivedere le politiche del credito, migliorare la gestione delle contestazioni o adeguare le strategie di recupero, riducendo così gli stralci futuri. Perché è importante Spiega i motivi delle perdite di ricavi e fornisce indicazioni essenziali per migliorare la valutazione del rischio di credito e le politiche di recupero crediti. Dove reperirli Queste informazioni vengono registrate quando viene elaborata un’attività di «Fattura stralciata», in genere nel modulo finanziario o di recupero crediti di HighRadius. Esempi FallimentoPrescrizione scadutaCosti di recupero superiori al debito
	Ora di fine EndTime	Data e ora in cui un’attività è stata completata.
Descrizione L’ora di fine indica quando si conclude un’attività. Molte attività di gestione degli incassi sono eventi istantanei, per i quali l’ora di inizio coincide con quella di fine; altre, come la «Risoluzione di una contestazione», possono invece avere una durata specifica. Quando disponibile, questo attributo viene utilizzato insieme all’ora di inizio per calcolare il tempo di elaborazione delle singole attività. In questo modo è possibile individuare quali passaggi, e non soltanto gli intervalli tra un passaggio e l’altro, assorbono più tempo e risorse. Perché è importante Permette di misurare con precisione la durata delle singole attività e di capire meglio in quali fasi del processo viene impiegato il tempo. Dove reperirli Consulti la documentazione di HighRadius. Questo dato potrebbe essere disponibile per alcune attività registrate che prevedono uno stato iniziale e uno finale. Esempi 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Paese Country	Paese del cliente associato alla fattura.
Descrizione Questo attributo indica il paese in cui si trova il cliente e permette di segmentare geograficamente il processo di gestione del credito e di recupero crediti. L’analisi dei dati per paese può far emergere differenze regionali nelle abitudini di pagamento, nell’efficacia delle strategie di recupero e nei motivi più comuni delle contestazioni. Queste informazioni sono essenziali per adattare le politiche alle diverse aree geografiche e per la reportistica direzionale nelle organizzazioni globali. Perché è importante Consente di svolgere analisi geografiche, individuare tendenze regionali nelle abitudini di pagamento e adattare di conseguenza le strategie di recupero crediti. Dove reperirli Queste informazioni fanno parte dei dati dell’anagrafica 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. In questa vista del processo, il valore sarà in genere «HighRadius». Negli ambienti con più sistemi, questo campo è fondamentale per comprendere la provenienza dei dati e risalire alla loro origine. Aiuta a distinguere i processi che coinvolgono piattaforme diverse, come un sistema ERP e uno strumento specializzato per il recupero crediti. Perché è importante Chiarisce l’origine dei dati, un aspetto importante per la governance e la convalida dei dati e per comprendere l’architettura tecnologica del processo. Dove reperirli In genere, è un valore statico aggiunto durante l’estrazione e la trasformazione dei dati per identificare il dataset. Esempi HighRadiusHighRadius-CollectionsHighRadius-CashApp
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’ultimo aggiornamento dei dati di questo record dal sistema di origine.
Descrizione Questo attributo indica quanto sono recenti i dati. Registra la data e l’ora dell’ultima estrazione o dell’ultimo aggiornamento dei dati da HighRadius. In fase di analisi, questo campo fornisce un’indicazione sull’attualità dei risultati. È fondamentale che le Dashboard e i report mostrino quanto siano aggiornate le informazioni, così da garantire che le decisioni aziendali si basino su dati recenti. Perché è importante Consente di verificare la tempestività dei dati, un aspetto fondamentale per dare credibilità all’analisi e prendere decisioni informate. Dove reperirli Questo timestamp viene generato e aggiunto a ogni 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	Unità aziendale o divisione interna responsabile della vendita o della fattura.
Descrizione L’attributo Unità aziendale assegna la fattura a una specifica area dell’organizzazione, ad esempio «Vendita al dettaglio», «Vendita all’ingrosso» o «Servizi». In questo modo è possibile analizzare i risultati per i diversi segmenti aziendali. La direzione può confrontare indicatori come i giorni medi di incasso, il tasso di contestazione e gli stralci tra le varie unità aziendali, individuando quelle con i risultati migliori e quelle che necessitano di interventi. Aiuta inoltre a definire responsabilità chiare per la gestione dei crediti in ciascuna area dell’organizzazione. Perché è importante Consente di confrontare i risultati delle diverse aree dell’organizzazione e di individuare le divisioni con i processi di gestione del credito e incasso più efficaci. Dove reperirli Si tratta di dati organizzativi, in genere presenti nella fattura o ricavati dall’ordine di vendita o dall’anagrafica cliente associata in HighRadius o nell’ERP. Esempi UA - Nord AmericaDivisione ServiziProduzione
	Valuta Currency	Codice della valuta dell’importo della fattura.
Descrizione Questo attributo indica la valuta della fattura, ad esempio USD, EUR o JPY. Fornisce il contesto necessario per interpretare gli importi monetari, come l’importo della fattura. Per un’azienda multinazionale, questo campo è indispensabile per un’analisi finanziaria accurata: garantisce che gli importi siano interpretati correttamente e permette di convertire le valute quando si aggregano i dati per la reportistica globale. Perché è importante È essenziale per interpretare correttamente tutti gli importi monetari ed evitare calcoli e report finanziari inesatti nei contesti in cui si utilizzano più valute. Dove reperirli È un campo standard del record della fattura, generalmente presente accanto all’importo della fattura. Esempi USDEURGBP

Obbligatorio Consigliato Facoltativo

Attività di gestione del credito e recupero crediti

Queste sono le fasi e le tappe chiave da registrare nell’Event Log per individuare e analizzare con precisione i processi di gestione del credito e recupero crediti.

7 Consigliato 8 Facoltativo

	Attività	Descrizione
	Contestazione registrata	Questa attività indica il momento in cui un cliente contesta una fattura o ne richiede una detrazione, registrata formalmente in HighRadius. Per l’importo contestato, il normale processo di recupero crediti viene sospeso.
Perché è importante È l’evento di inizio per misurare il tempo medio di risoluzione delle contestazioni. Individuare quando e perché vengono presentate aiuta ad affrontare le cause profonde, come errori di fatturazione o problemi di spedizione. Dove reperirli L’evento viene rilevato quando un utente crea un caso di contestazione collegato a una fattura in Deductions Cloud di HighRadius. L’azione genera un record della contestazione con data e ora. Acquisizione Rilevato dalla data e ora di creazione del caso di contestazione associato alla fattura. Tipo di evento explicit
	Contestazione risolta	Indica la conclusione del processo di gestione della contestazione, dopo aver esaminato il problema e raggiunto una soluzione. A questo punto, la fattura può passare al pagamento o allo stralcio.
Perché è importante È l’evento finale per misurare il tempo medio di risoluzione delle contestazioni. Cicli lunghi possono ritardare sensibilmente l’incasso e segnalare inefficienze nel processo. Dove reperirli L’evento viene rilevato quando lo stato del caso di contestazione passa a «Risolto», «Chiuso» o a uno stato finale equivalente. Per l’attività si utilizza la data e ora della modifica. Acquisizione Dedotto dalla data e ora in cui lo stato del caso di contestazione viene aggiornato allo stato finale «Risolto». Tipo di evento inferred
	Data di scadenza del pagamento superata	È un evento calcolato che si verifica quando la data corrente supera la scadenza della fattura. Non rappresenta un’azione dell’utente o del sistema, ma un cambiamento di stato fondamentale che avvia il processo di recupero crediti.
Perché è importante Questa attività è il principale fattore che avvia tutte le successive attività di sollecito e recupero. Distingue le fatture pagate puntualmente da quelle scadute e consente di analizzare l’efficacia delle strategie di recupero. Dove reperirli L’evento non viene registrato direttamente, ma calcolato confrontando la data di scadenza della fattura con la data e ora degli altri eventi. Viene ricavato durante la trasformazione dei dati per il Process Mining. Acquisizione Calcolato confrontando il campo due_date della fattura con la data corrente o la data e ora dell’evento (Timestamp > Due Date). Tipo di evento calculated
	Fattura generata	È il punto di partenza del ciclo di vita della fattura nel processo di recupero crediti. Indica che la fattura è stata creata nel sistema ERP e importata in HighRadius per la gestione dei crediti.
Perché è importante Questa attività costituisce l’evento di inizio principale per l’analisi del processo dalla fattura all’incasso. Tutti i tempi di ciclo, come i giorni medi di incasso (DSO), vengono in genere misurati a partire da questo momento. Dove reperirli È un evento esplicito, rilevato dalla data di creazione della fattura in HighRadius, normalmente sincronizzata dal sistema ERP di origine, come SAP o Oracle. Acquisizione Rilevato dalla data e ora di creazione della fattura nei dati dei crediti. 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 È l’evento finale del percorso ottimale del processo. Analizzare i percorsi che portano a questo esito aiuta a individuare le buone pratiche e le strategie di recupero più efficaci. Dove reperirli In genere, non è un evento esplicito, ma viene dedotto quando lo stato della fattura passa a «Chiuso» o «Compensato» e il saldo diventa zero. Spesso si utilizza come data e ora dell’evento quella dell’ultima registrazione del pagamento. Acquisizione Dedotto dal passaggio dello stato della fattura a «Chiuso» o dall’azzeramento del saldo della fattura. Tipo di evento inferred
	Fattura stralciata	Indica una conclusione alternativa del ciclo di vita della fattura: il credito è considerato inesigibile e viene stralciato come perdita su crediti. È un esito indesiderato.
Perché è importante Monitorare gli stralci è fondamentale per calcolare il tasso di stralcio delle fatture e analizzare le cause profonde delle perdite finanziarie. Aiuta a individuare carenze nella valutazione del credito o nelle attività di recupero. Dove reperirli L’evento viene rilevato quando viene registrata una transazione specifica per stralciare il saldo della fattura o quando lo stato della fattura passa a «Stralciata». Acquisizione Dedotto dal passaggio dello stato a «Stralciata» o dalla registrazione di una specifica transazione di stralcio sulla fattura. Tipo di evento inferred
	Pagamento ricevuto	Questa attività indica la ricezione di un pagamento da parte del cliente, spesso registrata a partire da un estratto conto bancario o da un file lockbox. I fondi sono stati ricevuti, ma non ancora associati alla fattura specifica.
Perché è importante È una tappa fondamentale che spesso interrompe il conteggio dei tempi di recupero. Da qui si misura il KPI del ritardo tra ricezione e registrazione del pagamento, che mette in evidenza i ritardi nell’abbinamento degli incassi. Dove reperirli L’evento viene rilevato dai record dei pagamenti in Cash Application Cloud di HighRadius. Ogni lotto di pagamenti o transazione proveniente da un file bancario ha una data di ricezione. Acquisizione Rilevato dalla data e ora del record di pagamento al momento dell’importazione o dell’inserimento nel modulo di gestione degli incassi. Tipo di evento explicit
	Chiamata di recupero registrata	Indica una chiamata manuale effettuata da un addetto al recupero crediti al cliente in merito a una fattura scaduta. Gli addetti 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 recupero e l’efficienza delle attività di recupero. Aiuta a distinguere le iniziative automatiche da quelle manuali. Dove reperirli È un evento esplicito, creato quando un addetto utilizza la funzione «Registra chiamata» o «Aggiungi attività» nell’interfaccia di HighRadius, sulla fattura o sull’account del cliente. La voce include la data e l’ora. Acquisizione Rilevato 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 che la fattura è stata recapitata al cliente, in genere tramite e-mail o portale clienti. HighRadius può automatizzare e registrare questa comunicazione.
Perché è importante Monitorare questa attività aiuta a verificare che i clienti ricevano le fatture tempestivamente. I ritardi tra la generazione e l’invio della fattura possono incidere direttamente sui tempi di pagamento e sui giorni medi di incasso (DSO). Dove reperirli Spesso viene registrata esplicitamente nella cronologia delle comunicazioni o delle attività associate alla fattura nel modulo Collections Cloud. Può anche essere dedotta dallo stato di un processo automatizzato di invio delle comunicazioni. Acquisizione Registrato nella cronologia delle comunicazioni della fattura quando viene inviata tramite e-mail o portale. Tipo di evento explicit
	Impegno di pagamento registrato	Questa attività si verifica quando un cliente si impegna a pagare una fattura in una data futura e l’addetto al recupero registra l’impegno nel sistema. Si tratta di un esito intermedio positivo.
Perché è importante Monitorare gli impegni di pagamento aiuta a prevedere i flussi di cassa e a valutare l’efficacia degli addetti al recupero. Consente inoltre di analizzare gli impegni non rispettati, quando il pagamento non arriva entro la data concordata. Dove reperirli È un evento esplicito registrato in HighRadius quando un addetto crea un record «Impegno di pagamento» collegato a una fattura. Il record ha una propria data e ora di creazione. Acquisizione Rilevato dalla data e ora di creazione dell’oggetto «Impegno di pagamento» in HighRadius. Tipo di evento explicit
	Limite di credito approvato	Indica il completamento positivo della revisione del credito, con l’assegnazione ufficiale di un limite al cliente. L’evento viene registrato quando un responsabile del credito approva la richiesta nella piattaforma HighRadius.
Perché è importante È una tappa fondamentale che consente di proseguire con il processo di vendita. Monitorare questa attività è essenziale per calcolare il KPI del tempo di ciclo complessivo di approvazione del credito. Dove reperirli In genere, l’evento viene rilevato quando lo stato della richiesta di limite di credito passa ad «Approvato». Può anche essere registrato esplicitamente nell’audit log del sistema. Acquisizione Dedotto dal passaggio della richiesta di credito allo stato «Approvato» o dal campo con la data e ora 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 conferma di un ordine di vendita e registrata quando nel sistema viene inserita una richiesta di nuovo limite di credito o di modifica di quello esistente.
Perché è importante Analizzare il tempo che intercorre tra la richiesta e l’approvazione aiuta a individuare i colli di bottiglia nell’acquisizione dei clienti e nel ciclo di vendita. È un punto di partenza fondamentale per misurare l’efficienza del team che gestisce il credito. Dove reperirli Questo evento è probabilmente dedotto da una modifica dello stato del profilo di credito del cliente o dalla data di creazione di una richiesta di limite di credito nel modulo Credit Management di HighRadius. Acquisizione Dedotto dalla data e ora di creazione di una richiesta di limite di credito o dal passaggio allo stato «In attesa di approvazione». Tipo di evento inferred
	Pagamento registrato	Indica il completamento del processo di abbinamento degli incassi: il pagamento ricevuto è stato associato correttamente a una fattura specifica e il saldo aperto è stato azzerato.
Perché è importante Questa attività conclude il ciclo di elaborazione del pagamento. Il tempo tra «Pagamento ricevuto» e «Pagamento registrato» rivela l’efficienza del processo di abbinamento degli incassi. Dove reperirli L’evento viene rilevato dal campo della data di registrazione o di compensazione della fattura. La data e ora vengono registrate al completamento dell’abbinamento dell’incasso. Acquisizione Rilevato dalla data e ora del campo «data di registrazione» o «data di compensazione» della singola voce contabile della fattura. Tipo di evento explicit
	Procedura di sollecito avviata	Questa attività indica l’avvio di una procedura formale di sollecito o il raggiungimento di un livello specifico della procedura per una fattura scaduta. È un passaggio più strutturato rispetto all’invio di un singolo promemoria.
Perché è importante Monitorare l’avvio delle procedure di sollecito aiuta ad analizzare l’efficacia delle diverse strategie di recupero e dei livelli di sollecito nel favorire i pagamenti. Dove reperirli In genere, l’evento viene dedotto da una modifica del campo «Livello di sollecito» o «Strategia di recupero» associato alla fattura in HighRadius. Acquisizione Dedotto da una modifica dell’attributo relativo al livello di sollecito della fattura, rilevata tramite i log delle modifiche o la cronologia con data e ora. Tipo di evento inferred
	Promemoria di pagamento scaduto inviato	Indica un promemoria, automatico o manuale, inviato al cliente per una fattura scaduta. HighRadius automatizza questa attività nell’ambito delle strategie di sollecito e ne registra la comunicazione.
Perché è importante Questa attività è fondamentale per misurare il tasso di efficacia dei solleciti. Consente di analizzare quanti promemoria occorrono prima di ricevere un pagamento. Dove reperirli È un evento esplicito registrato nel log delle attività o delle comunicazioni della fattura in Collections Cloud di HighRadius. Ogni promemoria inviato ha una voce corrispondente con data e ora. Acquisizione Rilevato dal log delle comunicazioni con data e ora associato alla fattura. Tipo di evento explicit

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i dati da HighRadius

Passaggi

Acceda al modulo di report e analisi: acceda alla Sua istanza HighRadius con un utente che disponga delle autorizzazioni necessarie per creare ed eseguire report personalizzati. Apra la sezione Report e analisi dalla Dashboard principale o dal menu dell’applicazione.
Crei un nuovo report personalizzato: avvii la procedura per creare un 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 delle fatture: aggiunga al layout del report i campi principali delle fatture, tra cui InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate e PaymentStatus. Questi costituiranno le colonne di base per ogni evento.
Aggiunga dati dagli oggetti correlati (eventi): questo è il passaggio più importante. Dovrà unire i dati di 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à, creerà un insieme di colonne che ne descrivono i dettagli.
Imposti il report nel formato event log: configuri il report in modo da ottenere una riga per evento. In genere, ciò richiede di unire diversi blocchi di dati anziché affiancarli come colonne. Per ogni blocco unito, associ il campo data pertinente a una colonna comune EventTime e inserisca come valore fisso il nome corrispondente in ActivityName.
Configuri l’evento 'Payment Due Date Passed': questo evento è condizionale. Crei un blocco di dati specifico per le fatture con DueDate nel passato e PaymentStatus ancora impostato su 'Open' o 'Overdue'. Per questi record, imposti ActivityName su 'Payment Due Date Passed' e utilizzi la stessa DueDate come EventTime.
Aggiunga le informazioni sugli addetti al recupero crediti e sulle contestazioni: includa i dati dei moduli Collections e Contestazioni. Unisca oggetti come CollectorNotes o ActivityHistory per recuperare CollectorName. Unisca l’oggetto Contestazioni per ottenere DisputeReason, se 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, così da mantenere gestibile il set di dati. In base alla struttura dell’organizzazione, potrebbe essere necessario filtrare anche per specifici codici società o unità aziendali.
Esegua e visualizzi un’anteprima del report: esegua il report e ne visualizzi un’anteprima. Verifichi che la struttura corrisponda al formato event log richiesto, con una riga per attività e colonne quali InvoiceNumber, ActivityName, EventTime e gli altri attributi.
Esporti i dati del report: quando l’anteprima è soddisfacente, esporti il report completo. Selezioni il formato CSV, facilmente acquisibile dagli strumenti di Process Mining. Verifichi che nelle impostazioni di esportazione sia selezionata la codifica UTF-8, per evitare problemi con i caratteri.
Verifichi i dati prima del caricamento: apra il file CSV esportato con un’applicazione per fogli di calcolo. Controlli che siano presenti tutte le 15 attività, che le date e le ore siano formattate correttamente e che gli attributi principali siano valorizzati come previsto, prima di caricare il file in ProcessMind.

Configurazione

Tipo di report: report personalizzato che combina dati provenienti da più moduli. A seconda della versione di HighRadius, può essere chiamato 'Joined Report' oppure può richiedere l’unione di più 'Blocks'.
Oggetto dati principale: inizi dall’oggetto Fatture o Accounts Receivable come base del report.
Oggetti dati secondari: dovrà collegare altri oggetti, come CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase e CashApplication.
Filtro per intervallo di date: applichi un filtro al campo principale del timestamp dell’evento. Si consiglia di estrarre dati relativi a un periodo da 3 a 6 mesi, per bilanciare il livello di dettaglio e le prestazioni. Ad esempio, EventTime negli ultimi 180 giorni.
Filtri per stato: valuti se escludere gli 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 insieme completo di dati.

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, recupero crediti, contestazioni e pagamenti.
Inizializzi lo script: crei un nuovo file di script Python, ad 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.
Implementi l’autenticazione: scriva una funzione per gestire l’autenticazione. La funzione utilizzerà il Client ID e il Client Secret per inviare una richiesta POST all’endpoint di autenticazione HighRadius (ad esempio /auth/v1/token) e ottenere un token bearer. Il token verrà inserito nell’intestazione di tutte le successive richieste di dati.
Recuperi i 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 recuperare tutti i record compresi nell’intervallo di date specificato. Dovrà richiamare l’API più volte e raccogliere i dati delle fatture finché non saranno disponibili altre pagine. Memorizzi i dati principali delle fatture in un elenco di dizionari.
Recuperi i dati degli oggetti correlati: crei funzioni separate per recuperare i dati di ciascuna entità principale, come contestazioni, note di recupero crediti e pagamenti. Le funzioni interrogheranno i rispettivi endpoint (ad esempio /disputes/v1/search, /collections/v1/notes, /cashapp/v1/payments) e dovranno recuperare in modo efficiente tutti i dati pertinenti al periodo specificato. In genere, è preferibile recuperare questi insiemi di dati in blocco, anziché interrogare una fattura alla volta.
Strutturi l’Event Log: inizializzi un elenco vuoto in cui inserire tutte le righe dell’Event Log. Lo script scorrerà i dati recuperati e trasformerà ogni azione o variazione di stato pertinente in un dizionario standardizzato, corrispondente a una singola riga evento. Ogni dizionario dovrà contenere le chiavi InvoiceNumber, ActivityName, EventTime e tutti gli altri attributi richiesti.
Generi gli eventi del ciclo di vita della fattura: scorra l’elenco principale delle fatture. Per ciascuna, crei gli eventi 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' e 'Invoice Written Off' in base alla data di creazione, ai registri delle comunicazioni, alla data di chiusura e ai campi di stato. Memorizzi questi dati come dizionari di eventi.
Calcoli l’evento 'Payment Due Date Passed': nello stesso ciclo delle fatture, aggiunga la logica per creare un evento 'Payment Due Date Passed'. Si tratta di un evento calcolato. La logica deve verificare che la data di scadenza della fattura sia trascorsa, che la fattura non sia ancora stata pagata e che l’evento 'Payment Due Date Passed' non sia già stato generato per quella fattura. Per questa attività, EventTime deve corrispondere alla data di scadenza.
Generi gli eventi di recupero crediti e contestazione: elabori i dati recuperati dagli endpoint di recupero crediti e contestazioni. Per ogni nota, promessa di pagamento, azione di sollecito o record di contestazione, crei le righe corrispondenti nell’Event Log ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Assocî al record dell’evento i dettagli pertinenti, come CollectorName e DisputeReason.
Generi gli eventi di pagamento: elabori i dati dei pagamenti dal modulo di registrazione degli incassi. Crei gli eventi 'Payment Received' in base alla data di creazione del pagamento o a quella dell’estratto conto bancario, e gli eventi 'Payment Posted' in base alla data in cui il pagamento è stato applicato correttamente alla fattura.
Consolidi e formatti i dati: dopo aver elaborato tutte le origini dati e generato gli eventi, converta l’elenco di dizionari in un DataFrame pandas. In questo modo sarà più semplice ordinare i dati e convertire i tipi di dati finali. Verifichi che la colonna EventTime utilizzi un formato timestamp uniforme (YYYY-MM-DD HH:MI:SS).
Esporti in CSV: utilizzi la funzione to_csv di pandas per esportare il DataFrame finale in un file CSV. Assegni al file un nome descrittivo, ad esempio highradius_event_log.csv. Imposti il parametro index=False per evitare che l’indice del DataFrame venga scritto come colonna. Il file è ora 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 recupero crediti, contestazioni e registrazione degli incassi.
Intervallo di date: lo script Python include le variabili START_DATE e END_DATE. È fondamentale impostare un intervallo di date specifico e ragionevole, ad esempio 3-6 mesi, per limitare il volume dei dati ed evitare tempi di esecuzione eccessivi. 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. Verifichi 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 tramite i parametri limit e offset oppure un approccio basato su cursore. Come punto di partenza, è generalmente adeguata una dimensione di pagina compresa tra 100 e 500.
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 di produzione, è preferibile utilizzare un server anziché un computer locale.
Campi personalizzati: se il processo si basa su campi personalizzati in HighRadius, sarà necessario modificare lo script affinché li recuperi e li includa nell’output.

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 a iniziare?

Questo template Le fornisce le basi strutturate dei dati necessarie per ottenere informazioni approfondite sui processi di gestione del credito e recupero crediti. Inizi oggi 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 una carta di credito: può iniziare 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 per la gestione del credito e il recupero crediti

Attività di gestione del credito e recupero crediti

Guide all’estrazione

Esportazione dal modulo Reporting and Analytics di HighRadius

Passaggi

Configurazione

Query di esempio sql

Estrazione tramite script Python e API REST HighRadius

Passaggi

Configurazione

Query di esempio python

È pronto a iniziare?

Inizi a ottimizzare la gestione del credito e il recupero crediti