> Miglioramento continuo dei processi > Order to Cash elaborazione degli ordini di vendita > NetSuite > Template dei dati

Il Suo Template dei dati per il processo dall’ordine all’incasso: gestione degli ordini di vendita

NetSuite

← Torna alla guida al miglioramento

Attributi del processo dall’ordine all’incasso: gestione degli ordini di vendita(21) Attività del processo dall’ordine all’incasso: gestione degli ordini di vendita(14) Guide all’estrazione dei dati(3)

Il Suo Template dei dati per il processo dall’ordine all’incasso: gestione degli ordini di vendita

Questo template fornisce indicazioni complete per raccogliere i dati necessari ad analizzare in NetSuite il processo dall’ordine all’incasso, con particolare riferimento alla gestione degli ordini di vendita. Illustra gli attributi e le attività essenziali da estrarre dal sistema e offre indicazioni pratiche per farlo in modo efficiente, così da preparare un’analisi efficace del processo.

Attributi consigliati per un’analisi dettagliata
Attività essenziali da monitorare nel processo
Indicazioni pratiche per estrarre i dati da NetSuite

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

Scarica il template

Attributi del processo dall’ordine all’incasso: gestione degli ordini di vendita

Questi sono i campi dati consigliati da includere nell’Event Log per analizzare in modo completo il processo dall’ordine all’incasso, con particolare riferimento alla gestione degli ordini di vendita.

3 Obbligatorio 8 Consigliato 10 Facoltativo

	Nome	Descrizione
	Nome dell’attività ActivityName	Nome dell’evento o dell’attività aziendale che si è verificata in un determinato momento.
Descrizione Questo attributo descrive un passaggio specifico o una modifica di stato nel ciclo di vita dell’ordine di vendita, ad esempio 'Ordine di vendita creato', 'Merce spedita' o 'Pagamento ricevuto'. La sequenza di queste attività costituisce la base della mappa del processo. Analizzare il flusso delle attività aiuta a individuare i percorsi più comuni, le deviazioni e i colli di bottiglia. Conoscere la frequenza e l’ordine delle attività è fondamentale per individuare opportunità di semplificazione delle operazioni e riduzione del lavoro manuale. Perché è importante Definisce i passaggi del processo e ne consente la visualizzazione e l’analisi del flusso. Dove reperirli In genere si ricava dalle modifiche di stato del sistema, dai tipi di transazione o dai log degli eventi specifici di NetSuite. Spesso è necessario associare i campi di stato o gli eventi di creazione delle transazioni a un nome di attività standardizzato. Esempi Ordine di vendita creatoOrdine di vendita approvatoMerce speditaFattura creataPagamento ricevuto
	Ora dell’evento EventTime	Data e ora che indicano quando si è verificata l’attività.
Descrizione Questo attributo fornisce la data e l’ora esatte di ogni attività del processo. Costituisce la base cronologica dell’Event Log e consente di calcolare i tempi di ciclo, le durate e i tempi di attesa tra i diversi passaggi. Le date e le ore precise sono essenziali per analizzare le prestazioni, ad esempio misurando il tempo che intercorre tra la creazione dell’ordine e la spedizione o individuando i ritardi nel processo di approvazione del credito. Consentono un’analisi dettagliata dell’efficienza del processo e del rispetto degli accordi sul livello di servizio. Perché è importante Le date e le ore sono fondamentali per calcolare tutte le metriche temporali, compresi i tempi di ciclo e le durate, indispensabili per individuare i colli di bottiglia del processo. Dove reperirli Corrisponde ai campi data dei record delle transazioni NetSuite, ad esempio 'Date Created' per l’ordine di vendita, 'Actual Ship Date' per le evasioni degli articoli o 'Date' per le fatture e i pagamenti. Esempi 2023-04-15T10:00:00Z2023-04-15T14:30:00Z2023-04-16T09:00:00Z
	Ordine di vendita SalesOrder	Identificativo univoco di ciascun documento di ordine di vendita.
Descrizione Il Sales Order è l’identificativo principale del caso e collega tutte le attività successive, dall’inserimento dell’ordine del cliente alla consegna della merce e al pagamento finale. Ogni ordine di vendita rappresenta una singola istanza del processo end-to-end. Nel Process Mining, questo attributo è fondamentale per ricostruire il percorso di ciascun ordine. Consente di analizzare le varianti di processo, i tempi di ciclo e i colli di bottiglia per singolo ordine, offrendo una visione completa del ciclo di vita di ogni richiesta del cliente. Perché è importante È l’identificativo principale che collega tutti gli eventi correlati in una singola istanza di processo e rende possibile l’analisi end-to-end. Dove reperirli È l’ID interno del record della transazione Sales Order in NetSuite. In genere è riportato come 'Internal ID' nel modulo Sales Order o nei risultati della ricerca. Esempi SO-100521SO-100522SO-100523
	Categoria di prodotto ProductCategory	Categoria del prodotto o servizio principale dell’ordine di vendita.
Descrizione Questo attributo classifica gli articoli dell’ordine di vendita in categorie più ampie, ad esempio 'Hardware', 'Software' o 'Servizi'. Se un ordine comprende più categorie, è possibile assegnare quella principale in base al valore o al numero di articoli. Analizzare il processo per categoria di prodotto può rivelare differenze nei percorsi di evasione. Ad esempio, l’evasione dei servizi può essere molto più semplice rispetto a quella dei prodotti fisici, che richiede prelievo, imballaggio e spedizione. Questa segmentazione è fondamentale per definire miglioramenti del processo specifici per categoria. Perché è importante Segmentare il processo per categoria di prodotto aiuta a individuare percorsi di evasione diversi e i colli di bottiglia specifici di ciascuna categoria. Dove reperirli Queste informazioni derivano dai record «Item» collegati alle righe dell’ordine di vendita. Potrebbe essere necessario unirli ai dati anagrafici degli articoli per ricavare la categoria. Esempi ElettronicaLicenza softwareServizi di consulenza
	Data di consegna richiesta RequestedDeliveryDate	La data di consegna richiesta dal cliente.
Descrizione Questo attributo registra la data entro cui il cliente ha richiesto di ricevere la merce. Costituisce la base di riferimento per misurare le consegne puntuali. La data viene confrontata con quella effettiva di consegna (timestamp «Goods Shipped») per calcolare il KPI «Tasso di consegne puntuali». Analizzare lo scarto tra la data richiesta e quella effettiva aiuta a individuare problemi sistemici nelle previsioni, nella gestione delle scorte o nella logistica che impediscono all’azienda di soddisfare le aspettative dei clienti. Perché è importante È la base di riferimento per misurare le prestazioni delle consegne puntuali e la soddisfazione dei clienti. Dove reperirli Può corrispondere a un campo standard o personalizzato del record Sales Order, spesso denominato «Requested Delivery Date» o in modo simile. Esempi 2023-05-202023-06-012023-06-15
	Importo totale dell’ordine TotalOrderAmount	Valore monetario complessivo dell’ordine di vendita.
Descrizione Questo attributo rappresenta il valore finanziario complessivo dell’ordine di vendita, inclusi tutti gli articoli, le imposte e le spese di spedizione. È una misura fondamentale del peso economico di ogni istanza del processo. Analizzare il processo in base al valore dell’ordine può rivelare schemi importanti. Ad esempio, gli ordini di valore elevato possono seguire un processo di approvazione diverso e più manuale, mentre quelli di valore ridotto possono essere ampiamente automatizzati. Questa analisi aiuta a dare priorità agli interventi di miglioramento sui processi relativi agli ordini con il maggiore impatto. Perché è importante Consente di analizzare il processo in base al valore, dando priorità agli ordini di importo elevato e aiutando a capire come l’efficienza del processo incida sui ricavi. Dove reperirli È il campo 'Total' del record della transazione Sales Order in NetSuite. Esempi 1500.00250.5012500.75
	Nome del cliente CustomerName	Nome del cliente che ha effettuato l’ordine di vendita.
Descrizione Questo attributo contiene il nome della persona fisica o giuridica che ha acquistato i beni o i servizi. Collega il processo dell’ordine di vendita a uno specifico account cliente. Filtrare o segmentare l’analisi per cliente è essenziale per comprenderne i comportamenti, individuare i problemi che interessano i clienti principali e valutare i livelli di servizio. Consente di analizzare il processo dal punto di vista del cliente e di capire chi subisce più ritardi o rilavorazioni. Perché è importante Consente di segmentare il processo per cliente, un aspetto fondamentale per analizzare la soddisfazione, individuare i problemi che interessano i clienti principali e adattare i servizi. Dove reperirli È il campo 'Customer' o 'Entity' del record della transazione Sales Order in NetSuite. Esempi Global Corp Inc.Innovate Solutions Ltd.Dynamic Tech
	Numero fattura InvoiceNumber	L’identificativo univoco della fattura del cliente.
Descrizione Questo attributo è il numero di riferimento del documento di fattura generato dall’ordine di vendita. Collega il processo di evasione dell’ordine a quello di gestione dei crediti verso clienti. Tenere traccia del numero di fattura è importante per la riconciliazione finanziaria e per le analisi che coprono l’intero percorso dall’ordine al pagamento finale. Collega in modo concreto le attività operative di spedizione della merce alla riscossione dei pagamenti. Perché è importante Collega l’ordine di vendita alla specifica transazione finanziaria di fatturazione e consente un’analisi completa del processo dall’ordine all’incasso. Dove reperirli È il campo «Invoice #» o «Transaction ID» del record Invoice creato a partire dal Sales Order. Esempi INV-2001INV-2002INV-2003
	Stato dell’ordine di vendita SalesOrderStatus	Stato corrente dell’ordine di vendita nel suo ciclo di vita.
