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

Il Suo Template dati per la gestione del credito e degli incassi

NetSuite

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

Il Suo Template dati per la gestione del credito e degli incassi

Questo Template fornisce una guida completa alla raccolta dei dati corretti per analizzare il processo di gestione del credito e degli incassi. Illustra gli attributi e le attività essenziali, insieme a indicazioni pratiche per l'estrazione, così da consentirLe di iniziare rapidamente. Seguendo queste raccomandazioni, potrà ottimizzare i dati per ottenere analisi e miglioramenti significativi del processo.

Attributi consigliati da raccogliere
Attività principali da monitorare
Indicazioni per l'estrazione da NetSuite

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

Scarica il Template

Attributi della gestione del credito e recupero crediti

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

3 Obbligatorio 5 Consigliato 13 Facoltativo

	Nome	Descrizione
	Nome dell'attività ActivityName	Il nome dell'attività aziendale che si è verificata in un determinato momento.
Descrizione Questo attributo descrive una fase o un evento specifico del processo di gestione del credito e riscossione, come 'Invoice Generated', 'Payment Received' o 'Dispute Registered'. Analizzare la sequenza e la frequenza di queste attività costituisce il nucleo del Process Mining e consente di rivelare il flusso effettivo del processo, le deviazioni e i colli di bottiglia. Perché è importante Questo attributo costituisce la struttura portante della mappa del processo e consente di visualizzare e analizzare il flusso del processo. Dove reperirlo Questo campo deriva in genere dalle modifiche di stato dei record delle transazioni, ad esempio Invoice e Customer Payment, oppure da record correlati come note di sistema, record personalizzati per le attività di riscossione o attività CRM. Esempi Fattura generataSollecito per scaduto inviatoPagamento ricevutoFattura svalutata
	Numero fattura InvoiceNumber	L'identificativo univoco di ogni fattura cliente.
Descrizione Il Numero fattura funge da identificativo principale del caso e collega in modo univoco tutte le attività relative a uno specifico credito commerciale. Consente un'analisi completa dell'intero ciclo di vita, dalla creazione della fattura e dalle successive azioni di gestione del credito fino al pagamento o alla risoluzione attraverso le attività di riscossione. In NetSuite corrisponde in genere al Transaction ID quando il tipo di transazione è 'Invoice'. Perché è importante È la chiave essenziale per tracciare il percorso della fattura dalla generazione alla chiusura, consentendo un'analisi end-to-end del processo. Dove reperirlo In genere corrisponde al campo 'Transaction ID' (ID interno: tranid) del record Invoice in NetSuite. Esempi INV0012345INV0054321INV0098765
	Ora dell'evento EventTime	Il timestamp che indica quando si è verificata l'attività.
Descrizione Questo attributo acquisisce la data e l'ora precise di ogni attività del processo. È fondamentale per tutte le analisi basate sul tempo, inclusi il calcolo dei tempi di ciclo, delle durate e dei tempi di attesa tra le fasi. In NetSuite, questo timestamp corrisponde solitamente alla data di creazione o di ultima modifica del record pertinente o della nota di sistema. Perché è importante Consente di calcolare tutte le metriche di performance legate al tempo, come i tempi di ciclo e i colli di bottiglia, fondamentali per l'analisi dell'efficienza. Dove reperirlo Proviene dai campi data di diversi record. Ad esempio, la 'Date Created' di un record Invoice per 'Invoice Generated' oppure il timestamp di una System Note per le modifiche di stato. Esempi 2023-01-15T10:00:00Z2023-02-01T14:30:00Z2023-02-15T09:05:00Z
	Data di scadenza DueDate	La data entro la quale deve essere effettuato il pagamento della fattura.
Descrizione La Due Date è la data di pagamento concordata contrattualmente. Costituisce il riferimento per determinare se un pagamento è puntuale o in ritardo. Questo attributo è essenziale per calcolare KPI come 'On-Time Payment Rate' e attivare le attività di sollecito una volta superata la scadenza. Perché è importante Funziona da principale riferimento per misurare la puntualità dei pagamenti ed è fondamentale per calcolare i giorni di ritardo e monitorare la conformità ai termini di pagamento. Dove reperirlo È il campo 'Due Date' (ID interno: duedate) del record della transazione Invoice. Esempi 2023-02-142023-03-312023-04-15
	ID cliente CustomerId	L'identificativo univoco del cliente associato alla fattura.
