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

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

NetSuite

Attributi per la gestione del credito e il recupero crediti(21) Attività di gestione del credito e recupero crediti(13) Guide all’estrazione(2)

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

Questo template fornisce indicazioni complete sui dati da raccogliere per analizzare il processo di gestione del credito e recupero crediti. Illustra gli attributi e le attività essenziali, insieme a indicazioni pratiche per l’estrazione, così da consentirLe di iniziare rapidamente. Seguendo queste raccomandazioni, potrà preparare i dati per un’analisi e un miglioramento efficaci del processo.

Attributi consigliati da raccogliere
Attività chiave da monitorare
Indicazioni per estrarre i dati da NetSuite

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 approfondito il processo di gestione del credito e recupero crediti.

3 Obbligatorio 5 Consigliato 13 Facoltativo

	Nome	Descrizione
	Nome dell’attività ActivityName	Nome dell’attività aziendale svolta in un determinato momento.
Descrizione Questo attributo descrive una fase o un evento specifico del processo di gestione del credito e recupero crediti, come 'Fattura generata', 'Pagamento ricevuto' o 'Contestazione registrata'. Analizzare la sequenza e la frequenza di queste attività è alla base del Process Mining: consente di ricostruire il flusso effettivo del processo e di individuare scostamenti e colli di bottiglia. Perché è importante Questo attributo costituisce la struttura portante della mappa del processo e ne consente la visualizzazione e l’analisi del flusso. Dove reperirli Questo campo viene in genere ricavato dalle modifiche di stato dei record delle transazioni (ad esempio Invoice e Customer Payment) o da record correlati, come le note di sistema, i record personalizzati per le attività di recupero crediti o le attività CRM. Esempi Fattura generataPromemoria per fattura scaduta inviatoPagamento ricevutoFattura stralciata
	Numero fattura InvoiceNumber	Identificativo univoco di ogni fattura cliente.
Descrizione Il numero della fattura funge da identificativo principale del caso e collega in modo univoco tutte le attività relative a uno specifico credito. Consente di analizzare l’intero ciclo di vita, dalla creazione della fattura alle successive attività di gestione del credito, fino al pagamento o alla risoluzione tramite il recupero crediti. In NetSuite corrisponde in genere al Transaction ID quando il tipo di transazione è 'Invoice'. Perché è importante È la chiave essenziale per seguire il percorso della fattura dalla generazione al saldo e consente di analizzare il processo da un capo all’altro. Dove reperirli In genere è il campo 'Transaction ID' (ID interno: tranid) del record Invoice in NetSuite. Esempi INV0012345INV0054321INV0098765
	Ora dell’evento EventTime	Data e ora in cui si è verificata l’attività.
Descrizione Questo attributo registra la data e l’ora esatte di ogni attività del processo. È fondamentale per tutte le analisi basate sul tempo, compreso il calcolo dei tempi di ciclo, delle durate e delle attese tra una fase e l’altra. In NetSuite, questo valore corrisponde di solito alla data di creazione o di ultima modifica del record pertinente o della nota di sistema. Perché è importante Consente di calcolare tutte le metriche temporali, come i tempi di ciclo e i colli di bottiglia, fondamentali per l’analisi dell’efficienza. Dove reperirli Il dato proviene dai campi data di diversi record. Ad esempio, per l’attività 'Fattura generata' si utilizza il campo 'Date Created' del record Invoice, mentre per le modifiche di stato si usa la data e l’ora della System Note. Esempi 2023-01-15T10:00:00Z2023-02-01T14:30:00Z2023-02-15T09:05:00Z
	Data di scadenza DueDate	Data entro cui deve essere pagata la fattura.
Descrizione La data di scadenza è la data concordata contrattualmente per il pagamento. È il riferimento per stabilire se un pagamento è puntuale o in ritardo. Questo attributo è essenziale per calcolare indicatori come il tasso di puntualità dei pagamenti e per avviare le attività di sollecito una volta superata la scadenza. Perché è importante È il principale riferimento per misurare la puntualità dei pagamenti ed è fondamentale per calcolare i giorni di ritardo e monitorare il rispetto dei termini di pagamento. Dove reperirli È il campo 'Due Date' (ID interno: duedate) del record della transazione Invoice. Esempi 2023-02-142023-03-312023-04-15
	ID cliente CustomerId	Identificativo univoco del cliente associato alla fattura.
Descrizione Questo attributo collega una fattura a uno specifico cliente in NetSuite. È essenziale per segmentare i dati e analizzare le prestazioni del processo per cliente o gruppo di clienti. Ad esempio, consente di confrontare le abitudini di pagamento o il tasso di contestazioni dei clienti strategici con quelli delle piccole imprese. Perché è importante Consente un’analisi incentrata sul cliente e aiuta a individuare quelli che pagano spesso in ritardo, presentano contestazioni o seguono procedure non standard. Dove reperirli È il campo 'Customer' (ID interno: entity) del record della transazione Invoice. Esempi CUST001CUST002CUST003
	Importo della fattura InvoiceAmount	Importo monetario totale della fattura.
Descrizione Indica l’importo totale dovuto per la fattura. È un attributo finanziario fondamentale per quasi tutte le analisi, ad esempio per determinare l’impatto finanziario dei pagamenti in ritardo o analizzare gli stralci delle fatture di importo elevato. Fornisce informazioni essenziali per stabilire le priorità delle attività di recupero crediti. Perché è importante Fornisce il contesto finanziario del processo e consente analisi basate sugli importi, ad esempio per dare priorità al recupero delle fatture scadute di valore elevato. Dove reperirli È il campo 'Amount (Total)' (ID interno: total) del record della transazione Invoice. Esempi 1500.00250.5012500.75
	Segmento cliente CustomerSegment	Classificazione del cliente, ad esempio per dimensione, settore o area geografica.
