> Miglioramento continuo dei processi > Order to Cash Fatturazione ed emissione delle fatture > Salesforce Sales Cloud > Template dei dati

Il Suo Template dati per Order to Cash, fatturazione ed emissione delle fatture

Salesforce Sales Cloud

← Torna alla guida al miglioramento

Attributi di Order to Cash - Fatturazione ed emissione delle fatture (19) Attività di Order to Cash - Fatturazione ed emissione delle fatture (13) Guide all'estrazione (3)

Il Suo Template dati per Order to Cash, fatturazione ed emissione delle fatture

Questo Template offre una panoramica completa degli attributi e delle attività essenziali necessari per analizzare efficacemente il processo Order to Cash, fatturazione ed emissione delle fatture. Specifica le informazioni da raccogliere per il Suo Event Log e fornisce indicazioni pratiche su come estrarre questi dati. Utilizzi questa risorsa per semplificare le iniziative di Process Mining e ottenere insight di valore.

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

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

Scarica il Template

Attributi di Order to Cash - Fatturazione ed emissione delle fatture

Questi sono i campi dati consigliati da includere nell’Event Log per un’analisi completa di Order to Cash - Fatturazione ed emissione delle fatture, assicurando l’acquisizione di tutte le informazioni critiche.

3 Obbligatorio 5 Consigliato 11 Facoltativo

	Nome	Descrizione
	Nome attività ActivityName	Il nome dello specifico evento aziendale che si è verificato nel processo di fatturazione.
Descrizione Questo Attributo descrive il passaggio o la milestone raggiunta nel ciclo di vita della fattura, ad esempio 'Invoice Generated' o 'Payment Received'. Queste attività costituiscono i nodi della mappa del processo. L’analisi della sequenza di Activity Name è fondamentale per il process mining. Rivela il flusso effettivo del processo e consente di confrontarlo con quello progettato. Viene utilizzata per individuare deviazioni, colli di bottiglia tra passaggi specifici e cicli di rilavorazione, supportando direttamente Dashboard come 'Billing Process Rework & Errors' e 'Billing Compliance Violation Report'. Perché è importante Definisce i passaggi del processo, costituendo l’ossatura della mappa del processo e consentendo di analizzare Workflow, colli di bottiglia e deviazioni. Dove reperirlo In genere deriva dalle modifiche al campo Status dell’oggetto Invoice o dai record di oggetti correlati come Task o Event, che registrano azioni specifiche. Esempi Fattura generataFattura approvataFattura inviata al clientePagamento ricevuto
	Numero fattura InvoiceNumber	L’identificativo univoco di ogni fattura, che funge da identificativo principale del caso per il processo di fatturazione.
Descrizione Invoice Number è l’Attributo centrale che raggruppa tutte le attività di fatturazione correlate in un unico caso. Ogni numero rappresenta un documento di fatturazione distinto inviato a un cliente. Nell’analisi di process mining, questo Attributo consente di monitorare end-to-end il ciclo di vita di una fattura, dalla generazione al pagamento finale e alla chiusura. È essenziale per costruire la mappa del processo e calcolare KPI a livello di caso, come 'Average Invoice Cycle Time' e 'Days Sales Outstanding'. Analizzare i processi per Invoice Number aiuta a individuare colli di bottiglia, cicli di rilavorazione e deviazioni di conformità nelle singole istanze di fatturazione. Perché è importante È la chiave essenziale per collegare tutti gli eventi di fatturazione correlati, consentendo una visione completa end-to-end del processo di fatturazione per ogni transazione univoca. Dove reperirlo In genere si tratta della chiave primaria dell’oggetto Invoice in Salesforce Sales Cloud, spesso rappresentata dal campo `InvoiceNumber` o da un ID univoco analogo. Esempi INV-00582INV-01934INV-10345
	Ora dell’evento EventTime	Il timestamp che indica quando si è verificata una specifica attività.
Descrizione Questo Attributo fornisce la data e l’ora di ogni attività, elementi fondamentali per l’ordinamento cronologico e l’analisi delle prestazioni. I timestamp stabiliscono la sequenza degli eventi e consentono di calcolare le durate tra un evento e l’altro. Nell’analisi dei processi, Event Time viene utilizzato per calcolare tutte le metriche basate sul tempo, inclusi i tempi di ciclo, i tempi di attesa e la durata di attività specifiche. Costituisce la base per KPI come 'Average Invoice Cycle Time' e 'DSO' e alimenta Dashboard quali 'Invoice Approval Cycle Time' e 'Payment Reconciliation Performance'. Perché è importante Questo timestamp è fondamentale per ordinare correttamente gli eventi e calcolare tutte le metriche di performance, come tempi di ciclo e durate, indispensabili per individuare i ritardi. Dove reperirlo Questi dati provengono spesso da campi timestamp generati dal sistema, come `CreatedDate` o `LastModifiedDate`, presenti sull’oggetto Invoice o sui record Task/Event correlati. Esempi 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-05-20T09:05:12Z
	Data di scadenza del pagamento PaymentDueDate	La data entro la quale il cliente è tenuto a pagare la fattura.
Descrizione Questo Attributo specifica il termine ultimo per il pagamento indicato sulla fattura. Viene calcolato in base alla data della fattura e ai termini di pagamento concordati. La Payment Due Date è un dato fondamentale per la pianificazione finanziaria e la gestione degli incassi. Costituisce il riferimento rispetto al quale vengono misurate le prestazioni effettive di pagamento. È essenziale per calcolare il KPI 'On-Time Payment Rate' e per i Dashboard che monitorano la puntualità dei pagamenti, come 'Days Sales Outstanding (DSO) Trend'. Perché è importante È il riferimento per misurare le prestazioni di pagamento, calcolare il DSO e attivare attività di incasso come i solleciti di pagamento. Dove reperirlo Si tratta di un campo data standard sull’oggetto Invoice di Salesforce, spesso denominato `DueDate`. Esempi 2023-05-152023-06-302023-07-01
	Importo totale della fattura InvoiceTotalAmount	Il valore monetario complessivo della fattura.
Descrizione Questo Attributo rappresenta l’importo totale dovuto dal cliente per i beni o i servizi forniti. È una metrica finanziaria fondamentale associata a ogni caso di fatturazione. Analizzare Invoice Total Amount aiuta a stabilire le priorità per le fatture di valore elevato e a comprendere come le prestazioni del processo varino tra transazioni di importo ridotto e transazioni di importo elevato. Può essere utilizzato per segmentare l’analisi nei Dashboard, ad esempio per verificare se le fatture di valore maggiore richiedono tempi di approvazione più lunghi o vengono pagate più tardi. È importante per gestire il rischio finanziario e concentrare efficacemente le attività di incasso. Perché è importante Consente di analizzare l’impatto finanziario, dando priorità alle fatture di valore elevato e comprendendo in che modo il valore monetario influenzi il comportamento del processo, ad esempio i tempi di approvazione o i ritardi nei pagamenti. Dove reperirlo Probabilmente si tratta di un campo valuta standard sull’oggetto Invoice, denominato ad esempio `GrandTotal` o con un nome analogo per il campo riepilogativo. Esempi 5400.5012500.00850.75
	Reparto fatturazione BillingDepartment	Il reparto o il team responsabile dell’attività di fatturazione.
Descrizione Questo Attributo specifica il gruppo funzionale, come 'Accounts Receivable' o 'Sales Operations', al quale appartiene l’utente responsabile. In genere deriva dal profilo o dal ruolo dell’utente in Salesforce. Analizzare le prestazioni per reparto è fondamentale per comprendere la responsabilità del processo e individuare problemi sistemici all’interno di team specifici. Viene utilizzato nei Dashboard 'Payment Reconciliation Performance' e 'Billing Team Workload & Performance' per confrontare l’efficienza e l’utilizzo delle risorse tra diverse aree funzionali. Perché è importante Consente di analizzare le prestazioni a livello di team o reparto, aiutando a individuare colli di bottiglia specifici del gruppo, vincoli di risorse o lacune formative. Dove reperirlo Queste informazioni sono generalmente memorizzate nell’oggetto Utente di Salesforce, in campi come `Reparto` o `Role.Name`. Esempi Crediti verso clientiOperazioni finanziarieTeam recupero crediti
	Stato della fattura InvoiceStatus	Lo stato corrente della fattura nel suo ciclo di vita.