Descrizione Questo attributo indica lo stato corrente dell’ordine di vendita, ad esempio 'Pending Approval', 'Pending Fulfillment' o 'Billed'. Fornisce un quadro della posizione dell’ordine nel processo complessivo. Il registro delle attività mostra il flusso storico, mentre lo stato corrente è utile per filtrare e concentrarsi sugli ordini attualmente bloccati o in lavorazione. Analizzare i casi in base allo stato finale aiuta a comprendere gli esiti del processo, ad esempio se un ordine è stato chiuso correttamente, annullato o è ancora in corso. Perché è importante Consente di filtrare i casi in base allo stato corrente, un aspetto fondamentale per analizzare gli ordini aperti e individuare quelli bloccati o in ritardo. Dove reperirli È il campo 'Status' del record della transazione Sales Order in NetSuite. Esempi In attesa di evasioneIn attesa di fatturazioneFatturatoChiuso
	Termini di pagamento PaymentTerms	Le condizioni concordate per il pagamento della fattura.
Descrizione Questo attributo definisce le condizioni in base alle quali il cliente deve pagare i beni o i servizi, ad esempio «30 giorni data fattura» o «Pagamento alla ricezione». Questi termini servono a calcolare la data di scadenza della fattura. L’analisi dei termini di pagamento aiuta a individuare quelli associati ai ritardi e consente all’azienda di valutare l’impatto finanziario delle proprie politiche di credito. È fondamentale per analizzare la Dashboard «Tasso di rispetto dei termini di pagamento» e comprendere l’andamento dei flussi di cassa. Perché è importante Fornisce la base per calcolare le scadenze dei pagamenti e analizzare il comportamento dei clienti e il rispetto dei termini concordati. Dove reperirli È il campo «Terms» del record della transazione Sales Order o Invoice in NetSuite. Esempi 30 giorni data fattura60 giorni data fatturaPagamento alla ricezione
	Utente User	L’utente o il dipendente che ha svolto l’attività.
Descrizione Questo attributo identifica la persona responsabile dell’esecuzione di un determinato passaggio del processo, ad esempio il rappresentante commerciale che ha creato l’ordine o l’operatore di magazzino che ha imballato la merce. Può contenere il nome dell’utente o un ID univoco. L’analisi per utente aiuta a comprendere la distribuzione del carico di lavoro, individuare esigenze di formazione e confrontare le prestazioni di singole persone o team. È fondamentale per l’analisi delle cause profonde quando si indagano deviazioni o ritardi associati alle azioni di utenti specifici. Perché è importante Consente di analizzare le prestazioni per dipendente o ruolo e aiuta a individuare chi ottiene i risultati migliori, le attività candidabili all’automazione e le opportunità di formazione. Dove reperirli Queste informazioni sono disponibili in campi come 'Created By', 'Modified By' o 'Owner' nei diversi record delle transazioni NetSuite. Esempi John SmithJane DoeUtente di magazzino 1
	Consegna puntuale IsOnTimeDelivery	Indicatore che segnala se l’ordine è stato consegnato entro la data richiesta.
Descrizione Questo attributo booleano calcolato confronta il timestamp di «Goods Shipped» o della consegna effettiva con «RequestedDeliveryDate». Il valore è vero se la consegna è avvenuta entro la data prevista o in anticipo, e falso se è avvenuta in ritardo. Questo indicatore è essenziale per calcolare il KPI «Tasso di consegne puntuali» e alimentare la Dashboard «Scarto tra promessa di consegna e realtà». Semplifica l’analisi delle prestazioni delle consegne e consente di filtrare e aggregare i dati per individuare le cause dei ritardi, legate a prodotti, regioni o colli di bottiglia del processo. Perché è importante Fornisce un esito chiaro e binario delle prestazioni di consegna, semplificando il calcolo dei KPI e l’analisi delle cause profonde dei ritardi negli ordini. Dove reperirli Viene calcolato durante la trasformazione dei dati, confrontando il timestamp dell’attività «Goods Shipped» con l’attributo «RequestedDeliveryDate». Esempi truefalse
	Data di scadenza del pagamento PaymentDueDate	La data entro cui deve essere pagata la fattura.
Descrizione Questo attributo indica la data calcolata entro cui il cliente deve effettuare il pagamento, in base alla data della fattura e ai termini di pagamento. Per esempio, per una fattura datata 1° aprile con termini «30 giorni data fattura», la scadenza è il 1° maggio. Questa data è fondamentale per l’analisi finanziaria e viene confrontata direttamente con la data di ricezione del pagamento per stabilire se il pagamento è stato effettuato puntualmente. È un elemento essenziale per calcolare il KPI «Tasso di pagamenti puntuali» e gestire i crediti verso clienti. Perché è importante È il valore di riferimento per misurare la puntualità dei pagamenti, fondamentale per la gestione dei flussi di cassa e dei crediti verso clienti. Dove reperirli È il campo «Due Date» del record della transazione Invoice. NetSuite lo calcola automaticamente in base alla data della fattura e ai termini di pagamento. Esempi 2023-05-302023-06-152023-07-01
	Numero di modifiche all’ordine di vendita SalesOrderChangeCount	Il numero di volte in cui un ordine di vendita è stato modificato dopo la creazione.
Descrizione Questa metrica calcolata conta le occorrenze dell’attività «Sales Order Changed» per ogni caso. Un numero elevato di modifiche indica rilavorazioni, che possono dipendere da richieste dei clienti, errori di inserimento dei dati o adeguamenti dei prezzi. Questo attributo alimenta direttamente il KPI «Tasso di rilavorazione degli ordini di vendita» e la Dashboard «Varianti di rilavorazione degli ordini di vendita». Analizzare le caratteristiche degli ordini con molte modifiche aiuta a individuare le cause profonde delle rilavorazioni, ad esempio problemi legati a prodotti, clienti o rappresentanti commerciali specifici. Perché è importante Quantifica direttamente le rilavorazioni e aiuta a individuare le fonti di inefficienza, i problemi di qualità dei dati e l’instabilità del processo. Dove reperirli Viene calcolato durante la trasformazione dei dati, contando gli eventi «Sales Order Changed» per ogni ID caso «SalesOrder». Esempi 013
	Paese di spedizione ShippingCountry	Il Paese di destinazione della spedizione.
Descrizione Questo attributo indica il Paese in cui viene spedita la merce dell’ordine. Il dato deriva dall’indirizzo di spedizione associato all’ordine di vendita. L’analisi geografica per Paese di spedizione può rivelare differenze nelle prestazioni del processo dovute alla logistica, alle procedure doganali o all’efficienza delle sedi regionali. Consente di confrontare i tempi di spedizione, la precisione delle consegne e i costi del processo tra Paesi o regioni. Perché è importante Consente di analizzare i dati per area geografica, individuare i colli di bottiglia regionali, confrontare le prestazioni logistiche e comprendere le complessità delle spedizioni internazionali. Dove reperirli Fa parte dell’indirizzo di spedizione («Shipping Address») nel record della transazione Sales Order. Esempi USAGermaniaGiappone
	Pagamento puntuale IsOnTimePayment	Indicatore che segnala se la fattura è stata pagata entro la data di scadenza.
Descrizione Questo attributo booleano calcolato confronta il timestamp di «Payment Received» con «PaymentDueDate». Il valore è vero se il pagamento è stato effettuato entro la data di scadenza, e falso in caso contrario. Questo attributo è alla base del KPI «Tasso di pagamenti puntuali» e della Dashboard «Tasso di rispetto dei termini di pagamento». Fornisce una misura chiara del comportamento di pagamento dei clienti e consente di analizzare quali clienti, regioni o termini di pagamento sono più spesso associati ai ritardi. Perché è importante Misura direttamente la puntualità dei pagamenti dei clienti, un aspetto fondamentale per la gestione dei flussi di cassa e la valutazione del rischio di credito. Dove reperirli Viene calcolato durante la trasformazione dei dati, confrontando il timestamp dell’attività «Payment Received» con l’attributo «PaymentDueDate». Esempi truefalse
	Sistema di origine SourceSystem	Identifica il sistema da cui provengono i dati.
Descrizione Questo attributo specifica l’applicazione di origine in cui sono stati generati i dati dell’evento. Per questo processo, in genere il valore è 'NetSuite'. Negli ambienti più complessi, può aiutare a distinguere i dati provenienti da diversi sistemi integrati, ad esempio un CRM o un WMS separato. Nell’analisi, aiuta a verificare la provenienza dei dati ed è fondamentale quando si combinano più fonti per ottenere una visione unificata del processo. Garantisce che i dati siano attribuiti correttamente alla loro origine, un aspetto importante per la governance dei dati e la risoluzione dei problemi. Perché è importante Fornisce un contesto essenziale sull’origine dei dati, soprattutto negli ambienti in cui sono integrati più sistemi. Dove reperirli È un valore statico ('NetSuite'), aggiunto durante l’estrazione e la trasformazione dei dati. Esempi NetSuite
	Stato del credito CreditStatus	Indica se l’ordine di vendita è soggetto a un blocco per motivi di credito.