Descrizione Il segmento cliente raggruppa i clienti in categorie significative, ad esempio 'Enterprise', 'PMI' o 'settore pubblico'. Questo attributo è essenziale per la Dashboard 'Efficacia delle strategie di recupero crediti per segmento', che consente di confrontare l’efficacia dei diversi approcci di recupero nei vari segmenti e di adattare le strategie alle caratteristiche di ciascun gruppo. Perché è importante Consente analisi mirate per determinare se determinati problemi di processo o comportamenti di pagamento si concentrano in specifici gruppi di clienti. Dove reperirli Spesso si tratta di un campo personalizzato del record Customer in NetSuite. I dati devono essere uniti a quelli del record della transazione Invoice. Esempi EnterpriseMercato medioSMB
	Stato della fattura InvoiceStatus	Stato corrente della fattura nel suo ciclo di vita.
Descrizione Indica lo stato corrente della fattura, ad esempio 'Open', 'Paid In Full' o 'Overdue'. È utile per filtrare e analizzare le sole fatture attive o problematiche. La Dashboard 'Anzianità e stato delle fatture scadute' utilizza questo attributo per fornire una fotografia dei crediti ancora da incassare. Perché è importante Consente di filtrare e concentrare l’analisi su specifiche fasi del ciclo di vita della fattura, ad esempio le fatture aperte, scadute o contestate. Dove reperirli Corrisponde al campo 'Status' (ID interno: status) del record della transazione Invoice. Esempi ApertaPagata per interoScaduta
	È automatizzata IsAutomated	Indica se un’attività è stata eseguita automaticamente da un sistema.
Descrizione Questo attributo booleano indica se un’attività è stata eseguita da un flusso di lavoro automatizzato o da un utente. Ad esempio, l’attività «Promemoria di scadenza inviato» può essere automatizzata, mentre «Telefonata di recupero crediti effettuata» è manuale. Il dato è essenziale per la Dashboard «Frequenza e impatto delle attività manuali», che consente di quantificare il livello di automazione e individuare ulteriori opportunità. Perché è importante Aiuta a quantificare il livello di automazione del processo e supporta le iniziative volte a ridurre il lavoro manuale e migliorare l’efficienza. Dove reperirli È un attributo derivato dal tipo di attività o dall’utente che l’ha eseguita. Ad esempio, se l’utente è un utente «SYSTEM» designato, l’attività viene contrassegnata come automatizzata. Esempi truefalse
	Giorni di ritardo DaysOverdue	Numero di giorni trascorsi dalla data di scadenza della fattura.
Descrizione Questa metrica calcolata misura il numero di giorni tra la data di scadenza della fattura e la data corrente, per le fatture aperte, oppure la data di pagamento. È un KPI fondamentale per il recupero crediti e viene utilizzato nella Dashboard «Fatture scadute: anzianità e stato» per classificare e stabilire le priorità delle attività di recupero. Un valore pari o inferiore a zero indica che la fattura non è scaduta. Perché è importante Misura direttamente l’entità dei ritardi di pagamento ed è una metrica chiave per i report sull’anzianità dei crediti e per stabilire le priorità delle attività di recupero. Dove reperirli Si calcola durante la trasformazione dei dati: (data corrente o data di pagamento) - data di scadenza. Esempi 1532090
	ID utente UserId	Identificativo dell’utente che ha svolto l’attività.
Descrizione Identifica il dipendente o l’utente di sistema responsabile di una determinata attività, come la contabilizzazione di un pagamento o una telefonata di recupero crediti. Consente di analizzare la distribuzione del carico di lavoro e le prestazioni del team, nonché di individuare le esigenze di formazione. Per le attività automatizzate, può trattarsi dell’ID di un utente di sistema. Perché è importante Consente di analizzare le prestazioni per utente o team, comprendere la distribuzione del carico di lavoro e individuare i punti in cui intervengono manualmente gli operatori. Dove reperirli Ricavato da campi come 'Created By', 'Modified By' o da un campo 'Owner' specifico delle transazioni o dei record correlati, ad esempio il record Phone Call per le telefonate di recupero crediti. Esempi j.doea.smithSYSTEM
	Motivo della contestazione DisputeReason	Motivo indicato dal cliente per contestare una fattura.
Descrizione Quando un cliente contesta una fattura, questo attributo registra il motivo, ad esempio 'Quantità errata', 'Merce danneggiata' o 'Fatturazione duplicata'. È fondamentale per le Dashboard 'Tempo di risoluzione delle contestazioni sulle fatture' e 'Analisi delle cause profonde degli stralci delle fatture', che aiutano a capire perché si verificano le contestazioni e a individuare schemi ricorrenti su cui intervenire per prevenire problemi futuri. Perché è importante Aiuta a individuare le cause profonde delle contestazioni dei clienti e fornisce indicazioni utili per migliorare i processi a monte, come l’evasione degli ordini o l’accuratezza della fatturazione. Dove reperirli Probabilmente si tratta di un campo personalizzato del record Invoice o di un record personalizzato correlato, utilizzato per tenere traccia delle contestazioni. Non è un campo standard di NetSuite. Esempi Quantità errataDiscrepanza di prezzoMerce danneggiata
	Nome dell’addetto al recupero crediti CollectorName	Nome dell’addetto al recupero crediti assegnato alla fattura.
Descrizione Identifica l’addetto o la risorsa responsabile della gestione di una fattura scaduta. Consente di analizzare le prestazioni del team di recupero crediti e di comprendere la distribuzione del carico di lavoro e l’efficacia dei singoli addetti. Supporta indicatori come il tasso di successo dei contatti per il recupero crediti. Perché è importante Consente di misurare le prestazioni e bilanciare il carico di lavoro del team di recupero crediti, collegando le attività a persone specifiche. Dove reperirli Spesso si tratta di un campo personalizzato del record Customer o Invoice. Alcuni pacchetti NetSuite per il recupero crediti includono questa funzionalità. Esempi Alice JohnsonRobert WilliamsNon assegnato
	Paese Country	Il paese dell’indirizzo di fatturazione del cliente.