Descrizione Questo Attributo riflette lo stato attuale della fattura, ad esempio 'Draft', 'Awaiting Approval', 'Sent', 'Paid' o 'Void'. Fornisce una fotografia della posizione della fattura nel processo in un determinato momento. Invoice Status è una dimensione fondamentale per il filtraggio e la segmentazione. Consente agli analisti di concentrarsi su specifici gruppi di fatture, ad esempio tutte quelle in attesa di pagamento o tutte quelle rifiutate. Aiuta così a definire le priorità e ad analizzare le caratteristiche delle fatture che si bloccano in determinate fasi. Perché è importante Fornisce una fotografia chiara dello stato attuale della fattura, consentendo di filtrare e analizzare i casi aperti, chiusi o problematici. Dove reperirlo In genere si tratta di un campo elenco di selezione standard denominato `Stato` nell’oggetto Invoice di Salesforce. Esempi In attesa di approvazioneApprovataInviata al clientePagataStralciata
	Utente responsabile UserResponsible	L’utente o l’agente che ha eseguito l’attività.
Descrizione Questo Attributo identifica lo specifico utente Salesforce responsabile di una determinata attività, come l’approvazione di una fattura o la registrazione di un pagamento. Spesso è collegato all’utente che ha modificato per ultimo il record o che è proprietario dell’attività. Analizzare il processo per User Responsible è fondamentale per comprendere le prestazioni del team, la distribuzione del carico di lavoro e le esigenze formative. Supporta direttamente il Dashboard 'Billing Team Workload & Performance', consentendo di confrontare le prestazioni e analizzare l’allocazione delle risorse. Aiuta inoltre nell’analisi delle cause alla radice durante l’indagine di ritardi o errori. Perché è importante Consente di analizzare le prestazioni individuali e del team e di bilanciare il carico di lavoro, aiutando a individuare gli utenti con le migliori prestazioni o quelli che necessitano di ulteriore formazione. Dove reperirlo Può essere individuato in campi come `LastModifiedById` sull’oggetto Invoice o `OwnerId` su Task correlati o oggetti personalizzati. Questi ID devono essere collegati all’oggetto User per ottenere il nome dell’utente. Esempi Alice JohnsonBob WilliamsCharlie Brown
	È un pagamento in ritardo IsLatePayment	Un flag calcolato che indica se il pagamento è stato ricevuto dopo la data di scadenza.
Descrizione Questo attributo booleano viene derivato confrontando il timestamp 'Customer Payment Received' con 'Payment Due Date'. Assume il valore true se il pagamento è avvenuto in ritardo e false negli altri casi. Questo flag semplifica l'analisi dei comportamenti di pagamento e dell'efficacia delle attività di sollecito. Costituisce la base del KPI 'On-Time Payment Rate' e consente di segmentare i clienti in pagatori puntuali e ritardatari per ulteriori analisi. Fornisce un esito binario chiaro per valutare le prestazioni di pagamento di ogni fattura. Perché è importante Fornisce una metrica chiara per valutare l'efficacia delle attività di sollecito, supportando direttamente il KPI 'On-Time Payment Rate' e consentendo di analizzare i fattori che contribuiscono ai pagamenti tardivi. Dove reperirlo Questo attributo non è presente nel sistema di origine. Viene calcolato nel livello ETL o nello strumento di Process Mining confrontando la data di pagamento con il campo `PaymentDueDate`. Esempi truefalse
	È una rilavorazione IsRework	Un flag calcolato che indica se una fattura ha attraversato un ciclo di rilavorazione.
Descrizione Questo attributo booleano viene derivato durante l'elaborazione dei dati. Viene impostato su true se la sequenza di attività di una fattura mostra evidenze di rilavorazione, ad esempio il ritorno a una fase precedente dopo averla superata, come nel caso di 'Invoice Corrected' dopo 'Invoice Approved'. Questo flag è fondamentale per individuare e quantificare rapidamente le inefficienze di processo. Alimenta direttamente il KPI 'Invoice Rework Rate' e la Dashboard 'Billing Process Rework & Errors', consentendo agli analisti di isolare ed esaminare i casi caratterizzati da cicli di rilavorazione costosi e dispendiosi in termini di tempo. Perché è importante Questo flag quantifica direttamente l'inefficienza del processo individuando i casi con cicli di correzione, aiutando a localizzare le fonti degli errori e a calcolare il costo della scarsa qualità. Dove reperirlo Questo attributo non è presente nel sistema di origine. Viene calcolato dallo strumento di Process Mining o nel livello ETL sulla base della sequenza di attività di ciascun caso. Esempi truefalse
	Giorni medi di incasso dei crediti commerciali DaysSalesOutstanding	Il numero di giorni trascorsi dall'invio della fattura alla ricezione del pagamento.
Descrizione Days Sales Outstanding (DSO) è una metrica finanziaria fondamentale che misura il numero medio di giorni necessari a un'azienda per incassare un pagamento dopo una vendita. Viene calcolato come intervallo tra l'evento 'Invoice Sent to Customer' e l'evento 'Customer Payment Received'. Questo KPI rappresenta uno degli obiettivi principali del processo Order to Cash e questo attributo lo rende disponibile per ogni singola fattura. Supporta direttamente la Dashboard 'Days Sales Outstanding (DSO) Trend' ed è essenziale per monitorare e migliorare il flusso di cassa. Perché è importante È un KPI fondamentale per misurare l'efficacia del processo di incasso e il suo impatto diretto sul flusso di cassa dell'azienda. Dove reperirlo Questo è un attributo calcolato. Il calcolo è `(Timestamp('Customer Payment Received') - Timestamp('Invoice Sent to Customer'))`. Esempi 32 giorni58 giorni29 giorni
	Nome cliente CustomerName	Il nome del cliente o dell’account a cui viene addebitata la fattura.
Descrizione Questo Attributo identifica il cliente o l’azienda a cui viene emessa la fattura. In genere è collegato al record Account associato in Salesforce. Analizzare il processo per cliente è essenziale per comprendere i comportamenti specifici e individuare i problemi che possono interessare gli account principali. Può rivelare se determinati clienti pagano costantemente in ritardo, richiedono più rilavorazioni o hanno cicli di approvazione complessi. Questi insight aiutano a gestire le relazioni con i clienti e a personalizzare le strategie di incasso. Perché è importante Consente un’analisi incentrata sul cliente per individuare schemi ricorrenti, ad esempio quali clienti pagano spesso in ritardo o richiedono più correzioni delle fatture, migliorando la gestione delle relazioni con i clienti. Dove reperirlo Proviene dal campo `Account.Name`, collegato tramite una relazione di lookup dall’oggetto Invoice all’oggetto Account. Esempi ABC CorporationGlobal Tech Inc.Innovate Solutions LLC
	Ora di fine dell’evento EventEndTime	Il timestamp che indica quando un’attività è stata completata.
Descrizione Questo Attributo registra l’ora di completamento di un’attività. Sebbene molte attività di fatturazione siano eventi istantanei, in cui Start Time coincide con End Time, alcune, come un passaggio di approvazione, possono avere una durata misurabile. La disponibilità di un End Time consente di calcolare con precisione il tempo di elaborazione dell’attività, ossia la durata durante la quale un agente o un sistema lavora attivamente su un’attività. Aiuta a distinguere il tempo di lavoro effettivo dal tempo di attesa, offrendo una visione più dettagliata dell’efficienza del processo. Perché è importante Consente di calcolare con precisione i tempi di elaborazione delle attività, distinguendo il lavoro attivo dal tempo di attesa inattivo per un’analisi più accurata dell’efficienza. Dove reperirlo Spesso non è un campo standard. Potrebbe essere necessario derivarlo prendendo lo StartTime dell’attività successiva nel caso oppure acquisirlo in un campo personalizzato. Esempi 2023-04-15T10:05:00Z2023-04-16T14:32:10Z2023-05-20T09:05:12Z
	Paese di fatturazione BillingCountry	Il Paese indicato nell'indirizzo di fatturazione della fattura.