Descrizione Questo attributo collega una fattura a una specifica entità cliente in NetSuite. È essenziale per segmentare i dati e analizzare le performance del processo tra clienti o gruppi di clienti diversi. Ad esempio, consente di analizzare i comportamenti di pagamento o i tassi di contestazione dei clienti strategici rispetto alle piccole imprese. Perché è importante Consente un'analisi incentrata sul cliente e aiuta a individuare quali clienti pagano frequentemente in ritardo, presentano contestazioni o seguono processi non standard. Dove reperirlo È il campo 'Customer' (ID interno: entity) del record della transazione Invoice. Esempi CUST001CUST002CUST003
	Importo della fattura InvoiceAmount	Il valore monetario complessivo della fattura.
Descrizione Rappresenta l'importo totale dovuto sulla fattura. È un attributo finanziario fondamentale, utilizzato in quasi tutte le analisi, ad esempio per individuare l'impatto finanziario dei pagamenti tardivi o analizzare le svalutazioni relative a fatture di importo elevato. Fornisce il contesto necessario per stabilire le priorità delle attività di riscossione. Perché è importante Fornisce un contesto finanziario al processo e consente analisi basate sul valore monetario, come la definizione delle priorità per la riscossione delle fatture scadute di importo elevato. Dove reperirlo È il campo 'Amount (Total)' (ID interno: total) del record della transazione Invoice. Esempi 1500.00250.5012500.75
	Segmento cliente CustomerSegment	La classificazione del cliente, ad esempio in base a dimensioni, settore o area geografica.
Descrizione Customer Segment raggruppa i clienti in categorie significative, ad esempio 'Enterprise', 'SMB' e 'Public Sector'. Questo attributo è fondamentale per il Dashboard 'Collection Strategy Performance by Segment', poiché consente di confrontare l'efficacia dei diversi approcci di riscossione tra i segmenti e di adattare le strategie ai comportamenti specifici di ciascun gruppo. Perché è importante Consente un'analisi mirata per determinare se determinati problemi di processo o comportamenti di pagamento siano concentrati in specifici gruppi di clienti. Dove reperirlo Spesso si tratta di un campo personalizzato del record Customer in NetSuite. I dati devono essere collegati dal record Customer alla transazione Invoice. Esempi EnterpriseMid-MarketSMB
	Stato della fattura InvoiceStatus	Lo stato attuale della fattura nel suo ciclo di vita.
Descrizione Indica lo stato attuale della fattura, ad esempio 'Open', 'Paid In Full' o 'Overdue'. È utile per filtrare e analizzare esclusivamente le fatture attive o problematiche. Il Dashboard 'Overdue Invoices Aging and Status' utilizza questo attributo per offrire una fotografia dei crediti commerciali ancora da incassare. Perché è importante Consente di filtrare e concentrare l'analisi su fasi specifiche del ciclo di vita della fattura, come fatture aperte, scadute o contestate. Dove reperirlo Corrisponde al campo 'Status' (ID interno: status) del record della transazione Invoice. Esempi ApertoPagato per interoScaduto
	È automatizzata IsAutomated	Un indicatore che segnala se un'attività è stata eseguita automaticamente da un sistema.
Descrizione Questo attributo booleano specifica se un'attività è stata eseguita da un Workflow automatizzato o da un utente. Ad esempio, l'attività 'Overdue Reminder Sent' può essere automatizzata, mentre 'Collection Call Made' è manuale. È essenziale per il Dashboard 'Manual Activity Frequency and Impact', che quantifica il livello di automazione e individua ulteriori opportunità di automazione. Perché è importante Aiuta a quantificare il livello di automazione del processo e supporta le iniziative volte a ridurre l'impegno manuale e migliorare l'efficienza. Dove reperirlo È 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	Il 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 del pagamento. È un KPI fondamentale per la riscossione, utilizzato nel Dashboard 'Overdue Invoices Aging and Status' 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 la gravità dei ritardi di pagamento ed è una metrica chiave per i report di aging e per stabilire le priorità delle attività di riscossione. Dove reperirlo Viene calcolato durante la trasformazione dei dati: (Data corrente o Data di pagamento) - Data di scadenza. Esempi 1532090
	ID utente UserId	L'identificativo dell'utente che ha eseguito 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 riscossione. Consente di analizzare la distribuzione del carico di lavoro e le performance del team, oltre a individuare le esigenze formative. Per le attività automatizzate può corrispondere all'ID di un utente di sistema. Perché è importante Consente di analizzare le performance per utente o team, comprendere la distribuzione del carico di lavoro e individuare i punti in cui intervengono attività manuali. Dove reperirlo Proviene da campi come 'Created By', 'Modified By' o da uno specifico campo 'Owner' delle transazioni o dei record correlati, ad esempio il record Phone Call per le telefonate di riscossione. Esempi j.doea.smithSYSTEM
	Motivo della contestazione DisputeReason	Il motivo indicato dal cliente per la contestazione di una fattura.