Descrizione Questo attributo riflette lo stato creditizio del cliente al momento dell’elaborazione dell’ordine, ad esempio «In sospeso» o «Sbloccato». È un fattore determinante nelle prime fasi del ciclo di vita dell’ordine. Analizzarlo aiuta a comprendere l’impatto dei controlli del credito sul tempo di ciclo complessivo dell’ordine. La Dashboard «Analisi del tempo di ciclo del controllo del credito» utilizza questi dati per individuare quanti ordini vengono bloccati e quanto tempo occorre per sbloccarli, mettendo in luce i colli di bottiglia nel processo di gestione del credito. Perché è importante Incide direttamente sul KPI «Tempo di ciclo del controllo del credito» e aiuta a spiegare i ritardi nelle prime fasi del processo dell’ordine. Dove reperirli Potrebbe essere un campo di stato standard o una casella personalizzata, ad esempio «Credit Hold», nel record Sales Order. Lo stato può anche essere dedotto dalla presenza delle attività «Credit Hold Applied» e «Credit Hold Released». Esempi BuonoIn sospesoSbloccato
	Team di vendita SalesTeam	Il team o il gruppo di vendita a cui viene attribuito l’ordine.
Descrizione Questo attributo identifica il team o il reparto responsabile della vendita. Serve a organizzare i rappresentanti commerciali e a gestire le aree di vendita o le linee di prodotto. Nel Process Mining, analizzare le prestazioni per team di vendita può far emergere le buone pratiche dei team con i risultati migliori o individuare problemi sistemici che interessano un team specifico. Può mettere in luce differenze nella qualità dell’inserimento dei dati, nelle approvazioni degli sconti o in altri fattori a monte che incidono sull’evasione dell’ordine. Perché è importante Consente di confrontare le prestazioni dei diversi team di vendita e di individuare le buone pratiche o le aree in cui è necessario un supporto. Dove reperirli Può essere un campo standard o personalizzato del record Sales Order, spesso collegato al record del dipendente che ricopre il ruolo di Sales Rep. Esempi Vendite Nord AmericaEnterprise EMEACanale APAC
	Tipo di ordine di vendita SalesOrderType	La classificazione dell’ordine di vendita, ad esempio standard, urgente o speciale.
Descrizione Questo attributo classifica gli ordini di vendita in base alla tipologia, che spesso determina il percorso e la priorità del processo. Per esempio, un «Ordine urgente» può saltare alcuni passaggi o essere soggetto a SLA più rigorosi rispetto a un «Ordine standard». Analizzare il processo in base alla tipologia di ordine è fondamentale per capire se le diverse varianti sono intenzionali ed efficaci. Aiuta a valutare se le procedure speciali previste per alcune tipologie portano davvero a risultati più rapidi o migliori e a quale costo. Perché è importante Consente di confrontare i diversi percorsi di processo previsti, ad esempio per gli ordini standard e urgenti, e verificare se producono i risultati attesi. Dove reperirli In genere è un campo personalizzato «Order Type» nel modulo Sales Order, poiché NetSuite utilizza moduli di transazione diversi, ad esempio Standard Sales Order e Standard Sales Order - Cash Sale, invece di prevedere un unico campo per la tipologia. Esempi Ordine standardOrdine urgenteOrdine di progetto
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’ultimo aggiornamento o dell’ultima estrazione dei dati dal sistema di origine.
Descrizione Questo attributo indica quando il set di dati è stato aggiornato l’ultima volta. Permette agli utenti aziendali di sapere quanto sono aggiornati i dati analizzati e di conoscere il periodo coperto dalle Dashboard e dalle analisi di Process Mining. Non viene utilizzato per analizzare il flusso del processo, ma è un metadato fondamentale per la governance dei dati e la fiducia degli utenti. Aiuta a valutare quanto siano aggiornate le informazioni e a sapere quando saranno disponibili i nuovi dati. Perché è importante Informa gli utenti sull’aggiornamento dei dati, un aspetto essenziale per prendere decisioni basate sull’analisi. Dove reperirli Questa data e ora vengono generate e associate al set di dati durante l’estrazione da NetSuite. Esempi 2023-10-27T02:00:00Z

Obbligatorio Consigliato Facoltativo

Attività del processo dall’ordine all’incasso: gestione degli ordini di vendita

Questi sono i passaggi e i traguardi principali da registrare nell’Event Log per individuare e analizzare il processo con precisione.

7 Consigliato 7 Facoltativo

	Attività	Descrizione
	Evasione dell’ordine creata	Questa attività segna l’inizio dell’evasione fisica in magazzino. Si verifica quando dalla transazione Sales Order viene generata una transazione 'Item Fulfillment'.
Perché è importante È una tappa fondamentale che collega il processo di vendita alle operazioni di magazzino. Il tempo che intercorre tra l’approvazione dell’ordine e la creazione dell’evasione è un indicatore importante della prontezza operativa. Dove reperirli È un evento esplicito. La data e l’ora corrispondono alla data di creazione del record 'Item Fulfillment', collegato al Sales Order di origine. Acquisizione Utilizzare la data di creazione della transazione Item Fulfillment collegata. Tipo di evento explicit
	Fattura creata	Indica la creazione della fattura relativa ai beni spediti o ai servizi forniti. È un evento esplicito, generato dalla creazione di una transazione 'Invoice' collegata all’ordine di vendita.
Perché è importante Questa attività è una tappa fondamentale per la rilevazione dei ricavi e segna l’inizio del ciclo di pagamento. Il tempo che intercorre tra la spedizione e la fatturazione incide direttamente sul flusso di cassa. Dove reperirli È un evento esplicito, ricavato dal campo 'Date Created' del record della transazione Invoice (tabella Transaction, Type='CustInvc'), collegato al Sales Order. Acquisizione Utilizzare la data di creazione della transazione Invoice collegata. Tipo di evento explicit
	Merce spedita	Questa tappa indica il momento in cui gli articoli lasciano il magazzino e sono in viaggio verso il cliente. Si deduce quando lo stato del record 'Item Fulfillment' viene aggiornato a 'Shipped'.
Perché è importante La spedizione è un passaggio fondamentale nella consegna al vettore e al cliente. Questo evento è essenziale per monitorare le prestazioni delle consegne puntuali e misurare il tempo di attraversamento complessivo dell’evasione dell’ordine. Dove reperirli Si deduce dal passaggio del campo 'Status' della transazione 'Item Fulfillment' collegata a 'Shipped'. La data e l’ora dell’evento corrispondono alla data di questa modifica di stato. Acquisizione Data e ora del passaggio a 'Shipped' nel record Item Fulfillment. Tipo di evento inferred
	Ordine di vendita approvato	Questa tappa indica che l’ordine di vendita ha superato tutti i controlli interni, ad esempio quelli sul credito e sulle scorte, ed è pronto per l’evasione. In genere si deduce dal passaggio dello stato dell’ordine a 'Pending Fulfillment'.
Perché è importante L’approvazione è un passaggio decisivo del processo. Misurare il tempo necessario per ottenerla aiuta a individuare i ritardi nelle verifiche interne e nei processi decisionali. Dove reperirli Si deduce da una modifica dello stato del record Sales Order. La data e l’ora vengono registrate quando il campo 'Order Status' viene aggiornato a 'Pending Fulfillment' o a uno stato personalizzato equivalente che indica l’approvazione. Acquisizione Data e ora del passaggio a 'Pending Fulfillment' nelle note di sistema del Sales Order. Tipo di evento inferred
	Ordine di vendita chiuso	È l’attività finale: indica che l’ordine di vendita è stato evaso e fatturato integralmente e può considerarsi completato. Si deduce dal passaggio dello stato dell’ordine di vendita a 'Closed'.
Perché è importante Questo evento segna la conclusione operativa del ciclo di vita dell’ordine. Il tempo che intercorre tra la creazione e la chiusura offre una visione completa della durata del processo end-to-end. Dove reperirli Si deduce dal passaggio del campo 'Status' della transazione Sales Order a 'Closed'. La data e l’ora si ricavano dalle note di sistema relative a questa modifica finale di stato. Acquisizione Data e ora del passaggio a 'Closed' nelle note di sistema del Sales Order. Tipo di evento inferred
	Ordine di vendita creato	Questa attività segna l’avvio ufficiale del processo relativo all’ordine di vendita. Si verifica quando una nuova transazione di vendita viene salvata per la prima volta in NetSuite e registra la richiesta iniziale del cliente.
Perché è importante È il principale evento di inizio del processo Order to Cash. Analizzare il tempo che intercorre tra questo evento e le attività successive è fondamentale per misurare l’efficienza complessiva dell’elaborazione degli ordini e i relativi tempi di ciclo. Dove reperirli È un evento esplicito, ricavato dal campo 'Date Created' del record della transazione Sales Order (tabella Transaction, Type='SalesOrd'). Acquisizione Utilizzare la data di creazione della transazione Sales Order. Tipo di evento explicit
	Pagamento ricevuto	Questa attività indica la ricezione del pagamento del cliente relativo a una fattura. Si rileva quando viene creata una transazione 'Customer Payment' e applicata alla fattura associata all’ordine di vendita.
Perché è importante In quanto evento conclusivo fondamentale, questa attività è essenziale per analizzare il ciclo di conversione della liquidità e le prestazioni dei pagamenti puntuali. Segna la conclusione positiva della transazione di vendita dal punto di vista finanziario. Dove reperirli È un evento esplicito. La data e l’ora corrispondono alla data di creazione della transazione 'Customer Payment' (tabella Transaction, Type='CustPymt') applicata alla fattura pertinente. Acquisizione Utilizzare la data della transazione Customer Payment applicata alla fattura. Tipo di evento explicit
	Articoli imballati	Indica che gli articoli prelevati sono stati imballati e sono pronti per la spedizione. Si rileva monitorando il passaggio dello stato del record 'Item Fulfillment' a 'Packed'.