Descrizione Questo attributo acquisisce il Paese dell'indirizzo di fatturazione del cliente. Rappresenta una dimensione geografica fondamentale per segmentare i dati di processo. Analizzare il processo di fatturazione per Paese è essenziale per individuare variazioni regionali nelle prestazioni, nella conformità e nel comportamento dei clienti. L'analisi può evidenziare se determinati Paesi presentano cicli di pagamento più lunghi, tassi di rilavorazione differenti o requisiti normativi specifici che incidono sul processo. In questo modo è possibile sostenere l'armonizzazione globale dei processi e le iniziative di ottimizzazione locale. Perché è importante Consente di analizzare i dati per area geografica, individuando variazioni regionali nelle prestazioni, nei requisiti di conformità e nei comportamenti di pagamento. Dove reperirlo Fa parte del campo composto standard dell'indirizzo nell'oggetto Invoice, generalmente `BillingCountry`. Esempi USAGermaniaGiapponeBrasile
	Responsabile dell’account AccountOwner	Il rappresentante commerciale o account manager responsabile dell’account cliente.
Descrizione Questo Attributo identifica il responsabile interno della relazione con il cliente. In genere si tratta del commerciale o dell’account manager assegnato all’Account in Salesforce. Sebbene non partecipi direttamente alla fatturazione, Account Owner può essere una dimensione rilevante per l’analisi. I problemi nel processo di fatturazione possono incidere sulla relazione con il cliente e questo Attributo aiuta a collegare i dati sulle prestazioni del processo alla dimensione commerciale dell’azienda. Può essere utilizzato per verificare se gli account gestiti da determinati responsabili presentano più problemi di fatturazione. Perché è importante Collega le prestazioni del processo di fatturazione al responsabile della relazione commerciale, aiutando a comprendere l’impatto aziendale degli errori o dei ritardi di fatturazione. Dove reperirlo È il campo `Owner.Name` dell’oggetto Account, correlato alla fattura. Esempi David MillerSophia GarciaJames Wilson
	Sistema di origine SourceSystem	Identifica il sistema dal quale hanno avuto origine i dati.
Descrizione Questo Attributo specifica l’applicazione di origine nella quale sono stati generati i dati degli eventi. Per questo processo, sarà generalmente 'Salesforce Sales Cloud'. Negli ambienti con più sistemi integrati, questo campo è fondamentale per la tracciabilità dei dati e la risoluzione dei problemi. Aiuta a comprendere il contesto dei dati e a garantire che gli eventi provenienti da sistemi diversi vengano uniti e interpretati correttamente nello strumento di process mining. Perché è importante Fornisce un contesto essenziale sull’origine dei dati, indispensabile per la governance dei dati, la validazione e l’analisi in ambienti con più sistemi. Dove reperirlo In genere si tratta di un valore statico aggiunto durante il processo di estrazione, trasformazione e caricamento (ETL) dei dati, per indicare l’origine del dataset. Esempi Salesforce Sales CloudSFSC
	Termini di pagamento PaymentTerms	Le condizioni concordate per il pagamento della fattura, come 'Net 30' o 'Due on Receipt'.
Descrizione Questo Attributo definisce le regole che stabiliscono quando e come deve essere pagata una fattura. Spesso determina il calcolo della Payment Due Date e può includere condizioni per sconti in caso di pagamento anticipato. Analizzare i dati per Payment Terms aiuta a comprendere come i diversi accordi influenzino il comportamento di pagamento. È fondamentale per il Dashboard 'Early Payment Discount Utilization', che confronta le date di pagamento con i termini concordati per individuare opportunità finanziarie non sfruttate. Fornisce inoltre il contesto per comprendere perché alcune fatture abbiano cicli di pagamento più lunghi o più brevi. Perché è importante Fornisce il contesto per le scadenze di pagamento ed è essenziale per analizzare il comportamento di pagamento, il DSO e l’efficacia dei programmi di sconto per pagamento anticipato. Dove reperirlo Queste informazioni sono probabilmente memorizzate in un campo picklist o di testo sull’oggetto Invoice o sull’oggetto Account associato in Salesforce. Esempi 30 giorni netti60 giorni netti2% entro 10 giorni, netto 30Pagamento alla ricezione
	Ultimo aggiornamento dei dati LastDataUpdate	Timestamp dell’ultimo aggiornamento dei dati dal sistema di origine.
Descrizione Questo Attributo indica quando i dati utilizzati per l’analisi di process mining sono stati estratti per l’ultima volta da Salesforce Sales Cloud. È un campo di metadati applicato all’intero dataset durante ogni aggiornamento. Questo timestamp è fondamentale per consentire agli utenti di comprendere il livello di aggiornamento dell’analisi. Aiuta a verificare se i Dashboard e i KPI visualizzati sono aggiornati, un aspetto essenziale per prendere decisioni aziendali tempestive e informate sulla base degli insight di processo. Perché è importante Informa gli utenti sull’aggiornamento dei dati, garantendo che le decisioni si basino su una visione attuale e pertinente del processo. Dove reperirlo Questo valore viene generato e applicato al dataset dallo strumento ETL o dalla pipeline dati durante ogni esecuzione. Esempi 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	Valuta della fattura InvoiceCurrency	Il codice della valuta utilizzata per l'importo della fattura, ad esempio USD o EUR.
Descrizione Questo attributo indica la valuta nella quale è denominata la fattura. È particolarmente importante per le organizzazioni che operano in più Paesi. Questo campo fornisce il contesto necessario per qualsiasi analisi finanziaria, consentendo di aggregare correttamente i valori monetari e di confrontare le metriche di processo tra diverse aree valutarie. È un filtro indispensabile per l'analisi dei KPI finanziari, poiché evita di combinare valute differenti. Perché è importante Fornisce il contesto necessario per tutti i valori monetari, garantendo analisi e report finanziari accurati, soprattutto nelle organizzazioni multinazionali. Dove reperirlo Si tratta generalmente del campo standard `CurrencyIsoCode`, disponibile nelle istanze Salesforce con la gestione multivaluta attivata. Esempi USDEURGBPJPY

Obbligatorio Consigliato Facoltativo

Attività di Order to Cash - Fatturazione ed emissione delle fatture

Queste sono le fasi e le tappe fondamentali del processo da acquisire nell’Event Log per una corretta individuazione del processo e una valutazione delle prestazioni.

5 Consigliato 8 Facoltativo

	Attività	Descrizione
	Fattura approvata	Un utente autorizzato ha esaminato e approvato la fattura, confermandone l’accuratezza e la disponibilità per l’invio al cliente. Questo evento viene generalmente acquisito quando lo stato della fattura viene modificato in 'Approved'.
Perché è importante Si tratta di una milestone fondamentale che condiziona il resto del processo di fatturazione. I ritardi in questa fase creano colli di bottiglia significativi, incidendo sul DSO e sulla durata complessiva del ciclo, misurata dal Dashboard 'Invoice Approval Cycle Time'. Dove reperirlo Dedotto dalla modifica di un campo di stato dell’oggetto Invoice in 'Approved'. Se vengono utilizzati Salesforce Approval Processes, l’evento può essere acquisito esplicitamente dalla cronologia dell’oggetto ProcessInstance. Acquisizione Modifica del campo di stato della fattura in 'Approved' o completamento di un passaggio formale del processo di approvazione. Tipo di evento inferred
	Fattura chiusa	Il ciclo di vita della fattura è completo, poiché il pagamento e la riconciliazione sono stati completati. Questa è l’attività finale di una fattura elaborata correttamente e viene generalmente registrata tramite un aggiornamento dello stato.
Perché è importante Questa attività costituisce il principale punto finale del processo, consentendo di calcolare con precisione la durata del ciclo end-to-end. Fornisce una definizione chiara del completamento ai fini dell’analisi del processo. Dove reperirlo Dedotto dal timestamp in cui il campo di stato dell’oggetto Invoice viene aggiornato a 'Closed', 'Paid in Full' o a uno stato finale analogo. Acquisizione Modifica del campo di stato della fattura a un valore finale 'Closed'. Tipo di evento inferred
	Fattura generata	Questa attività indica la creazione di un nuovo record di fattura all’interno di Salesforce. Rappresenta l’avvio ufficiale del processo di fatturazione per una specifica transazione e viene generalmente attivata dopo l’evasione di un ordine o il raggiungimento di una milestone contrattuale. L’evento viene acquisito dal timestamp di creazione del record della fattura.