Descrizione Quando un cliente contesta una fattura, questo attributo registra il motivo, ad esempio 'Incorrect Pricing', 'Damaged Goods' o 'Duplicate Billing'. È fondamentale per i Dashboard 'Invoice Dispute Resolution Time' e 'Invoice Write-Off Root Cause Analysis', poiché consente di comprendere perché si verificano le contestazioni e individuare schemi ricorrenti da correggere per prevenire problemi futuri. Perché è importante Aiuta a individuare le cause alla radice delle contestazioni dei clienti e fornisce gli insight necessari per migliorare i processi a monte, come l'evasione degli ordini o l'accuratezza della fatturazione. Dove reperirlo Probabilmente si tratta di un campo personalizzato del record Invoice o di un record personalizzato correlato utilizzato per monitorare i casi di contestazione. Non è un campo standard di NetSuite. Esempi Quantità errataDiscrepanza di prezzoMerce danneggiata
	Nome dell'addetto alla riscossione CollectorName	Il nome dell'addetto alla riscossione assegnato alla fattura.
Descrizione Identifica l'addetto o la risorsa responsabile della gestione di una fattura scaduta. Consente di analizzare le performance del team di riscossione e comprendere la distribuzione del carico di lavoro e l'efficacia dei singoli addetti. Supporta KPI come 'Collections Contact Success Rate'. Perché è importante Consente di misurare le performance e bilanciare il carico di lavoro del team di riscossione, collegando le attività di recupero a singole persone. Dove reperirlo Spesso si tratta di un campo personalizzato del record Customer o Invoice. Alcuni bundle NetSuite per la riscossione aggiungono 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 variazioni geografiche nei comportamenti di pagamento, nell'efficacia della riscossione e nei tassi di contestazione. Può aiutare ad adattare le strategie di riscossione a specifiche aree geografiche e a comprendere l'impatto delle condizioni economiche locali. Perché è importante Consente la segmentazione geografica del processo e può mettere in evidenza differenze regionali nei comportamenti di pagamento o nell'efficienza del processo. Dove reperirlo Proviene dai dettagli del 'Billing Address' della transazione Invoice, generalmente ereditati dal record Customer. Esempi USAGermaniaGiappone
	Pagamento effettuato puntualmente IsOnTimePayment	Indicatore che segnala se il pagamento è stato ricevuto entro o alla data di scadenza.
Descrizione Questo attributo booleano calcolato verifica se l'attività «Pagamento ricevuto» si è verificata entro o alla «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. Fornisce un risultato binario chiaro sulle prestazioni dei pagamenti. Perché è importante Fornisce una metrica binaria semplice per valutare la conformità ai termini di pagamento, rendendo facile calcolare e confrontare il Tasso di pagamenti puntuali. Dove reperirlo Viene calcolato 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 i fondi vengono ricevuti) e l'attività «Pagamento registrato» (quando il pagamento viene applicato alla fattura in NetSuite). È una metrica fondamentale per la Dashboard «Analisi del ritardo nella registrazione dei pagamenti», poiché evidenzia le inefficienze interne nell'applicazione degli incassi, che possono alterare la visibilità della liquidità. Perché è importante Evidenzia i ritardi interni nell'elaborazione e nell'applicazione degli incassi, che possono compromettere l'accuratezza della reportistica finanziaria e lo stato dei conti cliente. Dove reperirlo Viene calcolato nello strumento di Process Mining: Timestamp('Pagamento registrato') - Timestamp('Pagamento ricevuto'). Esempi 1 giorno4 ore3 giorni
	Sistema di origine SourceSystem	Il sistema dal quale sono stati estratti i dati.
