> Miglioramento continuo dei processi > Elaborazione delle fatture fornitori > NetSuite > Template dei dati

Il template dei dati per l’elaborazione delle fatture fornitori

NetSuite

Attributi per l’elaborazione delle fatture fornitori(21) Attività di elaborazione delle fatture fornitori(14) Guide all’estrazione(4)

Il template dei dati per l’elaborazione delle fatture fornitori

Questo template completo La guida nella raccolta dei dati necessari per ottimizzare l’elaborazione delle fatture fornitori. Indica gli attributi essenziali da raccogliere e le attività chiave da monitorare nell’Event Log. Include inoltre indicazioni pratiche per estrarre questi dati da NetSuite, così da disporre di tutte le informazioni necessarie per analizzare e migliorare il processo con precisione.

Attributi consigliati da raccogliere
Attività chiave da monitorare
Indicazioni per l’estrazione da NetSuite

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

Scarica il template

Attributi per l’elaborazione delle fatture fornitori

Questi sono i campi dati consigliati da includere nell’Event Log per un’analisi completa dell’elaborazione delle fatture fornitori.

5 Obbligatorio 6 Consigliato 10 Facoltativo

	Nome	Descrizione
	Attività ActivityName	Nome dell’attività aziendale o dell’evento che si è verificato nel processo di gestione della fattura.
Descrizione Questo attributo descrive una fase o una tappa specifica del processo di contabilità fornitori, ad esempio 'Fattura del fornitore creata', 'Fattura approvata' o 'Pagamento eseguito'. Analizzare la sequenza e la frequenza di queste attività è il fulcro del Process Mining. Consente di visualizzare il flusso del processo, individuare le varianti più e meno frequenti e rilevare colli di bottiglia o scostamenti dalla procedura standard. Le attività definite costituiscono i nodi della mappa del processo. Perché è importante Definisce le fasi del processo e consente di visualizzarne la mappa, calcolare i tempi di transizione e individuare colli di bottiglia e cicli di rilavorazione. Dove reperirli Ricavato dai log di sistema, dalle tracce di audit o dalle modifiche di stato della fattura del fornitore e dei record di pagamento correlati in NetSuite. Spesso è necessario applicare logiche di trasformazione. Esempi Fattura fornitore creataFattura approvataPagamento eseguitoDiscrepanza individuata
	Fattura Invoice	Identificativo univoco di ciascuna fattura del fornitore.
Descrizione La 'Fattura' è l’identificativo principale del caso e collega tutte le attività, dal momento della ricezione fino al pagamento finale. Questo attributo è essenziale per ricostruire l’intero percorso di ogni fattura. Nell’analisi consente di filtrare e aggregare i dati e di esaminare nel dettaglio i flussi di processo delle singole fatture; costituisce inoltre la base per l’analisi delle varianti e il calcolo dei tempi di ciclo. Perché è importante È l’attributo fondamentale che collega tutti gli eventi correlati in un’unica istanza di processo e consente di analizzare l’intero ciclo di vita di ogni fattura. Dove reperirli È la chiave primaria del record della transazione Vendor Bill in NetSuite, spesso indicata come Transaction ID o Document Number. Esempi INV-2023-001237894561VN54321A
	Ora di inizio EventTime	Data e ora che indicano quando è iniziata un’attività o un evento.
Descrizione Questo attributo registra la data e l’ora esatte in cui si è verificata una specifica attività. Definisce l’ordine cronologico degli eventi all’interno di ogni caso. È essenziale per tutte le analisi basate sul tempo, compreso il calcolo dei tempi di ciclo tra le attività e della durata complessiva del processo, nonché l’individuazione dei ritardi. Consente di ordinare correttamente gli eventi e costituisce la base per indicatori di prestazione come 'Tempo medio di approvazione delle fatture' e 'Giorni medi di pagamento dei debiti'. Perché è importante Fornisce la sequenza cronologica degli eventi, indispensabile per calcolare tutte le metriche basate sulla durata, individuare i colli di bottiglia e comprendere le prestazioni del processo. Dove reperirli Campi data e ora associati alle modifiche di stato o alle date di creazione e modifica nei record delle transazioni e nelle note di sistema di NetSuite. Esempi 2023-10-26T10:00:00Z2023-11-15T14:35:10Z2024-01-05T09:12:05Z
	Sistema di origine SourceSystem	Il sistema da cui sono stati estratti i dati.
Descrizione Questo attributo identifica l’origine dei dati del processo. In questa vista il valore sarà sempre 'NetSuite'. Negli ambienti con più sistemi, ad esempio un sistema OCR esterno e un ERP, questo campo è fondamentale per ricostruire la provenienza dei dati e risolvere i problemi. Conferma che tutti gli eventi siano attribuiti correttamente al sistema di registrazione di origine. Perché è importante Garantisce la tracciabilità dei dati ed è fondamentale negli ambienti con più sistemi per risalire all’origine dei dati ai fini della convalida e per comprenderne il contesto. Dove reperirli È un valore statico ('NetSuite') inserito durante l’estrazione e la trasformazione dei dati. Esempi NetSuite
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’ultimo aggiornamento dei dati di questo evento dal sistema di origine.
Descrizione Questo attributo indica quando i dati dell’evento sono stati estratti più di recente da NetSuite. Riflette l’aggiornamento dei dati nello strumento di Process Mining. È utile per valutare quanto siano aggiornati i dati su cui si basa l’analisi. Gli utenti possono verificarne l’attualità, un aspetto particolarmente importante per le Dashboard operative che monitorano lo stato delle fatture quasi in tempo reale. Perché è importante Indica con chiarezza quanto sono aggiornati i dati, consentendo agli utenti di valutare l’attualità dell’analisi del processo e di sapere quando è previsto il prossimo aggiornamento. Dove reperirli Questa data e ora vengono generate dallo strumento o dalla pipeline di estrazione dei dati al momento dell’acquisizione. Esempi 2024-03-10T02:00:00Z2024-03-11T02:00:00Z
	Approvatore Approver	Utente responsabile dell’approvazione della fattura per il pagamento.
Descrizione Questo attributo identifica il responsabile o il titolare del budget che ha approvato definitivamente la fattura. Nel corso del suo ciclo di vita, una fattura può essere sottoposta a più approvatori. È una dimensione fondamentale per la Dashboard 'Analisi dei colli di bottiglia nell’approvazione'. Analizzando i tempi di approvazione per approvatore, l’azienda può individuare chi impiega più tempo, riassegnare le fatture per bilanciare il carico di lavoro e snellire l’intero processo di approvazione. Perché è importante Aiuta a individuare i colli di bottiglia nell’approvazione e ad analizzare il carico di lavoro e le prestazioni dei responsabili coinvolti nel processo. Dove reperirli Queste informazioni sono spesso registrate nella cronologia del flusso di lavoro o nei log di approvazione associati alla transazione Vendor Bill. Esempi s.chenp.williamsr.davis
	Data di scadenza della fattura InvoiceDueDate	Data entro cui pagare la fattura per evitare penali.
Descrizione Questo attributo specifica la data di scadenza del pagamento, determinata in base alle condizioni di pagamento del fornitore e alla data della fattura. È una scadenza fondamentale nel processo di contabilità fornitori. Questa data è il riferimento per la Dashboard 'Conformità dei pagamenti' e per il KPI 'Tasso di rispetto dei termini di pagamento'. Serve a stabilire se i pagamenti sono puntuali, anticipati o in ritardo, con effetti diretti sui rapporti con i fornitori e sul rischio di penali per ritardato pagamento. Perché è importante È il riferimento principale per misurare la puntualità dei pagamenti, fondamentale per i rapporti con i fornitori e la conformità finanziaria. Dove reperirli È il campo standard 'Due Date' del record della transazione Vendor Bill. Esempi 2023-11-302023-12-152024-02-28
	Importo della fattura InvoiceAmount	Importo monetario totale della fattura.
Descrizione Questo attributo rappresenta l’importo lordo totale dovuto per la fattura del fornitore, prima di detrazioni o sconti. È una metrica finanziaria fondamentale per ogni caso. L’importo della fattura viene utilizzato nelle analisi finanziarie, ad esempio per suddividere le fatture per fascia di valore e verificare se seguono percorsi di processo diversi. Compare anche nelle Dashboard per valutare l’impatto finanziario dei colli di bottiglia o dei ritardi ed è indispensabile per calcolare il DPO. Perché è importante Consente di analizzare l’impatto finanziario delle inefficienze del processo e di suddividere le fatture per importo, così da dare priorità a quelle di valore più elevato. Dove reperirli Il campo 'Amount' o 'Total' nell’intestazione del record della transazione Vendor Bill. Esempi 1500.75250.0012500.50
	Nome del fornitore VendorName	Nome del fornitore che ha presentato la fattura.
Descrizione Questo attributo identifica la ragione sociale del fornitore associato alla fattura. È un dato anagrafico fondamentale collegato alla transazione. Analizzare il processo per fornitore aiuta a individuare problemi specifici, come frequenti discrepanze, ritardi nei pagamenti o opportunità di sconto dinamico. È essenziale per classificare le fatture aperte nella Dashboard 'Stato e anzianità delle fatture' e per gestire i rapporti con i fornitori. Perché è importante Consente di analizzare le prestazioni per fornitore, individuare quelli che presentano problemi, negoziare condizioni migliori e gestire efficacemente i rapporti. Dove reperirli Dal record Vendor collegato alla transazione Vendor Bill. Il campo è in genere denominato 'Vendor Name' o 'Company Name'. Esempi Global Office Supplies Inc.Tech Solutions LLCCreative Marketing Co.
	Numero dell’ordine di acquisto PurchaseOrderNumber	Identificativo dell’ordine di acquisto associato alla fattura, se applicabile.
Descrizione Questo attributo collega la fattura del fornitore a un ordine di acquisto approvato in precedenza (PO). La sua presenza o assenza permette di distinguere le fatture associate a un PO da quelle che non lo sono. Il campo è fondamentale per la Dashboard 'Efficienza dell’abbinamento PO/GR' e per il KPI 'Tasso di successo dell’abbinamento PO/GR'. Analizzare i processi in base alla presenza di un PO consente di individuare i vantaggi del confronto a tre vie e le opportunità di automazione. Perché è importante Distingue le fatture associate a un PO da quelle che non lo sono, spesso caratterizzate da percorsi di processo e potenzialità di automazione diversi. È fondamentale per analizzare l’efficienza degli abbinamenti. Dove reperirli Si trova in genere nelle righe o nell’intestazione del record Vendor Bill e lo collega a una transazione Purchase Order. Esempi PO-004589PO-005123null
	Utente addetto all’elaborazione ProcessorUser	Utente responsabile dell’elaborazione o dell’inserimento della fattura.
Descrizione Questo attributo identifica il membro del team di contabilità fornitori che ha inserito i dati o svolto le prime attività di elaborazione della fattura. Questi dati sono essenziali per la Dashboard 'Distribuzione del carico di lavoro del team di contabilità fornitori'. Aiutano i responsabili ad analizzare la distribuzione del carico, individuare le esigenze di formazione e valutare le prestazioni individuali o del team. Possono inoltre servire a risalire alle cause profonde degli errori, identificando l’utente che li ha elaborati. Perché è importante Consente di analizzare il carico di lavoro, monitorare le prestazioni e risalire alle cause profonde degli errori attribuendo le attività a specifici membri del team di contabilità fornitori. Dove reperirli I campi 'Created By' o 'Modified By' nelle note di sistema o nella traccia di audit delle prime attività sulla fattura del fornitore. Esempi j.doea.smithm.jones
	Codice aziendale CompanyCode	Identificativo della persona giuridica o della società controllata che elabora la fattura.