Descrizione Questo attributo indica il paese associato all’indirizzo di fatturazione del cliente riportato sulla fattura. Viene utilizzato per analizzare le differenze geografiche nelle modalità di pagamento, nell’efficacia delle attività di recupero crediti e nel numero di contestazioni. L’analisi può aiutare ad adattare le strategie di recupero alle diverse aree geografiche e a comprendere l’impatto delle condizioni economiche locali. Perché è importante Consente di segmentare geograficamente il processo, mettendo in evidenza le differenze regionali nelle modalità di pagamento o nell’efficienza del processo. Dove reperirli Il dato proviene dai dettagli «Billing Address» della transazione Invoice, generalmente ereditati dalla scheda Customer. Esempi USAGermaniaGiappone
	Pagamento puntuale IsOnTimePayment	Indica se il pagamento è stato ricevuto entro la data di scadenza.
Descrizione Questo attributo booleano calcolato verifica se l’attività «Pagamento ricevuto» è avvenuta entro la «Data di scadenza» della fattura. Semplifica il calcolo del KPI «Tasso di pagamenti puntuali» e consente di filtrare e analizzare facilmente i pagamenti puntuali e quelli in ritardo, fornendo un esito chiaro sulle prestazioni di pagamento. Perché è importante Fornisce una metrica binaria semplice per valutare il rispetto dei termini di pagamento e facilita il calcolo e il confronto del tasso di pagamenti puntuali. Dove reperirli Si calcola durante la trasformazione dei dati: TRUE se (data di pagamento <= data di scadenza), altrimenti FALSE. Esempi truefalse
	Ritardo nella registrazione del pagamento PaymentPostingLag	Tempo che intercorre tra la ricezione di un pagamento e la sua registrazione nel sistema.
Descrizione Questa durata calcolata misura il ritardo tra l’attività «Pagamento ricevuto», quando vengono ricevuti i fondi, e «Pagamento registrato», quando il pagamento viene associato alla fattura in NetSuite. È una metrica chiave per la Dashboard «Analisi dei ritardi nella registrazione dei pagamenti», che mette in evidenza le inefficienze interne nell’associazione degli incassi, capaci di compromettere la visibilità sui flussi di cassa. Perché è importante Mette in luce i ritardi interni nell’associazione degli incassi, che possono influire sull’accuratezza della rendicontazione finanziaria e sullo stato dei conti dei clienti. Dove reperirli Si calcola nello strumento di Process Mining: Timestamp('Payment Posted') - Timestamp('Payment Received'). Esempi 1 giorno4 ore3 giorni
	Sistema di origine SourceSystem	Sistema da cui sono stati estratti i dati.
Descrizione Identifica il sistema di origine dei dati degli eventi. In questa vista del processo il valore sarà sempre 'NetSuite', ma si tratta di un attributo obbligatorio per la governance dei dati e per distinguere le fonti in un ambiente con più sistemi. Perché è importante Garantisce la tracciabilità e la provenienza dei dati, aspetti importanti per la convalida e la governance, soprattutto negli ambienti con più sistemi integrati. Dove reperirli È un valore statico ('NetSuite') aggiunto durante la trasformazione dei dati. Esempi NetSuite
	Tempo di ciclo dalla fattura all’incasso InvoiceToCashCycleTime	Tempo totale dalla creazione della fattura al saldo finale.
Descrizione Questa metrica calcolata misura il tempo totale tra l’attività «Fattura generata» e l’attività «Fattura saldata». Rappresenta i risultati complessivi dell’intero processo di gestione del credito e recupero crediti. L’analisi di questo KPI aiuta a individuare ritardi sistemici e fornisce una misura complessiva della velocità dei flussi di cassa. Perché è importante È un KPI fondamentale e di alto livello, che misura l’efficienza complessiva dell’intero processo dalla fattura all’incasso. Dove reperirli Si tratta di un calcolo a livello di caso eseguito nello strumento di Process Mining: Timestamp('Invoice Settled') - Timestamp('Invoice Generated'). Esempi 32 giorni45 giorni91 giorni
	Termini di pagamento PaymentTerms	Termini di pagamento concordati con il cliente per la fattura.
Descrizione Questo attributo specifica le condizioni in base alle quali il cliente deve pagare una fattura, ad esempio 'Net 30' o 'Net 60'. Serve a calcolare la data di scadenza della fattura ed è fondamentale per la Dashboard 'Rispetto dei termini di pagamento e scostamenti', che analizza se i clienti rispettano gli accordi. Perché è importante Fornisce il riferimento contrattuale per le scadenze di pagamento ed è essenziale per analizzare il rispetto degli accordi e individuare gli scostamenti che incidono sul flusso di cassa. Dove reperirli È il campo 'Terms' (ID interno: terms) del record della transazione Invoice. Esempi Net 30Net 60Pagamento alla ricezione
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’ultimo aggiornamento dei dati dal sistema di origine.
Descrizione Questo attributo indica quando i dati del processo sono stati estratti e aggiornati per l’ultima volta nello strumento di Process Mining. Aiuta a capire quanto siano aggiornati i dati analizzati e consente di prendere decisioni sulla base di informazioni attuali. Perché è importante Rende trasparente l’aggiornamento dei dati e permette di sapere quanto siano recenti le analisi del processo. Dove reperirli Questo valore viene generato e aggiunto al set di dati al momento dell’estrazione. Esempi 2023-10-27T02:00:00Z
	Unità aziendale BusinessUnit	L’unità aziendale o la filiale associata alla transazione.
Descrizione Indica l’unità aziendale, il reparto o la filiale che ha emesso la fattura. Negli account NetSuite OneWorld corrisponde in genere al campo «Subsidiary». Consente di segmentare l’analisi del processo per le diverse aree dell’organizzazione, confrontarne i risultati e individuare problemi specifici di una divisione. Perché è importante Consente di confrontare i risultati del processo tra diverse unità organizzative, mettendo in luce variazioni che potrebbero richiedere approcci gestionali differenti. Dove reperirli In NetSuite OneWorld corrisponde al campo «Subsidiary». Negli altri account, a seconda della configurazione, può essere «Department» o «Class». Esempi Stati Uniti occidentaliServizi EMEAProdotti APAC