Descrizione Identifica il sistema di origine dei dati degli eventi. In questa vista di 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 provenienza e la tracciabilità dei dati, aspetti importanti per la validazione e la governance dei dati, soprattutto in ambienti con più sistemi integrati. Dove reperirlo Si tratta di un valore statico ('NetSuite') aggiunto durante il processo di trasformazione dei dati. Esempi NetSuite
	Tempo del ciclo dalla fattura all'incasso InvoiceToCashCycleTime	Tempo totale dalla generazione della fattura al saldo finale.
Descrizione Questa metrica calcolata misura la durata complessiva dall'attività «Fattura generata» all'attività «Fattura saldata». Rappresenta le prestazioni end-to-end dell'intero processo di gestione del credito e degli incassi. L'analisi di questo KPI aiuta a individuare ritardi sistemici e fornisce una misura di alto livello della velocità del flusso di cassa. Perché è importante Si tratta di un KPI fondamentale, di alto livello, che misura l'efficienza complessiva dell'intero processo dalla fattura all'incasso. Dove reperirlo Calcolo a livello di caso eseguito nello strumento di Process Mining: Timestamp('Fattura saldata') - Timestamp('Fattura generata'). Esempi 32 giorni45 giorni91 giorni
	Termini di pagamento PaymentTerms	I termini di pagamento concordati con il cliente per la fattura.
Descrizione Questo attributo specifica le condizioni entro le quali il cliente deve pagare una fattura, come 'Net 30' o 'Net 60'. Costituisce la base per calcolare la Due Date della fattura ed è fondamentale per il Dashboard 'Payment Terms Compliance and Deviations', che analizza il rispetto dei termini concordati da parte dei clienti. Perché è importante Fornisce la base contrattuale per le scadenze di pagamento ed è essenziale per analizzare la conformità e individuare le deviazioni che incidono sul flusso di cassa. Dove reperirlo È il campo 'Terms' (ID interno: terms) del record della transazione Invoice. Esempi 30 giorni netti60 giorni nettiPagamento alla ricezione
	Ultimo aggiornamento dei dati LastDataUpdate	Il timestamp dell'ultimo aggiornamento dei dati dal sistema di origine.
Descrizione Questo attributo indica quando i dati relativi a questo processo sono stati estratti e aggiornati l'ultima volta nello strumento di Process Mining. Aiuta gli utenti a comprendere il livello di aggiornamento dei dati analizzati e garantisce che le decisioni si basino su informazioni attuali. Perché è importante Offre trasparenza sull'attualità dei dati e consente agli utenti di sapere quanto sia aggiornata l'analisi del processo. Dove reperirlo Questo valore viene generato e applicato al dataset al momento dell'estrazione dei dati. Esempi 2023-10-27T02:00:00Z
	Unità aziendale BusinessUnit	L'unità aziendale o la filiale associata alla transazione.
Descrizione Rappresenta l'unità aziendale, il reparto o la filiale specifica 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 parti dell'organizzazione, confrontarne le performance e individuare problemi specifici di una divisione. Perché è importante Consente di confrontare le performance del processo tra diverse unità organizzative e di evidenziare variazioni che possono richiedere approcci gestionali differenti. Dove reperirlo In NetSuite OneWorld è il campo 'Subsidiary'. In altri account può essere 'Department' o 'Class', a seconda della configurazione. Esempi Stati Uniti occidentaliServizi EMEAProdotti APAC

Obbligatorio Consigliato Facoltativo

Attività di gestione del credito e recupero crediti

Queste sono le fasi essenziali del processo e le tappe fondamentali da acquisire nel Suo Event Log per un’individuazione accurata e l’ottimizzazione del Workflow di recupero crediti.

5 Consigliato 8 Facoltativo

	Attività	Descrizione
	Fattura generata	Indica la creazione ufficiale del record della fattura nel sistema. Questo evento viene acquisito dalla data di creazione della transazione Invoice in NetSuite e costituisce il punto di partenza del ciclo di vita della fattura.
Perché è importante Questo è l'evento iniziale principale del processo Invoice-to-Cash. È essenziale per calcolare metriche chiave come i Days Sales Outstanding (DSO) e il tempo di ciclo complessivo Invoice-to-Cash. Dove reperirlo Si tratta di un evento esplicito acquisito dalla data di creazione del record della transazione Invoice in NetSuite, nella tabella Transaction, dove Type è 'Invoice'. Acquisizione Utilizzi il timestamp di creazione del record della transazione Invoice. Tipo di evento explicit
	Fattura saldata	Il completamento positivo del ciclo di vita della fattura, in cui il saldo dovuto viene azzerato tramite pagamenti e crediti applicati. Viene dedotto quando lo stato della fattura passa a 'Paid In Full'.