Descrizione Questo attributo specifica la società o la controllata dell’organizzazione responsabile della fattura. È particolarmente rilevante per le aziende con più persone giuridiche. Analizzare il processo per codice aziendale consente di confrontare le prestazioni delle diverse parti dell’azienda. Può mettere in luce differenze di efficienza, conformità o carico di lavoro specifiche di una controllata e favorire iniziative di miglioramento mirate. Perché è importante Consente di confrontare le prestazioni del processo tra diverse persone giuridiche o società controllate, favorendo miglioramenti mirati e una governance aziendale efficace. Dove reperirli In NetSuite corrisponde al campo 'Subsidiary' del record della transazione in un account OneWorld. Esempi US01DE01UK01
	Data di pagamento PaymentDate	Data in cui è stato eseguito il pagamento della fattura.
Descrizione Questo attributo registra la data in cui è stato effettuato il pagamento al fornitore. Segna il saldo finanziario definitivo della fattura. Questa data serve a determinare la fine effettiva del processo per molti KPI, tra cui i 'Giorni medi di pagamento dei debiti' e il 'Tasso di rispetto dei termini di pagamento'. È il dato effettivo da confrontare con la 'Data di scadenza della fattura' e la 'Data limite per lo sconto per pagamento anticipato'. Perché è importante Segna la conclusione finanziaria del processo e costituisce la base per calcolare la conformità dei pagamenti, il DPO e i KPI relativi agli sconti ottenuti. Dove reperirli Dal campo 'Date' del record della transazione Bill Payment associata in NetSuite. Esempi 2023-11-282023-12-142024-02-25
	Data limite per lo sconto EarlyPaymentDiscountDate	Data entro cui pagare la fattura per ottenere uno sconto per pagamento anticipato.
Descrizione Questo attributo specifica l’ultima data utile per effettuare il pagamento e ottenere uno sconto dal fornitore, secondo quanto stabilito dai 'Termini di pagamento', ad esempio il '10' in '2% 10, Net 30'. Questa data è il riferimento principale per la Dashboard 'Opportunità di sconto per pagamento anticipato'. Confrontandola con la data corrente e quella di pagamento, il sistema può individuare opportunità, misurare il KPI 'Tasso di ottenimento degli sconti per pagamento anticipato' e aiutare l’azienda a massimizzare i risparmi. Perché è importante È una data fondamentale per massimizzare i risparmi ottenuti con gli sconti per pagamento anticipato; monitorarla aiuta a ottimizzare la gestione della liquidità. Dove reperirli È un campo calcolato nel record Vendor Bill, ricavato dalla data della fattura e dal campo 'Terms'. Esempi 2023-11-102024-01-20null
	Pagamento puntuale IsOnTimePayment	Indicatore che segnala se la fattura è stata pagata entro la data di scadenza.
Descrizione Questo attributo booleano calcolato verifica se la 'Data di pagamento' è precedente o uguale alla 'Data di scadenza della fattura'. Fornisce un esito chiaro, sì o no, sulla puntualità del pagamento di ogni fattura. L’attributo supporta direttamente la Dashboard 'Conformità dei pagamenti' e serve a calcolare il KPI 'Tasso di rispetto dei termini di pagamento'. Semplifica l’analisi, consentendo agli utenti di filtrare subito i pagamenti in ritardo e indagarne le cause profonde. Perché è importante Semplifica l’analisi della puntualità dei pagamenti e alimenta direttamente i KPI relativi al rispetto dei termini di pagamento e alla gestione dei rapporti con i fornitori. Dove reperirli Calcolato durante la trasformazione dei dati: PaymentDate <= InvoiceDueDate. Esempi truefalse
	Rilavorazione IsRework	Indicatore che segnala se l’attività fa parte di un ciclo di rilavorazione.
Descrizione Questo attributo booleano calcolato individua le attività che comportano la ripetizione del lavoro, come un secondo evento 'Discrepancy Identified' o una fattura respinta e poi inviata di nuovo per l’approvazione. È fondamentale per la Dashboard 'Analisi delle rilavorazioni e degli errori' e per il KPI 'Tasso di rilavorazione delle fatture'. Consente all’azienda di quantificare frequenza e impatto delle rilavorazioni e di individuare le fonti di inefficienza, errori e scostamenti dal processo. Perché è importante Quantifica le inefficienze del processo segnalando le attività che comportano sprechi di lavoro e consente di definire iniziative mirate per migliorare la qualità e la percentuale di attività completate correttamente al primo tentativo. Dove reperirli Calcolato durante la trasformazione dei dati analizzando la sequenza delle attività di un caso. Per esempio, quando 'Fattura approvata' è seguita da 'Fattura respinta' e poi da una nuova 'Fattura approvata'. Esempi truefalse
	Sconto per pagamento anticipato ottenuto IsEarlyPaymentCaptured	Indicatore che segnala se è stato ottenuto uno sconto disponibile per pagamento anticipato.
Descrizione Questo attributo booleano calcolato verifica se una fattura per cui è disponibile uno sconto è stata pagata entro la 'Data limite per lo sconto per pagamento anticipato'. È essenziale per misurare il KPI 'Tasso di ottenimento degli sconti per pagamento anticipato' e per la Dashboard 'Opportunità di sconto per pagamento anticipato'. Fornisce una misura chiara dell’efficacia della strategia aziendale per ottenere gli sconti e mette in evidenza i risparmi mancati. Perché è importante Misura direttamente l’efficacia della tesoreria o della funzione di contabilità fornitori nell’ottenere risparmi, un indicatore chiave delle prestazioni finanziarie. Dove reperirli Calcolato durante la trasformazione dei dati: PaymentDate <= EarlyPaymentDiscountDate per le fatture per cui è disponibile uno sconto. Esempi truefalsenull
	Stato della fattura InvoiceStatus	Stato corrente di elaborazione della fattura.
Descrizione Questo attributo indica lo stato corrente della fattura del fornitore nel ciclo di contabilità fornitori, ad esempio 'Open', 'Pending Approval' o 'Paid in Full'. È un attributo fondamentale per la Dashboard 'Stato e anzianità delle fatture', perché offre una fotografia del carico di lavoro e delle passività correnti. Consente di filtrare le fatture aperte o problematiche e di monitorare i progressi verso il completamento. Perché è importante Fornisce una fotografia aggiornata della fase del processo in cui si trova una fattura, essenziale per il monitoraggio operativo, la gestione del carico di lavoro e le previsioni finanziarie. Dove reperirli Il campo 'Status' del record della transazione Vendor Bill. Esempi ApertaIn attesa di approvazionePagata per intero
	Termini di pagamento PaymentTerms	Condizioni concordate per il pagamento della fattura, ad esempio Net 30 o 2% 10 Net 30.
Descrizione Questo attributo definisce le condizioni di pagamento richieste dal fornitore, compresi i tempi e gli eventuali sconti per pagamento anticipato. I termini di pagamento servono a calcolare la 'Data di scadenza della fattura' e la 'Data limite per lo sconto per pagamento anticipato'. Sono essenziali per la Dashboard 'Conformità dei pagamenti' e per analizzare le opportunità di ottenere sconti per pagamento anticipato, ottimizzando così il capitale circolante. Perché è importante Determina le scadenze di pagamento e le opportunità di sconto, incidendo direttamente sulla gestione dei flussi di cassa e sulla possibilità di ottenere risparmi. Dove reperirli Il campo 'Terms' della transazione Vendor Bill, in genere ereditato dal record anagrafico del fornitore. Esempi Net 30Net 602% 10, Net 30
	Tipo di documento DocumentType	Tipo di documento elaborato, ad esempio fattura o nota di credito.
Descrizione Questo attributo distingue le fatture standard dagli altri documenti correlati, come le note di credito, che possono seguire regole di elaborazione o flussi di lavoro diversi. Analizzare il processo per tipo di documento consente di confrontare elementi omogenei. Per esempio, l’approvazione di una fattura di importo elevato può essere molto più rigorosa di quella di una nota di credito di importo ridotto. Questa suddivisione offre una visione più accurata delle prestazioni del processo. Perché è importante Consente di suddividere il processo in base ai diversi tipi di documenti finanziari, che possono seguire percorsi e avere KPI distinti, rendendo l’analisi più precisa. Dove reperirli Si può identificare dal tipo di transazione in NetSuite, ad esempio 'Vendor Bill' o 'Vendor Credit'. Esempi Fattura standardNota di creditoNota di debito
	Valuta Currency	Codice della valuta in cui è espresso l’importo della fattura, ad esempio USD o EUR.
Descrizione Questo attributo specifica la valuta in cui è espresso l’importo della fattura e fornisce il contesto necessario per 'InvoiceAmount'. Per le organizzazioni multinazionali è fondamentale analizzare i dati in un’unica valuta coerente. Questo campo consente di convertire correttamente le valute e di confrontare le metriche finanziarie su basi omogenee tra regioni o unità aziendali diverse. Perché è importante Fornisce il contesto necessario per tutti gli importi monetari e garantisce analisi finanziarie accurate, soprattutto nelle attività internazionali. Dove reperirli Il campo 'Currency' del record della transazione Vendor Bill, spesso collegato ai dati anagrafici del fornitore. Esempi USDEURGBPCAD

Obbligatorio Consigliato Facoltativo

Attività di elaborazione delle fatture fornitori

Questi sono i passaggi e i traguardi chiave da registrare nell’Event Log per individuare con precisione il processo e i colli di bottiglia.

6 Consigliato 8 Facoltativo

	Attività	Descrizione
	Fattura approvata	Indica che la fattura fornitore è stata autorizzata al pagamento dagli approvatori designati. L’evento viene rilevato quando 'Approval Status' della fattura è impostato su 'Approved'.
Perché è importante È una tappa fondamentale che conclude la fase di approvazione e consente di registrare la fattura e programmare il pagamento. È un dato essenziale per misurare l’efficienza delle approvazioni. Dove reperirli Data e ora della modifica del campo 'Approval Status' nel record della fattura fornitore a 'Approved', come registrate in System Notes o nel registro del flusso di lavoro. Acquisizione Data e ora nel registro del flusso di lavoro o in System Notes per 'Approval Status' = 'Approved'. Tipo di evento explicit
	Fattura chiusa	Segna la chiusura definitiva della fattura del fornitore, in genere dopo il pagamento integrale. L’evento viene dedotto quando lo stato della fattura passa a 'Paid in Full'.
Perché è importante Fornisce un evento finale certo per il ciclo di vita del processo e conferma che non sono necessarie altre azioni per quella specifica fattura. Dove reperirli Deducibile dall’ora in cui il campo 'Status' della fattura del fornitore passa a 'Paid in Full', come registrato in System Notes. Acquisizione Ora in cui il campo 'Status' passa a 'Paid in Full'. Tipo di evento inferred
	Fattura fornitore creata	Indica l’inserimento in NetSuite di una nuova fattura di un fornitore. L’evento viene rilevato dalla data di creazione del record della transazione Vendor Bill e rappresenta l’inizio ufficiale del processo AP.