Perché è importante Questa attività aiuta a misurare l’efficienza della postazione di imballaggio. Il tempo che intercorre tra il prelievo e l’imballaggio può rivelare limiti di capacità o inefficienze del processo. Dove reperirli Si deduce dal passaggio del campo 'Status' della transazione 'Item Fulfillment' collegata a 'Packed'. La data e l’ora dell’aggiornamento si ricavano dalle note di sistema. Acquisizione Data e ora del passaggio a 'Packed' nel record Item Fulfillment. Tipo di evento inferred
	Articoli prelevati	Indica che gli articoli dell’ordine sono stati prelevati dalle rispettive ubicazioni di magazzino. È un evento dedotto dalla modifica dello stato del record 'Item Fulfillment' associato.
Perché è importante Analizzare il tempo necessario per prelevare gli articoli è essenziale per ottimizzare l’efficienza del magazzino. Questa attività aiuta a misurare e individuare i colli di bottiglia nel processo di prelievo. Dove reperirli Si deduce dal passaggio del campo 'Status' della transazione 'Item Fulfillment' collegata a 'Picked'. La data e l’ora si ricavano dalle note di sistema relative a questa modifica di stato. Acquisizione Data e ora del passaggio a 'Picked' nel record Item Fulfillment. Tipo di evento inferred
	Nota di credito creata	L’evento si verifica quando viene emessa una nota di credito relativa a un ordine di vendita o a una fattura, in genere per resi, rettifiche di prezzo o altre concessioni. Si rileva quando viene creata una transazione 'Credit Memo'.
Perché è importante Le note di credito spesso segnalano problemi nel processo, come errori di spedizione o difetti del prodotto. Analizzarne la frequenza e i tempi aiuta a individuare le cause profonde e a migliorare la qualità complessiva. Dove reperirli È un evento esplicito, basato sulla creazione di una transazione 'Credit Memo' (tabella Transaction, Type='CredMemo'), collegabile alla fattura o all’ordine di vendita originale. Acquisizione Utilizzare la data di creazione della transazione Credit Memo collegata. Tipo di evento explicit
	Ordine di vendita modificato	Questa attività registra ogni modifica significativa apportata a un ordine di vendita dopo la sua creazione, ad esempio alle quantità, agli articoli o ai prezzi. Le modifiche vengono rilevate tramite gli aggiornamenti nelle note di sistema o nella traccia di audit.
Perché è importante Modifiche frequenti possono indicare errori di inserimento dei dati o una domanda dei clienti instabile, con conseguenti rilavorazioni e inefficienze. Monitorarle aiuta a individuare le cause profonde delle modifiche agli ordini. Dove reperirli Si ricava dalle note di sistema o dalla traccia di audit associate alla transazione Sales Order. Ogni modifica registrata a un campo pertinente può essere considerata un’occorrenza di questa attività. Acquisizione Individuare nelle note di sistema del Sales Order le modifiche ai campi successive alla creazione iniziale. Tipo di evento inferred
	Ordine sospeso per verifica del credito	L’evento si verifica quando un ordine di vendita viene sospeso per verifica del credito, automaticamente o manualmente, interrompendo il processo di evasione. In genere si deduce dal passaggio dello stato dell’ordine a 'Pending Approval' o a uno stato specifico di 'Credit Hold'.
Perché è importante Individuare quando e perché gli ordini vengono sospesi è fondamentale per capire i ritardi nel ciclo di evasione. Questa attività mette in evidenza i colli di bottiglia legati ai problemi di credito dei clienti. Dove reperirli Si deduce dalle note di sistema o dalla traccia di audit del record Sales Order, cercando in particolare le modifiche del campo 'Order Status' a uno stato di sospensione. Acquisizione Individuare la data e l’ora in cui lo stato dell’ordine passa a uno stato di sospensione per verifica del credito. Tipo di evento inferred
	Scorte impegnate	Questo evento indica il momento in cui le scorte vengono riservate ufficialmente per un ordine di vendita, garantendone la disponibilità per l’evasione. Si deduce osservando le variazioni della 'Committed Quantity' nelle righe dell’ordine di vendita.
Perché è importante Questa attività è fondamentale per analizzare l’efficienza dell’allocazione delle scorte. I ritardi tra l’approvazione dell’ordine e l’impegno delle scorte possono causare esaurimenti e compromettere le date di consegna promesse. Dove reperirli Si deduce dalle note di sistema delle righe articolo del Sales Order. La data e l’ora corrispondono al momento in cui il campo 'Quantity Committed' passa da zero a un valore positivo. Acquisizione Data e ora della modifica del campo 'Quantity Committed' nelle righe dell’ordine. Tipo di evento inferred
	Sospensione per verifica del credito revocata	Indica il momento in cui un ordine di vendita viene riattivato dopo la sospensione per verifica del credito e può proseguire verso l’evasione. Si rileva osservando il passaggio da uno stato di sospensione a uno stato aperto o approvato.
Perché è importante La durata delle sospensioni per verifica del credito è un KPI fondamentale. Questo evento consente di misurare il tempo necessario per risolvere i problemi di credito e il loro impatto sul ciclo complessivo Order to Cash. Dove reperirli Si deduce dalle note di sistema o dalla traccia di audit del record Sales Order, rilevando la data e l’ora in cui il campo 'Order Status' cambia da uno stato di sospensione. Acquisizione Individuare la data e l’ora in cui lo stato dell’ordine passa da uno stato di sospensione per verifica del credito a uno stato attivo. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione dei dati

Come ottenere i dati da NetSuite

Passaggi

Acceda e apra la sezione: acceda al proprio account NetSuite con le autorizzazioni necessarie per consultare i record delle transazioni e creare ricerche salvate.
Apra le ricerche salvate: raggiunga la pagina per creare una ricerca salvata tramite Reports > New Search. Selezioni Transazione come tipo di ricerca.
Crei la ricerca degli eventi degli ordini di vendita: imposti la prima ricerca per acquisire gli eventi relativi al record dell’ordine di vendita. Nella scheda Criteria, imposti Tipo su Sales Order e Main Line su True. Aggiunga un filtro Date Created per l’intervallo di tempo desiderato. Nella scheda Results, aggiunga le colonne e le formule indicate nella sezione delle query qui sotto per «Saved Search 1». Salvi la ricerca con il nome ProcessMind_SalesOrder_Events.
Crei la ricerca degli eventi di evasione: crei una nuova ricerca di tipo Transazione. In Criteria, imposti Tipo su Item Fulfillment e Main Line su True. Utilizzi Created From : Date Created per applicare lo stesso intervallo di date della prima ricerca. In Results, aggiunga le colonne necessarie, assicurandosi di recuperare l’ID SalesOrder dai campi Created From.... Utilizzi le formule indicate qui sotto in «Saved Search 2». Salvi la ricerca con il nome ProcessMind_Fulfillment_Events.
Crei la ricerca degli eventi di fatturazione: crei una terza ricerca di tipo Transazione. In Criteria, imposti Tipo su Fattura e Credit Memo. Imposti Main Line su True e applichi il filtro Date Created. In Results, aggiunga le colonne necessarie, come indicato qui sotto in «Saved Search 3», recuperando l’ID SalesOrder dai campi Created From.... Salvi la ricerca con il nome ProcessMind_Billing_Events.
Crei la ricerca degli eventi di pagamento: crei l’ultima ricerca di tipo Transazione. In Criteria, imposti Tipo su Customer Payment e Main Line su True. Applichi il filtro Date Created. In Results, aggiunga le colonne indicate in «Saved Search 4». Per collegare i dati all’ordine di vendita, occorre passare dalla fattura. Salvi la ricerca con il nome ProcessMind_Payment_Events.
Esegua ed esporti le ricerche: esegua singolarmente ciascuna delle quattro ricerche salvate. Nella pagina dei risultati, faccia clic sull’icona Export - CSV per scaricare i dati.
Combini i file CSV: utilizzi un foglio di calcolo come Microsoft Excel o un linguaggio di scripting come Python per aprire i quattro file CSV. Aggiunga le righe dei file relativi a evasione, fatturazione e pagamenti a quello degli eventi degli ordini di vendita. Prima di combinarli, verifichi che le intestazioni delle colonne siano identiche in tutti i file.
Completi l’Event Log: riveda il file combinato e salvi i dati consolidati in un unico file CSV, pronto per il caricamento.

Configurazione

Autorizzazioni: è necessario un ruolo utente con accesso in visualizzazione a Sales Orders, Item Fulfillments, Invoices, Customer Payments e System Notes. Occorre inoltre poter creare ed eseguire ricerche salvate di tipo «Transaction».
Definizione delle ricerche salvate: questo metodo prevede la creazione di quattro ricerche salvate separate, rispettivamente per gli eventi degli ordini di vendita, di evasione, di fatturazione e di pagamento, da combinare poi esternamente. Tutte le ricerche sono di tipo Transaction.
Filtro per data: è fondamentale applicare lo stesso intervallo di date a tutte le ricerche per ottenere un insieme completo di dati. Applichi il filtro al campo Date Created della transazione principale, ad esempio Sales Order Date Created per la prima ricerca e Created From : Date Created per quella di evasione.
Criterio Main Line: imposti il filtro Main Line su True nei criteri di ricerca. In questo modo si ottiene un evento per ogni record di transazione, anziché uno per ogni riga, semplificando l’Event Log.
Formule per le attività: le colonne ActivityName ed EventTime vengono generate con i campi Formula (Text) e Formula (DateTime), utilizzando istruzioni CASE. È necessario adattare le formule ai campi personalizzati o ai valori di stato specifici dell’azienda, ad esempio per i blocchi di credito.
Esportazioni pianificate: per automatizzare il processo, configuri ciascuna ricerca salvata in modo che invii i risultati tramite e-mail secondo una pianificazione. Apra la scheda E-mail nella definizione della ricerca salvata, selezioni Send Email Alerts When Records are Created/Updated e specifichi la pianificazione e i destinatari.