Obbligatorio Consigliato Facoltativo

Attività di gestione del credito e recupero crediti

Questi sono i passaggi e le tappe fondamentali da registrare nell’Event Log per individuare con precisione il flusso di lavoro di recupero crediti e ottimizzarlo.

5 Consigliato 8 Facoltativo

	Attività	Descrizione
	Fattura generata	Indica la creazione ufficiale del record della fattura nel sistema. L’evento viene rilevato dalla data di creazione della transazione Invoice in NetSuite e segna l’inizio del ciclo di vita della fattura.
Perché è importante È l’evento di inizio principale del processo dalla fattura all’incasso. È essenziale per calcolare metriche chiave come i giorni medi di incasso (DSO) e il tempo di ciclo complessivo dalla fattura all’incasso. Dove reperirli È un evento esplicito, rilevato dalla data di creazione del record della transazione Invoice in NetSuite (tabella Transaction, con Type impostato su 'Invoice'). Acquisizione Utilizzare la data e l’ora di creazione del record della transazione della fattura. Tipo di evento explicit
	Fattura saldata	Il completamento del ciclo di vita della fattura, quando il saldo dovuto viene azzerato tramite pagamenti e crediti applicati. Si deduce quando lo stato della fattura passa a 'Paid In Full'.
Perché è importante È il principale evento finale positivo del processo e l’ultimo dato necessario per calcolare il tempo di ciclo complessivo dalla fattura all’incasso. Dove reperirli Si deduce quando il campo 'Status' della transazione Invoice passa a 'Paid In Full'. La data e l’ora possono corrispondere alla data dell’ultimo pagamento o dell’ultima nota di credito che ha chiuso la fattura. Acquisizione Data e ora dell’ultima applicazione di pagamento che imposta lo stato su 'Paid In Full'. Tipo di evento inferred
	Fattura stralciata	Esito negativo del ciclo di vita della fattura: il credito viene considerato inesigibile e rimosso dai crediti verso clienti. L’evento viene rilevato quando alla fattura viene applicata una registrazione contabile per crediti inesigibili.
Perché è importante È un punto finale critico che segnala un esito negativo. Analizzare i percorsi che portano agli stralci aiuta a individuare le debolezze nelle politiche di credito e nelle strategie di recupero, riducendo così i crediti inesigibili. Dove reperirli Si deduce dall’applicazione alla fattura di una registrazione 'Journal Entry' specifica per lo stralcio di un credito inesigibile. È possibile utilizzare anche uno stato personalizzato. Acquisizione Utilizzare la data della registrazione Journal Entry per lo stralcio applicata alla fattura. Tipo di evento inferred
	Pagamento ricevuto	Questo evento indica la creazione di un pagamento del cliente e la sua applicazione a una fattura. È una tappa fondamentale, rilevata direttamente dal record della transazione Customer Payment in NetSuite.
Perché è importante Questa attività è essenziale per calcolare il DSO e il tasso di puntualità dei pagamenti. Indica l’incasso e rappresenta una misura chiave del successo del recupero crediti. Dove reperirli Rilevato dalla data di creazione del record della transazione 'Customer Payment'. La sottolista 'Apply' di questo record collega il pagamento a una o più fatture. Acquisizione Utilizzare la data della transazione Customer Payment. Tipo di evento explicit
	Scadenza del pagamento superata	Evento calcolato che si verifica quando la data corrente supera la scadenza della fattura senza che questa sia stata pagata per intero. Segna il passaggio della fattura dallo stato 'corrente' a quello 'scaduto'.
Perché è importante Questo evento è un fattore determinante per tutte le attività di recupero crediti. Analizzare il tempo che intercorre dopo questo evento è fondamentale per comprendere l’efficienza del recupero crediti e l’efficacia dei solleciti. Dove reperirli È un evento calcolato, ricavato confrontando la data corrente con il campo 'Due Date' del record della transazione Invoice. La data e l’ora dell’evento corrispondono alla data di scadenza. Acquisizione La data e l’ora corrispondono al valore del campo 'Due Date' della fattura. Tipo di evento calculated
	Contestazione registrata	Indica che il cliente ha contestato formalmente la fattura, sospendendo la procedura standard di recupero crediti. In genere, si deduce dal cambiamento del campo di stato della fattura in 'Disputed'.
Perché è importante Questo evento segna l’inizio della misurazione del tempo di risoluzione della contestazione. Individuare le contestazioni frequenti può far emergere problemi nei processi di fatturazione o vendita. Dove reperirli Si deduce da un registro di sistema o da una modifica con data e ora del campo personalizzato 'Invoice Status' a un valore come 'Disputed' o 'In Dispute'. Acquisizione Data e ora in cui un campo di stato viene aggiornato per indicare una contestazione. Tipo di evento inferred
	Contestazione risolta	Segna la risoluzione della contestazione del cliente, consentendo la ripresa del processo di recupero crediti o il pagamento della fattura. Si deduce quando lo stato della fattura passa da 'Disputed' a uno stato attivo.
Perché è importante È il punto finale per misurare il tempo di ciclo di risoluzione delle contestazioni. Risolverle in modo efficiente è fondamentale per mantenere la soddisfazione dei clienti e accelerare il flusso di cassa. Dove reperirli Si deduce da un registro di sistema o da una modifica con data e ora del campo personalizzato 'Invoice Status' da 'Disputed' a un valore come 'Open' o 'Resolved'. Acquisizione Data e ora in cui un campo di stato viene aggiornato per indicare la risoluzione. Tipo di evento inferred
	Fattura inviata al cliente	Indica il momento in cui la fattura viene comunicata al cliente, in genere tramite e-mail. Spesso si deduce dai registri di sistema che tracciano le comunicazioni in uscita relative alla transazione della fattura.
