> Miglioramento continuo dei processi > Crediti verso clienti > NetSuite > Template dei dati

Il Suo Template dei dati sui crediti commerciali

NetSuite

Attributi dei crediti verso clienti (22) Attività dei crediti verso clienti (13) Guide all'estrazione (3)

Il Suo Template dei dati sui crediti commerciali

Questo Template fornisce una struttura completa per mappare il ciclo di fatturazione e recupero crediti in NetSuite. Descrive gli Attributi essenziali e le attività di processo necessari per creare un Event Log di alta qualità, assicurando la visibilità indispensabile per ottimizzare il flusso di cassa. Seguendo questa guida, potrà semplificare la preparazione dei dati e accelerare il percorso verso la riduzione dei giorni di incasso dei crediti commerciali.

Attributi essenziali di NetSuite per un'analisi approfondita
Milestone standardizzate per il monitoraggio delle attività dei crediti commerciali
Indicazioni strategiche per l'estrazione dei dati dai sistemi NetSuite

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

Scarica il Template

Attributi dei crediti verso clienti

La tabella seguente elenca i campi dati e gli attributi dimensionali consigliati, necessari per ottenere una visione completa dei cicli di vita delle fatture NetSuite.

5 Obbligatorio 7 Consigliato 10 Facoltativo

	Nome	Descrizione
	Attività Activity	L’evento o l’azione specifica eseguita sulla fattura.
Descrizione Questo attributo rappresenta il nome della fase del processo, ad esempio 'Invoice Created', 'Payment Applied' o 'Dispute Opened'. In NetSuite, viene generalmente ricavato dal campo `type` della transazione per gli eventi di creazione oppure dalla tabella `SystemNote` per le modifiche di stato e gli aggiornamenti. È centrale nel Process Mining, poiché definisce i nodi della mappa di processo. Analizzando la sequenza di queste attività, gli analisti possono individuare colli di bottiglia, cicli, come la gestione ripetuta di una contestazione, e deviazioni dal percorso standard. Perché è importante Definisce le fasi del Workflow e consente di costruire il grafo del processo. Dove reperirlo Derivato da Transaction 'type' o da SystemNote 'field'/'value' Esempi Fattura creataPagamento ricevutoNota di credito emessaContestazione aperta
	Numero di fattura TranId	Numero di riferimento univoco assegnato alla fattura in NetSuite.
Descrizione Questo attributo funge da identificativo principale del caso per il processo di contabilità clienti. In NetSuite, il campo `tranid` contiene generalmente il numero del documento, ad esempio INV-10023, visibile agli utenti e ai clienti. Collega tutti gli eventi successivi, come pagamenti, contestazioni e note di credito, a una specifica obbligazione finanziaria. Nell’analisi, questo identificativo viene utilizzato per raggruppare i singoli eventi in un unico caso di processo. Consente di visualizzare il ciclo order-to-cash dall’inizio alla fine ed è essenziale per unire i dati provenienti da diverse tabelle NetSuite, come `Transazione`, `TransactionLine` e `SystemNote`. Perché è importante È la chiave fondamentale per monitorare il ciclo di vita di un credito commerciale e calcolare i tempi di attraversamento. Dove reperirlo Tabella Transaction, campo 'tranid' Esempi INV-2023-001INV-998822CM-4022JE-10023
	Timestamp dell’evento DateCreated	La data e l’ora esatte in cui si è verificata l’attività.
Descrizione Questo attributo registra il momento preciso in cui si è verificato un evento. Per la creazione della fattura, corrisponde al campo `datecreated` della tabella Transaction. Per gli aggiornamenti successivi, corrisponde al timestamp presente nelle tabelle `SystemNote` o `Message`. I timestamp accurati sono fondamentali per calcolare i tempi di attraversamento, come il tempo medio del ciclo Invoice-to-Cash e il tempo di evasione della fattura. Consentono di ordinare correttamente gli eventi e di individuare i ritardi tra specifiche fasi del processo. Perché è importante È essenziale per ordinare gli eventi e calcolare le metriche di durata tra le fasi del processo. Dove reperirlo Transaction 'datecreated' o SystemNote 'date' Esempi 2023-10-15T08:30:00Z2023-10-15T14:45:22Z2023-11-01T09:00:00Z
	Sistema di origine SourceSystem	Il sistema di riferimento dal quale sono stati estratti i dati.
Descrizione Questo attributo identifica l’origine dei dati, che in questo contesto è 'NetSuite'. Negli ambienti con più sistemi, in cui i dati di Accounts Receivable possono essere uniti a quelli di un CRM o di un sistema bancario esterno, questo campo garantisce la tracciabilità. Consente agli analisti di filtrare o segmentare la vista del processo in base alla fonte dei dati quando vengono analizzati contemporaneamente più ERP. In genere è un valore statico aggiunto durante il processo di estrazione e trasformazione. Perché è importante Fornisce la provenienza dei dati e il contesto nelle implementazioni di Process Mining che coinvolgono più sistemi. Dove reperirlo Valore statico 'NetSuite' Esempi NetSuiteNetSuite ERPNetSuite OneWorld
	Ultimo aggiornamento dei dati LastDataUpdate	Il timestamp dell’estrazione o dell’ultimo aggiornamento dei dati.
Descrizione Questo attributo indica quando è stata acquisita da NetSuite l’istantanea dei dati. Viene utilizzato per determinare l’aggiornamento dell’analisi e calcolare l’anzianità delle pratiche aperte rispetto alla data dell’analisi. Nei Dashboard, aiuta a comprendere se si stanno esaminando dati in tempo reale o un’estrazione storica. Funge da riferimento per calcolare la durata corrente delle pratiche aperte relative a fatture non ancora saldate. Perché è importante Garantisce trasparenza sull’aggiornamento dei dati e contribuisce a calcolare le durate correnti delle pratiche aperte. Dove reperirlo Ora del sistema al momento dell’estrazione Esempi 2023-12-01T00:00:00Z2023-12-02T12:00:00Z
	Commerciale SalesRep	Il commerciale associato alla fattura.
Descrizione Questo attributo identifica il commerciale responsabile dell’account o della transazione. In NetSuite, corrisponde spesso al campo `salesrep` del record della transazione. Viene utilizzato per correlare i problemi di fatturazione o le note di credito a specifici commerciali. Ad esempio, il Dashboard Credit Memo and Revenue Leakage lo utilizza per verificare se determinati commerciali presentano tassi più elevati di rettifiche successive alla fatturazione, indicando possibili problemi di qualità nelle fasi a monte del processo di vendita. Perché è importante Collega i problemi a valle di Accounts Receivable ai responsabili del processo di vendita a monte. Dove reperirlo Tabella Transaction, campo 'salesrep' Esempi John SmithSarah ConnorKyle Reese
	Data di scadenza DueDate	La data entro la quale è previsto il pagamento in base ai termini concordati.
Descrizione Questo attributo contiene la data di scadenza prevista per la fattura, presente nel campo `duedate` di NetSuite. Costituisce il riferimento per determinare se un pagamento è puntuale o in ritardo. È la variabile principale per calcolare i giorni medi oltre i termini e individuare i rischi di riscossione degli importi elevati. Il confronto tra questa data e la `DateCreated` dell’evento di pagamento mostra l’entità dei ritardi e contribuisce a misurare il rispetto dei termini di credito. Perché è importante È il riferimento per tutti i calcoli relativi all’anzianità, agli insoluti e alla Conformità. Dove reperirlo Tabella Transaction, campo 'duedate' Esempi 2023-11-152023-12-012024-01-30
	Importo della fattura TotalAmount	Il valore finanziario complessivo della fattura.