Query di esempio sql

-- This configuration describes the settings for four separate NetSuite Saved Searches.
-- The CSV results must be combined externally into a single file.

-- =========================================================================
-- Saved Search 1: ProcessMind_SalesOrder_Events
-- =========================================================================

-- Type: Transaction

-- Criteria:
--   Type = is "Sales Order"
--   Main Line = is true
--   System Notes : Field = is any of "Status", "[Your Custom Field for Credit Hold]"
--   Date Created = is within [Specify Date Range]

-- Results (Columns):
--   1. Formula (Text): {tranid} -> Header: SalesOrder
--   2. Formula (Text): CASE WHEN {systemnotes.type} = 'Create' THEN 'Sales Order Created' WHEN {systemnotes.field} = 'Status' AND {systemnotes.newvalue} like 'Pending Fulfillment%' THEN 'Sales Order Approved' WHEN {systemnotes.field} = 'Status' AND {systemnotes.newvalue} like '%Credit Hold%' THEN 'Credit Hold Applied' WHEN {systemnotes.field} = 'Status' AND {systemnotes.oldvalue} like '%Credit Hold%' THEN 'Credit Hold Released' WHEN {systemnotes.field} = 'Status' AND {systemnotes.newvalue} like 'Closed' THEN 'Sales Order Closed' WHEN {systemnotes.type} = 'Change' THEN 'Sales Order Changed' ELSE NULL END -> Header: ActivityName
--   3. Formula (DateTime): {systemnotes.date} -> Header: EventTime
--   4. System Notes : Set By -> Header: User
--   5. Name -> Header: CustomerName
--   6. Amount -> Header: TotalOrderAmount
--   7. Status -> Header: SalesOrderStatus
--   8. [Your Formula for Product Category] -> Header: ProductCategory
--   9. Ship Date -> Header: RequestedDeliveryDate
--   10. Terms -> Header: PaymentTerms
--   11. Created From : Document Number -> Header: InvoiceNumber

-- =========================================================================
-- Saved Search 2: ProcessMind_Fulfillment_Events
-- =========================================================================

-- Type: Transaction

-- Criteria:
--   Type = is "Item Fulfillment"
--   Main Line = is true
--   Created From : Date Created = is within [Specify Date Range]
--   System Notes : Field = is "Status"

-- Results (Columns):
--   1. Formula (Text): {createdfrom.tranid} -> Header: SalesOrder
--   2. Formula (Text): CASE WHEN {systemnotes.type} = 'Create' THEN 'Order Fulfillment Created' WHEN {systemnotes.newvalue} like 'Picked' THEN 'Goods Picked' WHEN {systemnotes.newvalue} like 'Packed' THEN 'Goods Packed' WHEN {systemnotes.newvalue} like 'Shipped' THEN 'Goods Shipped' ELSE NULL END -> Header: ActivityName
--   3. Formula (DateTime): {systemnotes.date} -> Header: EventTime
--   4. System Notes : Set By -> Header: User
--   5. Created From : Name -> Header: CustomerName
--   6. Created From : Amount -> Header: TotalOrderAmount
--   7. Created From : Status -> Header: SalesOrderStatus
--   8. [Your Formula for Product Category] -> Header: ProductCategory
--   9. Created From : Ship Date -> Header: RequestedDeliveryDate
--   10. Created From : Terms -> Header: PaymentTerms
--   11. NULL -> Header: InvoiceNumber

-- =========================================================================
-- Saved Search 3: ProcessMind_Billing_Events
-- =========================================================================

-- Type: Transaction

-- Criteria:
--   Type = is any of "Invoice", "Credit Memo"
--   Main Line = is true
--   Date Created = is within [Specify Date Range]

-- Results (Columns):
--   1. Formula (Text): {createdfrom.tranid} -> Header: SalesOrder
--   2. Formula (Text): CASE WHEN {type} = 'Invoice' THEN 'Invoice Created' WHEN {type} = 'Credit Memo' THEN 'Credit Memo Created' ELSE NULL END -> Header: ActivityName
--   3. Formula (DateTime): {datecreated} -> Header: EventTime
--   4. Created By -> Header: User
--   5. Name -> Header: CustomerName
--   6. Created From : Amount -> Header: TotalOrderAmount
--   7. Created From : Status -> Header: SalesOrderStatus
--   8. [Your Formula for Product Category] -> Header: ProductCategory
--   9. Created From : Ship Date -> Header: RequestedDeliveryDate
--   10. Terms -> Header: PaymentTerms
--   11. Document Number -> Header: InvoiceNumber

-- =========================================================================
-- Saved Search 4: ProcessMind_Payment_Events
-- =========================================================================

-- Type: Transaction

-- Criteria:
--   Type = is "Customer Payment"
--   Main Line = is true
--   Date Created = is within [Specify Date Range]

-- Results (Columns):
--   1. Formula (Text): {appliedtotransaction.createdfrom} -> Header: SalesOrder
--   2. Formula (Text): 'Payment Received' -> Header: ActivityName
--   3. Formula (DateTime): {datecreated} -> Header: EventTime
--   4. Created By -> Header: User
--   5. Customer : Company Name -> Header: CustomerName
--   6. Applied To Transaction : Created From : Amount -> Header: TotalOrderAmount
--   7. Applied To Transaction : Created From : Status -> Header: SalesOrderStatus
--   8. [Your Formula for Product Category] -> Header: ProductCategory
--   9. Applied To Transaction : Created From : Ship Date -> Header: RequestedDeliveryDate
--   10. Applied To Transaction : Terms -> Header: PaymentTerms
--   11. Applied To Transaction : Document Number -> Header: InvoiceNumber

Passaggi

Abiliti SuiteAnalytics Connect: acceda a NetSuite come amministratore. Apra Setup > Company > Enable Features. Nella scheda Analytics, verifichi che la casella SuiteAnalytics Connect sia selezionata. Salvi le modifiche.
Scarichi e installi il driver ODBC: in NetSuite, individui il collegamento «Set Up SuiteAnalytics Connect» nel portlet Settings della Dashboard principale. Scarichi il driver ODBC adatto al sistema operativo in uso (Windows, macOS o Linux) e lo installi sul computer dal quale eseguirà la query SQL.
Configuri l’origine dati ODBC (DSN): apra ODBC Data Source Administrator sul computer. Aggiunga un nuovo User DSN o System DSN utilizzando il driver NetSuite installato. Inserisca Service Host, Port, Data Source, Account ID e Role ID, disponibili nella pagina «Set Up SuiteAnalytics Connect» di NetSuite.
Si autentichi e si connetta: utilizzi un client SQL, ad esempio DBeaver, Microsoft Power BI o uno script Python con la libreria pyodbc, per connettersi al DSN configurato. Le verrà chiesto di inserire il nome utente e la password NetSuite.
Prepari la query SQL: copi nell’editor del client SQL l’intera query fornita nella sezione della query di questo documento.
Personalizzi i parametri della query: individui all’inizio della query la clausola WHERE T.Date_Created >= '[START_DATE_YYYY-MM-DD]'. Sostituisca il segnaposto [START_DATE_YYYY-MM-DD] con la data effettiva di inizio del periodo di estrazione.
Esegua la query: esegua la query SQL personalizzata sul database NetSuite. A seconda dell’intervallo di date e del volume dei dati, l’operazione può richiedere alcuni minuti.
Riveda i risultati: la query restituirà un’unica tabella consolidata che rappresenta l’Event Log. Ogni riga corrisponde a un’attività specifica nel ciclo di vita dell’ordine di vendita. Verifichi che non vi siano errori e che le colonne (SalesOrder, ActivityName, EventTime e così via) contengano i valori previsti.
Esporti l’Event Log: esporti i risultati della query dal client SQL in un file CSV. Verifichi che la codifica sia UTF-8 e che le intestazioni delle colonne corrispondano ai nomi degli attributi richiesti da ProcessMind.
Carichi i dati in ProcessMind: il file CSV ottenuto è pronto per essere caricato direttamente in ProcessMind e analizzato.

Configurazione

Prerequisiti: è necessario accedere a un account NetSuite con SuiteAnalytics Connect abilitato. Il ruolo dell’utente che si connette tramite ODBC deve disporre di autorizzazioni sufficienti per visualizzare i record delle transazioni, le note di sistema, i dati delle entità e le informazioni sui dipendenti.
Driver ODBC: sul computer client deve essere installato e configurato il driver ODBC NetSuite corretto. I dettagli di connessione (Account ID, Role ID e Server) sono disponibili nella pagina di configurazione di SuiteAnalytics Connect in NetSuite.
Filtro per intervallo di date: la clausola WHERE T.Date_Created >= '[START_DATE_YYYY-MM-DD]' nella Common Table Expression (CTE) iniziale è il principale criterio per limitare i dati e incidere sulle prestazioni. È fondamentale specificare una data di inizio per evitare di interrogare l’intera cronologia, operazione che può essere estremamente lenta. Si consiglia di iniziare con un periodo compreso tra 3 e 6 mesi.
Tipi di transazione: la query filtra esplicitamente i tipi di transazione NetSuite standard, come 'SalesOrd', 'ItemShip', 'CustInvc', 'CustCred' e 'CustPymt'. Se l’organizzazione utilizza tipi di transazione personalizzati per il processo Order to Cash, dovrà aggiungerli alle clausole WHERE pertinenti.
Note di sistema: molte attività importanti, come le modifiche di stato e i blocchi, derivano dalla tabella System_Notes. Per acquisire correttamente questi eventi, è essenziale che il controllo sia abilitato per il campo 'Status' nei record delle transazioni.
Considerazioni sulle prestazioni: la query unisce diverse tabelle di grandi dimensioni, tra cui Transaction e System_Notes. Negli account NetSuite con volumi elevati di transazioni, può richiedere molte risorse. È consigliabile eseguirla nelle fasce orarie di minore attività.