Perché è importante Questo è il principale evento di avvio del processo di fatturazione. Analizzare il tempo che intercorre da questo momento al pagamento aiuta a misurare la durata complessiva del ciclo Order-to-Cash e a identificare i ritardi iniziali nell’inserimento dei dati. Dove reperirlo Questo evento viene acquisito dalla data di creazione, ossia dal campo CreatedDate, dell’oggetto personalizzato Invoice o di un oggetto analogo che rappresenta la fattura in Salesforce. Acquisizione Timestamp di creazione del record dell’oggetto fattura. Tipo di evento explicit
	Fattura inviata al cliente	La fattura approvata è stata ufficialmente consegnata al cliente tramite e-mail, posta o portale. L’evento viene spesso acquisito quando il campo 'Sent Date' viene valorizzato o quando lo stato passa a 'Sent'.
Perché è importante Questo evento segna l’inizio del periodo di incasso e costituisce il punto di partenza per il calcolo dei Days Sales Outstanding (DSO). È una milestone fondamentale per monitorare le comunicazioni con il cliente e le tempistiche di pagamento. Dove reperirlo Dedotto dalla valorizzazione del campo 'Sent Date' sull’oggetto Invoice o da un aggiornamento dello stato a 'Sent'. Potrebbe inoltre trattarsi di un evento esplicito registrato nella Activity History, se l’invio è avvenuto tramite uno strumento e-mail integrato. Acquisizione Timestamp di valorizzazione del campo 'Sent_Date__c'. Tipo di evento inferred
	Pagamento del cliente ricevuto	Il cliente ha effettuato un pagamento relativo alla fattura e i fondi sono stati ricevuti. L’evento viene generalmente registrato creando un record 'Payment' correlato e collegandolo alla fattura.
Perché è importante Questa è la milestone più importante della fase di incasso. Rappresenta il punto finale per il calcolo del DSO e indica l’avvenuta ricezione dei ricavi. Dove reperirlo Acquisito dalla data di creazione di un record dell’oggetto personalizzato 'Payment', correlato all’oggetto Invoice. Può inoltre essere dedotto dalla modifica dello stato della fattura in 'Paid'. Acquisizione Creazione di un record Payment correlato. Tipo di evento explicit
	Fattura corretta	Rappresenta una correzione o un aggiornamento manuale della fattura dopo che è stata rifiutata o è stato rilevato un errore. Spesso viene dedotto quando lo stato della fattura torna a uno stato precedente, ad esempio da 'Rejected' a 'Draft'.
Perché è importante Identificare i cicli di correzione è fondamentale per misurare il KPI 'Invoice Rework Rate'. Un numero elevato di correzioni indica problemi nel processo iniziale di generazione delle fatture, che causano ritardi. Dove reperirlo Dedotto dal monitoraggio della cronologia dei campi, rilevando una modifica dello stato da un valore di fase avanzata, ad esempio 'Rejected' o 'Approved', a un valore di fase precedente, ad esempio 'Draft' o 'In Progress'. Acquisizione Lo stato della fattura torna indietro nel flusso di processo. Tipo di evento inferred
	Fattura inviata per l’approvazione	La fattura è stata finalizzata e inviata per una revisione interna prima di essere trasmessa al cliente. Questa attività viene generalmente acquisita tramite una modifica del campo di stato del record della fattura, ad esempio da 'Draft' a 'Pending Approval'.
Perché è importante Il monitoraggio di questa attività aiuta a isolare il tempo trascorso nella coda di approvazione. È un passaggio fondamentale per calcolare il KPI 'Average Invoice Approval Time'. Dove reperirlo Dedotto dal monitoraggio della cronologia dei campi dell’oggetto Invoice, quando un campo di stato viene aggiornato a un valore come 'Submitted for Approval' o 'In Review'. Acquisizione Modifica del campo di stato della fattura a 'Pending Approval'. Tipo di evento inferred
	Fattura rifiutata	L’approvatore ha rifiutato la fattura, generalmente a causa di errori o discrepanze, rendendo necessarie la correzione e un nuovo invio. L’evento viene acquisito tramite la modifica dello stato del record della fattura in 'Rejected'.
Perché è importante Questa attività segnala una rilavorazione e un’inefficienza del processo. Analizzare la frequenza dei rifiuti aiuta a individuare le fonti più comuni di errore e supporta l’analisi delle cause alla radice per il Dashboard 'Billing Process Rework & Errors'. Dove reperirlo Dedotto dalla modifica di un campo di stato dell’oggetto Invoice in 'Rejected'. Questi dati possono essere presenti anche nei commenti della cronologia di un processo formale di approvazione. Acquisizione Modifica del campo di stato della fattura in 'Rejected'. Tipo di evento inferred
	Fattura stornata per inesigibilità	È stata presa la decisione di annullare il debito e la fattura viene chiusa senza il pagamento completo. Rappresenta un esito alternativo e negativo del processo di fatturazione.
Perché è importante Il monitoraggio degli storni per inesigibilità aiuta a quantificare la perdita di ricavi e a individuare i clienti o le situazioni che generano crediti inesigibili. Si tratta di un percorso eccezionale fondamentale da monitorare per valutare la solidità finanziaria. Dove reperirlo Dedotto dal timestamp in cui il campo di stato dell’oggetto Invoice viene aggiornato a 'Written Off' o 'Canceled - Bad Debt'. Acquisizione Modifica del campo di stato della fattura in 'Written Off'. Tipo di evento inferred
	Incasso applicato e riconciliato	Il pagamento ricevuto è stato completamente abbinato e applicato alla specifica fattura nel sistema, chiudendo il credito. L’evento viene acquisito tramite una modifica finale dello stato del record del pagamento o della fattura.
Perché è importante Questo evento segna l’ultimo passaggio del ciclo di conversione della liquidità. Il Dashboard 'Payment Reconciliation Performance' utilizza questa attività per misurare l’efficienza del team finanziario nell’applicazione degli incassi. Dove reperirlo Dedotto dalla modifica dello stato dell’Invoice o di un oggetto Payment correlato a uno stato finale come 'Reconciled' o 'Applied'. Acquisizione Modifica dello stato della fattura o del pagamento in 'Reconciled'. Tipo di evento inferred
	Pagamento registrato nel libro mastro	Il pagamento ricevuto è stato registrato formalmente nel sistema contabile o nel libro mastro dell’azienda. L’evento può essere acquisito tramite un aggiornamento dello stato del pagamento o della fattura dopo l’esecuzione di un’integrazione.
Perché è importante Questa attività distingue la ricezione del pagamento dalla riconciliazione finanziaria. Il tempo che intercorre tra la ricezione e la registrazione può evidenziare ritardi nei processi contabili interni. Dove reperirlo Dedotto dalla modifica di un campo di stato dell’oggetto Payment o Invoice a un valore come 'Posted' o 'Exported to ERP', spesso aggiornato tramite un’integrazione API. Acquisizione Modifica dello stato del pagamento o della fattura in 'Posted'. Tipo di evento inferred
	Raggiunta la data di scadenza del pagamento	Si tratta di un evento calcolato che rappresenta il momento in cui il pagamento della fattura diventa esigibile secondo i relativi termini di pagamento. Non è un’azione dell’utente, ma viene derivato dai dati della fattura.
Perché è importante Questa attività fornisce un riferimento fondamentale per analizzare il comportamento di pagamento e misurare il KPI 'On-Time Payment Rate'. Aiuta a distinguere tra pagamenti puntuali e pagamenti in ritardo. Dove reperirlo Si tratta di un evento calcolato, derivato dal confronto tra il timestamp corrente e il campo 'Due Date' dell’oggetto Invoice. Non esiste come evento memorizzato in Salesforce. Acquisizione Calcolato confrontando la data corrente con il campo Due Date della fattura. Tipo di evento calculated
	Sollecito di pagamento inviato	È stata inviata al cliente una comunicazione per ricordargli un pagamento imminente o scaduto. Spesso viene registrata come uno specifico record Activity, Task o Email, collegato alla fattura.
Perché è importante Il monitoraggio dei solleciti aiuta a valutare l’efficacia delle strategie di incasso. È essenziale per il Dashboard 'Payment Reminder Effectiveness' e per il KPI 'Payment Reminder Trigger Rate'. Dove reperirlo Acquisito dalla creazione di un record Activity, Task o Email, correlato all’oggetto Invoice, il cui oggetto o tipo indica che si tratta di un sollecito di pagamento. Acquisizione Creazione di un record Task o Email correlato, con un tipo o oggetto specifico. Tipo di evento explicit

Consigliato Facoltativo

Guide all'estrazione

Come ottenere i Suoi dati da Salesforce Sales Cloud

Passaggi