Descrizione Questo attributo rappresenta l’importo totale della fattura, generalmente presente nel campo `foreignTotal` o `total` della tabella Transaction di NetSuite. Rappresenta il valore da riscuotere dal cliente. Questa metrica viene utilizzata per analizzare il flusso del valore nel processo di Accounts Receivable, stabilire le priorità nella riscossione degli importi elevati e calcolare KPI come il valore dell’arretrato delle contestazioni. Consente di filtrare le pratiche per fascia di valore, concentrando gli interventi di ottimizzazione sulle transazioni a maggiore impatto. Perché è importante È fondamentale per quantificare l’impatto finanziario delle inefficienze di processo e stabilire le priorità di riscossione. Dove reperirlo Tabella Transaction, campo 'foreignTotal' o 'total' Esempi 1500.00250.5010000.00
	Nome del cliente Entity	Il nome del cliente o dell’entità associata alla fattura.
Descrizione Questo attributo identifica il cliente responsabile del pagamento della fattura. In NetSuite, si collega alla tabella `Entity`, ovvero all’anagrafica del cliente. È fondamentale per tutte le analisi incentrate sul cliente. Gli analisti utilizzano questo campo per segmentare le prestazioni in base al cliente e individuare quelli che pagano frequentemente in ritardo, generano contestazioni o si discostano dai termini di pagamento standard. Supporta i Dashboard Credit Terms Compliance Monitor e Collection Agent Throughput. Perché è importante Consente di segmentare le prestazioni del processo in base al comportamento e al profilo di rischio del cliente. Dove reperirlo Tabella Transaction, campo 'entity' (collegamento alla tabella Entity/Customer) Esempi Acme CorpGlobex CorporationSoylent Corp
	Reparto Department	Il reparto interno responsabile della transazione.
Descrizione Questo attributo corrisponde al segmento `department` di NetSuite e indica quale area funzionale, ad esempio Sales, Services o IT, ha generato la fattura. Consente di analizzare trasversalmente le prestazioni di Accounts Receivable. Segmentando i dati per reparto, gli analisti possono individuare le aree operative soggette a cicli di fatturazione più lenti o a tassi di contestazione più elevati, favorendo interventi di miglioramento mirati. Perché è importante Identifica i responsabili interni del processo e le differenze di efficienza nella fatturazione. Dove reperirlo Tabella Transaction, campo 'department' Esempi Servizi professionaliVendite di softwareEvasione hardware
	Stato della fattura Status	Lo stato corrente della fattura nel sistema.
Descrizione Questo attributo riflette lo stato della transazione in NetSuite, ad esempio 'Open', 'Paid In Full' o 'Pending Approval'. In genere deriva dal campo `status` o `statusRef`. Mentre l’attributo Activity registra la cronologia degli eventi, questo attributo fornisce lo stato corrente. È essenziale per filtrare il Dashboard High Value Collection Risk e visualizzare solo gli elementi attualmente aperti e scaduti. Perché è importante Fornisce una visibilità immediata sulle pratiche chiuse e su quelle che richiedono un intervento. Dove reperirlo Tabella Transaction, campo 'status' Esempi Pagato per interoApertoIn attesa di approvazione
	Unità aziendale Subsidiary	La filiale o l’unità aziendale a cui appartiene la fattura.
Descrizione Negli ambienti NetSuite OneWorld, questo attributo identifica la specifica entità giuridica o filiale che ha emesso la fattura. Consente di confrontare le prestazioni di diverse filiali o divisioni aziendali. Supporta il Dashboard Invoice Dispatch Efficiency, consentendo agli utenti di analizzare in dettaglio specifiche unità aziendali. Aiuta a stabilire se i problemi di processo sono sistemici e riguardano l’intera organizzazione oppure se sono circoscritti a determinate unità operative. Perché è importante È fondamentale per confrontare le prestazioni di diverse entità organizzative. Dove reperirlo Tabella Transaction, campo 'subsidiary' Esempi Stati Uniti occidentaliOperazioni EMEAVendite APAC
	Addetto alla riscossione CollectionAgent	L’utente responsabile delle attività di riscossione relative a questa fattura.
Descrizione Questo attributo identifica il dipendente incaricato di gestire le attività di riscossione relative alla fattura. Può coincidere con il commerciale oppure con uno specialista dedicato di Accounts Receivable; spesso è presente in un campo personalizzato o viene ricavato dall’utente che registra le attività 'Payment Reminder'. Questo attributo alimenta il Dashboard Collection Agent Throughput, consentendo ai responsabili di confrontare le prestazioni del team di riscossione e individuare esigenze formative o squilibri nei carichi di lavoro. Perché è importante Consente di valutare le prestazioni dei singoli membri del team di riscossione. Dove reperirlo SystemNotes 'name' nelle attività di riscossione o Custom Field Esempi Agent SmithSpecialista della fatturazione ATeam recupero crediti 1
	Area geografica Location	La località o l’area geografica associata alla transazione.
Descrizione In NetSuite, il campo `location` rappresenta spesso un magazzino, un ufficio o un’area geografica. Questo attributo associa tale campo a un concetto regionale ai fini dell’analisi. Viene utilizzato nel Dashboard DSO Performance Overview per individuare differenze regionali nei comportamenti di pagamento. Aiuta a stabilire se i problemi di riscossione sono globali o circoscritti a specifici territori. Perché è importante Supporta la segmentazione geografica delle prestazioni di Accounts Receivable. Dove reperirlo Tabella Transaction, campo 'location' Esempi Magazzino Nord AmericaUfficio di LondraSingapore
	Categoria prodotto Class	La categoria o la classe dei beni o servizi venduti.
Descrizione Questo attributo corrisponde al segmento `class` di NetSuite. Classifica il flusso dei ricavi, ad esempio Hardware o Consulting. Comprendere il mix di prodotti è fondamentale per l’analisi. Consente di analizzare il Dashboard 'Credit Memo and Revenue Leakage' per verificare se determinate linee di prodotto sono più soggette di altre a resi o errori di fatturazione. Perché è importante Segmenta le prestazioni del processo in base al tipo di prodotto o servizio venduto. Dove reperirlo Tabella Transaction, campo 'class' Esempi Ricavi da licenzeServizi di consulenzaHardware
	Codice valuta Currency	La valuta nella quale è stata emessa la fattura.
Descrizione Questo attributo specifica il codice valuta ISO, ad esempio USD o EUR, della transazione ed è presente nel campo `currency` di NetSuite. È necessario per gestire correttamente gli ambienti con più valute. Sebbene sia spesso un campo di supporto, è fondamentale quando si aggrega `TotalAmount`, per evitare di sommare in modo errato valute diverse senza effettuare la conversione. Fornisce inoltre il contesto per interpretare le differenze regionali nelle prestazioni. Perché è importante È essenziale per aggregare correttamente i dati finanziari nelle organizzazioni globali. Dove reperirlo Tabella Transaction, campo 'currency' Esempi USDEURGBP
	Data promessa di pagamento PromiseDate	La data entro la quale il cliente ha promesso di effettuare il pagamento.
Descrizione Questo attributo registra la data in cui il cliente si è impegnato a pagare una fattura scaduta, generalmente durante un’attività di riscossione. In NetSuite, viene normalmente memorizzato nel record 'Phone Call' o in un campo personalizzato del corpo della transazione. Questa data è essenziale per il Dashboard Promise to Pay Compliance. Confrontando la data promessa con la data effettiva del pagamento, l’organizzazione può misurare l’affidabilità degli impegni assunti dai clienti e l’efficacia delle attività di riscossione. Perché è importante Misura l’affidabilità degli impegni dei clienti e l’efficacia della riscossione. Dove reperirlo Record Task/Phone Call o Custom Field Esempi 2023-11-202023-12-05
	È contestata IsDisputed	Un indicatore che segnala se la fattura è attualmente contestata o lo è stata in passato.
Descrizione Questo attributo booleano indica se la fattura è stata coinvolta in un processo di contestazione. Deriva dalla presenza di attività relative a contestazioni o da uno specifico indicatore di stato nel record della fattura. Funge da filtro fondamentale per il Dashboard Dispute Lifecycle Analysis e consente di distinguere le fatture problematiche da quelle regolari nel calcolo del First-Pass Collection Rate. Perché è importante Distingue le pratiche complesse da quelle che seguono il percorso standard. Dove reperirlo Calcolato in base alla presenza dell’attività 'Dispute Opened' Esempi truefalse
	Giorni di ritardo DaysOverdue	Il numero di giorni trascorsi dalla data di scadenza di una fattura aperta.