Query di esempio sql

WITH SalesOrders AS (
    SELECT
        T.Transaction_ID,
        T.TranID AS SalesOrder_Number,
        T.Foreign_Total AS Total_Amount,
        T.Status AS Current_Status,
        T.Ship_Date AS Requested_Delivery_Date,
        CUST.Company_Name AS Customer_Name,
        TERMS.Term_Name AS Payment_Terms,
        (SELECT LIST_AGG(IT.Display_Name, ', ') FROM Transaction_Lines TL JOIN Item IT ON TL.Item_ID = IT.Item_ID WHERE TL.Transaction_ID = T.Transaction_ID) AS Product_Category_List -- Simplified product category
    FROM
        "Transaction" T
    JOIN
        Entity CUST ON T.Entity_ID = CUST.Entity_ID
    LEFT JOIN
        Terms ON T.Terms_ID = TERMS.Terms_ID
    WHERE
        T.Type = 'SalesOrd'
        AND T.Date_Created >= TO_TIMESTAMP_NTZ('[START_DATE_YYYY-MM-DD]', 'YYYY-MM-DD')
)
-- 1. Sales Order Created
SELECT
    SO.SalesOrder_Number AS "SalesOrder",
    'Sales Order Created' AS "ActivityName",
    T.Date_Created AS "EventTime",
    E.First_Name || ' ' || E.Last_Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    T.Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM
    "Transaction" T
JOIN
    SalesOrders SO ON T.Transaction_ID = SO.Transaction_ID
LEFT JOIN
    Employee E ON T.Created_By_ID = E.Employee_ID

UNION ALL

-- 2, 3, 4, 14. Status Changes (Credit Hold, Released, Approved, Closed)
SELECT
    SO.SalesOrder_Number AS "SalesOrder",
    CASE
        WHEN SN.New_Value LIKE '%Pending Approv%' OR SN.New_Value LIKE '%Credit Hold%' THEN 'Credit Hold Applied'
        WHEN SN.Old_Value LIKE '%Pending Approv%' AND SN.New_Value LIKE '%Pending Fulfill%' THEN 'Credit Hold Released'
        WHEN SN.New_Value LIKE '%Pending Fulfill%' THEN 'Sales Order Approved'
        WHEN SN.New_Value LIKE '%Closed%' OR SN.New_Value LIKE '%Billed%' THEN 'Sales Order Closed'
    END AS "ActivityName",
    SN.Date AS "EventTime",
    SN.Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SN.New_Value AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM
    System_Notes SN
JOIN
    SalesOrders SO ON SN.Transaction_ID = SO.Transaction_ID
WHERE
    SN.Field = 'TRANSACTION.STATUS' AND "ActivityName" IS NOT NULL

UNION ALL

-- 5. Sales Order Changed
SELECT
    SO.SalesOrder_Number AS "SalesOrder",
    'Sales Order Changed' AS "ActivityName",
    SN.Date AS "EventTime",
    SN.Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM
    System_Notes SN
JOIN
    SalesOrders SO ON SN.Transaction_ID = SO.Transaction_ID
WHERE 
    SN.Record_Type_ID = -30 -- Sales Order Transaction Type ID
    AND SN.Field NOT IN ('TRANSACTION.STATUS', 'TRANSACTION.MEMO') -- Exclude simple status or memo changes
    AND SN.Date > (SELECT T.Date_Created FROM "Transaction" T WHERE T.Transaction_ID = SO.Transaction_ID)

UNION ALL

-- 6. Inventory Committed
SELECT DISTINCT
    SO.SalesOrder_Number AS "SalesOrder",
    'Inventory Committed' AS "ActivityName",
    SN.Date AS "EventTime",
    SN.Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM
    System_Notes SN
JOIN
    Transaction_Lines TL ON SN.Transaction_Line_ID = TL.Transaction_Line_ID AND SN.Transaction_ID = TL.Transaction_ID
JOIN
    SalesOrders SO ON TL.Transaction_ID = SO.Transaction_ID
WHERE
    SN.Field = 'TRANSACTION_LINES.QUANTITY_COMMITTED'
    AND SN.New_Value > 0 AND (SN.Old_Value = 0 OR SN.Old_Value IS NULL)

UNION ALL

-- 7. Order Fulfillment Created
SELECT
    SO.SalesOrder_Number AS "SalesOrder",
    'Order Fulfillment Created' AS "ActivityName",
    IFF.Date_Created AS "EventTime",
    E.First_Name || ' ' || E.Last_Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM
    "Transaction" IFF
JOIN
    Transaction_Links TL ON IFF.Transaction_ID = TL.Transaction_ID
JOIN
    SalesOrders SO ON TL.Previous_Transaction_ID = SO.Transaction_ID
LEFT JOIN
    Employee E ON IFF.Created_By_ID = E.Employee_ID
WHERE
    IFF.Type = 'ItemShip'

UNION ALL

-- 8, 9, 10. Goods Picked, Packed, Shipped
SELECT 
    SO.SalesOrder_Number AS "SalesOrder",
    CASE 
        WHEN SN.New_Value = 'Picked' THEN 'Goods Picked'
        WHEN SN.New_Value = 'Packed' THEN 'Goods Packed'
        WHEN SN.New_Value = 'Shipped' THEN 'Goods Shipped'
    END AS "ActivityName",
    SN.Date AS "EventTime",
    SN.Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM 
    System_Notes SN
JOIN 
    "Transaction" IFF ON SN.Transaction_ID = IFF.Transaction_ID
JOIN 
    Transaction_Links TL ON IFF.Transaction_ID = TL.Transaction_ID
JOIN 
    SalesOrders SO ON TL.Previous_Transaction_ID = SO.Transaction_ID
WHERE 
    IFF.Type = 'ItemShip'
    AND SN.Field = 'TRANSACTION.STATUS'
    AND "ActivityName" IS NOT NULL

UNION ALL

-- 11. Invoice Created
SELECT
    SO.SalesOrder_Number AS "SalesOrder",
    'Invoice Created' AS "ActivityName",
    INV.Date_Created AS "EventTime",
    E.First_Name || ' ' || E.Last_Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    INV.TranID AS "InvoiceNumber"
FROM
    "Transaction" INV
JOIN
    Transaction_Links TL ON INV.Transaction_ID = TL.Transaction_ID
JOIN
    SalesOrders SO ON TL.Previous_Transaction_ID = SO.Transaction_ID
LEFT JOIN
    Employee E ON INV.Created_By_ID = E.Employee_ID
WHERE
    INV.Type = 'CustInvc'

UNION ALL

-- 12. Credit Memo Created
SELECT
    SO.SalesOrder_Number AS "SalesOrder",
    'Credit Memo Created' AS "ActivityName",
    CM.Date_Created AS "EventTime",
    E.First_Name || ' ' || E.Last_Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    NULL AS "InvoiceNumber"
FROM
    "Transaction" CM
JOIN
    Transaction_Links TL ON CM.Transaction_ID = TL.Transaction_ID
JOIN
    SalesOrders SO ON TL.Previous_Transaction_ID = SO.Transaction_ID
LEFT JOIN
    Employee E ON CM.Created_By_ID = E.Employee_ID
WHERE
    CM.Type = 'CustCred'

UNION ALL

-- 13. Payment Received
SELECT DISTINCT
    SO.SalesOrder_Number AS "SalesOrder",
    'Payment Received' AS "ActivityName",
    PAY.Date_Created AS "EventTime",
    E.First_Name || ' ' || E.Last_Name AS "User",
    SO.Customer_Name AS "CustomerName",
    SO.Total_Amount AS "TotalOrderAmount",
    SO.Current_Status AS "SalesOrderStatus",
    SO.Product_Category_List AS "ProductCategory",
    SO.Requested_Delivery_Date AS "RequestedDeliveryDate",
    SO.Payment_Terms AS "PaymentTerms",
    INV.TranID AS "InvoiceNumber"
FROM 
    "Transaction" PAY
JOIN 
    Transaction_Links PAY_LINK ON PAY.Transaction_ID = PAY_LINK.Transaction_ID -- Payment to Invoice link
JOIN 
    "Transaction" INV ON PAY_LINK.Previous_Transaction_ID = INV.Transaction_ID AND INV.Type = 'CustInvc'
JOIN 
    Transaction_Links INV_LINK ON INV.Transaction_ID = INV_LINK.Transaction_ID -- Invoice to SO link
JOIN 
    SalesOrders SO ON INV_LINK.Previous_Transaction_ID = SO.Transaction_ID
LEFT JOIN
    Employee E ON PAY.Created_By_ID = E.Employee_ID
WHERE 
    PAY.Type = 'CustPymt'
ORDER BY "SalesOrder", "EventTime";

Passaggi