Verifichi i prerequisiti: si assicuri di disporre delle autorizzazioni necessarie in Salesforce, tra cui "Run Reports", "Create and Customize Reports" e "Export Reports". Verifichi che Field History Tracking sia abilitato per i campi di stato principali degli oggetti Invoice e Payment. A tale scopo, vada a Setup > Object Manager, individui l’oggetto pertinente, acceda a Fields & Relationships e faccia clic su "Set History Tracking".
Definisca la strategia dei report: questo processo richiede la creazione di più report, poiché le attività provengono da record o eventi diversi, ad esempio la creazione di una fattura, le modifiche di stato e i pagamenti correlati. Creerà un report separato per ogni origine distinta e combinerà poi i risultati esternamente.
Crei il report per la creazione dei record: inizi dagli eventi più semplici. Crei un report per "Invoice Generated" e "Customer Payment Received". Acceda alla scheda Reports e faccia clic su "New Report". Scelga un tipo di report che includa l’oggetto Invoice, ad esempio "Invoices", oppure l’oggetto Payment. Aggiunga le colonne corrispondenti agli attributi dell’Event Log. Per l’attività "Invoice Generated", il CreatedDate del record della fattura sarà il valore di EventTime.
Crei il report della cronologia dei campi: per acquisire modifiche di stato come "Invoice Submitted for Approval", "Invoice Approved", "Invoice Rejected" e "Invoice Corrected", crei un report basato sul tipo di report "Invoice History". Questo tipo di report speciale espone le modifiche registrate da Field History Tracking. Applichi a questo report un filtro per le modifiche al campo Stato.
Crei il report per gli eventi basati sulle date: per eventi come "Invoice Sent to Customer" o "Payment Due Date Reached", crei un report sull’oggetto Invoice. Utilizzi direttamente i campi data, come Sent_Date__c o Payment_Due_Date__c, come valore di EventTime. Deve filtrare i record in cui queste date non sono nulle.
Crei il report per le attività correlate: per eventi come "Payment Reminder Issued", Le occorre un report che colleghi Activities, ovvero Task o Event, alle fatture. Utilizzi un tipo di report come "Activities with Invoices" oppure ne crei uno personalizzato. Applichi un filtro alle attività con un oggetto o un tipo specifico che indichi un promemoria.
Aggiunga le colonne standard a tutti i report: in ogni report creato, si assicuri di aggiungere le colonne che possono essere associate alla struttura richiesta dell’Event Log: InvoiceNumber, un campo per EventTime, come CreatedDate o la data della modifica del campo, UserResponsible, come LastModifiedById, e gli altri attributi consigliati.
Esporti i report in CSV: esegua ogni report singolarmente. Nella schermata dei risultati del report, utilizzi il menu a discesa per selezionare "Export" e scelga il formato "Details Only" con estensione .csv. Ripeta l’operazione per tutti i report creati.
Combini e trasformi i dati: apra i file CSV esportati in un programma per fogli di calcolo oppure utilizzi uno strumento di preparazione dei dati. Per ogni file, aggiunga una nuova colonna denominata ActivityName e la compili con l’attività specifica rappresentata, ad esempio "Invoice Generated" per tutte le righe del primo report. Associ le colonne di origine, come Invoice: Created Date, alle intestazioni standard dell’Event Log, come EventTime.
Crei l’Event Log finale: consolidi in un unico file principale tutti i dati trasformati provenienti dai singoli file CSV. Si assicuri che le intestazioni delle colonne siano esattamente InvoiceNumber, ActivityName, EventTime, UserResponsible e così via. Questo file unificato costituisce l’Event Log finale.
Applichi la formattazione finale: salvi il file consolidato in formato CSV con codifica UTF-8. Il file è ora pronto per essere caricato in ProcessMind.

Configurazione

Tipi di report: probabilmente dovrà utilizzare più tipi di report personalizzati per unire oggetti principali come Account con oggetti subordinati e di livello successivo come Invoice, Payment e Activity. Li crei in Setup > Report Types.
Field History Tracking: è fondamentale. Per l’oggetto Invoice, abiliti il monitoraggio della cronologia per qualsiasi campo Stato. Senza questa configurazione, non potrà acquisire attività relative a modifiche di stato come "Approved" o "Rejected". La cronologia non viene registrata retroattivamente.
Filtri dei dati: applichi sempre un filtro per data ai report, così da mantenere gestibile il volume dei dati. È buona prassi filtrare la data di creazione dell’oggetto principale sugli ultimi 3-6 mesi, ad esempio Invoice: Created Date uguale a LAST 180 DAYS.
Data Export Service: in alternativa all’esecuzione di singoli report, può utilizzare il servizio nativo Data Export Service, disponibile in Setup > Data Export. Questo servizio esporta tutti i dati dell’organizzazione con cadenza settimanale o mensile. Offre un backup completo, ma richiede una notevole elaborazione successiva per filtrare, unire e trasformare i dati in un Event Log.
Autorizzazioni dell’utente: l’utente che esegue l’estrazione deve disporre dell’accesso in lettura a tutti gli oggetti pertinenti, ad esempio Account, Order, Invoice__c, Payment__c e Activity, nonché ai relativi campi, oltre alle autorizzazioni per creare ed esportare i report.

a Query di esempio config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

Passaggi

Prerequisiti e configurazione: si assicuri di avere Python 3.6 o una versione successiva installata sul sistema. Installi le librerie necessarie eseguendo nel terminale il comando: pip install simple-salesforce pandas. Le serviranno inoltre il nome utente Salesforce, la password e il security token. Per ottenere il security token, acceda a Salesforce, apra le impostazioni personali e individui l'opzione 'Reset My Security Token'.
Attivazione di Field History Tracking: acceda alla Sua organizzazione Salesforce con un account amministratore. Acceda a Setup, quindi a Object Manager. Individui l'oggetto Invoice principale, ad esempio Invoice__c, e apra 'Fields & Relationships'. Selezioni 'Set History Tracking'. Attivi il monitoraggio per il campo che rappresenta lo stato della fattura, ad esempio Status__c. Ripeta la procedura per l'oggetto Payment, ad esempio Payment__c, e per il relativo campo di stato.
Download e configurazione dello script: salvi lo script Python fornito in un file denominato extract_invoices.py. Apra il file in un editor di testo e aggiorni i valori segnaposto nella sezione 'Salesforce Credentials and Settings'. Deve specificare SF_USERNAME, SF_PASSWORD, SF_SECURITY_TOKEN e SF_INSTANCE_URL. Modifichi START_DATE e END_DATE per definire il periodo di estrazione.
Personalizzazione dei nomi di oggetti e campi: esamini con attenzione le query SOQL contenute nello script. Lo script utilizza nomi segnaposto come Invoice__c, Payment__c, Status__c, Total_Amount__c e così via. Deve sostituire questi segnaposto con i nomi API effettivi degli oggetti e dei campi utilizzati nella Sua istanza Salesforce per la fatturazione e l'emissione delle fatture.
Esecuzione dello script di estrazione: apra un terminale o un prompt dei comandi, raggiunga la directory in cui ha salvato lo script ed esegua il comando: python extract_invoices.py. Lo script si collegherà all'API Salesforce, eseguirà le query ed elaborerà i dati.
Monitoraggio dell'avanzamento dello script: lo script visualizzerà nella console messaggi di stato mentre recupera ed elabora i dati per ogni tipo di attività. A seconda del volume dei dati e dei limiti API, l'operazione potrebbe richiedere del tempo. Verifichi la presenza di eventuali messaggi di errore che potrebbero indicare credenziali o nomi API non corretti.
Verifica del file di output: al completamento dello script verrà generato un file denominato salesforce_billing_event_log.csv nella stessa directory. Apra il file con un foglio di calcolo per esaminarne il contenuto e verificare che contenga i dati attesi.
Preparazione al caricamento: il file CSV generato presenta le colonne richieste InvoiceNumber, ActivityName ed EventTime, oltre agli altri attributi consigliati. Il file è pronto per essere caricato direttamente nello strumento di Process Mining senza ulteriori formattazioni.

Configurazione