Descrizione È un attributo calcolato che rappresenta la differenza tra `DueDate` e la data corrente dell’analisi, oppure la data del pagamento se la pratica è chiusa. Fornisce una metrica continua per l’analisi dell’anzianità. È il principale indicatore utilizzato per le fasce di anzianità, ad esempio 30-60 e 60-90, del Dashboard High Value Collection Risk. Consente di individuare immediatamente i ritardi più critici nel sistema. Perché è importante È una metrica standard per valutare la gravità dei ritardi di pagamento. Dove reperirlo Calcolato: (Data corrente - DueDate) Esempi 150-5
	Motivo della contestazione DisputeReason	Il codice o la descrizione del motivo per cui una fattura è contestata.
Descrizione Questo attributo registra il motivo specifico per cui un cliente ha rifiutato il pagamento o richiesto una correzione. In NetSuite, corrisponde spesso a un campo personalizzato o a uno specifico record 'Case' collegato alla fattura. È fondamentale per il Dashboard Dispute Lifecycle Analysis. Raggruppare i dati per motivo della contestazione aiuta a individuare le cause principali, come 'Pricing Error', 'Damaged Goods' o 'Missing PO', che richiedono correzioni sistemiche a monte per prevenire future perdite di ricavi. Perché è importante Individua le cause principali dei mancati pagamenti e delle attività amministrative ripetitive. Dove reperirlo Support Case collegato o Custom Transaction Body Field Esempi Prezzo erratoMerce non ricevutaErrore fiscale
	Nota della fattura Memo	Note o descrizioni associate all’intestazione della fattura.
Descrizione Questo attributo contiene la descrizione in testo libero o la nota inserita nella fattura, presente nel campo `memo`. Spesso include annotazioni manuali relative a modalità di gestione particolari o ad accordi con il cliente. L’analisi testuale di questo campo può far emergere motivi non strutturati di ritardi o contestazioni che i campi strutturati non rilevano. Aggiunge un contesto qualitativo ai dati quantitativi del processo. Perché è importante Fornisce contesto e dati qualitativi sulla transazione. Dove reperirlo Tabella Transaction, campo 'memo' Esempi Commissione per il servizio di ottobreCorrezione della fattura n. 1002Applicate condizioni di pagamento speciali
	Termini di pagamento Terms	Le condizioni di pagamento concordate per la fattura.
Descrizione Questo attributo specifica i termini di pagamento assegnati alla fattura, ad esempio 'Net 30' o 'Due on Receipt'. È presente nel campo `terms` del record Transaction. Questi dati vengono utilizzati per calcolare la data di pagamento prevista e analizzare se i clienti con termini più flessibili pagano con maggiore regolarità rispetto a quelli soggetti a termini più rigidi. Contribuiscono alla revisione delle politiche di credito e alla definizione del riferimento per il KPI Average Days Beyond Terms. Perché è importante Definisce il comportamento previsto e lo SLA del ciclo di pagamento del cliente. Dove reperirlo Tabella Transaction, campo 'terms' Esempi 30 giorni netti60 giorni nettiPagamento alla ricezione2% 10, 30 giorni netti

Obbligatorio Consigliato Facoltativo

Attività dei crediti verso clienti

Questi sono i passaggi fondamentali del processo e le tappe transazionali da acquisire nel Suo Event Log, per modellare con precisione il flusso di recupero crediti.

6 Consigliato 7 Facoltativo

	Attività	Descrizione
	Fattura approvata	Passaggio dello stato della fattura da Pending Approval a Open. L’evento viene acquisito monitorando le System Notes o i log dello storico del Workflow associati alla fattura.
Perché è importante Indica il tempo di elaborazione interno prima dell’emissione della fattura al cliente. I ritardi in questa fase aumentano la durata complessiva del ciclo senza creare valore per il cliente. Dove reperirlo System Notes: filtrare il campo 'status' quando cambia da 'Pending Approval' a 'Open'. Acquisizione Confrontare il campo di stato prima e dopo Tipo di evento inferred
	Fattura creata	Creazione iniziale del record della fattura nel sistema. L’evento viene acquisito dalla tabella Transaction quando il tipo di record è Invoice.
Perché è importante Segna l’inizio del ciclo accounts receivable e stabilisce la base per i calcoli dello scaduto. È essenziale per calcolare il tempo del ciclo Invoice-to-Cash. Dove reperirlo Tabella Transaction: campo 'trandate' o 'datecreated' per i record di tipo 'CustInvc'. Acquisizione Registrato all’esecuzione della transazione Invoice Tipo di evento explicit
	Fattura inviata	Invio della fattura al cliente tramite e-mail, posta o fax. L’evento viene acquisito esaminando i record Message collegati alla specifica transazione Invoice.
Perché è importante È fondamentale per il KPI Invoice Issuance Lead Time. Individuare i ritardi in questa fase rivela i colli di bottiglia amministrativi che impediscono una riscossione puntuale. Dove reperirlo Tabella Messages: eseguire il join sull’ID della transazione quando 'authoremail' è interno e 'recipientemail' è esterno. Acquisizione Registrato all’esecuzione dell’e-mail della transazione Tipo di evento explicit
	Fattura riconciliata	Modifica finale dello stato della fattura a 'Paid In Full'. Questo rappresenta lo stato finale del processo per i casi conclusi con successo.
Perché è importante Necessario per calcolare l’Average Invoice-to-Cash Cycle Time. Distingue gli elementi aperti da quelli chiusi nelle varianti di processo. Dove reperirlo System Notes: modifica dello stato del record Invoice a 'Paid In Full'. Acquisizione Confrontare il campo di stato prima e dopo Tipo di evento inferred
	Nota di credito emessa	Creazione di una transazione Credit Memo applicata alla fattura. Riduce il saldo aperto e indica spesso un reso o un errore di fatturazione.
Perché è importante Visualizza la Revenue Leakage. La frequente emissione di note di credito suggerisce problemi sistemici nei processi di vendita o di evasione. Dove reperirlo Tabella Transaction: record di tipo 'CustCred' applicato all’ID della fattura tramite 'appliedtotransaction'. Acquisizione Registrato all’esecuzione della transazione Credit Memo Tipo di evento explicit
	Pagamento completo ricevuto	Applicazione di un Customer Payment che riduce a zero il saldo della fattura. Questo evento segna la conclusione effettiva dell’attività di riscossione.
Perché è importante È il timestamp principale per i calcoli del DSO e dell’Average Days Beyond Terms. Rappresenta l’effettiva realizzazione del ricavo. Dove reperirlo Tabella Transaction: tipo 'CustPymt' applicato alla fattura quando lo 'status' risultante della fattura diventa 'Paid In Full'. Acquisizione Registrato all’esecuzione della transazione Payment Tipo di evento explicit
	Contestazione aperta	Avvio di una contestazione relativa alla fattura, spesso dedotto da un Support Case collegato o da uno stato personalizzato specifico. Questo evento interrompe il normale flusso di riscossione.
Perché è importante È fondamentale per la Dashboard Dispute Lifecycle Analysis. Volumi elevati in questa fase indicano problemi di qualità a monte nell’evasione o nella fatturazione. Dove reperirlo Record Support Case: eseguire il join con Transaction quando la categoria è 'Billing Dispute', oppure rilevare il cambio di stato della Transaction a 'Disputed'. Acquisizione Confrontare il campo di stato o la creazione del record collegato Tipo di evento inferred
	Contestazione risolta	Conclusione di una contestazione, con ritorno della fattura a uno stato riscuotibile o emissione di un credito. L’evento viene acquisito quando lo stato del Support Case collegato passa a Closed.