Prerequisito: configuri NetSuite per l’accesso API a. Apra Setup > Integration > Manage Integrations > New. b. Crei un nuovo record Integration. Abiliti Token-Based Authentication e annoti il Consumer Key e il Consumer Secret generati. c. Apra Setup > Users/Roles > Manage Roles > New. d. Crei un nuovo ruolo con autorizzazioni per Transactions (Sales Order, Item Fulfillment, Invoice e così via), Lists (Customers, Employees), Setup (Log in using Access Tokens) e SuiteAnalytics Connect. Assegni il ruolo a un utente specifico. e. Apra Setup > Users/Roles > Access Tokens > New. f. Crei un nuovo Access Token, selezionando il record Integration, l’utente e il ruolo appena creati. Annoti il Token ID e il Token Secret generati. g. Individui l’Account ID aprendo Setup > Integration > SOAP Web Services Preferences. Il valore è indicato come Account ID.
Configuri l’ambiente Python locale a. Verifichi di avere installato Python 3.6 o una versione successiva. b. Apra il terminale o il prompt dei comandi e installi le librerie necessarie: pip install requests requests_oauthlib pandas.
Crei lo script di estrazione Python a. Crei un nuovo file Python, ad esempio extract_netsuite_otc.py. b. Copi in questo file lo script Python completo riportato nella sezione della query qui sotto.
Configuri i parametri dello script a. Apra lo script e individui la sezione dei segnaposto all’inizio. b. Inserisca ACCOUNT_ID, CONSUMER_KEY, CONSUMER_SECRET, TOKEN_ID e TOKEN_SECRET di NetSuite, ottenuti al passaggio 1. c. Imposti START_DATE e END_DATE per definire il periodo di estrazione. Il formato richiesto è 'YYYY-MM-DD'.
Esegua lo script di estrazione a. Esegua lo script dal terminale: python extract_netsuite_otc.py. b. Lo script si connetterà all’API REST di NetSuite, eseguirà la query SuiteQL e gestirà la paginazione per recuperare tutti i dati. c. Nella console verranno visualizzati messaggi di avanzamento che indicano la pagina di dati in fase di acquisizione.
Riveda i dati grezzi a. Al termine dell’esecuzione, nella stessa directory verrà creato il file netsuite_otc_event_log.csv.
Trasformi e prepari i dati a. Lo script applica automaticamente le trasformazioni necessarie e associa i risultati della query ai nomi di colonna specificati: SalesOrder, ActivityName, EventTime, User, CustomerName e così via. b. Lo script assicura che la colonna EventTime utilizzi un formato timestamp standard.
Prepari il file per il caricamento in ProcessMind a. Il file netsuite_otc_event_log.csv viene generato nel formato corretto. b. Verifichi che le intestazioni delle colonne corrispondano agli attributi obbligatori e consigliati. c. Il file è pronto per essere caricato in ProcessMind e analizzato.

Configurazione

Credenziali di autenticazione: nello script Python occorre inserire Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret di NetSuite. Questi valori vengono generati dai record Integration e Access Token in NetSuite.
Endpoint API: lo script utilizza l’endpoint delle query SuiteQL di NetSuite: [your_account_specific_domain]/services/rest/query/v1/suiteql.
Intervallo di date: è necessario impostare START_DATE e END_DATE. Per l’analisi iniziale si consiglia un periodo di 3-6 mesi, così da bilanciare il volume dei dati e le informazioni sul processo. Per le istanze di grandi dimensioni, inizi con un periodo più breve, ad esempio un mese, per valutare le prestazioni.
Filtro per filiale: la query SuiteQL fornita contiene il segnaposto /* AND t.subsidiary = '[Your Subsidiary ID]' */. Se opera in un ambiente con più filiali, rimuova i commenti da questa riga e la aggiorni in ogni istruzione SELECT per filtrare una filiale specifica.
Prestazioni: l’estrazione recupera i dati in pagine, con un valore predefinito di 1.000 record per pagina, per gestire l’utilizzo della memoria e rispettare i limiti dell’API. Con insiemi di dati molto estesi, relativi a più anni, l’estrazione può richiedere molto tempo a causa dei limiti di frequenza imposti da NetSuite.
Prerequisiti: il ruolo NetSuite associato al token di accesso deve disporre di autorizzazioni sufficienti per visualizzare i record Sales Orders, Item Fulfillments, Invoices, Credit Memos, Customer Payments, Customers, Employees e System Notes. È inoltre necessario poter accedere a SuiteAnalytics Connect.

Query di esempio python

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

class=class="hl-string">"hl-comment"># --- Configuration Section --- #
class=class="hl-string">"hl-comment"># Replace with your NetSuite account-specific details
ACCOUNT_ID = class="hl-string">'[Your NetSuite Account ID]'
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]'

class=class="hl-string">"hl-comment"># The base URL for the REST API, typically requires replacing hyphens with underscores in the account ID for the domain
class=class="hl-string">"hl-comment"># e.g., if your account ID is 1234567-sb1, the domain part would be 1234567_sb1.suitetalk.api.netsuite.com
class=class="hl-string">"hl-comment"># For production accounts, it's just the account ID, e.g., 1234567.suitetalk.api.netsuite.com
BASE_URL = fclass="hl-string">'https://{ACCOUNT_ID.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' class=class="hl-string">"hl-comment"># Inclusive
END_DATE = class="hl-string">'2023-12-31'   class=class="hl-string">"hl-comment"># Inclusive
OUTPUT_FILE = class="hl-string">'netsuite_otc_event_log.csv'