Perché è importante Questo è il principale evento finale positivo del processo. Costituisce il punto dati conclusivo per calcolare il tempo di ciclo end-to-end Invoice-to-Cash. Dove reperirlo Deducibile dalla modifica del campo 'Status' della transazione Invoice a 'Paid In Full'. Il timestamp può essere ricavato dalla data dell'ultimo pagamento o dell'ultima nota di credito che ha chiuso la fattura. Acquisizione Timestamp dell'ultima applicazione di pagamento che imposta lo stato su 'Paid In Full'. Tipo di evento inferred
	Fattura svalutata	Conclusione negativa del ciclo di vita della fattura, in cui il credito viene considerato inesigibile e rimosso dai crediti commerciali. L'evento viene acquisito quando alla fattura viene applicata una registrazione contabile per crediti inesigibili.
Perché è importante Questo è un punto finale critico di mancato recupero. Analizzare i percorsi che portano alle svalutazioni aiuta a individuare le debolezze nella politica del credito e nella strategia di riscossione, riducendo in ultima analisi i crediti inesigibili. Dove reperirlo Deducibile dall'applicazione di una 'Journal Entry' alla fattura, quando la registrazione contabile riguarda specificamente la svalutazione di un credito inesigibile. Può essere utilizzato anche uno stato personalizzato. Acquisizione Utilizzi la data della Journal Entry di svalutazione applicata alla fattura. Tipo di evento inferred
	Pagamento ricevuto	Questo evento indica il momento in cui viene creato un pagamento del cliente e applicato a una fattura. È una tappa fondamentale, acquisita direttamente dal record della transazione Customer Payment in NetSuite.
Perché è importante Questa attività è essenziale per calcolare il DSO e l'On-Time Payment Rate. Segnala l'incasso e costituisce una misura chiave del successo della riscossione. Dove reperirlo Acquisito 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 Utilizzi la data della transazione del record Customer Payment. Tipo di evento explicit
	Superamento della data di scadenza del pagamento	Evento calcolato che si verifica quando la data corrente supera la data di scadenza della fattura senza che questa sia stata pagata integralmente. Segnala il passaggio della fattura dallo stato 'current' a quello di 'overdue'.
Perché è importante Questo evento costituisce un attivatore fondamentale per tutte le attività di riscossione. Analizzare il periodo successivo a questo evento è essenziale per comprendere l'efficienza della riscossione e l'efficacia dei solleciti. Dove reperirlo Si tratta di un evento calcolato, derivato dal confronto tra la data corrente e il campo 'Due Date' del record della transazione Invoice. Il timestamp dell'evento corrisponde alla Due Date. Acquisizione Il timestamp corrisponde al valore del campo 'Due Date' della fattura. Tipo di evento calculated
	Contestazione registrata	Indica che un cliente ha contestato formalmente la fattura, sospendendo il normale processo di riscossione. In genere viene dedotto dalla modifica del campo di stato della fattura allo stato 'Disputed'.
Perché è importante Questo evento costituisce il punto di partenza per misurare il tempo di risoluzione delle contestazioni. Individuare le contestazioni frequenti può far emergere problemi alla base dei processi di fatturazione o vendita. Dove reperirlo Deducibile da un log di sistema o da una modifica con timestamp di un campo personalizzato 'Invoice Status' a un valore come 'Disputed' o 'In Dispute'. Acquisizione Timestamp dell'aggiornamento di un campo di stato che indica una contestazione. Tipo di evento inferred
	Contestazione risolta	Segna la risoluzione della contestazione del cliente e consente la ripresa del processo di riscossione o la chiusura della fattura. Viene dedotto quando lo stato della fattura passa da 'Disputed' a uno stato attivo.