Perché è importante Definisce il punto di partenza per tutti i calcoli dei tempi di ciclo di elaborazione delle fatture, fondamentali per misurare l’efficienza complessiva del processo e monitorare l’anzianità delle fatture. Dove reperirli Il campo 'Date Created' del record della transazione Vendor Bill. Acquisizione Evento di creazione della transazione Vendor Bill. Tipo di evento explicit
	Fattura registrata nella contabilità generale	Indica il momento in cui l’impatto finanziario della fattura fornitore viene registrato ufficialmente nella contabilità generale. L’evento viene rilevato dalla data della transazione, quando la fattura è approvata e il flag 'Posting' è impostato.
Perché è importante È un punto di controllo finanziario fondamentale, che conferma la rilevazione formale della passività da parte dell’azienda. I ritardi nella registrazione possono compromettere l’accuratezza della rendicontazione finanziaria. Dove reperirli La data di registrazione associata alla transazione di contabilità generale creata dalla fattura fornitore. Verrà controllato il campo 'Posting' della fattura. Acquisizione Data della transazione di registrazione nella contabilità generale associata alla fattura fornitore. Tipo di evento explicit
	Pagamento eseguito	Rappresenta l’esecuzione definitiva del pagamento della fattura. L’evento viene rilevato dalla data della transazione Vendor Payment applicata alla fattura del fornitore.
Perché è importante È il principale punto di arrivo del processo di contabilità fornitori ed è essenziale per calcolare il tempo di ciclo end-to-end, verificare il rispetto dei termini di pagamento e calcolare i giorni medi di pagamento dei debiti (DPO). Dove reperirli Il campo 'Date' della transazione Vendor Payment collegata alla fattura del fornitore. Acquisizione Data della transazione Vendor Payment applicata alla fattura. Tipo di evento explicit
	Richiesta di approvazione inviata	Questo evento indica il momento in cui la fattura fornitore viene inserita formalmente in un flusso di lavoro di approvazione. Viene rilevato quando il campo 'Approval Status' della fattura passa da uno stato di bozza a 'Pending Approval'.
Perché è importante Questa attività segna l’inizio della misurazione del tempo di ciclo dell’approvazione, essenziale per individuare i colli di bottiglia legati a specifici approvatori o reparti. Dove reperirli Deducibile dalla data e dall’ora in cui il campo 'Approval Status' del record della fattura fornitore passa a 'Pending Approval', come registrato in System Notes. Acquisizione Data e ora della modifica del campo 'Approval Status' a 'Pending Approval'. Tipo di evento inferred
	Discrepanza individuata	Questa attività si verifica quando viene rilevata una discrepanza tra la fattura, l’ordine di acquisto o la ricevuta merci, che impedisce di proseguire l’elaborazione. Spesso è deducibile quando un utente imposta uno specifico 'Approval Status', ad esempio 'On Hold' o 'Pending Clarification'.
Perché è importante Mettere in evidenza questa attività aiuta a individuare le cause di attrito e rilavorazione nella fase di convalida, tra i principali motivi dei ritardi nei pagamenti. Dove reperirli Deducibile da una modifica del campo 'Approval Status' della fattura fornitore a uno stato di attesa non standard, ad esempio 'On Hold'. Potrebbe essere necessario configurare stati personalizzati. Acquisizione Monitorare le modifiche al campo 'Approval Status' che indicano una sospensione o una richiesta di chiarimenti. Tipo di evento inferred
	Fattura reinstradata per l’approvazione	Si verifica quando una fattura viene rimandata a una fase precedente o a un altro approvatore in seguito a una modifica o a un rifiuto. L’evento è deducibile quando il campo 'Approval Status' passa da 'Pending Approval' a un altro stato e poi torna a 'Pending Approval'.
Perché è importante Individuare gli eventi di reinstradamento è fondamentale per comprendere i cicli di rilavorazione nel processo di approvazione, che allungano notevolmente i tempi di ciclo. Dove reperirli Deducibile da System Notes rilevando le sequenze in cui 'Approval Status' passa più volte a 'Pending Approval' per la stessa fattura. Acquisizione Analizzare le sequenze di modifiche di 'Approval Status' in System Notes. Tipo di evento inferred
	Fattura rifiutata	Indica il rifiuto formale di una fattura fornitore durante il processo di approvazione, che richiede una correzione e un nuovo invio. L’evento viene rilevato quando 'Approval Status' viene aggiornato a 'Rejected'.
Perché è importante Monitorare i rifiuti è fondamentale per analizzare le rilavorazioni, individuare le cause più comuni, ad esempio codici errati o violazioni delle politiche, e migliorare la percentuale di approvazioni al primo tentativo. Dove reperirli Data e ora della modifica del campo 'Approval Status' nel record della fattura fornitore a 'Rejected', come registrate in System Notes. Acquisizione Data e ora nel registro del flusso di lavoro o in System Notes per 'Approval Status' = 'Rejected'. Tipo di evento explicit
	Nota di credito applicata	Si verifica quando una nota di credito del fornitore viene applicata a una fattura, riducendo l’importo dovuto. L’evento viene rilevato dall’applicazione che collega le due transazioni.
Perché è importante L’applicazione delle note di credito è una modalità alternativa importante per chiudere una fattura. Monitorarla aiuta a capire in che modo gli stralci e i resi incidono sul processo di contabilità fornitori. Dove reperirli Data di applicazione registrata quando una transazione Vendor Credit viene applicata alla fattura del fornitore. È visibile nei record correlati alla fattura. Acquisizione Data e ora di applicazione di una nota di credito del fornitore a una fattura del fornitore. Tipo di evento explicit
	Pagamento in ritardo rilevato	Evento calcolato che si verifica quando una fattura viene pagata dopo la scadenza. Si determina confrontando la data di esecuzione del pagamento con la data di scadenza indicata nella fattura del fornitore.
Perché è importante Questa attività è fondamentale per monitorare il rispetto dei termini di pagamento e gestire i rapporti con i fornitori. I ritardi frequenti possono compromettere la loro fiducia. Dove reperirli Si calcola confrontando il campo 'Date' della transazione Vendor Payment con il campo 'Due Date' della fattura del fornitore. L’evento si verifica se la data di pagamento è successiva alla data di scadenza. Acquisizione Confrontare il campo 'Date' di Vendor Payment con il campo 'Due Date' della fattura del fornitore. Tipo di evento calculated
	Pagamento programmato	Questa attività indica che una fattura fornitore è stata selezionata per il pagamento e inclusa in un lotto di pagamenti. Viene rilevata quando viene creata una transazione Vendor Payment con una data di pagamento futura.
Perché è importante Questo evento offre visibilità sul flusso dei pagamenti e aiuta a prevedere i flussi di cassa e a pianificare i pagamenti per usufruire degli sconti per pagamento anticipato. Dove reperirli Data di creazione della transazione Vendor Payment applicata alla fattura del fornitore. Acquisizione Data e ora di creazione della transazione Vendor Payment associata. Tipo di evento explicit
	Riconciliazione con l’ordine di acquisto avviata	Indica l’associazione di una fattura fornitore al relativo ordine di acquisto per la convalida. L’evento viene dedotto quando un ordine di acquisto viene collegato per la prima volta alla fattura fornitore nella sottolista 'Items' o 'Expenses', prima dell’approvazione.
Perché è importante Monitorare questa fase aiuta ad analizzare l’efficienza della riconciliazione e a individuare i ritardi che si verificano prima ancora che le fatture vengano inviate per l’approvazione. Dove reperirli Deducibile dal registro System Notes, che mostra la compilazione iniziale del campo 'Created From' o dei riferimenti agli ordini di acquisto a livello di riga nella fattura fornitore. Acquisizione Rilevare la compilazione del campo di riferimento dell’ordine di acquisto in System Notes. Tipo di evento inferred
	Sconto per pagamento anticipato ottenuto	Evento calcolato che si verifica quando una fattura viene pagata prima della data limite per ottenere lo sconto per pagamento anticipato. Si determina confrontando la data di pagamento con le condizioni di sconto indicate nella fattura del fornitore.
Perché è importante Misura direttamente la capacità del team di contabilità fornitori di ottenere gli sconti, con effetti diretti sulla redditività dell’azienda e sulla gestione della liquidità. Dove reperirli È un evento calcolato. Per determinarlo, occorre confrontare il campo 'Date' della transazione Vendor Payment con la data limite per lo sconto, ricavata dal campo 'Terms' della fattura del fornitore. Acquisizione Confrontare il campo 'Date' di Vendor Payment con la data limite per lo sconto ricavata dal campo 'Terms' della fattura del fornitore. Tipo di evento calculated

Consigliato Facoltativo

Guide all’estrazione

Come estrarre i dati da NetSuite

Passaggi

Acceda alla creazione di una ricerca salvata: acceda a NetSuite con un ruolo autorizzato a creare o modificare le ricerche salvate. Selezioni Reports > Saved Searches > All Saved Searches > New. Dall’elenco dei tipi di ricerca, selezioni Transaction.
Definisca i criteri di ricerca: nella scheda Criteria, imposti i filtri principali per selezionare le fatture pertinenti (Vendor Bills).
- Imposti Type su is Vendor Bill.
- Imposti Main Line su is True. In questo modo la ricerca si concentra sulle informazioni a livello di intestazione.
- Aggiunga un filtro Date Created per limitare l’estrazione dei dati a un periodo specifico (ad esempio, is within last 6 months).
Definisca le colonne dei risultati per gli attributi comuni: apra la scheda Results e aggiunga i seguenti campi, comuni a tutti gli eventi di una fattura.
- Document Number (etichetta personalizzata: Invoice)
- Entity (etichetta personalizzata: VendorName)
- Amount (etichetta personalizzata: InvoiceAmount)
- Due Date (etichetta personalizzata: InvoiceDueDate)
- Created By (etichetta personalizzata: ProcessorUser)
- Formula (Text): imposti la formula su '{source}' (etichetta personalizzata: SourceSystem). La colonna conterrà il valore 'NetSuite'.
- Formula (Date/Time): imposti la formula su {today} (etichetta personalizzata: LastDataUpdate).
Definisca le colonne dei risultati per le attività: questo è il passaggio più importante. Per ciascuna delle 14 attività, aggiunga due colonne formula: una per ActivityName e una per EventTime. Si otterrà così un insieme di dati con molte colonne, da trasformare in seguito.
- Esempio per 'Invoice Approved':
  - Aggiunga Formula (Text) con il valore CASE WHEN {approvalstatus} = 'Approved' THEN 'Invoice Approved' ELSE NULL END. Imposti un’etichetta personalizzata, ad esempio ActivityName_Approved.
  - Aggiunga Formula (Date/Time) con il valore CASE WHEN {approvalstatus} = 'Approved' THEN {systemnotes.date} WHERE systemnotes.field = 'Approval Status' and systemnotes.newvalue = 'Approved' ELSE NULL END. Imposti un’etichetta personalizzata, ad esempio EventTime_Approved. Nota: per recuperare l’ora esatta di una modifica di stato è spesso necessario consultare le note di sistema, un’operazione che può essere complessa. Se disponibile, il campo {approveddate} è un’alternativa più semplice, ma meno precisa.