Perché è importante È necessario per calcolare l’Average Dispute Resolution Time. Tempi di risoluzione lunghi incidono negativamente sul DSO e sulla soddisfazione dei clienti. Dove reperirlo Record Support Case: campo 'dateclosed' per i casi collegati alla fattura. Acquisizione Confrontare il campo di stato prima e dopo Tipo di evento inferred
	Crediti inesigibili stornati	Rimozione del saldo della fattura tramite una Journal Entry o uno specifico tipo di Credit Memo per importi inesigibili. Rappresenta un esito negativo del processo di riscossione.
Perché è importante Distingue i ricavi non incassati dalle riscossioni concluse nell’analisi. È importante per comprendere la reale efficienza della riscossione. Dove reperirlo Journal Entry o Credit Memo: filtrare in base a specifici conti GL, come Bad Debt Expense, collegati alla fattura. Acquisizione Derivato dall’utilizzo del conto GL Tipo di evento inferred
	Estratto conto bancario associato	Riconciliazione della transazione di pagamento con il flusso dell’estratto conto bancario. L’evento viene acquisito tramite la cronologia di 'Match Bank Data' o della riconciliazione.
Perché è importante Monitora l’Automated Bank Clearing Rate. I ritardi in questa fase rendono meno chiara la reale posizione di cassa e indicano ostacoli manuali nelle attività di back office. Dove reperirlo Stato della transazione: verificare se lo stato della transazione Payment cambia in 'Deposited' o viene contrassegnato come Reconciled. Acquisizione Confrontare il campo di stato prima e dopo Tipo di evento inferred
	Pagamento parziale registrato	Applicazione di un Customer Payment che riduce il saldo della fattura senza azzerarlo completamente. L’evento viene acquisito dalla tabella Transaction Line.
Perché è importante Supporta l’analisi Partial Payment Process Flow. Individua flussi di cassa frammentati e clienti con difficoltà di liquidità. Dove reperirlo Tabella Transaction: tipo 'CustPymt' applicato alla fattura quando 'amountremaining' > 0 sulla fattura. Acquisizione Registrato all’esecuzione della transazione Payment Tipo di evento explicit
	Promessa di pagamento ricevuta	Record che indica l’impegno del cliente a pagare entro una determinata data. Viene generalmente acquisito nelle User Notes o in un bundle specializzato per la gestione della riscossione.
Perché è importante Monitora il KPI Promise to Pay Compliance. Aiuta a distinguere i clienti collaborativi da quelli che richiedono un’escalation. Dove reperirlo Record Note: analisi del testo per 'PTP' o 'Promise', oppure campi specifici di una Collections SuiteApp. Acquisizione Derivato dall’analisi testuale delle note Tipo di evento inferred
	Sollecito di pagamento inviato	E-mail o lettera di riscossione generata e inviata al cliente in relazione a un pagamento scaduto. L’evento viene acquisito tramite i log del modulo Dunning Letters o i record Message collegati alla fattura.
Perché è importante Misura lo sforzo necessario per incassare la liquidità e l’efficacia delle strategie di sollecito. È essenziale per la Dashboard Collection Reminder Effectiveness. Dove reperirlo Record Message o Dunning Bundle Log: verificare oggetti specifici, ad esempio 'Reminder' o 'Overdue'. Acquisizione Derivato dai modelli dell’oggetto dei messaggi Tipo di evento inferred

Consigliato Facoltativo

Guide all'estrazione

Come ottenere i Suoi dati da NetSuite

Passaggi

Prerequisiti: verifichi che la funzionalità 'SuiteAnalytics Workbook' sia abilitata e che disponga delle autorizzazioni per accedere a Transazioni, Note di sistema, Messaggi e Casi di supporto.
Accedere a SuiteAnalytics: acceda a Analytics > Workbooks > Nuovo Workbook.
Selezionare il record radice: scelga Transazione come tipo di record radice. Questo record funge da riferimento per i dati finanziari.
Strategia del dataset: poiché è necessario estrarre attività diverse, come approvazioni, messaggi e contestazioni, in un unico Event Log 'as-is', un singolo dataset unito nell’interfaccia produrrebbe righe estese, con un prodotto cartesiano. L’approccio consigliato per gli utenti esperti consiste nell’utilizzare la funzionalità SuiteQL alla base di SuiteAnalytics. Può eseguire la query fornita di seguito tramite l’interfaccia 'SuiteAnalytics Connect' (ODBC/JDBC) oppure tramite un bundle 'SuiteQL Query Tool' nell’interfaccia.
Eseguire la query: copi lo script SuiteQL completo fornito nella sezione 'Query'. Sostituisca il segnaposto {{LastDataUpdate}} con il timestamp dell’estrazione e {{StartDate}} con la data di inizio dell’analisi, ad esempio '2023-01-01'.
Verificare le colonne: verifichi che tutte le colonne proiettate, tra cui TranId, Activity e DateCreated, siano presenti nel set di risultati.
Esportare i dati: esegua la query ed esporti i risultati in CSV.
Formattare: apra il CSV. Verifichi che la colonna 'DateCreated' sia formattata come YYYY-MM-DD HH:MM:SS e che 'TotalAmount' non contenga simboli di valuta, ma solo valori numerici.
Convalidare: controlli che un singolo ID fattura (TranId) compaia più volte con valori diversi di 'Activity', ad esempio Created, Approved e Payment Received.
Importare: carichi il CSV in ProcessMind. Associ 'TranId' a ID del caso, 'Activity' a Nome dell’attività e 'DateCreated' a Timestamp.

Configurazione

SuiteAnalytics Connect: deve essere abilitato in Enable Features > Analytics per eseguire esternamente query UNION complesse.
Autorizzazioni: l'utente deve disporre dell'accesso 'View' a Transactions, System Notes, Support Cases e Messages.
Filtro per data: si consiglia un intervallo mobile di 12 mesi. Le estrazioni storiche di grandi dimensioni potrebbero andare in timeout; verifichi i limiti di righe, poiché NetSuite spesso limita i risultati a 5.000-100.000 righe a seconda dell'interfaccia. Per lo storico completo si consiglia ODBC.
Contesto della subsidiary: se l'account utilizza OneWorld, si assicuri che l'utente abbia accesso a tutte le subsidiary interessate oppure filtri per t.subsidiary.
Prestazioni: la tabella SystemNote è molto grande. Per garantire prestazioni adeguate, è obbligatorio filtrare per recordtype e date.

a Query di esempio sql

/* SuiteQL Query for Accounts Receivable Process Mining */
/* Combined Event Log Extraction */