Credenziali Salesforce: deve fornire il nome utente Salesforce, la password e il security token. Il security token è necessario per l'accesso API dall'esterno degli intervalli IP considerati attendibili dall'organizzazione.
URL dell'istanza Salesforce: specifichi il dominio della Sua istanza Salesforce, ad esempio your_instance.my.salesforce.com. Se utilizza una sandbox, l'URL sarà diverso, ad esempio test.salesforce.com.
Filtri dell'intervallo di date: lo script include le variabili START_DATE e END_DATE. È consigliabile iniziare con un intervallo più breve, ad esempio 3-6 mesi, per gestire il volume dei dati e rimanere entro i limiti API. Queste date filtrano la query iniziale in base alle date di creazione delle fatture.
Nomi API di oggetti e campi: lo script utilizza nomi API segnaposto per oggetti e campi, ad esempio Invoice__c e Status__c. Deve sostituirli con i nomi API esatti del Suo modello dati Salesforce. Può trovarli in Salesforce Setup, nella sezione Object Manager.
Prerequisiti per il monitoraggio: l'accuratezza dell'Event Log, soprattutto per le modifiche di stato, dipende interamente dall'attivazione di Field History Tracking per i campi pertinenti prima che si verifichino le transazioni. Se il monitoraggio non era attivo, le modifiche storiche non verranno acquisite.
Limiti delle chiamate API: Salesforce applica limiti al numero di chiamate API effettuabili nell'arco di 24 ore. Per dataset molto grandi, valuti l'esecuzione dell'estrazione in batch con intervalli di date più brevi oppure la pianificazione nelle ore non di punta, così da evitare il superamento dei limiti.

a Query di esempio python

import pandas as pd
from simple_salesforce import Salesforce
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Salesforce Credentials and Settings ---
class=class="hl-string">"hl-comment"># IMPORTANT: Replace all placeholder values with your actual Salesforce information.
SF_USERNAME = class="hl-string">'[your_salesforce_username]'
SF_PASSWORD = class="hl-string">'[your_salesforce_password]'
SF_SECURITY_TOKEN = class="hl-string">'[your_salesforce_security_token]' class=class="hl-string">"hl-comment"># Append this to your password if required
SF_INSTANCE_URL = class="hl-string">'https://[your_instance].my.salesforce.com' class=class="hl-string">"hl-comment"># e.g., na1.salesforce.com

class=class="hl-string">"hl-comment"># --- Extraction Period ---
START_DATE = class="hl-string">'2023-01-01T00:00:00Z'
END_DATE = class="hl-string">'2023-12-31T23:59:59Z'

class=class="hl-string">"hl-comment"># --- Object and Field API Name Placeholders ---
class=class="hl-string">"hl-comment"># Replace these with the actual API names from your Salesforce org.
INVOICE_OBJECT = class="hl-string">'Invoice__c'
INVOICE_NUMBER_FIELD = class="hl-string">'Name'
INVOICE_STATUS_FIELD = class="hl-string">'Status__c'
INVOICE_TOTAL_AMOUNT_FIELD = class="hl-string">'Total_Amount__c'
INVOICE_DUE_DATE_FIELD = class="hl-string">'Due_Date__c'

PAYMENT_OBJECT = class="hl-string">'Payment__c'
PAYMENT_INVOICE_LOOKUP_FIELD = class="hl-string">'Invoice__c' class=class="hl-string">"hl-comment"># Lookup field from Payment to Invoice
PAYMENT_STATUS_FIELD = class="hl-string">'Status__c'