Perché è importante Il monitoraggio di questa attività aiuta a individuare i ritardi tra la creazione della fattura e la notifica al cliente, che possono influire sui tempi di pagamento. Fornisce indicazioni sull’efficienza del processo di comunicazione delle fatture. Dove reperirli Si deduce dalla data di un’e-mail inviata dal record della fattura, nella scheda secondaria Communication > Messages della transazione Invoice. Acquisizione Utilizzare la data e l’ora del record 'Message' collegato alla fattura. Tipo di evento inferred
	Nota di credito emessa	Indica la creazione di una nota di credito applicata alla fattura, spesso per correggere un errore o nell’ambito della risoluzione di una contestazione. In NetSuite si tratta di una transazione esplicita.
Perché è importante Un numero elevato di note di credito può indicare problemi sistemici, come errori di prezzo o problemi di spedizione. Analizzarne la frequenza aiuta a individuare le cause profonde delle perdite di ricavi. Dove reperirli È un evento esplicito, rilevato dalla data di creazione del record della transazione Credit Memo collegato alla fattura originale. Acquisizione Utilizzare la data e l’ora di creazione della transazione Credit Memo. Tipo di evento explicit
	Pagamento contabilizzato	Indica la data in cui l’impatto finanziario del pagamento viene registrato ufficialmente nella contabilità generale. L’evento viene rilevato dalla data di contabilizzazione della transazione Customer Payment.
Perché è importante Il tempo che intercorre tra 'Pagamento ricevuto' e 'Pagamento contabilizzato' mette in evidenza i ritardi amministrativi. Analizzare questo intervallo è importante per garantire una rendicontazione finanziaria accurata e tempestiva. Dove reperirli Rilevato dal campo 'Posting Period' o dalla data della transazione nell’impatto sulla contabilità generale della transazione 'Customer Payment'. Acquisizione Utilizzare la data di contabilizzazione nella contabilità generale della transazione Customer Payment. Tipo di evento explicit
	Procedura di sollecito avviata	Indica l’avvio di una procedura formale di sollecito o recupero crediti per una fattura scaduta, che può prevedere più passaggi. L’evento viene rilevato quando alla fattura viene assegnato un livello di sollecito specifico.
Perché è importante Monitorare l’avvio dei solleciti formali aiuta a misurare il rispetto della procedura e la sua efficacia. È una tappa fondamentale per analizzare l’influenza delle diverse strategie di sollecito sulle abitudini di pagamento. Dove reperirli Si deduce dalla data in cui il campo 'Dunning Level' del record della fattura o del cliente viene impostato per la prima volta su un valore diverso da zero o sul livello iniziale di sollecito. Acquisizione Individuare la data e l’ora in cui cambia il campo Dunning Level. Tipo di evento inferred
	Promemoria per fattura scaduta inviato	Al cliente viene inviato un primo promemoria, spesso automatico, relativo a una fattura scaduta. In genere, l’attività viene rilevata dalla creazione di una lettera di sollecito o da un evento di comunicazione registrato nel modulo di sollecito di NetSuite.
Perché è importante Questa attività è il primo passaggio della procedura di sollecito. Analizzarne la frequenza e l’impatto sui pagamenti aiuta a valutare l’efficacia delle prime azioni di recupero. Dove reperirli Rilevato dalla data di creazione di un record 'Dunning Letter' associato alla fattura e generato dall’applicazione NetSuite Dunning SuiteApp. Acquisizione Utilizzare la data e l’ora di creazione del record Dunning Letter. Tipo di evento explicit
	Telefonata di recupero crediti effettuata	Attività manuale di recupero crediti in cui un addetto contatta il cliente per telefono. L’evento viene rilevato dai record Phone Call creati dagli utenti nel modulo CRM di NetSuite.
Perché è importante Questa attività aiuta a quantificare il lavoro manuale svolto nel processo di recupero crediti. Analizzarne la frequenza e il tasso di successo è importante per ottimizzare l’allocazione delle risorse e l’automazione. Dove reperirli Rilevato dalla data di creazione di un record di attività 'Phone Call' associato al cliente, nel cui messaggio è indicato il numero della fattura. Acquisizione Utilizzare la data e l’ora del record dell’attività Phone Call nel CRM. Tipo di evento explicit

Consigliato Facoltativo

Guide all’estrazione

Come estrarre i dati da NetSuite

Passaggi

Acceda a NetSuite: acceda al Suo account NetSuite con un ruolo che disponga delle autorizzazioni per creare ed eseguire ricerche salvate e visualizzare i record di transazioni e attività necessari, ad esempio Fattura, Pagamento cliente e Telefonata.
Apra le ricerche salvate: vada a Reports > Saved Searches > All Saved Searches > New. Ripeta la procedura per creare diverse ricerche, una per ogni tipo di evento.
Crei la ricerca di base per le fatture: inizi creando una ricerca per l’evento «Fattura emessa». Selezioni «Transazione» come tipo di ricerca. Questa ricerca acquisirà la creazione della fattura.
Definisca i criteri di ricerca: nella scheda «Criteria», imposti i seguenti filtri:
- Tipo è Fattura.
- Main Line è true. In questo modo otterrà un record per fattura, anziché un record per ogni riga.
- Date Created rientra nel periodo di analisi desiderato, ad esempio negli ultimi 6 mesi.
Definisca i risultati della ricerca: nella scheda «Results», aggiunga le colonne necessarie per l’Event Log. Utilizzi etichette personalizzate che corrispondano ai nomi degli attributi richiesti, ad esempio InvoiceNumber. Imposti il campo ActivityName tramite formule. La sezione delle query contiene la mappatura dettagliata dei campi.
Crei le ricerche per gli altri eventi: seguendo le configurazioni indicate nella sezione delle query, crei ricerche salvate separate per altre attività, come pagamenti, note di credito, telefonate di recupero crediti e cambi di stato. Potrebbero essere necessari tipi di record diversi, come «Phone Call», oppure una ricerca in «System Notes».
Esegua ed esporti le ricerche: esegua separatamente ogni ricerca salvata. Nella pagina dei risultati, faccia clic sull’icona «Export - CSV» per scaricare i dati. Assegni a ogni file un nome descrittivo, ad esempio invoice_generated.csv o payment_received.csv.
Generi gli eventi «Data di scadenza del pagamento superata»: questo evento specifico non può essere esportato direttamente e deve essere calcolato dopo l’esportazione dei dati. Nello strumento di elaborazione dati che preferisce, ad esempio Python, Power Query o uno strumento ETL, crei una riga per ogni fattura non ancora interamente pagata, impostando ActivityName su «Data di scadenza del pagamento superata» e EventTime sulla data DueDate più un giorno.
Unisca i file esportati: utilizzi uno strumento esterno per accodare tutti i file CSV esportati in un unico file principale. Prima di unirli, verifichi che le intestazioni delle colonne siano identiche.
Formatti i dati finali: riveda il file CSV unificato. Verifichi che EventTime utilizzi un formato di data e ora coerente, ad esempio YYYY-MM-DD HH:MI:SS, e che ogni riga contenga tutte le colonne richieste (InvoiceNumber, ActivityName, EventTime).
Carichi i dati in ProcessMind: il file CSV finale, con tutti i dati unificati, è pronto per essere caricato come Event Log.