- Ripeta l’operazione per tutte le 14 attività richieste, applicando la logica indicata nella sezione della query qui sotto.
Configuri le impostazioni della ricerca: nella scheda secondaria Audience, verifichi che la ricerca sia accessibile ai ruoli o agli utenti che eseguiranno l’esportazione. Assegni alla ricerca un nome descrittivo, ad esempio ProcessMind AP Extraction.
Salvi ed esegua la ricerca: faccia clic su Save & Run per eseguire la ricerca. Controlli i risultati nell’interfaccia di NetSuite per verificare che i dati siano visualizzati nel formato con molte colonne previsto.
Esporti i dati in CSV: nella pagina dei risultati della ricerca, faccia clic sull’icona di esportazione (CSV, Excel o PDF) e selezioni CSV.
Trasformi i dati (unpivot): il file CSV esportato conterrà una riga per fattura e molte colonne per le attività e i relativi orari (ad esempio, ActivityName_Created, EventTime_Created, ActivityName_Approved, EventTime_Approved). Questo formato «largo» deve essere trasformato in un formato «lungo» per creare un Event Log.
- Apra il file CSV con uno strumento come Microsoft Excel (usando Power Query), Python (con Pandas) o un altro strumento di manipolazione dei dati.
- Utilizzi la funzione 'Unpivot'. Selezioni tutte le colonne degli attributi comuni (Invoice, VendorName e così via) e trasformi le colonne ActivityName_... ed EventTime_....
- La trasformazione creerà la struttura richiesta per l’Event Log, con una riga per ogni attività.
Pulisca e formatti il file finale: dopo la trasformazione, saranno presenti colonne che rappresentano l’attributo e il valore. Rinomini queste colonne ActivityName ed EventTime. Escluda le righe in cui ActivityName o EventTime è NULL. Verifichi che le intestazioni delle colonne finali corrispondano allo schema ProcessMind (Invoice, ActivityName, EventTime e così via).
Salvi l’Event Log finale: salvi i dati trasformati in un nuovo file CSV, pronto per il caricamento in ProcessMind.

Configurazione

Prerequisiti: un ruolo utente con autorizzazioni di livello Create o Full per le ricerche salvate. Il ruolo deve inoltre consentire la visualizzazione dei record Transaction (in particolare Vendor Bills, Vendor Payments e Vendor Credits) e dei relativi record di entità (Vendor, Employee).
Tipo di ricerca: per questo processo, inizi sempre con una ricerca di tipo Transaction.
Filtro per intervallo di date: è fondamentale applicare un filtro per intervallo di date (ad esempio, Date Created) per limitare le dimensioni dell’insieme di dati. Inizi con un intervallo più breve (ad esempio, 3-6 mesi) per verificare le prestazioni della ricerca e convalidare i risultati prima di estenderla a un periodo storico più ampio.
Filtro Main Line: in genere, si consiglia di impostare Criteria > Main Line > is True per ottenere un risultato per transazione. Tuttavia, per alcune attività a livello di riga, come 'PO Matching Attempted', potrebbe essere necessaria una ricerca separata o una formula più complessa che non utilizzi questo filtro.
Campi personalizzati: l’istanza NetSuite potrebbe utilizzare campi personalizzati per gestire il processo di contabilità fornitori (ad esempio, un campo personalizzato AP Process Status al posto del campo standard Approval Status). Individui questi campi e li sostituisca nei criteri di ricerca e nelle formule dei risultati.
Considerazioni sulle prestazioni: in NetSuite, una singola ricerca salvata con formule per tutte le 14 attività potrebbe essere lenta o andare in timeout. Valuti di suddividere la logica in più ricerche salvate (ad esempio, una per la creazione e l’approvazione delle fatture e una per i pagamenti) e di unire i file esportati prima della trasformazione.

Query di esempio json

# NetSuite Saved Search Configuration for Accounts Payable Event Log Extraction
# This configuration describes the settings for a single, comprehensive Saved Search.
# The output is a 'wide' file that must be unpivoted into an event log.

SearchType: "Transaction"

# ====================================================================
# CRITERIA
# ====================================================================
# Define the filters to select the base records
# --------------------------------------------------------------------

Filters: [
  {
    "field": "Type",
    "operator": "is",
    "value": "Vendor Bill"
  },
  {
    "field": "Main Line",
    "operator": "is",
    "value": "True"
  },
  {
    "field": "Date Created",
    "operator": "within",
    "value": "[Specify Date Range, e.g., thisfiscalquarter]"
  }
]

# ====================================================================
# RESULTS
# ====================================================================
# Define the columns for the output. The final CSV will have these columns.
# Common attributes are listed first, followed by pairs of columns for each activity.
# --------------------------------------------------------------------

Columns: [
  // --- Common Attributes ---
  { "field": "Document Number", "label": "Invoice" },
  { "field": "Entity", "label": "VendorName" },
  { "field": "Amount", "label": "InvoiceAmount" },
  { "field": "Applied To Transaction", "label": "PurchaseOrderNumber" },
  { "field": "Created By", "label": "ProcessorUser" },
  { "field": "Next Approver", "label": "Approver" },
  { "field": "Due Date", "label": "InvoiceDueDate" },
  { "formula": "'NetSuite'", "type": "Text", "label": "SourceSystem" },
  { "formula": "{today}", "type": "Date/Time", "label": "LastDataUpdate" },

  // --- Activity 1: Vendor Bill Created ---
  { "formula": "'Vendor Bill Created'", "type": "Text", "label": "ActivityName_Created" },
  { "field": "Date Created", "label": "EventTime_Created" },

  // --- Activity 2: PO Matching Attempted ---
  { "formula": "CASE WHEN {appliedtotransaction} IS NOT NULL THEN 'PO Matching Attempted' ELSE NULL END", "type": "Text", "label": "ActivityName_POMatched" },
  { "formula": "CASE WHEN {appliedtotransaction} IS NOT NULL THEN {datecreated} ELSE NULL END", "type": "Date/Time", "label": "EventTime_POMatched" },

  // --- Activity 3: Discrepancy Identified ---
  { "formula": "CASE WHEN {approvalstatus} = 'Rejected' THEN 'Discrepancy Identified' ELSE NULL END", "type": "Text", "label": "ActivityName_Discrepancy" },
  { "formula": "(SELECT MIN(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Rejected')", "type": "Date/Time", "label": "EventTime_Discrepancy" },

  // --- Activity 4: Approval Submitted ---
  { "formula": "CASE WHEN {approvalstatus} != 'Pending Approval' AND {approvalstatus} != 'Approved' THEN NULL ELSE 'Approval Submitted' END", "type": "Text", "label": "ActivityName_Submitted" },
  { "formula": "(SELECT MIN(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Pending Approval')", "type": "Date/Time", "label": "EventTime_Submitted" },

  // --- Activity 5: Invoice Re-Routed For Approval ---
  { "formula": "CASE WHEN (SELECT COUNT(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Pending Approval') > 1 THEN 'Invoice Re-Routed For Approval' ELSE NULL END", "type": "Text", "label": "ActivityName_ReRouted" },
  { "formula": "(SELECT MAX(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Pending Approval' AND systemnotes.date < (SELECT MAX(sub_notes.date) FROM systemnote sub_notes WHERE sub_notes.recordid = {internalid} AND sub_notes.field = 'TRANSACTION.APPROVALSTATUS' AND sub_notes.newvalue = 'Pending Approval'))", "type": "Date/Time", "label": "EventTime_ReRouted" },

  // --- Activity 6: Invoice Approved ---
  { "formula": "CASE WHEN {approvalstatus} = 'Approved' THEN 'Invoice Approved' ELSE NULL END", "type": "Text", "label": "ActivityName_Approved" },
  { "formula": "(SELECT MIN(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Approved')", "type": "Date/Time", "label": "EventTime_Approved" },

  // --- Activity 7: Invoice Rejected ---
  { "formula": "CASE WHEN {approvalstatus} = 'Rejected' THEN 'Invoice Rejected' ELSE NULL END", "type": "Text", "label": "ActivityName_Rejected" },
  { "formula": "(SELECT MAX(systemnotes.date) FROM systemnote WHERE systemnote.recordid = {internalid} AND systemnote.field = 'TRANSACTION.APPROVALSTATUS' AND systemnote.newvalue = 'Rejected')", "type": "Date/Time", "label": "EventTime_Rejected" },

  // --- Activity 8: Invoice Posted To GL ---
  { "formula": "CASE WHEN {posting} = 'Yes' THEN 'Invoice Posted To GL' ELSE NULL END", "type": "Text", "label": "ActivityName_Posted" },
  { "field": "Date", "label": "EventTime_Posted" },

  // --- Activity 9: Payment Scheduled ---
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Payment' AND {payingtransaction.trandate} > {today} THEN 'Payment Scheduled' ELSE NULL END", "type": "Text", "label": "ActivityName_Scheduled" },
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Payment' AND {payingtransaction.trandate} > {today} THEN {payingtransaction.datecreated} ELSE NULL END", "type": "Date/Time", "label": "EventTime_Scheduled" },

  // --- Activity 10: Payment Executed ---
  { "formula": "CASE WHEN {status} = 'Paid in Full' OR {status} = 'Pending Approval' THEN 'Payment Executed' ELSE NULL END", "type": "Text", "label": "ActivityName_Executed" },
  { "field": "Paying Transaction Date", "label": "EventTime_Executed" },

  // --- Activity 11: Invoice Closed ---
  { "formula": "CASE WHEN {status} = 'Paid in Full' THEN 'Invoice Closed' ELSE NULL END", "type": "Text", "label": "ActivityName_Closed" },
  { "field": "Paying Transaction Date", "label": "EventTime_Closed" },

  // --- Activity 12: Early Payment Captured ---
  { "formula": "CASE WHEN {payingtransaction.trandate} < {discountdate} AND {discountamount} IS NOT NULL THEN 'Early Payment Captured' ELSE NULL END", "type": "Text", "label": "ActivityName_EarlyPay" },
  { "formula": "CASE WHEN {payingtransaction.trandate} < {discountdate} AND {discountamount} IS NOT NULL THEN {payingtransaction.trandate} ELSE NULL END", "type": "Date/Time", "label": "EventTime_EarlyPay" },

  // --- Activity 13: Late Payment Identified ---
  { "formula": "CASE WHEN {daysoverdue} > 0 AND {status} = 'Paid in Full' THEN 'Late Payment Identified' ELSE NULL END", "type": "Text", "label": "ActivityName_LatePay" },
  { "formula": "CASE WHEN {daysoverdue} > 0 AND {status} = 'Paid in Full' THEN {payingtransaction.trandate} ELSE NULL END", "type": "Date/Time", "label": "EventTime_LatePay" },

  // --- Activity 14: Credit Memo Applied ---
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Credit' THEN 'Credit Memo Applied' ELSE NULL END", "type": "Text", "label": "ActivityName_CreditMemo" },
  { "formula": "CASE WHEN {payingtransaction.type} = 'Vendor Credit' THEN {payingtransaction.trandate} ELSE NULL END", "type": "Date/Time", "label": "EventTime_CreditMemo" }
]

Passaggi