class=class="hl-string">"hl-comment"># --- Main Script ---
def main():
    print(class="hl-string">"Connecting to Salesforce...")
    sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
    print(class="hl-string">"Connection successful.")

    all_events = []

    class=class="hl-string">"hl-comment"># 1. Get base Invoice data
    print(class="hl-string">"Fetching base invoice data...")
    soql_invoices = fclass="hl-string">"""
        SELECT Id, {INVOICE_NUMBER_FIELD}, CreatedDate, CreatedById, LastModifiedById, 
               {INVOICE_STATUS_FIELD}, {INVOICE_TOTAL_AMOUNT_FIELD}, {INVOICE_DUE_DATE_FIELD}
        FROM {INVOICE_OBJECT}
        WHERE CreatedDate >= {START_DATE} AND CreatedDate <= {END_DATE}
    """
    invoices_data = sf.query_all(soql_invoices)[class="hl-string">'records']
    df_invoices = pd.DataFrame(invoices_data).drop(columns=[class="hl-string">'attributes'])
    invoice_ids = class="hl-string">"','".join(df_invoices[class="hl-string">'Id'].tolist())

    class=class="hl-string">"hl-comment"># Activity: Invoice Generated & Payment Due Date Reached
    print(class="hl-string">"Processing 'Invoice Generated' and 'Payment Due Date Reached' events...")
    generated_events = df_invoices.copy()
    generated_events[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
    generated_events[class="hl-string">'EventTime'] = pd.to_datetime(generated_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
    generated_events[class="hl-string">'UserResponsible'] = generated_events[class="hl-string">'CreatedById']
    all_events.append(generated_events)

    due_date_events = df_invoices[df_invoices[INVOICE_DUE_DATE_FIELD].notna()].copy()
    due_date_events[class="hl-string">'ActivityName'] = class="hl-string">'Payment Due Date Reached'
    due_date_events[class="hl-string">'EventTime'] = pd.to_datetime(due_date_events[INVOICE_DUE_DATE_FIELD]).dt.tz_localize(None)
    due_date_events[class="hl-string">'UserResponsible'] = None class=class="hl-string">"hl-comment"># System-generated event
    all_events.append(due_date_events)

    class=class="hl-string">"hl-comment"># 2. Get Invoice Status Changes from Field History
    print(class="hl-string">"Fetching invoice status changes...")
    soql_invoice_history = fclass="hl-string">"""
        SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
        FROM {INVOICE_OBJECT}History
        WHERE ParentId IN ('{invoice_ids}') AND Field = '{INVOICE_STATUS_FIELD}'
    """
    invoice_history_data = sf.query_all(soql_invoice_history)[class="hl-string">'records']
    if invoice_history_data:
        df_invoice_history = pd.DataFrame(invoice_history_data).drop(columns=[class="hl-string">'attributes'])
        df_invoice_history = df_invoice_history.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id')
        df_invoice_history[class="hl-string">'EventTime'] = pd.to_datetime(df_invoice_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_invoice_history[class="hl-string">'UserResponsible'] = df_invoice_history[class="hl-string">'CreatedById']

        class=class="hl-string">"hl-comment"># Map status changes to Activity Names
        status_map = {
            (class="hl-string">'Draft', class="hl-string">'Pending Approval'): class="hl-string">'Invoice Submitted for Approval',
            (class="hl-string">'Pending Approval', class="hl-string">'Approved'): class="hl-string">'Invoice Approved',
            (class="hl-string">'Pending Approval', class="hl-string">'Rejected'): class="hl-string">'Invoice Rejected',
            (class="hl-string">'Rejected', class="hl-string">'Draft'): class="hl-string">'Invoice Corrected',
            (class="hl-string">'Approved', class="hl-string">'Sent'): class="hl-string">'Invoice Sent to Customer',
            (class="hl-string">'Approved', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Sent', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Approved', class="hl-string">'Written Off'): class="hl-string">'Invoice Written Off'
        }
        df_invoice_history[class="hl-string">'ActivityName'] = df_invoice_history.apply(lambda row: status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
        df_invoice_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
        all_events.append(df_invoice_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># 3. Get Payment Reminders from Tasks
    print(class="hl-string">"Fetching payment reminder tasks...")
    soql_tasks = fclass="hl-string">"""
        SELECT WhatId, ActivityDate, CreatedById, CreatedDate
        FROM Task
        WHERE WhatId IN ('{invoice_ids}') AND Subject LIKE '%Payment Reminder%'
    """
    task_data = sf.query_all(soql_tasks)[class="hl-string">'records']
    if task_data:
        df_tasks = pd.DataFrame(task_data).drop(columns=[class="hl-string">'attributes'])
        df_tasks = df_tasks.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_STATUS_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'WhatId', right_on=class="hl-string">'Id')
        df_tasks[class="hl-string">'ActivityName'] = class="hl-string">'Payment Reminder Issued'
        df_tasks[class="hl-string">'EventTime'] = pd.to_datetime(df_tasks[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_tasks[class="hl-string">'UserResponsible'] = df_tasks[class="hl-string">'CreatedById']
        all_events.append(df_tasks)

    class=class="hl-string">"hl-comment"># 4. Get Payment Data
    print(class="hl-string">"Fetching payment data...")
    soql_payments = fclass="hl-string">"""
        SELECT Id, {PAYMENT_INVOICE_LOOKUP_FIELD}, CreatedDate, CreatedById, LastModifiedById, {PAYMENT_STATUS_FIELD}
        FROM {PAYMENT_OBJECT}
        WHERE {PAYMENT_INVOICE_LOOKUP_FIELD} IN ('{invoice_ids}')
    """
    payment_data = sf.query_all(soql_payments)[class="hl-string">'records']
    if payment_data:
        df_payments = pd.DataFrame(payment_data).drop(columns=[class="hl-string">'attributes'])
        df_payments = df_payments.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=PAYMENT_INVOICE_LOOKUP_FIELD, right_on=class="hl-string">'Id', suffixes=(class="hl-string">'_payment', class="hl-string">'_invoice'))
        payment_ids = class="hl-string">"','".join(df_payments[class="hl-string">'Id_payment'].tolist())
        
        class=class="hl-string">"hl-comment"># Activity: Customer Payment Received
        payment_received_events = df_payments.copy()
        payment_received_events[class="hl-string">'ActivityName'] = class="hl-string">'Customer Payment Received'
        payment_received_events[class="hl-string">'EventTime'] = pd.to_datetime(payment_received_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        payment_received_events[class="hl-string">'UserResponsible'] = payment_received_events[class="hl-string">'CreatedById']
        all_events.append(payment_received_events)
        
        class=class="hl-string">"hl-comment"># 5. Get Payment Status Changes
        print(class="hl-string">"Fetching payment status changes...")
        soql_payment_history = fclass="hl-string">"""
            SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
            FROM {PAYMENT_OBJECT}History
            WHERE ParentId IN ('{payment_ids}') AND Field = '{PAYMENT_STATUS_FIELD}'
        """
        payment_history_data = sf.query_all(soql_payment_history)[class="hl-string">'records']
        if payment_history_data:
            df_payment_history = pd.DataFrame(payment_history_data).drop(columns=[class="hl-string">'attributes'])
            df_payment_history = df_payment_history.merge(df_payments[[class="hl-string">'Id_payment', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id_payment')
            df_payment_history[class="hl-string">'EventTime'] = pd.to_datetime(df_payment_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df_payment_history[class="hl-string">'UserResponsible'] = df_payment_history[class="hl-string">'CreatedById']

            payment_status_map = {
                (class="hl-string">'Received', class="hl-string">'Posted'): class="hl-string">'Payment Posted to Ledger',
                (class="hl-string">'Posted', class="hl-string">'Reconciled'): class="hl-string">'Cash Applied/Reconciled'
            }
            df_payment_history[class="hl-string">'ActivityName'] = df_payment_history.apply(lambda row: payment_status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
            df_payment_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
            all_events.append(df_payment_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># --- Final Assembly ---
    print(class="hl-string">"Assembling final event log...")
    final_df = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Standardize column names
    final_df.rename(columns={
        INVOICE_NUMBER_FIELD: class="hl-string">'InvoiceNumber',
        INVOICE_STATUS_FIELD: class="hl-string">'InvoiceStatus',
        INVOICE_TOTAL_AMOUNT_FIELD: class="hl-string">'InvoiceTotalAmount',
        INVOICE_DUE_DATE_FIELD: class="hl-string">'PaymentDueDate'
    }, inplace=True)

    class=class="hl-string">"hl-comment"># Select and order columns for the final event log
    required_cols = {
        class="hl-string">'InvoiceNumber': None,
        class="hl-string">'ActivityName': None,
        class="hl-string">'EventTime': None,
        class="hl-string">'UserResponsible': None,
        class="hl-string">'InvoiceStatus': None,
        class="hl-string">'InvoiceTotalAmount': None,
        class="hl-string">'PaymentDueDate': None
    }
    for col in required_cols:
        if col not in final_df.columns:
            final_df[col] = required_cols[col]
    
    class=class="hl-string">"hl-comment"># We cannot extract Billing Department directly from this model, so we will add it as an empty column
    final_df[class="hl-string">'BillingDepartment'] = None

    final_df = final_df[list(required_cols.keys()) + [class="hl-string">'BillingDepartment']]

    class=class="hl-string">"hl-comment"># Sort by case and event time
    final_df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)

    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'salesforce_billing_event_log.csv'
    final_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Event log saved to {output_filename}")

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

Passaggi

Selezioni una piattaforma ETL o iPaaS con un connettore Salesforce Sales Cloud supportato e crei una connessione utilizzando il metodo di autenticazione Salesforce richiesto. Inserisca nella configurazione della piattaforma esclusivamente la stringa di connessione, le credenziali, l'identificativo dell'organizzazione o i valori specifici dell'ambiente.
Verifichi che l'organizzazione Salesforce connessa esponga l'oggetto invoice, la cronologia dello stato della fattura o la relativa fonte di audit, i record delle attività correlate, i record dei pagamenti e gli eventuali record di integrazione contabile necessari per il processo. Sostituisca ogni riferimento a oggetti o campi tra parentesi quadre nella query con i nomi corrispondenti configurati nel Suo ambiente Salesforce.
Configuri i parametri di estrazione incrementale per una data di inizio e una data di fine. Utilizzi, ove applicabile, la data di creazione della fattura, la data della modifica di stato, la data dell'attività, la data del pagamento, la data di registrazione contabile, la data di riconciliazione e la data di chiusura. Estragga un periodo di lookback sufficiente a includere i casi creati prima del periodo selezionato ma ancora attivi durante tale periodo.
Aggiunga la query completa riportata di seguito al componente di query Salesforce o di trasformazione dello strumento ETL. Se il connettore non supporta la sintassi mostrata, riproduca la stessa logica utilizzando componenti visuali per origine, filtro, join, campi calcolati e union. Non faccia affidamento su ProcessMind per dedurre gli eventi dalle modifiche di stato, poiché ogni attività deve essere emessa come riga esplicita dell'Event Log.
Configuri le mappature dell'origine per l'oggetto invoice, la cronologia dello stato della fattura o la fonte di audit, i record delle attività correlate, i record dei pagamenti, i record delle registrazioni contabili e i record di riconciliazione. Mappi il numero della fattura a InvoiceNumber, l'etichetta dell'attività a ActivityName e il timestamp pertinente a EventTime. Mantenga gli attributi consigliati ogni volta che i relativi valori di origine sono disponibili.
Applichi le regole di trasformazione. Converta tutti i timestamp in un unico fuso orario concordato, normalizzi i valori di stato, converta InvoiceTotalAmount in un tipo numerico, converta PaymentDueDate in un tipo data o timestamp e rimuova i record privi di InvoiceNumber o EventTime. Per Payment Due Date Reached, emetta una riga esplicita utilizzando PaymentDueDate come EventTime solo quando la data di scadenza rientra nella finestra di estrazione e il record della fattura è disponibile.
Elimini i duplicati utilizzando InvoiceNumber, ActivityName, EventTime e, ove disponibile, l'identificativo del record di origine. Mantenga le occorrenze separate quando l'origine contiene più invii, rifiuti, solleciti, correzioni, pagamenti, registrazioni contabili o eventi di riconciliazione legittimi.
Verifichi che l'output contenga tutti i 13 valori ActivityName richiesti, che ogni riga includa InvoiceNumber ed EventTime e che i timestamp degli eventi siano ordinati correttamente all'interno di ciascuna fattura, laddove i dati di origine consentano tale ordinamento.
Carichi il risultato trasformato in formato CSV, Parquet o in un altro formato di Event Log supportato da ProcessMind. Utilizzi InvoiceNumber come identificativo del caso, ActivityName come colonna dell'attività ed EventTime come colonna dell'orario dell'evento. Includa UserResponsible, BillingDepartment, InvoiceStatus, InvoiceTotalAmount e PaymentDueDate come attributi aggiuntivi.
Esporti l'Event Log finale e lo carichi in ProcessMind. Durante l'importazione, verifichi che ProcessMind legga le righe così come sono state fornite e non debba derivare attività mancanti.

Configurazione

Connettore: utilizzi il connettore Salesforce preconfigurato della piattaforma ETL o iPaaS e si autentichi con un utente di integrazione che disponga dell'accesso in lettura a tutte le origini configurate relative a fatture, cronologia degli stati, attività, pagamenti, registrazioni contabili e riconciliazioni.
Mappatura di oggetti e campi: sostituisca [Invoice object], [Invoice Number field], [Invoice Created Date field] e tutti gli altri riferimenti tra parentesi quadre con i nomi dell'organizzazione Salesforce di destinazione. Le configurazioni Salesforce utilizzano spesso oggetti e campi personalizzati, pertanto le mappature devono essere verificate e non date per scontate.
Intervallo di date: inizi con 3-6 mesi di dati. Estenda il periodo analizzato quando le fatture possono rimanere aperte tra diversi periodi di reporting e includa un margine temporale per gli aggiornamenti relativi a cambi di stato, pagamenti, solleciti ed eventi di riconciliazione.
Estrazione incrementale: utilizzi, quando disponibile, un watermark basato sul timestamp dell'ultima modifica dell'origine estratta correttamente. Conservi il watermark al di fuori dell'Event Log e rielabori una piccola finestra di sovrapposizione per evitare di perdere gli aggiornamenti ricevuti in ritardo.
Filtri: applichi i filtri relativi a società, unità aziendale, entità giuridica, valuta, tipo di fattura e ciclo di vita solo quando sono esplicitamente richiesti dall'analisi. Sostituisca [Company filter] e [Document type filter] con criteri specifici dell'organizzazione oppure li rimuova quando non sono applicabili.
Cronologia degli stati: preferisca un'origine che conservi ogni transizione di stato. Il solo campo relativo allo stato corrente della fattura non consente di ricostruire in modo affidabile gli eventi precedenti di approvazione, rifiuto, correzione, invio, chiusura o stralcio.
Evento calcolato di scadenza: Payment Due Date Reached viene generato da PaymentDueDate e non corrisponde a un'azione dell'utente Salesforce. Definisca se l'evento debba essere generato per tutte le fatture o solo per quelle rimaste aperte fino alla data di scadenza.
Record correlati: configuri le join utilizzando le chiavi di relazione effettive dell'organizzazione Salesforce. Non presuma che una fattura, un pagamento, un'attività, una registrazione contabile o un record di riconciliazione utilizzi lo stesso campo di relazione in tutte le implementazioni.
Prestazioni: filtri i record dell'origine per data prima delle join, selezioni solo i campi necessari, utilizzi la paginazione del connettore, abiliti l'estrazione incrementale e, quando supportato, suddivida gli intervalli di date più ampi. Eviti di estrarre ripetutamente l'intera cronologia.
Tipi di dati: normalizzi i timestamp in un unico fuso orario, conservi il timestamp originale dell'origine quando è richiesta la tracciabilità a fini di audit e utilizzi un tipo decimale per InvoiceTotalAmount.
Prerequisiti: la licenza ETL o iPaaS deve includere il connettore Salesforce, l'accesso API deve essere abilitato per l'utente di integrazione e l'utente deve disporre delle autorizzazioni a livello di oggetto, campo e record per ogni origine configurata.
Sicurezza: conservi le credenziali nel gestore dei segreti della piattaforma, limiti i dati estratti agli utenti autorizzati e rispetti i limiti Salesforce e aziendali relativi alle chiamate API e alla conservazione dei dati.

a Query di esempio config

SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Generated' AS ActivityName,
    CAST(i.[Invoice Created Date field] AS TIMESTAMP) AS EventTime,
    CAST(i.[Invoice Created By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
WHERE i.[Invoice Number field] IS NOT NULL
  AND i.[Invoice Created Date field] >= [Start date parameter]
  AND i.[Invoice Created Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Submitted for Approval' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Pending Approval'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Approved' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Approved'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Rejected' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Rejected'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Corrected' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[Previous Status field] = 'Rejected'
  AND h.[New Status field] = 'Draft'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Sent to Customer' AS ActivityName,
    CAST(COALESCE(i.[Sent Date field], h.[Status Change Date field]) AS TIMESTAMP) AS EventTime,
    CAST(COALESCE(i.[Sent By field], h.[Changed By field]) AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(COALESCE(h.[New Status field], i.[Invoice Status field]) AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
LEFT JOIN [Invoice status history object] h
  ON h.[Invoice relationship field] = i.[Invoice record identifier field]
 AND h.[New Status field] = 'Sent'
WHERE i.[Invoice Number field] IS NOT NULL
  AND (i.[Sent Date field] IS NOT NULL OR h.[Status Change Date field] IS NOT NULL)
  AND COALESCE(i.[Sent Date field], h.[Status Change Date field]) >= [Start date parameter]
  AND COALESCE(i.[Sent Date field], h.[Status Change Date field]) < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Payment Due Date Reached' AS ActivityName,
    CAST(i.[Payment Due Date field] AS TIMESTAMP) AS EventTime,
    CAST(NULL AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
WHERE i.[Invoice Number field] IS NOT NULL
  AND i.[Payment Due Date field] IS NOT NULL
  AND i.[Payment Due Date field] >= [Start date parameter]
  AND i.[Payment Due Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Payment Reminder Issued' AS ActivityName,
    CAST(a.[Activity Date field] AS TIMESTAMP) AS EventTime,
    CAST(a.[Assigned User field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Activity object] a ON a.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND a.[Activity Type field] IN ('Task', 'Email')
  AND a.[Reminder Indicator field] = TRUE
  AND a.[Activity Date field] >= [Start date parameter]
  AND a.[Activity Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Customer Payment Received' AS ActivityName,
    CAST(p.[Payment Received Date field] AS TIMESTAMP) AS EventTime,
    CAST(p.[Recorded By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Payment object] p ON p.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND p.[Payment Received Date field] IS NOT NULL
  AND p.[Payment Received Date field] >= [Start date parameter]
  AND p.[Payment Received Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Payment Posted to Ledger' AS ActivityName,
    CAST(p.[Ledger Posting Date field] AS TIMESTAMP) AS EventTime,
    CAST(p.[Posted By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Payment object] p ON p.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND p.[Ledger Posting Date field] IS NOT NULL
  AND p.[Ledger Posting Date field] >= [Start date parameter]
  AND p.[Ledger Posting Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Cash Applied/Reconciled' AS ActivityName,
    CAST(r.[Reconciliation Date field] AS TIMESTAMP) AS EventTime,
    CAST(r.[Reconciled By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Reconciliation object] r ON r.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND r.[Reconciliation Date field] IS NOT NULL
  AND r.[Reconciliation Date field] >= [Start date parameter]
  AND r.[Reconciliation Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Closed' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Closed'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Written Off' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Written Off'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]

È pronto per iniziare?

Utilizzi questo Template per avviare il percorso di analisi dei processi e individuare opportunità di miglioramento significativo. Inizi oggi stesso a ottimizzare il processo di fatturazione ed emissione delle fatture.

Torna alla guida al miglioramento Scarica il Template

Pagamenti più rapidi: ottimizzi subito la fatturazione e l'emissione delle fatture O2C

Riduca del 30% la durata del ciclo di fatturazione e migliori il flusso di cassa con semplicità.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito; configurazione semplice in pochi minuti

Il Suo Template dati per Order to Cash, fatturazione ed emissione delle fatture

Il Suo Template dati per Order to Cash, fatturazione ed emissione delle fatture

Attributi di Order to Cash - Fatturazione ed emissione delle fatture

Attività di Order to Cash - Fatturazione ed emissione delle fatture

Guide all'estrazione

Salesforce Report Builder e Data Export Service

Passaggi

Configurazione

a Query di esempio config

Script Python tramite Salesforce REST API

Passaggi

Configurazione

a Query di esempio python

Estrazione ETL tramite connettore Salesforce predefinito

Passaggi

Configurazione

a Query di esempio config

È pronto per iniziare?

Pagamenti più rapidi: ottimizzi subito la fatturazione e l'emissione delle fatture O2C

Il Suo Template dati per Order to Cash, fatturazione ed emissione delle fatture

Il Suo Template dati per Order to Cash, fatturazione ed emissione delle fatture

Attributi di Order to Cash - Fatturazione ed emissione delle fatture

Attività di Order to Cash - Fatturazione ed emissione delle fatture

Guide all'estrazione

Salesforce Report Builder e Data Export Service

Passaggi

Configurazione

a Query di esempio config

Script Python tramite Salesforce REST API

Passaggi

Configurazione

a Query di esempio python

Estrazione ETL tramite connettore Salesforce predefinito

Passaggi

Configurazione

a Query di esempio config

È pronto per iniziare?

Pagamenti più rapidi: ottimizzi subito la fatturazione e l'emissione delle fatture O2C

La Sua privacy è importante