Configurazione

Prerequisiti: è necessario un ruolo utente con autorizzazioni per creare, modificare ed esportare le Saved Searches. Occorre poter accedere ai seguenti tipi di record: Transazione (per fatture, pagamenti e note di credito), Phone Call (o altri record di attività CRM) e System Notes.
Tipi di record: i principali tipi di record utilizzati in queste ricerche sono Transazione e Phone Call. Il record System Note viene utilizzato anche per acquisire le modifiche di stato e gli eventi di comunicazione quando non sono disponibili record di transazione diretti.
Filtro per intervallo di date: per garantire prestazioni adeguate e gestire il volume dei dati, applichi sempre un filtro per data, ad esempio Date Created o Last Modified Date, a tutte le ricerche salvate. Per un’analisi iniziale si consiglia di utilizzare dati relativi a un periodo da 3 a 6 mesi.
Filtro Main Line: quando cerca record di transazione, utilizzi il criterio Main Line is true per isolare le informazioni a livello di intestazione. In questo modo evita di duplicare gli eventi per ogni riga di una fattura o di un pagamento.
Utilizzo delle formule: le formule NetSuite sono essenziali per creare la colonna standardizzata ActivityName. I campi Formula (Text) consentono di inserire il nome dell’attività per ogni ricerca, mentre Formula (Date/Time) può essere utilizzato, se necessario, per uniformare i campi di data e ora.
Limiti di esportazione: tenga presente che l’esportazione CSV dall’interfaccia di NetSuite è in genere limitata a 100.000 righe per ricerca. Per set di dati più grandi, potrebbe essere necessario eseguire le ricerche suddividendole in intervalli di date più brevi oppure utilizzare ricerche pianificate che inviano i risultati al File Cabinet.

Query di esempio sql

/*
This configuration outlines the setup for multiple NetSuite Saved Searches. 
Each search is designed to extract a specific activity for the event log.
Create one Saved Search in the NetSuite UI for each block defined below.
*/