Prerequisiti: verifichi che nel Suo account NetSuite sia attivo il modulo SuiteAnalytics Connect. Si assicuri che il ruolo utente disponga dell’autorizzazione 'SuiteAnalytics Connect' e dell’accesso ai record necessari (Vendor Bills, Vendor Payments, Purchase Orders, System Notes).
Installi e configuri il driver: scarichi il driver NetSuite ODBC (o JDBC) appropriato per il Suo sistema operativo dall’interfaccia NetSuite, in Home > Set Preferences > Analytics Driver. Segua le istruzioni di installazione e configuri un nuovo Data Source Name (DSN) che punti al servizio NetSuite.
Stabilisca la connessione: apra il client SQL che preferisce (ad esempio, DBeaver, Power BI o Tableau). Crei una nuova connessione usando il driver/DSN configurato. Per l’autenticazione, Le serviranno l’ID account NetSuite, l’ID ruolo e le credenziali utente.
Prepari la query: copi la query SuiteQL completa riportata nella sezione 'query' qui sotto nell’editor del client SQL.
Personalizzi i segnaposto: modifichi i valori segnaposto nelle clausole WHERE della query. Come minimo, imposti [START_DATE] e [END_DATE] per definire il periodo di analisi. Modifichi inoltre [SUBSIDIARY_ID] se utilizza un account NetSuite OneWorld.
Adatti la logica personalizzata: riveda le sezioni contrassegnate da commenti come -- CUSTOMIZABLE. Queste parti della query deducono attività come 'Discrepancy Identified' in base a specifici valori di stato. Aggiorni tali valori in base alla configurazione NetSuite e ai processi aziendali della Sua organizzazione.
Esegua la query: esegua la query personalizzata sul database NetSuite. A seconda dell’intervallo di date e del volume dei dati, l’operazione potrebbe richiedere alcuni minuti.
Esporti i risultati: al termine della query, esporti il risultato dal client SQL in un file CSV.
Prepari il file per il caricamento: verifichi che il file CSV esportato sia codificato in UTF-8 e che le intestazioni delle colonne corrispondano agli attributi richiesti e consigliati per ProcessMind (ad esempio, Invoice, ActivityName, EventTime). Il file è pronto per il caricamento.

Configurazione