class=class="hl-string">"hl-comment"># --- SuiteQL Query --- #
class=class="hl-string">"hl-comment"># This query unions data from multiple sources to create a comprehensive event log.
SUITEQL_QUERY = fclass="hl-string">"""
-- 1. Sales Order Created
SELECT
    t.tranId AS SalesOrder,
    'Sales Order Created' AS ActivityName,
    t.createdDate AS EventTime,
    BUILTIN.DF(t.entity) AS CustomerName,
    BUILTIN.DF(t.salesRep) AS User,
    t.total AS TotalOrderAmount,
    BUILTIN.DF(t.status) AS SalesOrderStatus,
    BUILTIN.DF(tl.item) AS ProductCategory, -- Simplified, assumes first line item category is representative
    t.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(t.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM
    Transaction AS t
    JOIN TransactionLine AS tl ON t.id = tl.transaction
WHERE
    t.type = 'SalesOrd'
    AND tl.mainLine = 'F'
    AND tl.item IS NOT NULL
    AND t.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND t.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 2. Credit Hold Applied / 3. Credit Hold Released / 4. Sales Order Approved / 14. Sales Order Closed
SELECT
    t.tranId AS SalesOrder,
    CASE 
        WHEN sn.newValue LIKE '%Pending Approv%' THEN 'Credit Hold Applied'
        WHEN sn.oldValue LIKE '%Pending Approv%' AND sn.newValue LIKE '%Pending Fulfill%' THEN 'Credit Hold Released'
        WHEN sn.newValue LIKE '%Pending Fulfill%' THEN 'Sales Order Approved'
        WHEN sn.newValue LIKE '%Closed%' THEN 'Sales Order Closed'
    END AS ActivityName,
    sn.date AS EventTime,
    BUILTIN.DF(t.entity) AS CustomerName,
    BUILTIN.DF(sn.author) AS User,
    t.total AS TotalOrderAmount,
    sn.newValue AS SalesOrderStatus,
    NULL AS ProductCategory,
    t.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(t.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM
    Transaction AS t
    JOIN SystemNote AS sn ON sn.recordId = t.id
WHERE
    t.type = 'SalesOrd'
    AND sn.field = 'TRANSACTION.STATUS'
    AND t.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    AND CASE 
        WHEN sn.newValue LIKE '%Pending Approv%' THEN 1
        WHEN sn.oldValue LIKE '%Pending Approv%' AND sn.newValue LIKE '%Pending Fulfill%' THEN 1
        WHEN sn.newValue LIKE '%Pending Fulfill%' THEN 1
        WHEN sn.newValue LIKE '%Closed%' THEN 1
        ELSE 0
    END = 1
    /* AND t.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 5. Sales Order Changed
SELECT
    t.tranId AS SalesOrder,
    'Sales Order Changed' AS ActivityName,
    sn.date AS EventTime,
    BUILTIN.DF(t.entity) AS CustomerName,
    BUILTIN.DF(sn.author) AS User,
    t.total AS TotalOrderAmount,
    BUILTIN.DF(t.status) AS SalesOrderStatus,
    NULL AS ProductCategory,
    t.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(t.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM
    Transaction AS t
    JOIN SystemNote AS sn ON sn.recordId = t.id
WHERE
    t.type = 'SalesOrd'
    AND sn.field IN ('TRANSACTION.TRANDATE', 'TRANSACTION.SHIPDATE', 'TRANSACTIONLINE.QUANTITY', 'TRANSACTIONLINE.RATE')
    AND t.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND t.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 6. Inventory Committed (approximated by 'Sales Order Approved' event)
SELECT
    t.tranId AS SalesOrder,
    'Inventory Committed' AS ActivityName,
    sn.date AS EventTime,
    BUILTIN.DF(t.entity) AS CustomerName,
    BUILTIN.DF(sn.author) AS User,
    t.total AS TotalOrderAmount,
    sn.newValue AS SalesOrderStatus,
    NULL AS ProductCategory,
    t.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(t.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM
    Transaction AS t
    JOIN SystemNote AS sn ON sn.recordId = t.id
WHERE
    t.type = 'SalesOrd'
    AND sn.field = 'TRANSACTION.STATUS'
    AND sn.newValue LIKE '%Pending Fulfill%'
    AND t.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND t.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 7. Order Fulfillment Created
SELECT
    so.tranId AS SalesOrder,
    'Order Fulfillment Created' AS ActivityName,
    ful.createdDate AS EventTime,
    BUILTIN.DF(so.entity) AS CustomerName,
    BUILTIN.DF(ful.createdby) AS User,
    so.total AS TotalOrderAmount,
    BUILTIN.DF(so.status) AS SalesOrderStatus,
    NULL AS ProductCategory,
    so.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(so.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM
    Transaction AS ful
    JOIN TransactionLink AS tl ON ful.id = tl.id
    JOIN Transaction AS so ON so.id = tl.previousdoc
WHERE
    ful.type = 'ItemShip'
    AND so.type = 'SalesOrd'
    AND so.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND so.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 8. Goods Picked / 9. Goods Packed / 10. Goods Shipped
SELECT
    so.tranId AS SalesOrder,
    CASE 
        WHEN sn.newValue LIKE '%Picked%' THEN 'Goods Picked'
        WHEN sn.newValue LIKE '%Packed%' THEN 'Goods Packed'
        WHEN sn.newValue LIKE '%Shipped%' THEN 'Goods Shipped'
    END AS ActivityName,
    sn.date AS EventTime,
    BUILTIN.DF(so.entity) AS CustomerName,
    BUILTIN.DF(sn.author) AS User,
    so.total AS TotalOrderAmount,
    BUILTIN.DF(so.status) AS SalesOrderStatus,
    NULL AS ProductCategory,
    so.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(so.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM
    Transaction AS ful
    JOIN SystemNote AS sn ON sn.recordId = ful.id
    JOIN TransactionLink AS tl ON ful.id = tl.id
    JOIN Transaction AS so ON so.id = tl.previousdoc
WHERE
    ful.type = 'ItemShip'
    AND so.type = 'SalesOrd'
    AND sn.field = 'TRANSACTION.STATUS'
    AND so.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND so.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 11. Invoice Created
SELECT
    so.tranId AS SalesOrder,
    'Invoice Created' AS ActivityName,
    inv.createdDate AS EventTime,
    BUILTIN.DF(so.entity) AS CustomerName,
    BUILTIN.DF(inv.createdby) AS User,
    so.total AS TotalOrderAmount,
    BUILTIN.DF(so.status) AS SalesOrderStatus,
    NULL AS ProductCategory,
    so.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(so.terms) AS PaymentTerms,
    inv.tranId AS InvoiceNumber
FROM
    Transaction AS inv
    JOIN TransactionLink AS tl ON inv.id = tl.id
    JOIN Transaction AS so ON so.id = tl.previousdoc
WHERE
    inv.type = 'CustInvc'
    AND so.type = 'SalesOrd'
    AND so.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND so.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 12. Credit Memo Created
SELECT 
    so.tranId AS SalesOrder,
    'Credit Memo Created' AS ActivityName,
    cm.createdDate AS EventTime,
    BUILTIN.DF(so.entity) AS CustomerName,
    BUILTIN.DF(cm.createdby) AS User,
    so.total AS TotalOrderAmount,
    BUILTIN.DF(so.status) AS SalesOrderStatus,
    NULL AS ProductCategory,
    so.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(so.terms) AS PaymentTerms,
    NULL AS InvoiceNumber
FROM 
    Transaction cm
    JOIN TransactionLink tl ON cm.id = tl.id
    JOIN Transaction so ON tl.previousdoc = so.id
WHERE 
    cm.type = 'CustCred'
    AND so.type = 'SalesOrd'
    AND so.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND so.subsidiary = '[Your Subsidiary ID]' */

UNION ALL

-- 13. Payment Received
SELECT
    so.tranId AS SalesOrder,
    'Payment Received' AS ActivityName,
    payment.createdDate AS EventTime,
    BUILTIN.DF(so.entity) AS CustomerName,
    BUILTIN.DF(payment.createdby) AS User,
    so.total AS TotalOrderAmount,
    BUILTIN.DF(so.status) AS SalesOrderStatus,
    NULL AS ProductCategory,
    so.shipDate AS RequestedDeliveryDate,
    BUILTIN.DF(so.terms) AS PaymentTerms,
    inv.tranId AS InvoiceNumber
FROM
    Transaction AS payment
    JOIN TransactionLink AS paymentLink ON payment.id = paymentLink.id
    JOIN Transaction AS inv ON paymentLink.previousdoc = inv.id
    JOIN TransactionLink AS invLink ON inv.id = invLink.id
    JOIN Transaction AS so ON invLink.previousdoc = so.id
WHERE
    payment.type = 'CustPymt'
    AND inv.type = 'CustInvc'
    AND so.type = 'SalesOrd'
    AND so.createdDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    /* AND so.subsidiary = '[Your Subsidiary ID]' */
"""

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

    oauth = OAuth1(
        client_key=CONSUMER_KEY,
        client_secret=CONSUMER_SECRET,
        resource_owner_key=TOKEN_ID,
        resource_owner_secret=TOKEN_SECRET,
        realm=ACCOUNT_ID,
        signature_method=class="hl-string">'HMAC-SHA256'
    )

    while True:
        paginated_query = {
            class="hl-string">'q': query
        }

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

        rest_url = fclass="hl-string">"{BASE_URL}?limit={limit}&offset={offset}"

        try:
            print(fclass="hl-string">"Fetching data... Page offset: {offset}")
            response = requests.post(rest_url, headers=headers, json=paginated_query, auth=oauth)
            response.raise_for_status()  class=class="hl-string">"hl-comment"># Raises an HTTPError for bad responses (4xx or 5xx)

            data = response.json()
            results = data.get(class="hl-string">'items', [])
            all_results.extend(results)

            if not data.get(class="hl-string">'hasMore', False):
                print(class="hl-string">"No more pages to fetch.")
                break

            offset += limit
            class=class="hl-string">"hl-comment"># Respect API concurrency limits
            time.sleep(1)

        except requests.exceptions.HTTPError as e:
            print(fclass="hl-string">"HTTP Error: {e}")
            print(fclass="hl-string">"Response Body: {e.response.text}")
            break
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Request Error: {e}")
            break
        except json.JSONDecodeError:
            print(fclass="hl-string">"JSON Decode Error. Response was: {response.text}")
            break

    return all_results

if __name__ == class="hl-string">"__main__":
    print(class="hl-string">"Starting NetSuite Order-to-Cash extraction...")
    
    results = execute_suiteql_query(SUITEQL_QUERY)

    if results:
        df = pd.json_normalize(results)
        class=class="hl-string">"hl-comment"># Rename columns to match ProcessMind requirements
        df.columns = [c.replace(class="hl-string">'.', class="hl-string">'_') for c in df.columns] class=class="hl-string">"hl-comment"># Flatten nested names
        df.rename(columns={
            class="hl-string">'salesorder': class="hl-string">'SalesOrder',
            class="hl-string">'activityname': class="hl-string">'ActivityName',
            class="hl-string">'eventtime': class="hl-string">'EventTime',
            class="hl-string">'customername': class="hl-string">'CustomerName',
            class="hl-string">'user': class="hl-string">'User',
            class="hl-string">'totalorderamount': class="hl-string">'TotalOrderAmount',
            class="hl-string">'salesorderstatus': class="hl-string">'SalesOrderStatus',
            class="hl-string">'productcategory': class="hl-string">'ProductCategory',
            class="hl-string">'requesteddeliverydate': class="hl-string">'RequestedDeliveryDate',
            class="hl-string">'paymentterms': class="hl-string">'PaymentTerms',
            class="hl-string">'invoicenumber': class="hl-string">'InvoiceNumber'
        }, inplace=True)
        
        class=class="hl-string">"hl-comment"># Ensure all required columns exist
        required_cols = [class="hl-string">'SalesOrder', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'CustomerName', class="hl-string">'User', class="hl-string">'TotalOrderAmount', class="hl-string">'SalesOrderStatus', class="hl-string">'ProductCategory', class="hl-string">'RequestedDeliveryDate', class="hl-string">'PaymentTerms', class="hl-string">'InvoiceNumber']
        for col in required_cols:
            if col not in df.columns:
                df[col] = None

        class=class="hl-string">"hl-comment"># Convert EventTime to datetime and format it
        df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
        df = df.sort_values(by=[class="hl-string">'SalesOrder', class="hl-string">'EventTime'])

        df.to_csv(OUTPUT_FILE, index=False)
        print(fclass="hl-string">"Successfully extracted {len(df)} events to {OUTPUT_FILE}")
    else:
        print(class="hl-string">"No data returned from the query.")

È pronto per iniziare?

Utilizzi questo template per semplificare la raccolta dei dati e iniziare a individuare informazioni utili sull’elaborazione degli ordini di vendita nel processo Order to Cash di NetSuite. Inizi oggi a ottimizzare i processi.

Torna alla guida al miglioramento

Scarica il template

Incassi più rapidi: ottimizzi oggi l’elaborazione degli ordini di vendita

Si unisca alle aziende che hanno ridotto del 30% il tempo di ciclo del processo Order to Cash.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito. La configurazione richiede pochi minuti.

Il Suo Template dei dati per il processo dall’ordine all’incasso: gestione degli ordini di vendita

Il Suo Template dei dati per il processo dall’ordine all’incasso: gestione degli ordini di vendita

Attributi del processo dall’ordine all’incasso: gestione degli ordini di vendita

Attività del processo dall’ordine all’incasso: gestione degli ordini di vendita

Guide all’estrazione dei dati

Ricerca salvata NetSuite ed esportazione CSV automatizzata

Passaggi

Configurazione

Query di esempio sql

Query SQL NetSuite SuiteAnalytics Connect (ODBC)

Passaggi

Configurazione

Query di esempio sql

Estrazione con Python tramite SuiteTalk REST Web Services

Passaggi

Configurazione

Query di esempio python

È pronto per iniziare?

Incassi più rapidi: ottimizzi oggi l’elaborazione degli ordini di vendita