Perché è importante Questo è il punto finale per misurare il tempo di ciclo della risoluzione delle contestazioni. Una risoluzione efficiente è fondamentale per mantenere la soddisfazione dei clienti e accelerare il flusso di cassa. Dove reperirlo Deducibile da un log di sistema o da una modifica con timestamp del campo personalizzato 'Invoice Status' da 'Disputed' a un valore come 'Open' o 'Resolved'. Acquisizione Timestamp dell'aggiornamento di un campo di stato che indica la risoluzione. Tipo di evento inferred
	Fattura inviata al cliente	Rappresenta il momento in cui la fattura viene comunicata al cliente, in genere tramite e-mail. Solitamente viene dedotto dai log di sistema che registrano le comunicazioni in uscita relative alla transazione Invoice.
Perché è importante Il monitoraggio di questa attività aiuta a individuare i ritardi tra la creazione della fattura e la notifica al cliente, che possono incidere sui tempi di pagamento. Offre visibilità sull'efficienza del processo di comunicazione della fatturazione. Dove reperirlo Deducibile dalla data di un'e-mail inviata dal record della fattura, disponibile nella sottoscheda Communication > Messages della transazione Invoice. Acquisizione Utilizzi il timestamp del record 'Message' collegato alla fattura. Tipo di evento inferred
	Nota di credito emessa	Rappresenta 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 ricorso frequente alle note di credito può indicare problemi sistemici, come errori di prezzo o problemi di spedizione. Analizzarne la frequenza aiuta a individuare le cause alla radice delle perdite di ricavi. Dove reperirlo Si tratta di un evento esplicito acquisito dalla data di creazione del record della transazione Credit Memo collegato alla fattura originale. Acquisizione Utilizzi il timestamp di creazione della transazione Credit Memo. Tipo di evento explicit
	Pagamento contabilizzato	Rappresenta la data in cui l'impatto finanziario del pagamento viene registrato ufficialmente nel General Ledger. Viene acquisita dalla data di contabilizzazione della transazione Customer Payment.
Perché è importante Il tempo tra 'Payment Received' e 'Payment Posted' evidenzia i ritardi amministrativi. Analizzare questo intervallo è importante per garantire una rendicontazione finanziaria accurata e tempestiva. Dove reperirlo Acquisito dal 'Posting Period' o dalla data della transazione relativa all'impatto sul General Ledger della transazione 'Customer Payment'. Acquisizione Utilizzi la data di contabilizzazione nel GL della transazione Customer Payment. Tipo di evento explicit
	Procedura di sollecito avviata	Rappresenta l'avvio di un processo formale di sollecito o riscossione per una fattura scaduta, che può prevedere più fasi. L'evento viene acquisito quando alla fattura viene assegnato uno specifico livello di sollecito.
Perché è importante Monitorare l'avvio del sollecito formale aiuta a misurare l'aderenza e l'efficacia delle procedure di sollecito. È una tappa fondamentale per analizzare l'influenza delle diverse strategie di sollecito sul comportamento di pagamento. Dove reperirlo Deducibile dalla data in cui il 'Dunning Level' del record della fattura o del cliente viene impostato per la prima volta su uno stato di sollecito diverso da zero o iniziale. Acquisizione Individui il timestamp della modifica del campo Dunning Level. Tipo di evento inferred
	Sollecito per scaduto inviato	Al cliente viene inviato un primo sollecito, spesso automatizzato, relativo a una fattura scaduta. Questa attività viene generalmente acquisita dalla creazione di una lettera di sollecito o da un evento di comunicazione registrato nel modulo di sollecito di NetSuite.
Perché è importante Questa attività rappresenta il primo passaggio del processo di sollecito. Analizzarne la frequenza e l'impatto sui pagamenti aiuta a valutare l'efficacia delle prime azioni di riscossione. Dove reperirlo Acquisito dalla data di creazione di un record 'Dunning Letter' associato alla fattura e generato dall'applicazione NetSuite Dunning SuiteApp. Acquisizione Utilizzi il timestamp di creazione del record Dunning Letter. Tipo di evento explicit
	Telefonata di riscossione effettuata	Attività manuale di riscossione durante la quale un addetto contatta telefonicamente il cliente. L'evento viene acquisito dai record di attività Phone Call creati dagli utenti nel modulo CRM di NetSuite.
Perché è importante Questa attività aiuta a quantificare l'impegno manuale nel processo di riscossione. Analizzarne frequenza e tasso di successo è importante per ottimizzare l'allocazione delle risorse e l'automazione. Dove reperirlo Acquisito dalla data di creazione di un record di attività 'Phone Call' in cui il record correlato è il cliente e il numero della fattura è riportato nel messaggio. Acquisizione Utilizzi il timestamp del record di attività Phone Call del CRM. Tipo di evento explicit