SuiteAnalytics Connect: questo modulo aggiuntivo di NetSuite è necessario per utilizzare questo metodo di estrazione. Fornisce accesso in sola lettura a una replica dei dati NetSuite.
Autorizzazioni del ruolo utente: il ruolo NetSuite utilizzato per la connessione deve disporre dell’autorizzazione 'SuiteAnalytics Connect'. Deve inoltre consentire la visualizzazione dei seguenti record: Transactions (Vendor Bill, Vendor Payment, Vendor Credit), Entities (Vendor, Employee) e System Notes.
Filtro per intervallo di date: è fondamentale filtrare la query per un intervallo di date specifico (ad esempio, trandate BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD') per mantenere i tempi di esecuzione entro limiti gestibili. Prima di eseguire un’estrazione completa, inizi con un intervallo più breve, ad esempio 3-6 mesi.
Filtro per società controllata: negli account NetSuite OneWorld, includa sempre una clausola WHERE che filtri per ID della società controllata, così da isolare i dati di una specifica entità giuridica e migliorare le prestazioni della query.
Flussi di lavoro di approvazione personalizzati: la query fornita presuppone l’utilizzo del campo standard 'Approval Status' nei Vendor Bills. Se la Sua organizzazione utilizza SuiteFlow o script personalizzati con campi o record dedicati alle approvazioni, le sezioni della query che fanno riferimento a SystemNote per il campo approvalstatus richiederanno modifiche sostanziali.

Query di esempio sql

-- This query extracts an event log for the Accounts Payable Invoice Processing from NetSuite.
-- It uses a UNION ALL approach to gather 14 distinct activities into a single file.

WITH VendorBillsInScope AS (
    -- CTE to select the primary Vendor Bills to analyze.
    -- Filtering here is critical for performance.
    SELECT
        Transaction.ID AS BillID,
        Transaction.tranid AS Invoice,
        Transaction.trandate AS BillDate,
        Transaction.duedate AS InvoiceDueDate,
        Transaction.foreignTotal AS InvoiceAmount,
        Transaction.entity AS VendorID,
        Transaction.createdBy AS ProcessorUserID,
        Transaction.status AS BillStatus,
        Transaction.approvalStatus AS ApprovalStatus,
        Transaction.discountDate AS DiscountDate
    FROM
        Transaction
    WHERE
        Transaction.type = 'VendBill'
        -- CRITICAL: Define the date range for the extraction
        AND Transaction.trandate BETWEEN TO_DATE('[START_DATE]', 'YYYY-MM-DD') AND TO_DATE('[END_DATE]', 'YYYY-MM-DD')
        -- OPTIONAL: Filter by a specific subsidiary for NetSuite OneWorld accounts
        -- AND Transaction.subsidiary = [SUBSIDIARY_ID]
),

-- Base information for joins, including vendor, processor, and PO data.
BaseInfo AS (
    SELECT
        vb.BillID,
        vb.Invoice,
        vb.InvoiceAmount,
        vb.InvoiceDueDate,
        vb.DiscountDate,
        vendor.companyName AS VendorName,
        processor.entityId AS ProcessorUser,
        LISTAGG(DISTINCT po.tranid, ', ') WITHIN GROUP (ORDER BY po.tranid) AS PurchaseOrderNumber
    FROM
        VendorBillsInScope vb
    LEFT JOIN
        Entity vendor ON vb.VendorID = vendor.ID
    LEFT JOIN
        Employee processor ON vb.ProcessorUserID = processor.ID
    LEFT JOIN
        TransactionLine tl ON vb.BillID = tl.Transaction
    LEFT JOIN
        Transaction po ON tl.purchaseOrder = po.ID AND po.type = 'PurchOrd'
    GROUP BY
        vb.BillID, vb.Invoice, vb.InvoiceAmount, vb.InvoiceDueDate, vb.DiscountDate, vendor.companyName, processor.entityId
),

-- System Notes are used to track status changes for approvals, rejections, etc.
Notes AS (
    SELECT
        sn.transactionId AS BillID,
        sn.date AS NoteDate,
        sn.field AS NoteField,
        sn.newValue AS NoteNewValue,
        sn.oldValue AS NoteOldValue,
        approver.entityId AS Approver
    FROM
        SystemNote sn
    JOIN
        VendorBillsInScope vb ON sn.transactionId = vb.BillID
    LEFT JOIN
        Employee approver ON sn.author = approver.ID
    WHERE
        -- Filtering to relevant fields improves performance
        sn.field IN ('approvalstatus', 'status')
)

-- 1. Vendor Bill Created
SELECT
    bi.Invoice AS "Invoice",
    'Vendor Bill Created' AS "ActivityName",
    vb.BillDate AS "EventTime",
    'NetSuite' AS "SourceSystem",
    BUILTIN.CURRRENT_TIMESTAMP() AS "LastDataUpdate",
    bi.VendorName AS "VendorName",
    bi.InvoiceAmount AS "InvoiceAmount",
    bi.PurchaseOrderNumber AS "PurchaseOrderNumber",
    bi.ProcessorUser AS "ProcessorUser",
    NULL AS "Approver",
    bi.InvoiceDueDate AS "InvoiceDueDate"
FROM
    VendorBillsInScope vb
JOIN
    BaseInfo bi ON vb.BillID = bi.BillID

UNION ALL

-- 2. PO Matching Attempted (Inferred from PO link on creation date)
SELECT
    bi.Invoice,
    'PO Matching Attempted',
    vb.BillDate, -- Occurs at the same time as creation
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    NULL,
    bi.InvoiceDueDate
FROM
    VendorBillsInScope vb
JOIN
    BaseInfo bi ON vb.BillID = bi.BillID
WHERE
    bi.PurchaseOrderNumber IS NOT NULL

UNION ALL

-- 3. Discrepancy Identified (CUSTOMIZABLE: Inferred from status change to 'On Hold')
SELECT
    bi.Invoice,
    'Discrepancy Identified',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver, -- User who placed it on hold
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' 
    -- CUSTOMIZABLE: Update 'On Hold' to match the status your company uses for discrepancies.
    AND n.NoteNewValue = 'On Hold'

UNION ALL

-- 4. Approval Submitted
SELECT
    bi.Invoice,
    'Approval Submitted',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver, -- User who submitted for approval
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Pending Approval'

UNION ALL

-- 5. Invoice Re-Routed For Approval (Inferred by status returning to Pending Approval)
SELECT
    bi.Invoice,
    'Invoice Re-Routed For Approval',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' 
    AND n.NoteNewValue = 'Pending Approval'
    AND n.NoteOldValue IN ('Rejected', 'On Hold') -- Capture re-submission after rejection/hold

UNION ALL

-- 6. Invoice Approved
SELECT
    bi.Invoice,
    'Invoice Approved',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Approved'

UNION ALL

-- 7. Invoice Rejected
SELECT
    bi.Invoice,
    'Invoice Rejected',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Rejected'

UNION ALL

-- 8. Invoice Posted To GL (Happens upon approval)
SELECT
    bi.Invoice,
    'Invoice Posted To GL',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    n.Approver,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'approvalstatus' AND n.NoteNewValue = 'Approved'

UNION ALL

-- 9. Payment Scheduled & 10. Payment Executed & 12. Early & 13. Late Payments
WITH Payments AS (
    SELECT
        tp.previousDoc AS BillID,
        vp.trandate AS PaymentExecutionDate,
        vp.createdDate AS PaymentScheduledDate
    FROM
        TransactionPayment tp
    JOIN
        Transaction vp ON tp.nextDoc = vp.ID AND vp.type = 'VendPymt'
    WHERE
        tp.previousDoc IN (SELECT BillID FROM VendorBillsInScope)
)
SELECT p.Invoice, p.ActivityName, p.EventTime, p.SourceSystem, p.LastDataUpdate, p.VendorName, p.InvoiceAmount, p.PurchaseOrderNumber, p.ProcessorUser, p.Approver, p.InvoiceDueDate FROM (
    SELECT bi.Invoice, 'Payment Scheduled' AS ActivityName, p.PaymentScheduledDate AS EventTime, 'NetSuite' AS SourceSystem, BUILTIN.CURRRENT_TIMESTAMP() AS LastDataUpdate, bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL AS Approver, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID
    UNION ALL
    SELECT bi.Invoice, 'Payment Executed', p.PaymentExecutionDate, 'NetSuite', BUILTIN.CURRRENT_TIMESTAMP(), bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID
    UNION ALL
    SELECT bi.Invoice, 'Early Payment Captured', p.PaymentExecutionDate, 'NetSuite', BUILTIN.CURRRENT_TIMESTAMP(), bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID WHERE p.PaymentExecutionDate <= bi.DiscountDate
    UNION ALL
    SELECT bi.Invoice, 'Late Payment Identified', p.PaymentExecutionDate, 'NetSuite', BUILTIN.CURRRENT_TIMESTAMP(), bi.VendorName, bi.InvoiceAmount, bi.PurchaseOrderNumber, bi.ProcessorUser, NULL, bi.InvoiceDueDate FROM Payments p JOIN BaseInfo bi ON p.BillID = bi.BillID WHERE p.PaymentExecutionDate > bi.InvoiceDueDate
) p

UNION ALL

-- 11. Invoice Closed (Paid in Full)
SELECT
    bi.Invoice,
    'Invoice Closed',
    n.NoteDate,
    'NetSuite',
    BUILTIN.CURRRENT_TIMESTAMP(),
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    NULL,
    bi.InvoiceDueDate
FROM
    Notes n
JOIN
    BaseInfo bi ON n.BillID = bi.BillID
WHERE
    n.NoteField = 'status' AND n.NoteNewValue = 'Paid In Full'

UNION ALL

-- 14. Credit Memo Applied
SELECT 
    bi.Invoice,
    'Credit Memo Applied',
    vc.trandate AS EventTime,
    'NetSuite' AS SourceSystem,
    BUILTIN.CURRRENT_TIMESTAMP() AS LastDataUpdate,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.PurchaseOrderNumber,
    bi.ProcessorUser,
    NULL AS Approver,
    bi.InvoiceDueDate
FROM 
    TransactionLink tl
JOIN 
    Transaction vc ON tl.previousDoc = vc.ID AND vc.type = 'VendCred'
JOIN 
    BaseInfo bi ON tl.nextDoc = bi.BillID;

Passaggi

Prerequisiti: verifichi di avere installato Python 3.6 o versione successiva, insieme alle librerie requests, requests-oauthlib e pandas. Può installarle con pip: pip install requests requests-oauthlib pandas.
Abiliti le funzionalità NetSuite: in NetSuite, un amministratore deve abilitare SuiteTalk Web Services. Acceda a Setup > Company > Enable Features > SuiteCloud e selezioni le caselle SUITEANALYTICS WORKBOOK e SUITETALK (WEB SERVICES).
Crei un record di integrazione e un token di accesso: acceda a Setup > Integration > Manage Integrations > New. Crei un nuovo record di integrazione, abilitando TOKEN-BASED AUTHENTICATION e TBA: AUTHORIZATION FLOW. Prenda nota di CONSUMER KEY e CONSUMER SECRET. Acceda quindi a Setup > Users/Roles > Access Tokens > New per creare un token di accesso per l’utente/ruolo desiderato e associarlo al record di integrazione. Prenda nota di TOKEN ID e TOKEN SECRET.
Configuri lo script Python: copi lo script Python fornito in un file (ad esempio, extract_netsuite_ap.py). Inserisca i valori richiesti nel dizionario NETSUITE_CREDENTIALS al posto dei segnaposto: Account ID, Consumer Key/Secret e Token ID/Secret.
Imposti i parametri di estrazione: modifichi le variabili START_DATE e END_DATE nello script per definire il periodo da estrarre. Per i primi test, si consiglia di iniziare con un intervallo più breve, ad esempio un mese.
Esegua lo script: avvii lo script dal terminale con il comando python extract_netsuite_ap.py. Lo script eseguirà l’autenticazione con NetSuite, lancerà diverse query SuiteQL per raccogliere i dati e li elaborerà.
Controlli l’esecuzione dello script: lo script mostrerà nella console gli aggiornamenti sullo stato di avanzamento, indicando il gruppo di dati recuperato (Vendor Bills, System Notes, Payments e così via). L’elaborazione di grandi volumi di dati può richiedere alcuni minuti.
Controlli il risultato: al termine dell’esecuzione, verrà creato nella stessa cartella un file CSV denominato netsuite_ap_event_log.csv, contenente l’Event Log strutturato.
Logica di trasformazione dei dati: lo script trasforma automaticamente i dati NetSuite grezzi nel formato richiesto per l’Event Log. Individua attività come 'Invoice Approved' analizzando le note di sistema per rilevare le modifiche al campo 'Approval Status' e calcola eventi derivati come 'Late Payment Identified' confrontando le date di pagamento con quelle di scadenza.
Prepari il file per il caricamento: il file CSV generato è formattato per essere caricato direttamente negli strumenti di Process Mining. Verifichi che le intestazioni delle colonne (Invoice, ActivityName, EventTime e così via) corrispondano allo schema previsto dall’applicazione di destinazione.

Configurazione

Autenticazione: lo script utilizza l’autenticazione basata su token (TBA) con OAuth 1.0, lo standard NetSuite per le integrazioni da server a server. Deve fornire Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret.
Endpoint API: lo script crea automaticamente l’URL dell’endpoint REST API utilizzando l’Account ID. Verifichi che l’account NetSuite sia configurato per consentire le richieste REST Web Services.
Intervallo di date: l’estrazione è controllata dalle variabili START_DATE e END_DATE. Per recuperare i dati in modo efficiente ed evitare timeout, è fondamentale filtrare la query principale in base a un campo data indicizzato, come lastmodifieddate o datecreated.
Filtri sui dati: le query SuiteQL possono essere personalizzate per filtrare società controllate, fornitori o tipi di documento specifici, aggiungendo clausole WHERE (ad esempio, WHERE subsidiary = 'YourSubsidiaryID').
Considerazioni sulle prestazioni: NetSuite impone limiti di utilizzo delle API. Lo script gestisce con affidabilità gli insiemi di dati di grandi dimensioni tramite la paginazione (LIMIT e OFFSET). Per milioni di record, valuti di eseguire l’estrazione in intervalli di date più brevi e consecutivi.
Prerequisiti: il ruolo associato al token di accesso deve disporre delle autorizzazioni di visualizzazione per i seguenti tipi di record: Vendor Bill, Vendor Payment, Vendor Credit, Purchase Order, System Note, Vendor ed Employee.

Query di esempio python

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

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your NetSuite Token-Based Authentication credentials
NETSUITE_CREDENTIALS = {
    class="hl-string">"account": class="hl-string">"[Your_NetSuite_Account_ID]", class=class="hl-string">"hl-comment"># e.g., 1234567_SB1
    class="hl-string">"consumer_key": class="hl-string">"[Your_Consumer_Key]",
    class="hl-string">"consumer_secret": class="hl-string">"[Your_Consumer_Secret]",
    class="hl-string">"token_id": class="hl-string">"[Your_Token_ID]",
    class="hl-string">"token_secret": class="hl-string">"[Your_Token_Secret]"
}

class=class="hl-string">"hl-comment"># Set the date range for the extraction
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'

class=class="hl-string">"hl-comment"># --- NetSuite API Client ---
def get_netsuite_api_url(account_id):
    class=class="hl-string">"hl-comment"># Replace class="hl-string">'-' with class="hl-string">'_' for sandbox/release preview accounts
    account_id_formatted = account_id.replace(class="hl-string">'-', class="hl-string">'_').lower()
    return fclass="hl-string">"https://{account_id_formatted}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query against the NetSuite REST API with pagination."""
    url = get_netsuite_api_url(NETSUITE_CREDENTIALS[class="hl-string">"account"])
    auth = OAuth1(
        client_key=NETSUITE_CREDENTIALS[class="hl-string">"consumer_key"],
        client_secret=NETSUITE_CREDENTIALS[class="hl-string">"consumer_secret"],
        resource_owner_key=NETSUITE_CREDENTIALS[class="hl-string">"token_id"],
        resource_owner_secret=NETSUITE_CREDENTIALS[class="hl-string">"token_secret"],
        realm=NETSUITE_CREDENTIALS[class="hl-string">"account"]
    )
    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }
    
    all_results = []
    offset = 0
    limit = 1000 class=class="hl-string">"hl-comment"># Max limit per page

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(url, headers=headers, data=payload, auth=auth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            all_results.extend(items)
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit
            print(fclass="hl-string">"Fetched {len(all_results)} records...")
            time.sleep(1) class=class="hl-string">"hl-comment"># Be respectful to the API

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            if e.response is not None:
                print(fclass="hl-string">"Response Body: {e.response.text}")
            break

    return pd.DataFrame(all_results)

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    print(class="hl-string">"Starting NetSuite AP Data Extraction...")
    
    class=class="hl-string">"hl-comment"># 1. Fetch Vendor Bills
    print(class="hl-string">"\n--- Step 1: Fetching Vendor Bills ---")
    vendor_bill_query = fclass="hl-string">"""
        SELECT
            tran.ID as TransactionId,
            tran.tranId as Invoice,
            tran.entity as VendorId,
            BUILTIN.DF(tran.entity) as VendorName,
            tran.tranDate as TransactionDate,
            tran.dueDate as InvoiceDueDate,
            tran.createdDate as CreatedDate,
            tran.lastModifiedDate as LastDataUpdate,
            tran.total as InvoiceAmount,
            BUILTIN.DF(tran.createdBy) as ProcessorUser,
            BUILTIN.DF(tran.approvalStatus) as ApprovalStatusText,
            tran.approvalStatus as ApprovalStatusId,
            tran.status as StatusId,
            tran.terms as TermsId,
            BUILTIN.DF(tran.terms) as TermsName
        FROM
            Transaction AS tran
        WHERE
            tran.type = 'VendBill'
            AND tran.lastModifiedDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
    """
    df_bills = execute_suiteql(vendor_bill_query)
    if df_bills.empty:
        print(class="hl-string">"No vendor bills found for the specified date range. Exiting.")
        return
    
    bill_ids = class="hl-string">','.join(df_bills[class="hl-string">'TransactionId'].astype(str).tolist())
    print(fclass="hl-string">"Found {len(df_bills)} vendor bills.")

    class=class="hl-string">"hl-comment"># 2. Fetch System Notes for status changes
    print(class="hl-string">"\n--- Step 2: Fetching System Notes for status changes ---")
    system_notes_query = fclass="hl-string">"""
        SELECT
            transactionId,
            field,
            newValue,
            oldValue,
            date as EventTime
        FROM
            SystemNote
        WHERE
            transactionId IN ({bill_ids})
            AND field IN ('transaction.approvalstatus', 'transaction.status')
    """
    df_notes = execute_suiteql(system_notes_query)
    print(fclass="hl-string">"Found {len(df_notes)} relevant system notes.")

    class=class="hl-string">"hl-comment"># 3. Fetch PO Links
    print(class="hl-string">"\n--- Step 3: Fetching Purchase Order Links ---")
    po_link_query = fclass="hl-string">"""
        SELECT DISTINCT
            vb.ID as BillId,
            po.tranId as PurchaseOrderNumber
        FROM
            Transaction AS vb
            JOIN TransactionLine AS vbl ON vb.ID = vbl.Transaction
            JOIN Transaction AS po ON vbl.purchaseOrder = po.ID
        WHERE
            vb.ID IN ({bill_ids})
    """
    df_po = execute_suiteql(po_link_query)
    df_po.rename(columns={class="hl-string">'BillId': class="hl-string">'TransactionId'}, inplace=True)
    print(fclass="hl-string">"Found {len(df_po)} PO links.")

    class=class="hl-string">"hl-comment"># 4. Fetch Payments
    print(class="hl-string">"\n--- Step 4: Fetching Payment Information ---")
    payment_query = fclass="hl-string">"""
        SELECT
            link.prevtranid AS BillId,
            pymt.tranDate AS PaymentDate,
            pymt.ID AS PaymentId
        FROM
            NextTransactionLineLink AS link
            JOIN Transaction AS pymt ON link.nexttranid = pymt.ID
        WHERE
            link.prevtranid IN ({bill_ids})
            AND pymt.type = 'VendPymt'
    """
    df_payments = execute_suiteql(payment_query)
    df_payments.rename(columns={class="hl-string">'BillId': class="hl-string">'TransactionId'}, inplace=True)
    print(fclass="hl-string">"Found {len(df_payments)} payment applications.")

    class=class="hl-string">"hl-comment"># 5. Fetch Credit Memo Applications
    print(class="hl-string">"\n--- Step 5: Fetching Credit Memo Applications ---")
    credit_query = fclass="hl-string">"""
        SELECT
            link.prevtranid AS BillId,
            credit.tranDate AS CreditApplyDate
        FROM
            NextTransactionLineLink AS link
            JOIN Transaction AS credit ON link.nexttranid = credit.ID
        WHERE
            link.prevtranid IN ({bill_ids})
            AND credit.type = 'VendCred'
    """
    df_credits = execute_suiteql(credit_query)
    df_credits.rename(columns={class="hl-string">'BillId': class="hl-string">'TransactionId'}, inplace=True)
    print(fclass="hl-string">"Found {len(df_credits)} credit memo applications.")

    class=class="hl-string">"hl-comment"># --- Event Log Generation ---
    print(class="hl-string">"\n--- Step 6: Generating Event Log ---")
    event_log = []
    source_system = class="hl-string">"NetSuite SuiteTalk API"

    for _, bill in df_bills.iterrows():
        base_event = {
            class="hl-string">'Invoice': bill[class="hl-string">'Invoice'],
            class="hl-string">'SourceSystem': source_system,
            class="hl-string">'LastDataUpdate': bill[class="hl-string">'LastDataUpdate'],
            class="hl-string">'VendorName': bill[class="hl-string">'VendorName'],
            class="hl-string">'InvoiceAmount': bill[class="hl-string">'InvoiceAmount'],
            class="hl-string">'InvoiceDueDate': bill[class="hl-string">'InvoiceDueDate'],
            class="hl-string">'ProcessorUser': bill[class="hl-string">'ProcessorUser'],
            class="hl-string">'Approver': None, class=class="hl-string">"hl-comment"># Placeholder, can be enriched from workflow data if available
        }

        po_info = df_po[df_po[class="hl-string">'TransactionId'] == bill[class="hl-string">'TransactionId']]
        base_event[class="hl-string">'PurchaseOrderNumber'] = po_info[class="hl-string">'PurchaseOrderNumber'].iloc[0] if not po_info.empty else None

        class=class="hl-string">"hl-comment"># Activity: Vendor Bill Created
        event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Vendor Bill Created', class="hl-string">'EventTime': bill[class="hl-string">'CreatedDate']})

        class=class="hl-string">"hl-comment"># Activity: PO Matching Attempted (inferred at creation if PO exists)
        if base_event[class="hl-string">'PurchaseOrderNumber'] is not None:
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'PO Matching Attempted', class="hl-string">'EventTime': bill[class="hl-string">'CreatedDate']})

        class=class="hl-string">"hl-comment"># Activities from System Notes
        notes = df_notes[df_notes[class="hl-string">'transactionId'] == bill[class="hl-string">'TransactionId']].sort_values(class="hl-string">'EventTime')
        for _, note in notes.iterrows():
            activity = None
            if note[class="hl-string">'field'] == class="hl-string">'transaction.approvalstatus':
                if note[class="hl-string">'newValue'] == class="hl-string">'Pending Approval': activity = class="hl-string">'Approval Submitted'
                elif note[class="hl-string">'newValue'] == class="hl-string">'Approved': 
                    activity = class="hl-string">'Invoice Approved'
                    event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Invoice Posted To GL', class="hl-string">'EventTime': note[class="hl-string">'EventTime']})
                elif note[class="hl-string">'newValue'] == class="hl-string">'Rejected': activity = class="hl-string">'Invoice Rejected'
                elif note[class="hl-string">'oldValue'] == class="hl-string">'Pending Approval' and note[class="hl-string">'newValue'] != class="hl-string">'Approved': activity = class="hl-string">'Invoice Re-Routed For Approval'
            
            if note[class="hl-string">'field'] == class="hl-string">'transaction.status' and note[class="hl-string">'newValue'] == class="hl-string">'Paid In Full':
                activity = class="hl-string">'Invoice Closed'

            class=class="hl-string">"hl-comment"># Logic for discrepancy is highly custom. We infer it from a move to a non-standard approval status like class="hl-string">'On Hold'.
            class=class="hl-string">"hl-comment"># This requires knowing the specific numeric ID for such a status.
            class=class="hl-string">"hl-comment"># Example: elif note[class="hl-string">'field'] == class="hl-string">'transaction.approvalstatus' and note[class="hl-string">'newValueId'] == class="hl-string">'[Your_On_Hold_Status_ID]': activity = class="hl-string">'Discrepancy Identified'

            if activity:
                event_log.append({**base_event, class="hl-string">'ActivityName': activity, class="hl-string">'EventTime': note[class="hl-string">'EventTime']})

        class=class="hl-string">"hl-comment"># Payment Activities
        payments = df_payments[df_payments[class="hl-string">'TransactionId'] == bill[class="hl-string">'TransactionId']]
        if not payments.empty:
            first_payment = payments.sort_values(class="hl-string">'PaymentDate').iloc[0]
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Scheduled', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']}) class=class="hl-string">"hl-comment"># Simplified: using payment date for schedule
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Payment Executed', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']})

            class=class="hl-string">"hl-comment"># Derived Payment Events
            payment_date = pd.to_datetime(first_payment[class="hl-string">'PaymentDate'])
            due_date = pd.to_datetime(bill[class="hl-string">'InvoiceDueDate'])
            if due_date and payment_date > due_date:
                event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Late Payment Identified', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']})
            
            class=class="hl-string">"hl-comment"># Early payment requires discount date from terms, which needs another join. Simplified for this example.
            class=class="hl-string">"hl-comment"># If you query class="hl-string">'discountdate' from the transaction you can compare it here.
            class=class="hl-string">"hl-comment"># For example: if pd.to_datetime(bill[class="hl-string">'discountdate']) and payment_date <= pd.to_datetime(bill[class="hl-string">'discountdate']):
            class=class="hl-string">"hl-comment">#    event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Early Payment Captured', class="hl-string">'EventTime': first_payment[class="hl-string">'PaymentDate']})

        class=class="hl-string">"hl-comment"># Credit Memo Activity
        credits = df_credits[df_credits[class="hl-string">'TransactionId'] == bill[class="hl-string">'TransactionId']]
        for _, credit in credits.iterrows():
            event_log.append({**base_event, class="hl-string">'ActivityName': class="hl-string">'Credit Memo Applied', class="hl-string">'EventTime': credit[class="hl-string">'CreditApplyDate']})

    class=class="hl-string">"hl-comment"># Finalize DataFrame
    df_event_log = pd.DataFrame(event_log)
    df_event_log.sort_values(by=[class="hl-string">'Invoice', class="hl-string">'EventTime'], inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'netsuite_ap_event_log.csv'
    df_event_log.to_csv(output_filename, index=False)
    print(fclass="hl-string">"\nExtraction complete. Event log saved to {output_filename}")

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

Passaggi

Abiliti SuiteScript: acceda a Setup > Company > Enable Features. Nella scheda SuiteCloud, verifichi che Server SuiteScript sia abilitato.
Crei il file dello script: copi il codice JavaScript completo dalla sezione della query qui sotto e lo salvi in un file .js (ad esempio, processmind_ap_extraction.js).
Carichi lo script nel File Cabinet: in NetSuite, acceda a Documents > Files > SuiteScripts. Crei una nuova cartella (ad esempio, ProcessMind) e vi carichi il file .js creato.
Crei il record dello script: acceda a Customization > Scripting > Scripts > New. Selezioni il file appena caricato e faccia clic su Create Script Record. Assegni un nome allo script (ad esempio, "ProcessMind AP Extraction"), specifichi un ID (ad esempio, _pm_ap_extraction) e salvi.
Definisca i parametri dello script: nella pagina del record dello script, apra la scheda secondaria Parameters e crei i seguenti parametri:
- custscript_pm_start_date: etichetta Start Date, tipo Date.
- custscript_pm_end_date: etichetta End Date, tipo Date.
- custscript_pm_folder_id: etichetta Target Folder ID, tipo Integer Number. È l’ID interno della cartella File Cabinet in cui verrà salvato il risultato.
- custscript_pm_subsidiary_id: etichetta Subsidiary ID (Optional), tipo Integer Number.
Distribuisca lo script: faccia clic sul pulsante Deploy Script nella pagina del record dello script. Selezioni Scheduled Script e faccia clic su Save.
Configuri la distribuzione: nella pagina Script Deployment, assegni un ID alla distribuzione (ad esempio, _pm_ap_extraction_deployment). Per i test iniziali, imposti Status su Not Scheduled.
Imposti la pianificazione: nella scheda secondaria Schedule, configuri la frequenza di estrazione. Per la prima esecuzione, può avviarla manualmente una sola volta. Per le estrazioni successive, imposti una pianificazione giornaliera o settimanale in orario non lavorativo.
Imposti i parametri di esecuzione: nella scheda secondaria Parameters della distribuzione, inserisca Start Date, End Date e Target Folder ID desiderati per l’estrazione.
Esegua lo script e recuperi il file: per avviarlo manualmente, salvi la distribuzione con Status impostato su Not Scheduled, quindi faccia clic su Save and Execute. Controlli l’avanzamento dello script in Customization > Scripting > Script Execution Logs. Al termine, acceda alla cartella di destinazione nel File Cabinet e scarichi l’Event Log in formato CSV generato.
Prepari il file per ProcessMind: verifichi che il file CSV scaricato contenga le intestazioni corrette, come specificato nello script (Invoice, ActivityName, EventTime e così via). Il file è pronto per il caricamento in ProcessMind.

Configurazione

Prerequisiti: un ruolo utente NetSuite con autorizzazioni per creare ed eseguire SuiteScript, accedere ai record Vendor Bill e Vendor Payment e visualizzare System Notes.
Parametri dello script: lo script si configura tramite i parametri di distribuzione e può essere riutilizzato senza modifiche al codice:
- Start Date e End Date: definiscono il periodo di elaborazione delle fatture in base alla data di creazione. Per il caricamento iniziale, si consiglia un periodo di 6-12 mesi. Per i successivi caricamenti incrementali, è possibile impostare gli ultimi 7 giorni.
- Target Folder ID: specifica l’ID interno della cartella File Cabinet di NetSuite in cui verrà salvato il file CSV. La cartella deve essere creata in precedenza.
- Subsidiary ID (Optional): in un account OneWorld, limita l’estrazione a una specifica società controllata. Lasci il campo vuoto per includere tutte le società controllate a cui l’utente ha accesso.
Considerazioni sulle prestazioni: negli ambienti con volumi elevati di transazioni (oltre 50.000 fatture al mese), uno script Map/Reduce potrebbe essere più adatto per evitare di superare i limiti di utilizzo. Pianifichi l’esecuzione dello script fuori dall’orario lavorativo per ridurre al minimo l’impatto sulle prestazioni.
Campi personalizzati: se il processo di approvazione o altri dati chiave dipendono da campi o record personalizzati, occorre modificare i filtri e le colonne della ricerca salvata nello script per includere gli ID interni di tali elementi.

Query di esempio javascript

/**
 * @NApiVersion 2.1
 * @NScriptType ScheduledScript
 * @NModuleScope SameAccount
 */

/*

ProcessMind NetSuite AP Invoice Extraction Script

This script extracts Accounts Payable invoice processing events from NetSuite.
It queries Vendor Bill and related transaction data, formats it into a single event log, and saves it as a CSV file in the File Cabinet.

Script Parameters:
- custscript_pm_start_date: (Date) The start date for the query window (based on bill creation date).
- custscript_pm_end_date: (Date) The end date for the query window.
- custscript_pm_folder_id: (Integer) The internal ID of the File Cabinet folder to save the CSV file in.
- custscript_pm_subsidiary_id: (Integer, Optional) The internal ID of the subsidiary to filter on.

*/

define(['N/search', 'N/runtime', 'N/file', 'N/format', 'N/log'], (search, runtime, file, format, log) => {

    const execute = (context) => {
        log.debug('Script Execution Started', 'Starting AP Invoice event log extraction.');

        const script = runtime.getCurrentScript();
        const startDate = script.getParameter({ name: 'custscript_pm_start_date' });
        const endDate = script.getParameter({ name: 'custscript_pm_end_date' });
        const folderId = script.getParameter({ name: 'custscript_pm_folder_id' });
        const subsidiaryId = script.getParameter({ name: 'custscript_pm_subsidiary_id' });

        if (!startDate || !endDate || !folderId) {
            log.error('Missing Parameters', 'Start Date, End Date, and Folder ID are required.');
            return;
        }

        let allEvents = [];
        const now = new Date();

        // Helper to format date/time for CSV
        const formatDateTime = (dateStr) => {
            if (!dateStr) return '';
            try {
                const parsedDate = format.parse({ value: dateStr, type: format.Type.DATETIME });
                return format.format({ value: parsedDate, type: format.Type.DATETIMETZ });
            } catch (e) {
                return dateStr; // Fallback for simple date strings
            }
        };

        // Helper function to run a search and format results
        const runSearchAndCollectEvents = (config) => {
            log.debug('Running Search', `Activity: ${config.activityName}`);
            const searchObj = search.create({
                type: config.type,
                filters: config.filters,
                columns: config.columns
            });

            const pagedData = searchObj.runPaged({ pageSize: 1000 });
            pagedData.pageRanges.forEach(pageRange => {
                const page = pagedData.fetch({ index: pageRange.index });
                page.data.forEach(result => {
                    allEvents.push({
                        'Invoice': result.getValue(config.mapping.Invoice) || '',
                        'ActivityName': config.activityName,
                        'EventTime': formatDateTime(result.getValue(config.mapping.EventTime)) || '',
                        'SourceSystem': 'NetSuite',
                        'LastDataUpdate': format.format({ value: now, type: format.Type.DATETIMETZ }),
                        'VendorName': result.getText(config.mapping.VendorName) || result.getValue(config.mapping.VendorName) || '',
                        'InvoiceAmount': result.getValue(config.mapping.InvoiceAmount) || '',
                        'PurchaseOrderNumber': result.getText(config.mapping.PurchaseOrderNumber) || result.getValue(config.mapping.PurchaseOrderNumber) || '',
                        'ProcessorUser': result.getText(config.mapping.ProcessorUser) || '',
                        'Approver': result.getText(config.mapping.Approver) || '',
                        'InvoiceDueDate': result.getValue(config.mapping.InvoiceDueDate) || ''
                    });
                });
            });
            log.debug('Search Complete', `Found ${allEvents.length} total events so far.`);
        };

        // Common filters
        let baseBillFilters = [
            ['mainline', 'is', 'T'], 'AND',
            ['type', 'anyof', 'VendBill'], 'AND',
            ['datecreated', 'within', startDate, endDate]
        ];
        if (subsidiaryId) {
            baseBillFilters.push('AND', ['subsidiary', 'anyof', subsidiaryId]);
        }

        // --- Define Search Configurations for each Activity ---

        const searchConfigs = [
            // 1. Vendor Bill Created
            {
                activityName: 'Vendor Bill Created',
                type: 'vendorbill',
                filters: baseBillFilters,
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'datecreated', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: 'datecreated', VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: 'createdby', InvoiceDueDate: 'duedate' }
            },
            // 2. PO Matching Attempted (Inferred from System Notes on first PO application)
            {
                activityName: 'PO Matching Attempted',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'appliedtotransaction'], 'AND', ['systemnotes.newvalue', 'contains', 'Purchase Order']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', sort: search.Sort.ASC, label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' }),
                    search.createColumn({ name: 'appliedtotransaction', label: 'PurchaseOrderNumber' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: 'createdby', InvoiceDueDate: 'duedate', PurchaseOrderNumber: 'appliedtotransaction' }
            },
            // 3. Discrepancy Identified (Uses a placeholder for custom status, e.g., 'On Hold')
            {
                activityName: 'Discrepancy Identified',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', '[On Hold]']]), // Placeholder: Replace '[On Hold]' with your actual status text
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 4. Approval Submitted & 5. Invoice Re-Routed For Approval
            {
                activityName: 'Approval Submitted', // This will capture initial and subsequent submissions
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', 'Pending Approval']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 6. Invoice Approved & 8. Invoice Posted to GL
            {
                activityName: 'Invoice Approved', // Approval event often coincides with posting
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', 'Approved']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'Approver' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', Approver: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 7. Invoice Rejected
            {
                activityName: 'Invoice Rejected',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'approvalstatus'], 'AND', ['systemnotes.newvalue', 'is', 'Rejected']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'Approver' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', Approver: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 9. Payment Scheduled
            {
                activityName: 'Payment Scheduled',
                type: 'vendorpayment',
                filters: [['mainline', 'is', 'T'], 'AND', ['type', 'anyof', 'VendPymt'], 'AND', ['appliedtotransaction.type', 'anyof', 'VendBill'], 'AND', ['appliedToTransaction.datecreated', 'within', startDate, endDate]],
                columns: [
                    search.createColumn({ name: 'tranid', join: 'appliedToTransaction', label: 'Invoice' }),
                    search.createColumn({ name: 'datecreated', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', join: 'appliedToTransaction', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', join: 'appliedToTransaction', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: search.createColumn({name: 'tranid', join: 'appliedToTransaction'}), EventTime: 'datecreated', VendorName: 'entity', InvoiceAmount: search.createColumn({name: 'total', join: 'appliedToTransaction'}), ProcessorUser: 'createdby', InvoiceDueDate: search.createColumn({name: 'duedate', join: 'appliedToTransaction'}) }
            },
            // 10. Payment Executed
            {
                activityName: 'Payment Executed',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['payingtransaction.trandate', 'isnotempty', '']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'payingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', join: 'payingTransaction', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'payingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'createdby', join: 'payingTransaction'}), InvoiceDueDate: 'duedate' }
            },
            // 11. Invoice Closed
            {
                activityName: 'Invoice Closed',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['systemnotes.field', 'is', 'Status'], 'AND', ['systemnotes.newvalue', 'is', 'Vendor Bill : Paid in Full']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'date', join: 'systemNotes', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'name', join: 'systemNotes', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'date', join: 'systemNotes'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'name', join: 'systemNotes'}), InvoiceDueDate: 'duedate' }
            },
            // 12. Early Payment Captured
            {
                activityName: 'Early Payment Captured',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['payingtransaction.trandate', 'isnotempty', ''], 'AND', ['formuladate: {payingtransaction.trandate} <= {discountdate}', 'is', '1']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'payingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'payingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', InvoiceDueDate: 'duedate' }
            },
            // 13. Late Payment Identified
            {
                activityName: 'Late Payment Identified',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['payingtransaction.trandate', 'isnotempty', ''], 'AND', ['formuladate: {payingtransaction.trandate} > {duedate}', 'is', '1']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'payingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'payingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', InvoiceDueDate: 'duedate' }
            },
            // 14. Credit Memo Applied
            {
                activityName: 'Credit Memo Applied',
                type: 'vendorbill',
                filters: baseBillFilters.concat(['AND', ['applyingtransaction.type', 'anyof', 'VendCred']]),
                columns: [
                    search.createColumn({ name: 'tranid', label: 'Invoice' }),
                    search.createColumn({ name: 'trandate', join: 'applyingTransaction', label: 'EventTime' }),
                    search.createColumn({ name: 'entity', label: 'VendorName' }),
                    search.createColumn({ name: 'total', label: 'InvoiceAmount' }),
                    search.createColumn({ name: 'createdby', join: 'applyingTransaction', label: 'ProcessorUser' }),
                    search.createColumn({ name: 'duedate', label: 'InvoiceDueDate' })
                ],
                mapping: { Invoice: 'tranid', EventTime: search.createColumn({name: 'trandate', join: 'applyingTransaction'}), VendorName: 'entity', InvoiceAmount: 'total', ProcessorUser: search.createColumn({name: 'createdby', join: 'applyingTransaction'}), InvoiceDueDate: 'duedate' }
            },
        ];

        // Execute all searches
        searchConfigs.forEach(config => {
            try {
                runSearchAndCollectEvents(config);
            } catch (e) {
                log.error(`Search Failed for ${config.activityName}`, e);
            }
        });

        // Convert to CSV and save
        if (allEvents.length > 0) {
            const headers = Object.keys(allEvents[0]);
            let csvContent = headers.join(',') + '\n';
            allEvents.forEach(event => {
                const row = headers.map(header => {
                    let value = event[header] ? event[header].toString() : '';
                    // Escape commas and quotes
                    if (value.includes(',') || value.includes('"') || value.includes('\n')) {
                        value = '"' + value.replace(/"/g, '""') + '"';
                    }
                    return value;
                });
                csvContent += row.join(',') + '\n';
            });

            const fileName = `ProcessMind_AP_EventLog_${new Date().toISOString().slice(0, 10)}.csv`;
            const csvFile = file.create({
                name: fileName,
                fileType: file.Type.CSV,
                contents: csvContent,
                folder: folderId
            });
            const fileId = csvFile.save();
            log.audit('File Created', `Successfully created file ${fileName} with ID ${fileId} in folder ${folderId}.`);
        } else {
            log.audit('No Events Found', 'No events found for the specified criteria.');
        }

        log.debug('Script Execution Finished', `Processed a total of ${allEvents.length} events.`);
    };

    return { execute };
});

È pronto a iniziare?

Con questo template dei dati, dispone di tutto il necessario per iniziare a ottimizzare l’elaborazione delle fatture fornitori. Inizi a migliorare il flusso di lavoro e a ottenere pagamenti più rapidi e conformi.

Torna alla guida al miglioramento

Scarica il template

Riprenda il controllo: ottimizzi oggi la gestione delle fatture fornitori

Elimini le penali per ritardato pagamento e i pagamenti duplicati, riducendo i costi del 60%.

Inizi la prova gratuita

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

Il template dei dati per l’elaborazione delle fatture fornitori

Il template dei dati per l’elaborazione delle fatture fornitori

Attributi per l’elaborazione delle fatture fornitori

Attività di elaborazione delle fatture fornitori

Guide all’estrazione

Esportazione di ricerche salvate e report standard da NetSuite

Passaggi

Configurazione

Query di esempio json

Query SuiteQL tramite SuiteAnalytics Connect (ODBC/JDBC)

Passaggi

Configurazione

Query di esempio sql

Script Python con API SuiteTalk REST/SOAP

Passaggi

Configurazione

Query di esempio python

Esportazione automatica dei dati con SuiteScript lato server

Passaggi

Configurazione

Query di esempio javascript

È pronto a iniziare?

Riprenda il controllo: ottimizzi oggi la gestione delle fatture fornitori