/* 1. Invoice Created */
SELECT
  t.tranid AS TranId,
  'Invoice Created' AS Activity,
  TO_CHAR(t.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  emp.entityid AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
  LEFT JOIN Employee emp ON t.salesrep = emp.id
WHERE
  t.type = 'CustInvc'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 2. Invoice Approved (via System Notes) */
SELECT
  t.tranid AS TranId,
  'Invoice Approved' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND sn.recordtypeid = -30 /* Transaction Record Type */
  AND sn.standardfield = 'STATUS'
  AND sn.oldvalue = 'Pending Approval'
  AND sn.newvalue = 'Open'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 3. Invoice Dispatched / 4. Payment Reminder (via Messages) */
SELECT
  t.tranid AS TranId,
  CASE 
    WHEN m.subject LIKE '%Reminder%' THEN 'Payment Reminder Sent'
    ELSE 'Invoice Dispatched'
  END AS Activity,
  TO_CHAR(m.messagedate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN Message m ON m.transaction = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND (m.subject LIKE '%Invoice%' OR m.subject LIKE '%Reminder%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 5. Dispute Opened / 6. Dispute Resolved (via Support Cases) */
SELECT
  t.tranid AS TranId,
  CASE 
    WHEN sc.status = 'Closed' THEN 'Dispute Resolved'
    ELSE 'Dispute Case Opened'
  END AS Activity,
  TO_CHAR(sc.createddate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN SupportCase sc ON sc.custevent_linked_invoice = t.id /* Adjust custom field name */
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 7. Promise to Pay (via Notes) */
SELECT
  t.tranid AS TranId,
  'Promise to Pay Received' AS Activity,
  TO_CHAR(n.notedate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN Note n ON n.transaction = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND (n.title LIKE '%Promise%' OR n.note LIKE '%Promise%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 8. Credit Memo Issued */
/* Logic: Find Credit Memos applied to the Invoice */
SELECT
  inv.tranid AS TranId,
  'Credit Memo Issued' AS Activity,
  TO_CHAR(cm.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  cm.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  inv.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  inv.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction inv
  JOIN NextTransactionLineLink ntll ON ntll.previousdoc = inv.id
  JOIN Transaction cm ON ntll.nextdoc = cm.id
  LEFT JOIN Customer c ON inv.entity = c.id
  LEFT JOIN Subsidiary s ON inv.subsidiary = s.id
WHERE
  inv.type = 'CustInvc'
  AND cm.type = 'CustCred'
  AND inv.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 9. Partial Payment / 10. Full Payment Received */
SELECT
  inv.tranid AS TranId,
  CASE
    WHEN (inv.foreigntotal - py.foreigntotal) <= 0 THEN 'Full Payment Received'
    ELSE 'Partial Payment Posted'
  END AS Activity,
  TO_CHAR(py.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  py.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  inv.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  inv.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction inv
  JOIN NextTransactionLineLink ntll ON ntll.previousdoc = inv.id
  JOIN Transaction py ON ntll.nextdoc = py.id
  LEFT JOIN Customer c ON inv.entity = c.id
  LEFT JOIN Subsidiary s ON inv.subsidiary = s.id
WHERE
  inv.type = 'CustInvc'
  AND py.type = 'CustPymt'
  AND inv.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 11. Bad Debt Written Off */
SELECT
  t.tranid AS TranId,
  'Bad Debt Written Off' AS Activity,
  TO_CHAR(je.trandate, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  t.status AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN NextTransactionLineLink ntll ON ntll.previousdoc = t.id
  JOIN Transaction je ON ntll.nextdoc = je.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND je.type = 'Journal'
  AND (je.memo LIKE '%Bad Debt%' OR je.memo LIKE '%Write Off%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 13. Invoice Cleared */
SELECT
  t.tranid AS TranId,
  'Invoice Cleared' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH:MI:SS') AS DateCreated,
  t.foreigntotal AS TotalAmount,
  c.entityid AS Entity,
  t.duedate AS DueDate,
  s.name AS Subsidiary,
  NULL AS SalesRep,
  'Paid In Full' AS Status,
  'NetSuite' AS SourceSystem,
  SYSDATE AS LastDataUpdate
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
  LEFT JOIN Customer c ON t.entity = c.id
  LEFT JOIN Subsidiary s ON t.subsidiary = s.id
WHERE
  t.type = 'CustInvc'
  AND sn.standardfield = 'STATUS'
  AND sn.newvalue = 'Paid In Full'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

Passaggi

Prerequisiti e autorizzazioni: verifichi di disporre di un ruolo con autorizzazioni 'SuiteAnalytics Connect' o 'SuiteQL'. Per l’autenticazione tramite REST o tramite una connessione ODBC configurata, sono necessari un Token ID e un Token Secret validi.
Comprendere lo schema: l’estrazione si basa sulle tabelle Transazione, TransactionLine, SystemNote, Messaggio, Nota e SupportCase. NetSuite memorizza le modifiche storiche ai campi, come gli aggiornamenti dello stato, in SystemNote, elemento fondamentale per i timestamp delle approvazioni e delle modifiche di stato.
Identificare l’ambito: determini la consociata, l’intervallo di date e i tipi di record specifici, generalmente 'CustInvc' per le fatture, necessari per l’analisi.
Configurare la query SuiteQL: la query fornita utilizza UNION ALL per combinare i dati provenienti da tabelle diverse in un unico formato di Event Log. NetSuite SuiteQL non supporta SQL procedurale complesso, pertanto la logica è appiattita in blocchi di selezione specifici per ogni attività.
Strategia di esecuzione: esegua la query tramite l’API REST NetSuite /services/rest/query/v1/suiteql oppure tramite ODBC. A causa delle dimensioni potenziali della tabella SystemNote, si consiglia vivamente di eseguire l’estrazione in batch, suddivisi per trandate, ad esempio mese per mese.
Gestire la paginazione: l’API REST NetSuite limita generalmente le risposte a 1.000 righe. Implementi la gestione dell’offset o l’attraversamento dell’intestazione 'Link' nello script di estrazione per recuperare l’intero dataset.
Trasformare i dati: la query allinea tutti i risultati a uno schema standard, tra cui TranId, Activity e Date. Verifichi che, durante l’esportazione, le date siano formattate secondo lo standard ISO 8601 (YYYY-MM-DD THH:MM:SS) se l’output SQL grezzo utilizza un formato locale diverso.
Logica per contestazioni e recupero crediti: la query cerca record SupportCase collegati al cliente e record Nota relativi a 'Promise to Pay'. Verifichi se la Sua organizzazione utilizza campi personalizzati per questi indicatori invece degli oggetti standard e, se necessario, modifichi le clausole WHERE di conseguenza.
Convalidare: confronti il numero di 'Invoice Created' nel file estratto con una Saved Search in NetSuite per lo stesso periodo, così da verificare la completezza dei dati.
Esportare il risultato finale: salvi il dataset risultante in un file CSV. Prima di caricarlo in ProcessMind, verifichi che le intestazioni corrispondano all’elenco degli attributi da includere, tra cui TranId, Activity e DateCreated.

Configurazione

Intervallo di date: filtri per trandate nella tabella Transaction e per date in SystemNote. Per i processi attivi si consiglia una finestra mobile di 12 mesi.
Filtro per subsidiary: è essenziale negli ambienti con più subsidiary. Aggiunga AND t.subsidiary = [Your Subsidiary ID] a tutte le clausole WHERE.
Tipi di record: la query si concentra su CustInvc (Invoice), CustPymt (Payment), CustCred (Credit Memo) e Journal.
System Notes: questa tabella è molto grande. Per garantire prestazioni adeguate, è obbligatorio filtrare per recordtype = 'invoice'.
Mappatura degli stati: gli stati NetSuite sono ID interni, ad esempio 'A' e 'B'. La query utilizza BUILTIN.DF per recuperare i nomi visualizzati, ma verifichi che corrispondano alle etichette localizzate dell'interfaccia.
Strategia dei join: utilizza join standard su transaction.id. Si assicuri che i collegamenti 'Applied To' siano integri per la cronologia dei pagamenti.

a Query di esempio sql

/* 1. Invoice Created */
SELECT
  t.tranid AS TranId,
  'Invoice Created' AS Activity,
  TO_CHAR(t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
WHERE
  t.recordtype = 'invoice'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 2. Invoice Approved (Detected via SystemNote status change to Open) */
SELECT
  t.tranid AS TranId,
  'Invoice Approved' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
WHERE
  t.recordtype = 'invoice'
  AND sn.recordtypeid = -30 /* Invoice Record Type ID */
  AND sn.field = 'status'
  AND (sn.after LIKE '%Open%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 3. Invoice Dispatched (Email Sent) */
SELECT
  t.tranid AS TranId,
  'Invoice Dispatched' AS Activity,
  TO_CHAR(m.messagedate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN Message m ON m.transaction = t.id
WHERE
  t.recordtype = 'invoice'
  AND m.subject LIKE '%Invoice%'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 4. Payment Reminder Sent */
SELECT
  t.tranid AS TranId,
  'Payment Reminder Sent' AS Activity,
  TO_CHAR(m.messagedate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN Message m ON m.transaction = t.id
WHERE
  t.recordtype = 'invoice'
  AND (m.subject LIKE '%Reminder%' OR m.subject LIKE '%Overdue%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 5. Dispute Case Opened (Linked Support Case) */
SELECT
  t.tranid AS TranId,
  'Dispute Case Opened' AS Activity,
  TO_CHAR(sc.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SupportCase sc ON sc.company = t.entity
WHERE
  t.recordtype = 'invoice'
  AND sc.title LIKE '%Invoice%'
  AND sc.createddate >= t.createddate
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 6. Dispute Resolved */
SELECT
  t.tranid AS TranId,
  'Dispute Resolved' AS Activity,
  TO_CHAR(sc.lastmodifieddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SupportCase sc ON sc.company = t.entity
WHERE
  t.recordtype = 'invoice'
  AND sc.status = 'Closed'
  AND sc.title LIKE '%Invoice%'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 7. Promise to Pay Received */
SELECT
  t.tranid AS TranId,
  'Promise to Pay Received' AS Activity,
  TO_CHAR(n.notedate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN Note n ON n.transaction = t.id
WHERE
  t.recordtype = 'invoice'
  AND (n.note LIKE '%Promise to Pay%' OR n.note LIKE '%PTP%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 8. Credit Memo Issued */
SELECT
  t.tranid AS TranId,
  'Credit Memo Issued' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'creditmemo'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 9. Partial Payment Posted */
SELECT
  t.tranid AS TranId,
  'Partial Payment Posted' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'customerpayment'
  AND ABS(tl.foreignamount) < t.foreigntotal
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 10. Full Payment Received */
SELECT
  t.tranid AS TranId,
  'Full Payment Received' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'customerpayment'
  AND ABS(tl.foreignamount) >= (t.foreigntotal - 1.00) /* Approx check for full payment allowing small variance */
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 11. Bad Debt Written Off */
SELECT
  t.tranid AS TranId,
  'Bad Debt Written Off' AS Activity,
  TO_CHAR(link_t.createddate, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'journalentry'
  AND (link_t.memo LIKE '%Write off%' OR link_t.memo LIKE '%Bad Debt%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 12. Bank Statement Matched (via Payment Status) */
SELECT
  t.tranid AS TranId,
  'Bank Statement Matched' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN TransactionLine tl ON tl.doc = t.id
  JOIN Transaction link_t ON link_t.id = tl.transaction
  JOIN SystemNote sn ON sn.recordid = link_t.id
WHERE
  t.recordtype = 'invoice'
  AND link_t.recordtype = 'customerpayment'
  AND sn.field = 'status'
  AND sn.after LIKE '%Deposited%'
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

UNION ALL

/* 13. Invoice Cleared (Final Status) */
SELECT
  t.tranid AS TranId,
  'Invoice Cleared' AS Activity,
  TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') AS DateCreated,
  'NetSuite' AS SourceSystem,
  TO_CHAR(SYSDATE, 'YYYY-MM-DD HH24:MI:SS') AS LastDataUpdate,
  t.foreigntotal AS TotalAmount,
  BUILTIN.DF(t.entity) AS Entity,
  TO_CHAR(t.duedate, 'YYYY-MM-DD') AS DueDate,
  BUILTIN.DF(t.subsidiary) AS Subsidiary,
  BUILTIN.DF(t.salesrep) AS SalesRep,
  BUILTIN.DF(t.status) AS Status,
  BUILTIN.DF(t.department) AS Department
FROM
  Transaction t
  JOIN SystemNote sn ON sn.recordid = t.id
WHERE
  t.recordtype = 'invoice'
  AND sn.recordtypeid = -30
  AND sn.field = 'status'
  AND (sn.after LIKE '%Paid In Full%')
  AND t.trandate >= TO_DATE('2023-01-01', 'YYYY-MM-DD')

Passaggi

Configurazione dei prerequisiti e delle autorizzazioni Verifichi di disporre dell’accesso di amministratore all’account NetSuite. Acceda a Setup, Company, Enable Features. Nella scheda SuiteTalk, verifichi che 'REST Web Services' sia abilitato. In Setup, Integration, Manage Integrations, crei una nuova integrazione denominata 'ProcessMining_Extractor'. Abiliti 'Token-based Authentication' e deselezioni 'TBA: Authorization Flow' se utilizza la generazione standard dei token. Annoti il Consumer Key e il Consumer Secret.
Generazione dei token di accesso Acceda a Manage Access Tokens. Crei un nuovo token per il ruolo Administrator, oppure per un ruolo specifico con autorizzazioni per Transazioni, note di sistema ed elenchi. Copi il Token ID e il Token Secret. A questo punto dispone delle quattro chiavi necessarie per OAuth 1.0a.
Preparazione dell’ambiente Python Verifichi che Python 3.x sia installato. Installi le librerie necessarie con pip: pip install requests requests-oauthlib pandas. Queste librerie sono necessarie per gestire l’handshake OAuth 1.0a e la manipolazione dei dati.
Configurazione dei parametri dello script Apra lo script Python fornito. Sostituisca i segnaposto ACCOUNT_ID, CONSUMER_KEY, CONSUMER_SECRET, TOKEN_ID e TOKEN_SECRET con le Sue credenziali specifiche. Imposti TARGET_START_DATE sull’intervallo storico desiderato, ad esempio '2023-01-01'.
Comprensione della strategia API Lo script utilizza l’endpoint dell’API REST NetSuite /query/v1/suiteql. Sebbene sia possibile scorrere singolarmente i record, l’utilizzo di SuiteQL tramite l’API REST è molto più efficiente per il Process Mining, poiché consente di unire le tabelle Transaction, TransactionLine, Message e SystemNote con un numero inferiore di richieste HTTP.
Esecuzione dello script di estrazione Esegua lo script dal terminale o dall’IDE. Lo script esegue cinque passaggi di estrazione distinti: uno per il flusso principale delle fatture, uno per i pagamenti, uno per le note di credito, uno per i log delle comunicazioni (messaggi) e uno per le modifiche dello stato di sistema (traccia di audit).
Monitoraggio dell’esecuzione Lo script stampa l’avanzamento nella console, indicando il numero di record recuperati per ogni tipo di attività. Presti attenzione agli errori HTTP 400 o 500, che generalmente indicano problemi di autorizzazione o una sintassi SuiteQL non valida.
Trasformazione e unione dei dati Lo script gestisce automaticamente la trasformazione dei dati. Converte il formato specifico delle date NetSuite in un timestamp ISO 8601 standard. Normalizza inoltre i nomi dei campi, ad esempio tranid in ID caso, e associa specifici tipi di transazione ai nomi standardizzati delle attività definiti nei requisiti.
Gestione della logica post-elaborazione Lo script include la logica per distinguere tra 'Pagamento parziale registrato' e 'Pagamento completo ricevuto', confrontando l’importo del pagamento applicato con il totale della fattura originale. Deduce inoltre 'Fattura liquidata' in base alla modifica finale dello stato.
Verifica del file di output Al termine, lo script genera un file denominato netsuite_ar_event_log.csv. Apra il file e controlli le prime righe. Verifichi che TranId sia valorizzato e che DateCreated abbia il formato corretto.
Importazione in ProcessMind Il CSV generato è formattato appositamente per ProcessMind. Associ TranId a ID caso, Attività ad Attività e DateCreated a Timestamp. Verifichi che Importo e Stato siano associati come attributi del caso.

Configurazione

Metodo di autenticazione: OAuth 1.0a (Token Based Authentication). Questo è lo standard obbligatorio per la sicurezza della REST API di NetSuite.
Endpoint API: https://[AccountID].suitetalk.api.netsuite.com/services/rest/query/v1/suiteql. L'endpoint SuiteQL viene utilizzato nell'architettura REST per consentire filtri e join complessi su System Notes.
Gestione della concorrenza: NetSuite applica limiti di concorrenza in base al livello del servizio, generalmente 5-20 thread simultanei. Questo script opera correttamente su un singolo thread per evitare errori '429 Too Many Requests'.
Formattazione delle date: NetSuite consente di personalizzare i formati delle date. Lo script presuppone il formato ISO standard o il formato statunitense standard; potrebbe essere necessario modificare l'analisi delle date se la Sua istanza utilizza il formato GMA.
Limiti delle query: SuiteQL restituisce un massimo di 1.000 righe per pagina. Lo script implementa un ciclo while con una logica per gestire i flag hasMore e gli offset/intervalli necessari alla paginazione di dataset di grandi dimensioni.
Autorizzazioni necessarie: il ruolo dell'utente deve disporre delle autorizzazioni 'View' per Invoice, Customer Payment, Credit Memo, Journal Entry, Support Case, Message e System Note.

a Query di esempio python

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

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
class=class="hl-string">"hl-comment"># Replace these with your actual NetSuite credentials
ACCOUNT_ID = class="hl-string">'123456_SB1'  class=class="hl-string">"hl-comment"># Use hyphens for sandbox, e.g., 123456-sb1
CONSUMER_KEY = class="hl-string">'your_consumer_key'
CONSUMER_SECRET = class="hl-string">'your_consumer_secret'
TOKEN_ID = class="hl-string">'your_token_id'
TOKEN_SECRET = class="hl-string">'your_token_secret'
TARGET_START_DATE = class="hl-string">'2023-01-01'

class=class="hl-string">"hl-comment"># NetSuite REST API Base URL (Format account ID correctly for URL)
class=class="hl-string">"hl-comment"># For URL, usually lowercase and hyphens: 123456-sb1
NS_ACCOUNT_URL_PART = ACCOUNT_ID.lower().replace(class="hl-string">'_', class="hl-string">'-')
BASE_URL = fclass="hl-string">'https://{NS_ACCOUNT_URL_PART}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql'

class=class="hl-string">"hl-comment"># Authentication
auth = OAuth1(CONSUMER_KEY, CONSUMER_SECRET, TOKEN_ID, TOKEN_SECRET, realm=ACCOUNT_ID)
headers = {
    class="hl-string">'Prefer': class="hl-string">'transient',
    class="hl-string">'Content-Type': class="hl-string">'application/json'
}

class=class="hl-string">"hl-comment"># === HELPER FUNCTION ===
def run_suiteql(query):
    all_rows = []
    offset = 0
    limit = 1000
    has_more = True
    
    print(fclass="hl-string">"Executing Query starting with: {query[:50]}...")
    
    while has_more:
        class=class="hl-string">"hl-comment"># Note: Pagination in SuiteQL via REST often involves ROWNUM logic or limits
        class=class="hl-string">"hl-comment"># Standard REST paging links are preferred, but for SuiteQL body, we iterate logic
        class=class="hl-string">"hl-comment"># For simplicity in this script, we assume the query returns < 100k or we would implement ID-based iteration.
        class=class="hl-string">"hl-comment"># Ideally, we inject LIMIT/OFFSET if supported or filter by ID ranges.
        class=class="hl-string">"hl-comment"># Here we use a robust wrapper handling the class="hl-string">'items' response.
        
        class=class="hl-string">"hl-comment"># Adjust query for paging if necessary, or rely on requests if result set is small.
        class=class="hl-string">"hl-comment"># For production large scale, add class="hl-string">'AND rownum between X and Y' logic.
        
        payload = {class="hl-string">"q": query}
        response = requests.post(BASE_URL, auth=auth, headers=headers, json=payload)
        
        if response.status_code == 200:
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            all_rows.extend(items)
            
            class=class="hl-string">"hl-comment"># Check for generic SuiteTalk pagination links
            if len(items) < limit:
                has_more = False
            else:
                class=class="hl-string">"hl-comment"># In strict SuiteQL, you must handle offset manually in SQL
                class=class="hl-string">"hl-comment"># For this script, we assume strict date filtering keeps batches manageable
                has_more = False class=class="hl-string">"hl-comment"># Preventing infinite loop in this demo template
        else:
            print(fclass="hl-string">"Error {response.status_code}: {response.text}")
            has_more = False
            
    return all_rows

class=class="hl-string">"hl-comment"># === EXTRACTION LOGIC ===

events = []

class=class="hl-string">"hl-comment"># 1. INVOICES (Created, Due Date, Attributes)
print(class="hl-string">"Extracting Invoices...")
q_invoices = fclass="hl-string">"""
    SELECT 
        t.tranid,
        'Invoice Created' as activity,
        TO_CHAR(t.trandate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        t.foreignTotal as amount,
        e.entityid as customer,
        t.duedate,
        s.name as subsidiary,
        emp.entityid as salesrep,
        t.status,
        d.name as department
    FROM 
        transaction t
        LEFT JOIN entity e ON t.entity = e.id
        LEFT JOIN subsidiary s ON t.subsidiary = s.id
        LEFT JOIN employee emp ON t.salesrep = emp.id
        LEFT JOIN department d ON t.department = d.id
    WHERE 
        t.recordtype = 'invoice'
        AND t.trandate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
invoices = run_suiteql(q_invoices)
for row in invoices:
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'tranid'),
        class="hl-string">'Activity': row.get(class="hl-string">'activity'),
        class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
        class="hl-string">'TotalAmount': row.get(class="hl-string">'amount'),
        class="hl-string">'Entity': row.get(class="hl-string">'customer'),
        class="hl-string">'DueDate': row.get(class="hl-string">'duedate'),
        class="hl-string">'Subsidiary': row.get(class="hl-string">'subsidiary'),
        class="hl-string">'SalesRep': row.get(class="hl-string">'salesrep'),
        class="hl-string">'Status': row.get(class="hl-string">'status'),
        class="hl-string">'Department': row.get(class="hl-string">'department'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })

class=class="hl-string">"hl-comment"># 2. PAYMENTS (Partial, Full, Bank Match)
print(class="hl-string">"Extracting Payments...")
q_payments = fclass="hl-string">"""
    SELECT 
        inv.tranid as invoice_num,
        t.tranid as payment_ref,
        TO_CHAR(t.trandate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        tl.foreignAmount as payment_amt,
        inv.foreignTotal as invoice_total,
        t.status as payment_status
    FROM 
        transaction t
        JOIN transactionLine tl ON t.id = tl.transaction
        JOIN transaction inv ON tl.createdfrom = inv.id
    WHERE 
        t.recordtype = 'customerpayment'
        AND inv.recordtype = 'invoice'
        AND t.trandate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
payments = run_suiteql(q_payments)
for row in payments:
    class=class="hl-string">"hl-comment"># Logic to distinguish Partial vs Full
    act = class="hl-string">'Partial Payment Posted'
    class=class="hl-string">"hl-comment"># Simple heuristic: if remaining amount is small or payment equals total
    class=class="hl-string">"hl-comment"># In a real scenario, we would check class="hl-string">'amountremaining' on the invoice
    try:
        if float(row.get(class="hl-string">'payment_amt', 0)) >= float(row.get(class="hl-string">'invoice_total', 0)):
            act = class="hl-string">'Full Payment Received'
    except:
        pass
        
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
        class="hl-string">'Activity': act,
        class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })
    
    class=class="hl-string">"hl-comment"># Bank Match / Cleared Check
    class=class="hl-string">"hl-comment"># Assuming class="hl-string">'deposited' status or similar indicates bank matching
    if row.get(class="hl-string">'payment_status') == class="hl-string">'deposited':
        events.append({
            class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
            class="hl-string">'Activity': class="hl-string">'Bank Statement Matched',
            class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class=class="hl-string">"hl-comment"># Using payment date as proxy if match date unavailable
            class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
        })

class=class="hl-string">"hl-comment"># 3. CREDIT MEMOS & BAD DEBT
print(class="hl-string">"Extracting Credit Memos...")
q_credits = fclass="hl-string">"""
    SELECT 
        inv.tranid as invoice_num,
        t.tranid as credit_ref,
        t.recordtype,
        TO_CHAR(t.trandate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        t.memo
    FROM 
        transaction t
        JOIN transactionLine tl ON t.id = tl.transaction
        JOIN transaction inv ON tl.createdfrom = inv.id
    WHERE 
        t.recordtype IN ('creditmemo', 'journalentry')
        AND inv.recordtype = 'invoice'
        AND t.trandate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
credits = run_suiteql(q_credits)
for row in credits:
    act = class="hl-string">'Credit Memo Issued'
    if class="hl-string">'write off' in str(row.get(class="hl-string">'memo')).lower() or class="hl-string">'bad debt' in str(row.get(class="hl-string">'memo')).lower():
        act = class="hl-string">'Bad Debt Written Off'
        
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
        class="hl-string">'Activity': act,
        class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })

class=class="hl-string">"hl-comment"># 4. MESSAGES (Dispatch, Reminders)
print(class="hl-string">"Extracting Messages...")
q_msgs = fclass="hl-string">"""
    SELECT 
        t.tranid as invoice_num,
        m.subject,
        TO_CHAR(m.messagedate, 'YYYY-MM-DD HH24:MI:SS') as event_time,
        m.authoremail
    FROM 
        message m
        JOIN transaction t ON m.transaction = t.id
    WHERE 
        t.recordtype = 'invoice'
        AND m.messagedate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
msgs = run_suiteql(q_msgs)
for row in msgs:
    subj = str(row.get(class="hl-string">'subject')).lower()
    act = None
    if class="hl-string">'invoice' in subj and class="hl-string">'attached' in subj:
        act = class="hl-string">'Invoice Dispatched'
    elif class="hl-string">'reminder' in subj or class="hl-string">'overdue' in subj:
        act = class="hl-string">'Payment Reminder Sent'
        
    if act:
        events.append({
            class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
            class="hl-string">'Activity': act,
            class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'),
            class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
        })

class=class="hl-string">"hl-comment"># 5. SUPPORT CASES (Disputes)
print(class="hl-string">"Extracting Support Cases...")
class=class="hl-string">"hl-comment"># Requires linking Case to Invoice (often custom field or text match)
class=class="hl-string">"hl-comment"># Here assuming generic link via Customer + Time logic or direct field if exists
class=class="hl-string">"hl-comment"># Using standard support case table
q_cases = fclass="hl-string">"""
    SELECT 
        c.casenumber,
        c.title,
        c.status,
        TO_CHAR(c.createddate, 'YYYY-MM-DD HH24:MI:SS') as create_time,
        TO_CHAR(c.lastmodifieddate, 'YYYY-MM-DD HH24:MI:SS') as close_time,
        t.tranid as invoice_num
    FROM 
        supportcase c
        JOIN transaction t ON c.company = t.entity -- Loose join by customer
    WHERE 
        t.recordtype = 'invoice'
        AND (c.title LIKE '%' || t.tranid || '%' OR c.incomingmessage LIKE '%' || t.tranid || '%')
        AND c.createddate >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
cases = run_suiteql(q_cases)
for row in cases:
    class=class="hl-string">"hl-comment"># Dispute Opened
    events.append({
        class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
        class="hl-string">'Activity': class="hl-string">'Dispute Case Opened',
        class="hl-string">'DateCreated': row.get(class="hl-string">'create_time'),
        class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
    })
    class=class="hl-string">"hl-comment"># Dispute Resolved (if closed)
    if class="hl-string">'closed' in str(row.get(class="hl-string">'status')).lower():
        events.append({
            class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'),
            class="hl-string">'Activity': class="hl-string">'Dispute Resolved',
            class="hl-string">'DateCreated': row.get(class="hl-string">'close_time'),
            class="hl-string">'SourceSystem': class="hl-string">'NetSuite'
        })

class=class="hl-string">"hl-comment"># 6. SYSTEM NOTES (Approvals, Status Changes, Cleared)
print(class="hl-string">"Extracting System Notes...")
class=class="hl-string">"hl-comment"># This query can be heavy. Ensure proper filtering.
q_notes = fclass="hl-string">"""
    SELECT 
        t.tranid as invoice_num,
        sn.field,
        sn.oldvalue,
        sn.newvalue,
        TO_CHAR(sn.date, 'YYYY-MM-DD HH24:MI:SS') as event_time
    FROM 
        systemnote sn
        JOIN transaction t ON sn.recordid = t.id
    WHERE 
        sn.recordtypeid = -30 -- Transaction Record Type ID usually -30, verify in setup
        AND t.recordtype = 'invoice'
        AND sn.date >= TO_DATE('{TARGET_START_DATE}', 'YYYY-MM-DD')
"""
notes = run_suiteql(q_notes)
for row in notes:
    field = str(row.get(class="hl-string">'field')).lower()
    old_v = str(row.get(class="hl-string">'oldvalue')).lower()
    new_v = str(row.get(class="hl-string">'newvalue')).lower()
    
    if class="hl-string">'status' in field:
        if class="hl-string">'pending approval' in old_v and class="hl-string">'open' in new_v:
            events.append({class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'), class="hl-string">'Activity': class="hl-string">'Invoice Approved', class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class="hl-string">'SourceSystem': class="hl-string">'NetSuite'})
        elif class="hl-string">'paid in full' in new_v:
            events.append({class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'), class="hl-string">'Activity': class="hl-string">'Invoice Cleared', class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class="hl-string">'SourceSystem': class="hl-string">'NetSuite'})
            
    class=class="hl-string">"hl-comment"># Promise to Pay check (User Notes often appear in System Notes or separate Note table)
    class=class="hl-string">"hl-comment"># Assuming Note capture via System Note for context
    if class="hl-string">'note' in field: 
        events.append({class="hl-string">'TranId': row.get(class="hl-string">'invoice_num'), class="hl-string">'Activity': class="hl-string">'Promise to Pay Received', class="hl-string">'DateCreated': row.get(class="hl-string">'event_time'), class="hl-string">'SourceSystem': class="hl-string">'NetSuite'})

class=class="hl-string">"hl-comment"># === EXPORT ===
print(class="hl-string">"Generating CSV...")
df = pd.DataFrame(events)

class=class="hl-string">"hl-comment"># Deduplicate and Sort
df.drop_duplicates(inplace=True)
df[class="hl-string">'LastDataUpdate'] = datetime.now().isoformat()

class=class="hl-string">"hl-comment"># Save
df.to_csv(class="hl-string">'netsuite_ar_event_log.csv', index=False)
print(class="hl-string">"Done. File saved as netsuite_ar_event_log.csv")

È pronto per iniziare?

Inizi il percorso verso un ciclo di cassa più efficiente applicando questo Template al Suo ambiente NetSuite. Il nostro team è a Sua disposizione qualora avesse bisogno di ulteriore assistenza per la mappatura dei dati o l'integrazione tecnica.

Torna alla guida al miglioramento Scarica il Template

Accelerare subito il ciclo dei crediti commerciali di NetSuite

Riduca il DSO di 15-20 giorni e colmi oggi stesso le lacune nel flusso di cassa.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito, configurazione in 5 minuti

Il Suo Template dei dati sui crediti commerciali

Il Suo Template dei dati sui crediti commerciali

Attributi dei crediti verso clienti

Attività dei crediti verso clienti

Guide all'estrazione

Esportazione dei dati da NetSuite SuiteAnalytics Workbook

Passaggi

Configurazione

a Query di esempio sql

Estrazione dei dati delle transazioni NetSuite tramite SuiteQL

Passaggi

Configurazione

a Query di esempio sql

Script Python per l'estrazione tramite SuiteTalk REST API

Passaggi

Configurazione

a Query di esempio python

È pronto per iniziare?

Accelerare subito il ciclo dei crediti commerciali di NetSuite

Il Suo Template dei dati sui crediti commerciali

Il Suo Template dei dati sui crediti commerciali

Attributi dei crediti verso clienti

Attività dei crediti verso clienti

Guide all'estrazione

Esportazione dei dati da NetSuite SuiteAnalytics Workbook

Passaggi

Configurazione

a Query di esempio sql

Estrazione dei dati delle transazioni NetSuite tramite SuiteQL

Passaggi

Configurazione

a Query di esempio sql

Script Python per l'estrazione tramite SuiteTalk REST API

Passaggi

Configurazione

a Query di esempio python

È pronto per iniziare?

Accelerare subito il ciclo dei crediti commerciali di NetSuite

La Sua privacy è importante