Consigliato Facoltativo

Guide all'estrazione

Come ottenere i dati da NetSuite

Passaggi

Acceda a NetSuite: acceda al Suo account NetSuite con un ruolo che disponga delle autorizzazioni per creare ed eseguire Saved Searches e visualizzare i record di transazione e attività richiesti, ad esempio Invoice, Customer Payment e Phone Call.
Acceda a Saved Searches: selezioni Reports > Saved Searches > All Saved Searches > New. Ripeterà questa procedura per creare diverse ricerche distinte, una per ogni tipo di evento.
Crei la ricerca di base delle fatture: inizi creando una ricerca per l'evento «Invoice Generated». Selezioni «Transaction» come tipo di ricerca. Questa ricerca acquisirà la creazione della fattura.
Definisca i criteri di ricerca: nella scheda «Criteria», imposti i seguenti filtri:
- Type è Invoice.
- 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 gli ultimi 6 mesi.
Definisca i risultati della ricerca: nella scheda «Results», aggiunga le colonne necessarie per l'Event Log. Utilizzi etichette personalizzate corrispondenti ai nomi degli attributi richiesti, ad esempio InvoiceNumber. Utilizzi formule per impostare il campo ActivityName. Le mappature dettagliate dei campi sono disponibili nella sezione delle query.
Crei le ricerche per gli altri eventi: seguendo le configurazioni indicate nella sezione delle query, crei Saved Searches separate per altre attività, come Payments, Credit Memos, Collection Calls e modifiche di stato. Potrebbero utilizzare tipi di record diversi, come «Phone Call», oppure richiedere la ricerca in «System Notes».
Esegua ed esporti le ricerche: esegua ogni Saved Search singolarmente. Dalla 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 e payment_received.csv.
Generi gli eventi «Payment Due Date Passed»: questo evento specifico non viene esportato direttamente. Deve essere calcolato dopo l'esportazione dei dati. Nello strumento di manipolazione dei dati che preferisce, come Python, Power Query o uno strumento ETL, per ogni fattura non ancora saldata completamente crei una riga con ActivityName impostato su «Payment Due Date Passed» e EventTime impostato sulla DueDate più un giorno.
Combini i file esportati: utilizzi uno strumento esterno per accodare tutti i file CSV esportati in un unico file principale. Prima di combinarli, verifichi che le intestazioni delle colonne siano identiche in tutti i file.
Formattti i dati finali: esamini il file CSV combinato. Verifichi che EventTime utilizzi un formato timestamp coerente, ad esempio YYYY-MM-DD HH:MI:SS, e che tutte le colonne richieste, InvoiceNumber, ActivityName ed EventTime, siano presenti in ogni riga.
Carichi i dati in ProcessMind: il file CSV finale e combinato è ora pronto per essere caricato come Event Log.

Configurazione

Prerequisiti: è necessario un ruolo utente con autorizzazioni per creare, modificare ed esportare Saved Searches. È inoltre necessario 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 per acquisire le modifiche dello stato e gli eventi di comunicazione quando non sono disponibili record di transazione diretti.
Filtri per intervallo di date: per garantire le prestazioni e gestire il volume dei dati, applichi sistematicamente un filtro per data, ad esempio Date Created o Last Modified Date, a tutte le ricerche salvate. Per l’analisi iniziale è consigliato un periodo di dati compreso tra 3 e 6 mesi.
Filtro Main Line: durante la ricerca nei 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 impostare il nome dell’attività per ogni ricerca, mentre Formula (Date/Time) può essere utilizzato per standardizzare i campi timestamp, se necessario.
Limiti di esportazione: tenga presente che l’esportazione CSV basata sull’interfaccia di NetSuite è generalmente limitata a 100.000 righe per ricerca. Per dataset più grandi, potrebbe essere necessario eseguire le ricerche suddividendo l’intervallo di date in blocchi più piccoli oppure utilizzare ricerche pianificate che inviino i risultati al File Cabinet.