// Saved Search 1: Invoice Generated
{
  "SavedSearchName": "ProcessMind - Invoice Generated",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Generated'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 2: Invoice Sent to Customer
{
  "SavedSearchName": "ProcessMind - Invoice Sent",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "E-mailed"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Sent to Customer'"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Note: 'Payment Due Date Passed' is a calculated event, generated post-export.

// Saved Search 3: Overdue Reminder Sent & Dunning Procedure Initiated
{
  "SavedSearchName": "ProcessMind - Dunning Events",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "[Your Dunning Status Field]"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} = '[Your First Dunning Level]' THEN 'Dunning Procedure Initiated' ELSE 'Overdue Reminder Sent' END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 4: Collection Call Made
{
  "SavedSearchName": "ProcessMind - Collection Calls",
  "RecordType": "Phone Call",
  "Criteria": [
    {"Field": "Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Collection Call Made'"},
    {"Column": "EventTime", "Field": "Completed Date"},
    {"Column": "InvoiceNumber", "Field": "Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Company : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Company : Category"},
    {"Column": "InvoiceAmount", "Field": "Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Transaction : Status"}
  ]
}

// Saved Search 5: Dispute Registered & Resolved
{
  "SavedSearchName": "ProcessMind - Dispute Status",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "Status"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} LIKE '%Disputed%' THEN 'Dispute Registered' WHEN {systemnotes.oldvalue} LIKE '%Disputed%' THEN 'Dispute Resolved' ELSE NULL END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 6: Credit Memo Issued
{
  "SavedSearchName": "ProcessMind - Credit Memos",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Credit Memo"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Applied To Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Credit Memo Issued'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 7: Payment Received & Posted
{
  "SavedSearchName": "ProcessMind - Payments",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Customer Payment"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    // For 'Payment Received'
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Received'"},
    {"Column": "EventTime", "Field": "Date Created"},
    // For 'Payment Posted'
    // {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Posted'"},
    // {"Column": "EventTime", "Field": "[Your GL Posting Date Field]"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 8: Invoice Settled
{
  "SavedSearchName": "ProcessMind - Invoice Settled",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Status", "Operator": "anyof", "Value": "Paid In Full"},
    {"Field": "Date Closed", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Settled'"},
    {"Column": "EventTime", "Field": "Date Closed"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 9: Invoice Written Off
{
  "SavedSearchName": "ProcessMind - Invoice Written Off",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Journal Entry"},
    {"Field": "Main Line", "Operator": "is", "Value": "false"},
    {"Field": "Account", "Operator": "is", "Value": "[Your Bad Debt Expense Account]"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Written Off'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Created From : Document Number"},
    {"Column": "CustomerId", "Field": "Created From : Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Created From : Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Created From : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Created From : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Created From : Status"}
  ]
}

Passaggi

Prerequisiti: verifichi che sul sistema sia installato Python 3.6 o versione successiva. Le serviranno anche le credenziali NetSuite SuiteTalk per Token Based Authentication (TBA): Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret. Il ruolo NetSuite associato deve disporre delle autorizzazioni per accedere a tutti i record necessari, inclusi Transaction (fatture, pagamenti e note di credito), attività CRM (telefonate) e record dei clienti.
Installi le librerie Python: apra la riga di comando o il terminale e installi le librerie Python necessarie. Le principali sono pandas per la manipolazione dei dati e requests e requests_oauthlib per le chiamate API; in alternativa, può utilizzare una libreria NetSuite dedicata. pip install pandas requests requests_oauthlib
Configuri l’autenticazione: nello script Python fornito, individui la sezione dedicata alle credenziali. Inserisca in modo sicuro Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret di NetSuite nelle variabili segnaposto indicate. È consigliabile utilizzare variabili d’ambiente o un archivio sicuro per gestire queste credenziali, anziché inserirle direttamente nel codice.
Configuri i parametri di estrazione: nello script, definisca le variabili start_date e end_date per specificare l’intervallo temporale dei dati da estrarre. Può anche modificare il filtro subsidiary_id per limitare l’estrazione a una specifica filiale NetSuite.
Comprenda la logica dello script: lo script è strutturato per interrogare separatamente ciascuna delle 13 attività richieste. Ogni query è un’istruzione SuiteQL distinta inviata all’endpoint REST API di NetSuite. Lo script gestisce automaticamente la paginazione dell’API per recuperare tutti i record di ciascuna query.
Esegua lo script Python: avvii lo script dal terminale con il comando python your_netsuite_extraction_script.py. Lo script si collegherà a NetSuite, eseguirà le query e mostrerà nella console gli aggiornamenti sullo stato del recupero dei dati per ciascuna attività.
Combini e trasformi i dati: dopo aver recuperato i dati grezzi di ciascuna attività, lo script utilizza la libreria pandas per concatenare i singoli risultati in un unico DataFrame. Questo DataFrame rappresenta l’Event Log.
Riveda e salvi l’Event Log: lo script salverà il DataFrame finale in un file CSV denominato netsuite_collections_event_log.csv. Apra il file per controllare che i dati siano completi e corretti.
Prepari il file per il caricamento: verifichi che il file CSV finale contenga le intestazioni richieste: InvoiceNumber, ActivityName e EventTime, oltre agli eventuali attributi consigliati. Il file è pronto per essere caricato in ProcessMind.

Configurazione

Autenticazione: lo script utilizza l’autenticazione basata su token (TBA) di NetSuite. Dovrà fornire l’ID account, la chiave consumer, il segreto consumer, l’ID token e il segreto token. Il ruolo associato al token deve disporre dell’accesso in lettura ai record Transaction, Customer, Phone Call e Message.
Intervallo di date: le variabili start_date ed end_date dello script definiscono il periodo di estrazione. Per l’analisi iniziale si consiglia un intervallo di 3-6 mesi, così da bilanciare il volume di dati e le prestazioni.
Filtro per filiale: è inclusa una variabile subsidiary_id per filtrare i dati di una specifica unità aziendale. Se opera in un ambiente con una sola filiale, può ometterla.
Endpoint API: lo script utilizza l’endpoint REST API SuiteQL di NetSuite. Verifichi che sia abilitato per il Suo account (/services/rest/query/v1/suiteql).
Gestione della paginazione: lo script include una funzione che gestisce automaticamente le risposte API suddivise in pagine. Il valore di page_size è impostato su 1000, il massimo consentito dall’API, per ridurre al minimo il numero di chiamate necessarie.
Campi personalizzati: l’estrazione degli eventi 'Dispute Registered' e 'Dispute Resolved' presuppone l’utilizzo dei campi personalizzati custbody_dispute_date e custbody_dispute_resolved_date. Aggiorni lo script con gli ID effettivi dei campi utilizzati nella Sua istanza NetSuite.

Query di esempio python

import pandas as pd
import requests
from requests_oauthlib import OAuth1
import json
import os
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Best practice: Use environment variables instead of hardcoding credentials.
NS_ACCOUNT = os.getenv(class="hl-string">'NS_ACCOUNT', class="hl-string">'[Your NetSuite Account ID]')
NS_CONSUMER_KEY = os.getenv(class="hl-string">'NS_CONSUMER_KEY', class="hl-string">'[Your Consumer Key]')
NS_CONSUMER_SECRET = os.getenv(class="hl-string">'NS_CONSUMER_SECRET', class="hl-string">'[Your Consumer Secret]')
NS_TOKEN_ID = os.getenv(class="hl-string">'NS_TOKEN_ID', class="hl-string">'[Your Token ID]')
NS_TOKEN_SECRET = os.getenv(class="hl-string">'NS_TOKEN_SECRET', class="hl-string">'[Your Token Secret]')

class=class="hl-string">"hl-comment"># The base URL for the SuiteQL API endpoint
BASE_URL = fclass="hl-string">"https://{NS_ACCOUNT.replace('_', '-')}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'
SUBSIDIARY_ID = class="hl-string">'[Your Subsidiary ID]' class=class="hl-string">"hl-comment"># Optional: filter by subsidiary

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query and handles pagination."""
    all_results = []
    offset = 0
    limit = 1000

    oauth = OAuth1(
        client_key=NS_CONSUMER_KEY,
        client_secret=NS_CONSUMER_SECRET,
        resource_owner_key=NS_TOKEN_ID,
        resource_owner_secret=NS_TOKEN_SECRET,
        realm=NS_ACCOUNT,
        signature_method=class="hl-string">'HMAC-SHA256'
    )

    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(BASE_URL, headers=headers, data=payload, auth=oauth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            data = response.json()
            
            if not data.get(class="hl-string">'items'):
                break

            all_results.extend(data[class="hl-string">'items'])
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            print(fclass="hl-string">"Response body: {response.text if 'response' in locals() else 'No response'}")
            return None

    return all_results

def main():
    class="hl-string">"""Main function to orchestrate the data extraction."""
    all_events = []
    
    class=class="hl-string">"hl-comment"># Common WHERE clause for filtering by date and subsidiary
    common_filter = fclass="hl-string">"WHERE T.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD') AND T.subsidiary = {SUBSIDIARY_ID}"

    class=class="hl-string">"hl-comment"># --- Define SuiteQL Queries for Each Activity ---
    queries = {
        class="hl-string">'Invoice Generated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Generated' AS ActivityName,
                TO_CHAR(T.createdDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.createdDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Sent to Customer': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Sent to Customer' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND M.emailed = 'T' AND M.messageDate IS NOT NULL
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Payment Due Date Passed': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Payment Due Date Passed' AS ActivityName,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD"T"23:59:59"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status NOT IN ('CustInvc:B', 'CustInvc:A') -- Not Paid In Full or Pending Approval
                AND T.dueDate < CURRENT_DATE
                AND T.dueDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Overdue Reminder Sent': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Overdue Reminder Sent' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND (M.subject LIKE '%Overdue%' OR M.subject LIKE '%Reminder%')
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dunning Procedure Initiated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dunning Procedure Initiated' AS ActivityName,
                TO_CHAR(SL.systemNoteDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
                INNER JOIN SystemNote AS SL ON T.id = SL.recordId
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND SL.field = 'custbody_dunning_level' AND SL.oldValue IS NULL -- Assumes a custom dunning level field
                AND SL.systemNoteDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Collection Call Made': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Collection Call Made' AS ActivityName,
                TO_CHAR(PC.completedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                PhoneCall AS PC
                INNER JOIN Transaction AS T ON PC.transaction = T.id
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND PC.title LIKE '%Collection%'
                AND PC.completedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dispute Registered': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Registered' AS ActivityName,
                TO_CHAR(T.custbody_dispute_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_date IS NOT NULL -- Assumes a custom dispute date field
                AND T.custbody_dispute_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Dispute Resolved': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Resolved' AS ActivityName,
                TO_CHAR(T.custbody_dispute_resolved_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_resolved_date IS NOT NULL -- Assumes a custom dispute resolved date field
                AND T.custbody_dispute_resolved_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Credit Memo Issued': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Credit Memo Issued' AS ActivityName,
                TO_CHAR(CM.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                CM.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS CM
                INNER JOIN TransactionLine AS CML ON CM.id = CML.transaction
                INNER JOIN Transaction AS AppliedTo ON CML.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON CM.entity = C.id
            WHERE
                CM.type = 'CustCred' AND CM.voided = 'F' AND CM.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND CM.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Received': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Received' AS ActivityName,
                TO_CHAR(P.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND P.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Posted': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Posted' AS ActivityName,
                TO_CHAR(P.postingdate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc' AND P.posting = 'T'
                AND P.postingdate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Invoice Settled': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Settled' AS ActivityName,
                TO_CHAR(T.lastModifiedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status = 'CustInvc:B' -- Paid In Full
                AND T.lastModifiedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Written Off': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Invoice Written Off' AS ActivityName,
                TO_CHAR(JE.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                JE.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS JE
                INNER JOIN TransactionLine AS JEL ON JE.id = JEL.transaction
                INNER JOIN Transaction AS AppliedTo ON JEL.entity = AppliedTo.entity -- A best-effort link via customer
                INNER JOIN Customer AS C ON JE.entity = C.id
            WHERE
                JE.type = 'Journal' AND JE.voided = 'F' AND JE.subsidiary = {SUBSIDIARY_ID}
                AND JEL.account = [Your Bad Debt Expense Account ID] -- Must configure your specific bad debt account
                AND AppliedTo.type = 'CustInvc'
                AND JE.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
                AND (JEL.memo LIKE '%' || AppliedTo.tranid || '%' OR JE.memo LIKE '%' || AppliedTo.tranid || '%') -- Best-effort link by checking memo field for invoice number
        """
    }

    for activity, query in queries.items():
        print(fclass="hl-string">"Fetching data for: {activity}...")
        results = execute_suiteql(query)
        if results:
            all_events.extend(results)
            print(fclass="hl-string">"  ...found {len(results)} events.")
        else:
            print(fclass="hl-string">"  ...no events found or an error occurred.")

    if not all_events:
        print(class="hl-string">"No data extracted. Exiting.")
        return

    class=class="hl-string">"hl-comment"># Convert to pandas DataFrame
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Data Cleaning and Formatting
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'])
    df.rename(columns=lambda c: class="hl-string">''.join(c.split()).capitalize(), inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'netsuite_collections_event_log.csv'
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"\nEvent log successfully saved to {output_file}")

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

È pronto a iniziare?

Utilizzi questo template per semplificare la preparazione dei dati e ottenere informazioni utili sul processo di gestione del credito e recupero crediti. Inizi oggi a migliorare i flussi di cassa.

Torna alla guida al miglioramento

Scarica il template

Inizi oggi a ottimizzare la gestione del credito e il recupero crediti.

Individui le inefficienze, riduca del 30% il tempo di ciclo e migliori rapidamente i flussi di cassa.

Inizi la prova gratuita

Non è richiesta la carta di credito; la configurazione richiede pochi minuti.

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

Il Suo Template di 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 dei dati da ricerche salvate e report di NetSuite

Passaggi

Configurazione

Query di esempio sql

Estrazione con Python tramite i servizi Web NetSuite SuiteTalk

Passaggi

Configurazione

Query di esempio python

È pronto a iniziare?

Inizi oggi a ottimizzare la gestione del credito e il recupero crediti.