a 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 di avere Python 3.6 o versione successiva installato sul sistema. Avrà inoltre bisogno delle credenziali per NetSuite SuiteTalk, in particolare per l'autenticazione basata su token (TBA), che include 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 richiesti, inclusi Transactions, come Invoices, Payments e Credit Memos, CRM Activities, come Phone Calls, e Customer records.
Installi le librerie Python: apra la riga di comando o il terminale e installi le librerie Python necessarie. Le librerie principali sono pandas per la manipolazione dei dati, requests e requests_oauthlib per effettuare chiamate API, oppure una libreria NetSuite dedicata. pip install pandas requests requests_oauthlib
Configuri l'autenticazione: nello script Python fornito, individui la sezione relativa alle credenziali. Inserisca in modo sicuro Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret di NetSuite nelle variabili segnaposto designate. È fortemente consigliato utilizzare variabili d'ambiente o un vault sicuro per gestire queste credenziali, anziché inserirle direttamente nel codice.
Configuri i parametri di estrazione: nello script, definisca le variabili start_date ed end_date per specificare l'intervallo temporale dell'estrazione. Può inoltre modificare il filtro subsidiary_id se desidera limitare l'estrazione a una specifica società controllata 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 API per recuperare tutti i record di ogni query.
Esegua lo script Python: esegua lo script dal terminale utilizzando il comando python your_netsuite_extraction_script.py. Lo script si connetterà a NetSuite, eseguirà la serie di query e stamperà nella console gli aggiornamenti di stato durante il recupero dei dati per ogni attività.
Combini e trasformi i dati: dopo aver recuperato i dati grezzi per ogni attività, lo script utilizza la libreria pandas per concatenare tutti i risultati singoli in un unico DataFrame. Questo DataFrame rappresenta l'Event Log.
Esamini 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 verificare completezza e accuratezza dei dati.
Prepari il caricamento: verifichi che il file CSV finale contenga le intestazioni richieste InvoiceNumber, ActivityName ed EventTime, insieme agli attributi consigliati. Il file è ora pronto per essere caricato in ProcessMind.

Configurazione

Autenticazione: lo script utilizza l'autenticazione basata su token (TBA) di NetSuite. Deve fornire Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret. 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 nello script controllano la finestra di estrazione. Per un'analisi iniziale si consiglia un periodo compreso tra 3 e 6 mesi, così da bilanciare il volume dei dati e le prestazioni.
Filtro per società controllata: la variabile subsidiary_id consente di filtrare i dati per una specifica unità aziendale. Se opera in un ambiente con un'unica società controllata, può omettere questo filtro.
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 per gestire automaticamente le risposte API paginate. page_size è impostato su 1000, il valore massimo consentito dall'API, per ridurre al minimo il numero di chiamate necessarie.
Campi personalizzati: l'estrazione di «Dispute Registered» e «Dispute Resolved» presuppone l'utilizzo dei campi personalizzati (custbody_dispute_date, custbody_dispute_resolved_date). Deve aggiornare lo script con gli ID effettivi dei campi utilizzati nella Sua istanza NetSuite.

a 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 preziose sul processo di gestione del credito e degli incassi. Inizi oggi il percorso verso un flusso di cassa più solido.

Torna alla guida al miglioramento Scarica il Template

Inizi oggi a ottimizzare la gestione del credito e dei solleciti!

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

Inizi la prova gratuita

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

Il Suo Template dati per la gestione del credito e degli incassi

Il Suo Template dati per la gestione del credito e degli incassi

Attributi della gestione del credito e recupero crediti

Attività di gestione del credito e recupero crediti

Guide all'estrazione

Esportazione dei dati da Saved Searches e report di NetSuite

Passaggi

Configurazione

a Query di esempio sql

Estrazione Python tramite i servizi Web NetSuite SuiteTalk

Passaggi

Configurazione

a Query di esempio python

Pronto a iniziare?

Inizi oggi a ottimizzare la gestione del credito e dei solleciti!

Il Suo Template dati per la gestione del credito e degli incassi

Il Suo Template dati per la gestione del credito e degli incassi

Attributi della gestione del credito e recupero crediti

Attività di gestione del credito e recupero crediti

Guide all'estrazione

Esportazione dei dati da Saved Searches e report di NetSuite

Passaggi

Configurazione

a Query di esempio sql

Estrazione Python tramite i servizi Web NetSuite SuiteTalk

Passaggi

Configurazione

a Query di esempio python

Pronto a iniziare?

Inizi oggi a ottimizzare la gestione del credito e dei solleciti!

La Sua privacy è importante