> Miglioramento continuo dei processi > Lead to Cash > Salesforce Sales Cloud > Template dei dati

Il Suo template dei dati Lead to Cash

Salesforce Sales Cloud

Attributi Lead to Cash(18) Attività Lead to Cash(16) Guide all’estrazione(3)

Il Suo template dei dati Lead to Cash

Questo template offre una guida chiara alla raccolta dei dati essenziali per analizzare il processo Lead to Cash. Indica gli attributi principali da raccogliere e le attività da monitorare, oltre a fornire indicazioni pratiche su come estrarre queste informazioni dal sistema. Con questo template, può preparare i dati in modo efficiente e ottenere informazioni utili tramite il Process Mining.

Attributi consigliati da raccogliere
Attività principali da monitorare
Indicazioni per l’estrazione da Salesforce Sales Cloud

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

Scarica il template

Attributi Lead to Cash

Questi campi dati sono essenziali per creare un Event Log completo e analizzare nel dettaglio il processo Lead to Cash.

3 Obbligatorio 5 Consigliato 10 Facoltativo

	Nome	Descrizione
	Attività ActivityName	Nome dell’evento aziendale o dell’attività che si è verificata in un determinato momento del processo di vendita.
Descrizione Il nome dell’attività descrive una fase o una tappa specifica del percorso Lead to Cash, ad esempio 'Opportunità creata', 'Preventivo inviato' o 'Contratto firmato'. Queste attività si ricavano dalle modifiche ai campi chiave o dalla creazione di record correlati in Salesforce. Analizzare la sequenza delle attività consente di visualizzare il flusso del processo, individuare i percorsi più comuni e rilevare le deviazioni dal processo di vendita standard. È un passaggio fondamentale per creare mappe di processo e calcolare KPI come i tempi di ciclo tra le diverse fasi. Perché è importante Definisce le fasi della mappa di processo e consente di visualizzare e analizzare il percorso dalla generazione del lead all’incasso. Dove reperirli In genere, si ricava da una combinazione di fonti dati, tra cui l’oggetto Opportunity History (per le modifiche ai campi, come Stage), le date di creazione degli oggetti correlati (ad esempio Quote e Contract) e i record Task o Event specifici. Esempi Opportunità creataPreventivo presentato al clienteOpportunità conclusa con esito positivoFattura generata
	Opportunità di vendita SalesOpportunity	Identificativo univoco di ogni opportunità di vendita, utilizzato come identificativo principale del caso nel processo Lead to Cash.
Descrizione L’opportunità di vendita è l’oggetto centrale che consente di seguire una potenziale trattativa dalla qualificazione alla conclusione. Ogni opportunità ha un ID univoco che collega tutte le attività, le comunicazioni, i preventivi e i contratti correlati. Nel Process Mining, questo ID è essenziale per ricostruire l’intero percorso di ogni trattativa. Utilizzando l’opportunità di vendita come ID del caso, è possibile analizzare l’intero ciclo di vita, misurare i tempi tra le fasi, individuare le variazioni del processo e comprendere quali fattori portano a vincere o perdere una trattativa. Perché è importante È l’identificativo fondamentale che collega tutte le fasi del processo e consente un’analisi completa e accurata del ciclo di vendita di ogni trattativa. Dove reperirli È il campo standard 'Id' dell’oggetto Opportunity in Salesforce Sales Cloud (ad esempio, Opportunity.Id). Esempi 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	Ora di inizio EventTimestamp	Data e ora precise in cui si è verificata l’attività.
Descrizione Il timestamp dell’evento registra il momento esatto in cui si è verificata un’attività. È fondamentale per ordinare gli eventi cronologicamente e per tutte le analisi temporali del processo. Questo attributo è alla base del calcolo di tutte le metriche di prestazione, come i tempi di ciclo, le durate e i tempi di attesa. Ad esempio, la differenza tra i timestamp di 'Fattura generata' e 'Pagamento ricevuto' fornisce i dati per il KPI 'Giorni medi per il pagamento'. Timestamp accurati sono essenziali per individuare i colli di bottiglia e misurare l’efficienza del processo. Perché è importante Definisce l’ordine cronologico degli eventi ed è essenziale per calcolare durate e prestazioni. Dove reperirli Ricavato da diversi campi data di Salesforce, come 'CreatedDate' dell’oggetto Opportunity, 'LastModifiedDate' di Opportunity History o campi data specifici degli oggetti correlati, come Quote e Contract. Esempi 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	Fase di vendita StageName	Fase attuale dell’opportunità nella pipeline di vendita, ad esempio 'Qualification' o 'Negotiation'.
Descrizione La fase di vendita indica l’avanzamento dell’opportunità nel processo di vendita predefinito. Le modifiche a questo campo costituiscono eventi chiave del processo, come il raggiungimento della fase di proposta. Questo attributo è fondamentale per creare le Dashboard 'Individuazione dei colli di bottiglia nella pipeline di vendita' e 'Vista operativa giornaliera della pipeline di vendita'. Consente di analizzare quanto tempo le opportunità trascorrono in ogni fase, i tassi di conversione tra le fasi e lo stato complessivo della pipeline di vendita. Perché è importante Tiene traccia dell’avanzamento dell’opportunità nel processo di vendita e consente di analizzare i colli di bottiglia e gestire la pipeline. Dove reperirli È il campo standard 'StageName' dell’oggetto Opportunity. Esempi Ricerca di potenziali clientiQualificazioneAnalisi delle esigenzeProposal/Price QuoteNegoziazione/revisione
	Importo dell’opportunità Amount	Importo totale stimato della vendita relativa all’opportunità.
Descrizione Questo attributo indica il valore monetario di una potenziale trattativa. È una delle metriche più importanti per l’analisi finanziaria e delle prestazioni. L’importo dell’opportunità viene utilizzato in quasi tutte le viste finanziarie, ad esempio per calcolare il valore totale della pipeline e il valore medio delle trattative, nonché per correlare il valore ad altri fattori, come gli sconti o i tempi di ciclo. È un elemento chiave delle Dashboard 'Prestazioni dei rappresentanti commerciali' ed 'Efficacia degli sconti sulle opportunità'. Perché è importante Indica il valore finanziario di ogni trattativa, essenziale per i report sulla pipeline, le previsioni dei ricavi e l’analisi delle prestazioni. Dove reperirli È il campo standard 'Amount' dell’oggetto Opportunity. Esempi 50000125000.75250000
	Percentuale di sconto DiscountPercentage	La percentuale di sconto applicata all’opportunità.
Descrizione Questo attributo registra lo sconto offerto su una trattativa, di solito come percentuale del prezzo totale. È un fattore determinante per comprendere la redditività delle trattative e le dinamiche di vendita. Questa metrica è alla base della Dashboard 'Efficacia degli sconti sulle opportunità' e del KPI 'Sconto medio sulle trattative vinte'. Analizzando questo attributo, i responsabili delle vendite possono capire se gli sconti contribuiscono a concludere le trattative o riducono semplicemente i margini, oltre a confrontare le politiche di sconto tra aree geografiche e rappresentanti commerciali. Perché è importante È fondamentale per analizzare la redditività, valutare l’efficacia della strategia dei prezzi e individuare sconti eccessivi. Dove reperirli In genere è un campo personalizzato di tipo valuta o percentuale nell’oggetto Opportunity o Quote. Consultare la documentazione di Salesforce Sales Cloud o l’amministratore. Esempi 0.050.100.15
	Responsabile dell’opportunità OpportunityOwner	Rappresentante commerciale assegnato all’opportunità di vendita e responsabile della sua gestione.
Descrizione Il responsabile dell’opportunità è l’utente Salesforce incaricato principalmente di gestire la trattativa. È una dimensione fondamentale per l’analisi delle prestazioni. Analizzando i dati per responsabile dell’opportunità, le organizzazioni possono creare la Dashboard 'Prestazioni dei rappresentanti commerciali'. È così possibile confrontare i tempi di ciclo, i tassi di successo e il valore medio delle trattative tra i membri del team, individuando i migliori risultati e le esigenze di formazione. Perché è importante Questo attributo è essenziale per analizzare le prestazioni del team di vendita, confrontare i risultati individuali e individuare le esigenze di formazione. Dove reperirli È il campo 'OwnerId' dell’oggetto Opportunity, collegato all’oggetto User. Esempi John SmithMaria GarciaDavid Chen
	Vinta IsWon	Indicatore booleano che specifica se l’opportunità è stata vinta o persa.
Descrizione Questo attributo indica con un semplice valore true o false l’esito finale di un’opportunità di vendita. È impostato su true se la fase dell’opportunità è 'Closed Won' e su false se è 'Closed Lost'. 'Vinta' è alla base del calcolo del KPI 'Tasso di successo delle opportunità', una delle misure più importanti dell’efficacia delle vendite. Viene inoltre utilizzato per segmentare l’analisi, ad esempio confrontando i percorsi delle trattative vinte con quelli delle trattative perse o calcolando lo 'Sconto medio sulle trattative vinte'. Perché è importante Misura direttamente l’esito di un’opportunità di vendita e consente di analizzare le trattative vinte e perse e calcolare i tassi di successo. Dove reperirli È il campo standard 'IsWon' dell’oggetto Opportunity. È un campo formula basato su StageName. Esempi truefalse
	Area geografica Region	L’area geografica o il territorio di vendita associato all’opportunità.
Descrizione L’attributo dell’area geografica segmenta le opportunità in base alla posizione, ad esempio 'Nord America', 'EMEA' o 'APAC'. È un criterio comune per organizzare i team di vendita e la relativa reportistica. È la dimensione principale della Dashboard 'Confronto delle prestazioni di vendita per area geografica'. Consente ai responsabili di confrontare le prestazioni dei processi nelle diverse aree, individuando le pratiche efficaci nelle zone con i risultati migliori e gli aspetti da migliorare nelle altre. L’analisi può riguardare i tempi di ciclo, i tassi di successo e l’utilizzo degli sconti. Perché è importante Consente di confrontare i processi e i risultati di vendita nei diversi territori geografici, individuando punti di forza e criticità a livello regionale. Dove reperirli Spesso è un campo personalizzato nell’oggetto Opportunity o Account. Consultare la documentazione di Salesforce Sales Cloud o l’amministratore. Esempi Nord AmericaEMEAAPACAmerica Latina
	È una rilavorazione IsRework	Indicatore calcolato che segnala se un’attività rappresenta una rilavorazione o la ripetizione di un passaggio.
Descrizione È una rilavorazione è un indicatore booleano impostato su true quando il processo torna a una fase precedente. Ad esempio, se l’attività 'Preventivo modificato' si verifica dopo 'Preventivo presentato al cliente', viene considerata una rilavorazione. Questo attributo è fondamentale per quantificare le inefficienze del processo. Contribuisce direttamente al calcolo dei KPI 'Tasso di errori nell’elaborazione degli ordini' e 'Frequenza di rilavorazione dei preventivi'. Evidenziare le rilavorazioni aiuta a individuare requisiti poco chiari, problemi di comunicazione o criticità di qualità. Perché è importante Quantifica le inefficienze del processo individuando e segnalando le attività che fanno parte di cicli di rilavorazione, così da orientare gli interventi di miglioramento. Dove reperirli Questo indicatore viene calcolato dallo strumento di Process Mining, che analizza la sequenza delle attività e rileva i passaggi a ritroso nel flusso del processo. Esempi truefalse
	ID contratto ContractId	L’identificativo univoco del contratto associato all’opportunità.
Descrizione L’ID contratto collega l’opportunità a una registrazione formale del contratto in Salesforce. È un passaggio fondamentale nelle fasi finali della conclusione di una trattativa. Questo attributo consente di analizzare nel dettaglio la fase contrattuale e supporta le Dashboard 'Tempo di ciclo dal preventivo al contratto' e 'Conformità e rispetto dei contratti'. Permette di monitorare attività come 'Contratto inviato per la firma' e 'Contratto attivato', misurandone la durata e il rispetto degli SLA. Perché è importante Consente di monitorare con precisione il sottoprocesso di gestione dei contratti, inclusi i tempi di ciclo e la conformità. Dove reperirli Questo ID proviene dal campo 'Id' dell’oggetto Contract, in genere collegato all’oggetto Opportunity o Account. Esempi 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	ID ordine OrderId	L’identificativo univoco dell’ordine di vendita creato a partire da un’opportunità vinta.
Descrizione L’ID ordine collega un’opportunità di vendita al successivo processo di evasione dell’ordine. Segna il passaggio delle attività dal reparto vendite a quello operativo. Questo ID è essenziale per estendere l’analisi del processo oltre la fase 'Opportunità chiusa e vinta' fino alla gestione degli ordini. Consente di monitorare le attività 'Ordine creato' e 'Ordine evaso' ed è necessario per misurare il 'Tasso di errori nell’evasione degli ordini'. Perché è importante Collega la parte commerciale del processo alla fase di evasione dell’ordine, consentendo un’analisi completa del processo Lead to Cash. Dove reperirli Questo ID proviene dal campo 'Id' dell’oggetto Order, spesso collegato all’oggetto Opportunity. Esempi 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK
	ID preventivo QuoteId	L’identificativo univoco di un preventivo di vendita collegato all’opportunità.
Descrizione L’ID preventivo identifica una specifica offerta di prezzo presentata al cliente per un’opportunità. Nel corso del suo ciclo di vita, un’opportunità può avere più preventivi. Monitorare gli ID dei preventivi è essenziale per analizzare la fase di formulazione dell’offerta nel processo di vendita. Aiuta a misurare il 'Tempo di ciclo dal preventivo al contratto', a capire quante revisioni del preventivo ('Preventivo modificato') vengono effettuate e supporta il KPI 'Frequenza di rilavorazione dei preventivi', distinguendo le diverse versioni. Perché è importante Questo attributo consente di analizzare il ciclo del preventivo, compreso il numero di revisioni e il tempo che intercorre tra la presentazione del preventivo e l’accettazione. Dove reperirli Questo ID proviene dal campo 'Id' dell’oggetto Quote, collegato all’oggetto Opportunity. Esempi 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	Nome dell’account AccountName	Il nome dell’account cliente o dell’azienda associata all’opportunità.
Descrizione Il nome dell’account collega l’opportunità di vendita a un cliente specifico e consente di analizzare il processo di vendita dal punto di vista del cliente. L’analisi del processo per cliente permette alle organizzazioni di comprendere i cicli di vendita degli account strategici, individuare i clienti interessati da frequenti rilavorazioni o lunghe fasi di negoziazione e adattare le strategie di relazione. Offre inoltre una dimensione utile per filtrare e approfondire i dati del processo. Perché è importante Collega il processo di vendita a un cliente specifico, consentendo di analizzare i tempi del ciclo di vendita e le modalità di interazione a livello di cliente. Dove reperirli Deriva dal campo di ricerca 'AccountId' dell’oggetto Opportunity, che fa riferimento al campo 'Name' dell’oggetto Account. Esempi Global Tech Inc.Innovate Solutions LLCQuantum Industries
	Origine del lead LeadSource	La fonte da cui proviene il lead, ad esempio 'Web', 'Partner' o 'Fiera'.
Descrizione La fonte del lead indica il canale di marketing o l’attività commerciale che ha generato il lead iniziale. Questa informazione è fondamentale per valutare l’efficacia delle diverse strategie di acquisizione dei clienti. Questo attributo è la dimensione principale della Dashboard 'Analisi delle prestazioni di conversione dei lead'. Analizzando i tassi di conversione e il valore delle trattative per fonte del lead, le aziende possono ottimizzare gli investimenti di marketing e concentrarsi sui canali più redditizi. Perché è importante Consente di valutare l’efficacia dei canali di marketing collegando i lead alla loro origine e ai successivi tassi di successo. Dove reperirli È il campo standard 'LeadSource' dell’oggetto Lead, che in genere viene trasferito all’oggetto Opportunity al momento della conversione. Esempi WebRichiesta telefonicaSegnalazione di un partnerElenco acquistato
	Sistema di origine SourceSystem	Identifica il sistema di origine da cui sono stati estratti i dati.
Descrizione Questo attributo specifica il sistema di registrazione da cui provengono i dati dell’evento. Per il processo Lead to Cash, in genere si tratta di 'Salesforce Sales Cloud'. Negli ambienti con più sistemi integrati, questo campo è fondamentale per ricostruire la provenienza dei dati, risolvere i problemi e capire quale sistema fa fede per le diverse fasi del processo. Garantisce chiarezza e affidabilità alla base dati. Perché è importante Indica l’origine dei dati, un’informazione fondamentale per la governance e la convalida dei dati e per gli ambienti con più sistemi. Dove reperirli In genere, è un valore statico aggiunto durante l’estrazione e la trasformazione dei dati per indicare l’origine del set di dati. Esempi Salesforce Sales CloudSFSC
	Tipo di opportunità Type	Classifica l’opportunità, ad esempio come 'Nuova azienda' o 'Cliente esistente'.
Descrizione Il tipo di opportunità è un campo di classificazione standard utilizzato per segmentare le trattative. Aiuta a distinguere i processi e i cicli di vendita necessari per acquisire nuovi clienti da quelli rivolti alla vendita aggiuntiva ai clienti esistenti. Nel Process Mining, questo attributo consente di effettuare analisi comparative. Ad esempio, un’organizzazione può filtrare la mappa del processo per verificare se il ciclo di vendita per la 'Nuova azienda' è più lungo o prevede più passaggi rispetto ai rinnovi dei 'Clienti esistenti'. Queste informazioni orientano le decisioni strategiche e gli interventi di ottimizzazione dei processi. Perché è importante La segmentazione delle opportunità per tipo consente di confrontare processi di vendita, tempi di ciclo e tassi di successo per i nuovi clienti e per quelli esistenti. Dove reperirli È il campo standard 'Type' dell’oggetto Opportunity. Esempi Nuova aziendaCliente esistente - UpgradeCliente esistente - RinnovoVendita aggiuntiva
	Ultimo aggiornamento dei dati LastDataUpdate	Timestamp che indica quando i dati sono stati aggiornati l’ultima volta dal sistema di origine.
Descrizione Questo attributo indica la data e l’ora dell’estrazione più recente dei dati da Salesforce Sales Cloud e fornisce un riferimento sull’aggiornamento dei dati analizzati. Sapere quando i dati sono stati aggiornati l’ultima volta è essenziale per interpretare correttamente l’analisi, soprattutto nelle Dashboard operative, come 'Vista operativa giornaliera della pipeline di vendita'. In questo modo, le decisioni tengono conto dell’effettiva attualità dei dati. Perché è importante Indica quanto sono aggiornati i dati, così gli utenti possono valutare l’attualità dell’analisi del processo. Dove reperirli È un attributo di metadati generato dalla pipeline dei dati o dallo strumento ETL al momento dell’estrazione. Esempi 2023-10-27T02:00:00Z2023-10-28T02:00:00Z

Obbligatorio Consigliato Facoltativo

Attività Lead to Cash

Sono i passaggi e i traguardi principali del processo da monitorare, per individuare il processo e analizzarne accuratamente le prestazioni.

8 Consigliato 8 Facoltativo

	Attività	Descrizione
	Contratto attivato	Questa attività indica che il contratto è stato sottoscritto da tutte le parti ed è quindi legalmente attivo. In genere, viene registrata quando lo stato dell’oggetto Contract passa a 'Activated'.
Perché è importante È la conferma definitiva dell’accordo legale con il cliente e una tappa fondamentale per la rilevazione dei ricavi e la conformità. Eventuali ritardi possono incidere direttamente sulle previsioni finanziarie. Dove reperirli Ricavato dalla modifica del campo Status dell’oggetto Contract al valore 'Activated'. Il timestamp della modifica viene acquisito tramite la cronologia dei campi. Acquisizione Individuare il timestamp in cui il campo 'Status' dell’oggetto Contract viene impostato su 'Activated'. Tipo di evento inferred
	Lead convertito in opportunità	Questa attività segna il momento in cui un lead qualificato viene convertito in un’opportunità di vendita, con il relativo account e contatto. In genere, si tratta di un’azione esplicita eseguita da un rappresentante commerciale in Salesforce.
Perché è importante È il passaggio cruciale dal marketing o dallo sviluppo dei lead al team di vendita. Analizzare i tempi e i tassi di conversione a partire da questo momento aiuta a valutare la qualità dei lead e l’efficienza della fase iniziale del processo di vendita. Dove reperirli L’evento si individua verificando che il campo IsConverted dell’oggetto Lead sia true e che il campo ConvertedOpportunityId sia valorizzato. Il timestamp corrisponde a ConvertedDate. Acquisizione Registrato quando un utente converte un record Lead, valorizzando i campi ConvertedDate e ConvertedOpportunityId. Tipo di evento explicit
	Opportunità conclusa con esito negativo	Indica la conclusione senza successo di una trattativa, persa a favore di un concorrente o perché il cliente ha deciso di non acquistare. Si registra quando StageName dell’opportunità viene aggiornato al valore 'Closed Lost'.
Perché è importante È il principale esito negativo. Analizzare quando e perché si perdono le trattative è fondamentale per migliorare la strategia di vendita, la formazione e il posizionamento del prodotto. Dove reperirli Ricavato dalla modifica del campo StageName dell’oggetto Opportunity al valore 'Closed Lost'. La data è registrata nel campo CloseDate e il timestamp nella cronologia dei campi. Acquisizione Individuare in OpportunityFieldHistory il timestamp in cui 'StageName' dell’opportunità assume il valore 'Closed Lost'. Tipo di evento inferred
	Opportunità conclusa con esito positivo	Indica la conclusione positiva di una trattativa di vendita, con la vittoria dell’opportunità. Si registra quando il campo StageName dell’opportunità viene aggiornato manualmente o automaticamente al valore 'Closed Won'.
Perché è importante È uno dei principali risultati positivi del processo di vendita. Analizzare le tendenze e gli attributi delle trattative vinte è fondamentale per comprendere le prestazioni e la strategia di vendita. Dove reperirli Ricavato dalla modifica del campo StageName dell’oggetto Opportunity al valore 'Closed Won'. La data dell’evento è registrata nel campo CloseDate e il timestamp nella cronologia dei campi. Acquisizione Individuare in OpportunityFieldHistory il timestamp in cui 'StageName' dell’opportunità assume il valore 'Closed Won'. Tipo di evento inferred
	Opportunità creata	Indica la creazione in Salesforce di un nuovo record di opportunità di vendita, che rappresenta una potenziale operazione in grado di generare ricavi. L’evento viene registrato esplicitamente con il timestamp di creazione al primo salvataggio del record.
Perché è importante Questa attività segna l’inizio ufficiale del ciclo di vendita per una determinata opportunità. Costituisce il punto di partenza per misurare il tempo complessivo del ciclo di vendita e la velocità della pipeline. Dove reperirli Ricavato dal campo di sistema CreatedDate dell’oggetto Opportunity, che fornisce il timestamp preciso di creazione del record dell’opportunità. Acquisizione Utilizzare il campo CreatedDate dell’oggetto Opportunity. Tipo di evento explicit
	Pagamento ricevuto	Questa attività conferma che il pagamento del cliente è stato ricevuto e associato alla fattura. In genere, si ricava dalla modifica dello stato della fattura al valore 'Paid' o dalla creazione di un record Payment.
Perché è importante È l’attività finale del processo Lead to Cash e rappresenta l’incasso dei ricavi. Il tempo che intercorre tra la fatturazione e il pagamento è un KPI fondamentale per il flusso di cassa. Dove reperirli Ricavato dalla modifica dello stato dell’oggetto Invoice al valore 'Paid' oppure dalla creazione di un oggetto Payment collegato alla fattura. Spesso questi dati provengono da un sistema finanziario esterno. Acquisizione Individuare il momento in cui 'Status' di Invoice assume il valore 'Paid' oppure viene creato un record Payment associato. Tipo di evento inferred
	Preventivo accettato dal cliente	Questa attività segna l’accettazione da parte del cliente delle condizioni e dei prezzi del preventivo. In genere, viene registrata quando un utente aggiorna lo stato di Quote impostandolo su 'Accepted'.
Perché è importante È un segnale d’acquisto decisivo e una tappa fondamentale prima della preparazione del contratto. Il tempo che intercorre tra la presentazione e l’accettazione è un indicatore importante degli ostacoli nel ciclo di vendita. Dove reperirli Ricavato dalla modifica del campo Status dell’oggetto Quote al valore 'Accepted'. Il timestamp si ottiene dalla cronologia delle modifiche al campo. Acquisizione Individuare il timestamp in cui il campo 'Status' di Quote assume il valore 'Accepted'. Tipo di evento inferred
	Preventivo creato	Questa attività rappresenta la preparazione di un documento formale con il prezzo proposto al cliente. Viene registrata quando si crea un nuovo record Quote e lo si collega all’opportunità.
Perché è importante La creazione di un preventivo è un passaggio importante verso la conclusione di una trattativa. Analizzare il numero di preventivi e i tempi necessari per prepararli aiuta a valutare l’efficienza del team di vendita e l’avanzamento delle trattative. Dove reperirli Ricavato dal campo di sistema CreatedDate dell’oggetto Quote. L’oggetto Quote è collegato all’oggetto Opportunity tramite una relazione di ricerca. Acquisizione Utilizzare il campo CreatedDate dell’oggetto Quote associato all’opportunità. Tipo di evento explicit
	Contratto inviato per la firma	Indica che il contratto formale è stato preparato e inviato al cliente per la firma. Spesso si ricava da una modifica dello stato dell’oggetto Contract, ad esempio al valore 'Sent' o 'Out for Signature'.
Perché è importante Questa attività avvia la fase finale, legale e amministrativa, della conclusione della trattativa. Monitorarla aiuta a valutare l’efficienza della gestione dei contratti. Dove reperirli Ricavato da una modifica dello stato dell’oggetto Contract, collegato all’opportunità. È necessario registrare la cronologia del campo Status di Contract. Acquisizione Individuare il timestamp in cui il campo 'Status' di Contract assume un valore come 'Sent for Signature'. Tipo di evento inferred
	Fase dell’opportunità modificata	Questa attività registra ogni modifica della fase di vendita di un’opportunità, ad esempio il passaggio da 'Qualification' a 'Needs Analysis'. Le modifiche vengono registrate nella cronologia dei campi del sistema e consentono di ricostruire l’avanzamento dell’opportunità.
Perché è importante Monitorare i cambi di fase è essenziale per comprendere la velocità della pipeline di vendita, individuare i colli di bottiglia in cui le trattative si bloccano e analizzare la conformità del processo. Dove reperirli Ricavato dall’oggetto OpportunityFieldHistory, che registra le modifiche al campo StageName dell’oggetto Opportunity. Ogni voce include un timestamp e i valori precedente e nuovo. Acquisizione Estrarre gli eventi di modifica del campo 'StageName' dalla tabella OpportunityFieldHistory. Tipo di evento inferred
	Fattura generata	Indica la creazione di una fattura per addebitare al cliente i beni o i servizi consegnati. Può essere registrata con la creazione di un record Invoice, in Salesforce Billing o in un sistema esterno integrato.
Perché è importante Questa attività avvia la fase finanziaria del ciclo Lead to Cash. La rapidità e la precisione della fatturazione incidono direttamente sul flusso di cassa. Dove reperirli È necessario disporre di Salesforce Billing o di un pacchetto equivalente. L’evento si ricava dal campo CreatedDate dell’oggetto Invoice, collegato all’ordine o all’account. Acquisizione Se disponibile, utilizzare il campo CreatedDate dell’oggetto Invoice. Tipo di evento explicit
	Ordine creato	Questa attività segna la creazione di un ordine di vendita e avvia formalmente l’evasione dopo la conclusione positiva della trattativa. Viene registrata quando si crea un nuovo record Order associato all’opportunità o all’account.
Perché è importante È il passaggio ufficiale dal processo di vendita al team che si occupa dell’evasione degli ordini e delle attività operative. L’efficienza di questa fase è fondamentale per garantire consegne puntuali e la soddisfazione del cliente. Dove reperirli Ricavato dal campo di sistema CreatedDate dell’oggetto Order. In genere, l’ordine è collegato all’account e/o all’opportunità da cui ha avuto origine. Acquisizione Utilizzare il campo CreatedDate dell’oggetto Order associato all’account dell’opportunità. Tipo di evento explicit
	Ordine evaso	Indica che i prodotti o i servizi inclusi nell’ordine sono stati consegnati al cliente. In genere, si ricava dalla modifica dello stato dell’oggetto Order a uno stato finale come 'Fulfilled' o 'Completed'.
Perché è importante Questa tappa segna il completamento della consegna promessa al cliente. Il tempo che intercorre tra la creazione e l’evasione dell’ordine è un indicatore importante dell’efficienza operativa e della soddisfazione del cliente. Dove reperirli Ricavato dalla modifica del campo Status dell’oggetto Order a un valore che indica il completamento. Per acquisire il timestamp dell’evento è necessario registrare la cronologia dei campi. Acquisizione Individuare il timestamp in cui il campo 'Status' di Order assume il valore 'Fulfilled' o 'Completed'. Tipo di evento inferred
	Preventivo modificato	Indica un aggiornamento o una revisione di un preventivo esistente, spesso in seguito ai commenti del cliente o alla negoziazione. Si rileva monitorando le modifiche ai campi chiave del record Quote dopo la sua creazione.
Perché è importante Modifiche frequenti ai preventivi possono indicare inefficienze, lacune nella comunicazione o negoziazioni prolungate. Analizzare questo ciclo di rilavorazione è fondamentale per ridurre i tempi dalla preparazione del preventivo alla firma del contratto. Dove reperirli Ricavato dal campo LastModifiedDate dell’oggetto Quote oppure, con maggiore dettaglio, dalla cronologia di campi come TotalPrice o delle voci. Acquisizione Confrontare LastModifiedDate e CreatedDate dell’oggetto Quote oppure utilizzare la cronologia dei campi Quote. Tipo di evento inferred
	Preventivo presentato al cliente	Questo evento indica che il preventivo è stato inviato o presentato formalmente al cliente per la revisione. In genere, si ricava da una modifica dello stato del record Quote, ad esempio da 'Draft' a 'Presented' o 'In Review'.
Perché è importante Questa attività dà inizio alla fase di negoziazione e approvazione da parte del cliente. Monitorarla aiuta a misurare i tempi di risposta del cliente e a individuare ritardi nella fase di accettazione del preventivo. Dove reperirli Ricavato dalle modifiche al campo Status dell’oggetto Quote. Per ottenere il timestamp preciso della modifica, è necessario registrare la cronologia di questo campo. Acquisizione Individuare il timestamp in cui il campo 'Status' di Quote assume il valore 'Presented', 'Sent' o un valore equivalente. Tipo di evento inferred
	Raggiunta la fase di proposta	Segna il momento in cui un’opportunità passa alla fase 'Proposal/Price Quote'. L’evento si ricava dalla cronologia del campo 'StageName' dell’opportunità.
Perché è importante È una tappa importante: indica che è stata individuata una possibile soluzione, pronta per essere valutata economicamente e presentata. È un momento cruciale per analizzare i tempi necessari a definire la soluzione e preparare il preventivo. Dove reperirli Ricavato dall’oggetto OpportunityFieldHistory, individuando in particolare il timestamp in cui il campo 'StageName' viene aggiornato a 'Proposal/Price Quote' o a un valore personalizzato equivalente. Acquisizione Filtrare OpportunityFieldHistory per individuare i record in cui 'Field' è 'StageName' e 'NewValue' corrisponde alla fase di proposta. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i dati da Salesforce Sales Cloud

Passaggi

Verifica dei prerequisiti: Field History Tracking: prima di iniziare, verifichi con l’amministratore Salesforce che Field History Tracking sia attivo per i campi chiave dei seguenti oggetti: Opportunity (StageName, Importo), Preventivo (Status), Contract (Status) e Ordine (Status). Questo è fondamentale per acquisire correttamente le modifiche al processo.
Acceda ai report Salesforce: acceda alla Sua istanza Salesforce. Utilizzi App Launcher per trovare e aprire la scheda «Reports». Faccia clic su «New Report» per iniziare.
Crei il report sulla cronologia delle opportunità: questo report acquisisce la creazione delle opportunità, le modifiche alle fasi e gli eventi di chiusura. Selezioni il tipo di report «Opportunities with Field History». Aggiunga le seguenti colonne: ID opportunità, Nome opportunità, Data di creazione, Campo/Evento, Valore precedente, Nuovo valore, Data di modifica e Modificato da. Aggiunga anche gli attributi consigliati: Proprietario, Importo, Vinta e gli eventuali campi relativi agli sconti.
Crei il report sulla conversione dei lead: crei un secondo report utilizzando il tipo di report «Leads». Aggiunga le colonne: ID lead, Data di conversione, ID opportunità convertita e Proprietario del lead. Applichi un filtro per mostrare solo i lead per cui «Converted» è impostato su true.
Crei il report sugli eventi dei preventivi: crei un terzo report utilizzando un tipo di report «Quotes», preferibilmente uno che includa la cronologia, se disponibile (ad esempio, «Quotes with Field History»). Aggiunga le colonne: ID preventivo, ID opportunità, CreatedDate, LastModifiedDate e Status. Questi dati serviranno a ricavare la creazione dei preventivi e le relative modifiche di stato.
Crei altri report (contratti, ordini, fatture): seguendo lo stesso schema del report sui preventivi, crei report separati per contratti, ordini e fatture, se questi oggetti sono utilizzati nella Sua istanza Salesforce. Per ciascuno, includa l’ID del record, l’ID dell’opportunità associata, CreatedDate, LastModifiedDate e il campo Status dell’oggetto.
Esegua ed esporti tutti i report: per ciascun report, imposti un intervallo di date uniforme, ad esempio «Opportunity Created Date» negli ultimi 6 mesi. Esegua ogni report e utilizzi la funzione «Export» per salvare i risultati in un file CSV.
Riunisca i dati in un foglio di calcolo: apra un’applicazione per fogli di calcolo, come Microsoft Excel. Copi i dati di ciascun file CSV esportato in un foglio separato all’interno di un’unica cartella di lavoro.
Crei il foglio Event Log finale: crei un nuovo foglio denominato «Event Log». Definisca le intestazioni obbligatorie: SalesOpportunity, ActivityName, EventTimestamp e quelle consigliate: OpportunityOwner, StageName, Importo, IsWon, DiscountPercentage.
Trasformi e consolidi i dati: compili manualmente il foglio «Event Log» elaborando i dati dei fogli di origine. Per ogni riga di origine, crei una riga corrispondente nel log degli eventi. Ad esempio, per una riga del foglio della cronologia delle opportunità in cui «New Value» è «Closed Won», crei una riga nel log con ActivityName impostato su «Opportunity Closed Won» e EventTimestamp impostato sulla «Edit Date». Ripeta l’operazione per tutte le 16 attività richieste nei file di origine.
Applichi la formattazione finale ed esporti il file: verifichi che la colonna EventTimestamp abbia un formato uniforme (ad esempio, YYYY-MM-DD HH:MI:SS). La colonna SalesOpportunity deve essere compilata in ogni riga utilizzando l’ID opportunità dei report di origine. Salvi il foglio «Event Log» finale e consolidato come file CSV da caricare.

Configurazione

Tipi di report: il tipo di report principale richiesto è «Opportunities with Field History». Saranno necessari anche report per Lead, Preventivi, Contract, Ordini e Fatture. La disponibilità di tipi di report con cronologia per questi oggetti migliora notevolmente l’accuratezza dei dati.
Field History Tracking: deve essere configurato in anticipo da un amministratore Salesforce. È essenziale per monitorare le modifiche alla fase dell’opportunità e allo stato di preventivi, contratti e ordini.
Autorizzazioni: l’utente che esegue i report deve avere accesso in lettura a tutti gli oggetti pertinenti: Lead, Account, Opportunity, OpportunityFieldHistory, Quote, Contract, Order e, se necessario, Invoice e Payment.
Filtro per intervallo di date: è fondamentale applicare lo stesso filtro per intervallo di date a tutti i report, così da garantire la coerenza dei dati. Per mantenere gestibile il volume, si consiglia di filtrare «Opportunity Created Date» sugli ultimi 3-6 mesi.
Volume dei dati: nelle organizzazioni con volumi molto elevati di opportunità e attività, Report Builder potrebbe rallentare o raggiungere i limiti di esportazione, che in genere si aggirano intorno alle 100.000 righe, a seconda dell’edizione. In questi casi, il servizio settimanale Data Export è un’alternativa più affidabile per ottenere i dati grezzi.

Query di esempio sql

/*
Salesforce Report Builder is a graphical user interface, so a direct script is not applicable.
The following describes the configuration and transformation logic required to build the final event log file from the various exported reports.
*/

-- **FINAL EVENT LOG STRUCTURE (Target CSV File)**
-- `SalesOpportunity` (TEXT): The Salesforce Opportunity ID (18-digit).
-- `ActivityName` (TEXT): The name of the business event.
-- `EventTimestamp` (DATETIME): The timestamp of the event.
-- `OpportunityOwner` (TEXT): The name of the opportunity owner.
-- `StageName` (TEXT): The stage of the opportunity at the time of the event.
-- `Amount` (NUMERIC): The opportunity amount.
-- `IsWon` (BOOLEAN): True if the opportunity is in a 'Closed Won' stage.
-- `DiscountPercentage` (NUMERIC): The discount percentage, if applicable.

-- **DATA TRANSFORMATION LOGIC (To be applied in a spreadsheet or script)**

-- **From Lead Conversion Report**
-- Activity: 'Lead Converted to Opportunity'
-- `SalesOpportunity` <-- `Converted Opportunity ID`
-- `ActivityName` <-- 'Lead Converted to Opportunity'
-- `EventTimestamp` <-- `Converted Date`

-- **From Opportunity History Report**
-- Activity: 'Opportunity Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Created'
-- `EventTimestamp` <-- `Created Date`

-- Activity: 'Opportunity Stage Changed'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Stage Changed'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage'

-- Activity: 'Proposal Stage Reached'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Proposal Stage Reached'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Proposal/Price Quote'

-- Activity: 'Opportunity Closed Won'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Closed Won'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Closed Won'

-- Activity: 'Opportunity Closed Lost'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Closed Lost'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Closed Lost'

-- **From Quote Report (Requires Quote History Tracking for status changes)**
-- Activity: 'Quote Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Created'
-- `EventTimestamp` <-- `CreatedDate`

-- Activity: 'Quote Presented to Customer'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Presented to Customer'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Presented']

-- Activity: 'Quote Modified'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Modified'
-- `EventTimestamp` <-- `LastModifiedDate` (Note: This is an approximation)
-- Filter: WHERE `LastModifiedDate` > `CreatedDate`

-- Activity: 'Quote Accepted by Customer'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Accepted by Customer'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Accepted']

-- **From Contract Report (Requires Contract History Tracking for status changes)**
-- Activity: 'Contract Sent for Signature'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Contract Sent for Signature'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Sent']

-- Activity: 'Contract Activated'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Contract Activated'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Activated']

-- **From Order Report (Requires Order History Tracking for status changes)**
-- Activity: 'Order Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Order Created'
-- `EventTimestamp` <-- `CreatedDate`

-- Activity: 'Order Fulfilled'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Order Fulfilled'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Fulfilled']

-- **From Invoice/Payment Report (If available in Salesforce)**
-- Activity: 'Invoice Generated'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Invoice Generated'
-- `EventTimestamp` <-- [Invoice CreatedDate]

-- Activity: 'Payment Received'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Payment Received'
-- `EventTimestamp` <-- [Payment Date or Invoice Paid Date]

Passaggi

Prerequisiti: verifichi di disporre di un account utente Salesforce con accesso API e autorizzazioni sufficienti per leggere gli oggetti Opportunity, Lead, Preventivo, Contract, Ordine e Fattura, nonché i relativi oggetti Field History. Field History Tracking deve essere attivo per i campi chiave di questi oggetti, ad esempio StageName e Status.
Scelga uno strumento di esecuzione: questa query utilizza clausole UNION ALL, non supportate da Developer Console o Workbench nativi di Salesforce. Deve utilizzare uno strumento esterno in grado di connettersi a Salesforce ed eseguire query in stile SQL, ad esempio uno strumento di business intelligence (BI) come Tableau o Power BI, uno strumento ETL come MuleSoft o Informatica oppure uno strumento di interrogazione dati con connettore Salesforce, come DBeaver o DataGrip.
Stabilisca la connessione a Salesforce: configuri la connessione alla Sua istanza Salesforce nello strumento scelto. In genere, Le serviranno nome utente, password e token di sicurezza. Selezioni l’opzione del connettore Salesforce (API).
Prepari la query: copi la query SOQL completa fornita nella sezione query di questo documento nell’editor dello strumento.
Configuri i segnaposto: la query contiene diversi segnaposto da sostituire con valori specifici della Sua organizzazione Salesforce. Tra questi:
- 'YYYY-MM-DDThh:mm:ssZ': sostituisca tutte le occorrenze con le date di inizio e fine desiderate per il periodo di estrazione, utilizzando il formato ISO 8601.
- [Your_Discount_Field__c]: sostituisca il segnaposto con il nome API del campo personalizzato relativo alla percentuale di sconto nell’oggetto Opportunity.
- [Quote_Presented_Status]: sostituisca il segnaposto con il valore di stato effettivamente utilizzato quando un preventivo viene presentato a un cliente, ad esempio «Presented» o «In Review».
- [Opportunity_Lookup_On_Contract__c]: sostituisca il segnaposto con il nome API del campo di ricerca nell’oggetto Contract che collega il contratto all’opportunità.
- [Order_Fulfilled_Status]: sostituisca il segnaposto con il valore di stato che indica l’evasione di un ordine, ad esempio «Fulfilled», «Shipped» o «Completed».
- [Opportunity_Lookup_On_Invoice__c]: sostituisca il segnaposto con il nome API del campo di ricerca nell’oggetto Invoice che collega la fattura all’opportunità.
Esegua la query: avvii l’esecuzione della query completa. A seconda del volume dei dati e dello strumento utilizzato, l’operazione potrebbe richiedere alcuni minuti.
Verifichi i risultati: al termine della query, controlli che il set di dati restituito contenga righe per tutte le diverse attività e che le colonne siano compilate come previsto.
Gestisca gli eventuali errori: se la query non viene eseguita, controlli che i nomi dei segnaposto sostituiti non contengano errori di battitura. Verifichi che l’utente disponga delle autorizzazioni di sicurezza a livello di campo per tutti i campi interrogati. Se l’intervallo di date è troppo ampio, la query potrebbe andare in timeout o raggiungere i limiti di sistema; provi a ridurlo, ad esempio a un singolo trimestre.
Esporti i dati: esporti il set di risultati finale in un file CSV.
Prepari il caricamento: verifichi che le intestazioni del file CSV corrispondano agli attributi richiesti: SalesOpportunity, ActivityName, EventTimestamp, OpportunityOwner, StageName, Importo, IsWon e DiscountPercentage. Il file è ora pronto per essere caricato in uno strumento di Process Mining.

Configurazione

Tracciamento della cronologia dei campi: Questa estrazione dipende in modo essenziale dall’attivazione di Field History Tracking per gli oggetti Opportunity (StageName), Quote (Status), Contract (Status) e Ordine (Status). Senza questa funzione, le attività relative ai cambiamenti di stato e di fase non verranno acquisite.
Autorizzazioni utente: L’utente che esegue la query deve disporre dell’accesso API e delle autorizzazioni di lettura per tutti gli oggetti inclusi: Lead, Opportunity, OpportunityFieldHistory, Quote, QuoteHistory, Contract, ContractHistory, Ordine, OrderHistory, Fattura e InvoiceHistory.
Intervallo di date: È fondamentale definire un intervallo di date specifico usando i segnaposto 'YYYY-MM-DDThh:mm:ssZ'. Per l’analisi iniziale, si consiglia un periodo di 3-6 mesi, così da bilanciare il volume dei dati e le prestazioni. Se l’istanza Salesforce è molto estesa, inizi con un intervallo più breve, ad esempio un mese, per verificare le prestazioni e gli eventuali limiti di esecuzione.
Campi e stati personalizzati: La query contiene segnaposto per i campi personalizzati (ad esempio, [Your_Discount_Field__c]) e i valori di stato personalizzati (ad esempio, [Quote_Presented_Status]). Dovrà individuare i nomi API e i valori corretti nella configurazione Salesforce e aggiornare la query di conseguenza.
Disponibilità degli oggetti: La query presuppone l’uso degli oggetti standard Contract e Ordine, oltre all’oggetto Fattura (comune con Salesforce Billing). Se l’organizzazione non utilizza questi oggetti o adotta un pacchetto di fatturazione diverso, le relative parti della query restituiranno errori o nessun dato e dovranno essere rimosse o adattate.

Query di esempio sql

SELECT
    ConvertedOpportunityId AS SalesOpportunity,
    'Lead Converted to Opportunity' AS ActivityName,
    ConvertedDate AS EventTimestamp,
    ConvertedOpportunity.Owner.Name AS OpportunityOwner,
    ConvertedOpportunity.StageName AS StageName,
    ConvertedOpportunity.Amount AS Amount,
    ConvertedOpportunity.IsWon AS IsWon,
    ConvertedOpportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Lead
WHERE IsConverted = TRUE AND ConvertedDate >= YYYY-MM-DDThh:mm:ssZ AND ConvertedDate <= YYYY-MM-DDThh:mm:ssZ AND ConvertedOpportunityId != NULL

UNION ALL

SELECT
    Id AS SalesOpportunity,
    'Opportunity Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Owner.Name AS OpportunityOwner,
    StageName AS StageName,
    Amount AS Amount,
    IsWon AS IsWon,
    [Your_Discount_Field__c] AS DiscountPercentage
FROM Opportunity
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Stage Changed' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Proposal Stage Reached' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Proposal/Price Quote' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Quote Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    Opportunity.StageName AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Quote
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Presented to Customer' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE Field = 'Status' AND NewValue = '[Quote_Presented_Status]' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Modified' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE CreatedDate > Quote.CreatedDate AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Accepted by Customer' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE Field = 'Status' AND NewValue = 'Accepted' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Contract.[Opportunity_Lookup_On_Contract__c] AS SalesOpportunity,
    'Contract Sent for Signature' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Contract.Opportunity__r.Owner.Name AS OpportunityOwner,
    Contract.Opportunity__r.StageName AS StageName,
    Contract.Opportunity__r.Amount AS Amount,
    Contract.Opportunity__r.IsWon AS IsWon,
    Contract.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM ContractHistory
WHERE Field = 'Status' AND NewValue = 'Sent for Signature' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Contract.[Opportunity_Lookup_On_Contract__c] != NULL

UNION ALL

SELECT
    Contract.[Opportunity_Lookup_On_Contract__c] AS SalesOpportunity,
    'Contract Activated' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Contract.Opportunity__r.Owner.Name AS OpportunityOwner,
    Contract.Opportunity__r.StageName AS StageName,
    Contract.Opportunity__r.Amount AS Amount,
    Contract.Opportunity__r.IsWon AS IsWon,
    Contract.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM ContractHistory
WHERE Field = 'Status' AND NewValue = 'Activated' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Contract.[Opportunity_Lookup_On_Contract__c] != NULL

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Closed Won' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Closed Won' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Order Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    Opportunity.StageName AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Order
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND OpportunityId != NULL

UNION ALL

SELECT
    Order.OpportunityId AS SalesOpportunity,
    'Order Fulfilled' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Order.Opportunity.Owner.Name AS OpportunityOwner,
    Order.Opportunity.StageName AS StageName,
    Order.Opportunity.Amount AS Amount,
    Order.Opportunity.IsWon AS IsWon,
    Order.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OrderHistory
WHERE Field = 'Status' AND NewValue = '[Order_Fulfilled_Status]' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Order.OpportunityId != NULL

UNION ALL

SELECT
    [Opportunity_Lookup_On_Invoice__c] AS SalesOpportunity,
    'Invoice Generated' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity__r.Owner.Name AS OpportunityOwner,
    Opportunity__r.StageName AS StageName,
    Opportunity__r.Amount AS Amount,
    Opportunity__r.IsWon AS IsWon,
    Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM Invoice
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND [Opportunity_Lookup_On_Invoice__c] != NULL

UNION ALL

SELECT
    Invoice.[Opportunity_Lookup_On_Invoice__c] AS SalesOpportunity,
    'Payment Received' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Invoice.Opportunity__r.Owner.Name AS OpportunityOwner,
    Invoice.Opportunity__r.StageName AS StageName,
    Invoice.Opportunity__r.Amount AS Amount,
    Invoice.Opportunity__r.IsWon AS IsWon,
    Invoice.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM InvoiceHistory
WHERE Field = 'Status' AND NewValue = 'Paid' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Invoice.[Opportunity_Lookup_On_Invoice__c] != NULL

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Closed Lost' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Closed Lost' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

Passaggi

Preparare l’ambiente: Verifichi che sul sistema sia installato Python 3.6 o una versione successiva. Le servirà anche pip, il programma di installazione dei pacchetti Python, per installare le librerie necessarie.
Installare le librerie necessarie: Apra il prompt dei comandi o il terminale e installi le librerie simple-salesforce e pandas eseguendo il comando: pip install simple-salesforce pandas.
Configurare l’accesso API a Salesforce: Acceda al Suo account Salesforce con un profilo amministratore. Apra Setup, quindi Apps e App Manager. Crei una nuova 'Connected App'. Abiliti le impostazioni OAuth per l’app e le assegni l’ambito 'Access and manage your data (api)'. Dopo aver salvato, riceverà una 'Consumer Key' e un 'Consumer Secret'. Verifichi inoltre che l’account utente utilizzato dallo script disponga di un Security Token. Può generarlo o reimpostarlo nelle impostazioni personali, selezionando 'Reset My Security Token'.
Configurare lo script Python: Copi lo script Python completo fornito nella sezione Query in un file denominato extract_lead_to_cash.py.
Inserire le credenziali: Apra il file dello script e sostituisca i valori segnaposto di username, password, security_token e instance_url con le credenziali Salesforce specifiche. In ambiente di produzione, non inserisca le credenziali direttamente nel codice: utilizzi un metodo sicuro, come le variabili di ambiente o un file di configurazione.
Definire il periodo di estrazione: Modifichi le variabili start_date e end_date nello script per definire l’intervallo temporale dei dati da estrarre. Utilizzi il formato 'YYYY-MM-DD'.
Comprendere la logica dello script: Lo script si connette all’API Salesforce ed esegue una serie di query Salesforce Object Query Language (SOQL). Ogni query riguarda un oggetto specifico, ad esempio Opportunity, OpportunityFieldHistory o Preventivo, per acquisire una distinta attività aziendale.
Aggregare i dati: I risultati di ogni query vengono convertiti in un formato strutturato denominato DataFrame pandas. I singoli DataFrame, ciascuno relativo a un’attività, vengono quindi raccolti in un’unica lista.
Trasformare e formattare i dati: Lo script concatena tutti i singoli DataFrame in un Event Log completo. Rinomina le colonne in base allo schema richiesto per il Process Mining (SalesOpportunity, ActivityName, EventTimestamp e così via) e verifica che i tipi di dati siano corretti.
Eseguire lo script: Esegua lo script dal terminale con il comando: python extract_lead_to_cash.py. Lo script si connetterà a Salesforce, eseguirà le query ed elaborerà i dati.
Recuperare l’Event Log: Al termine dell’esecuzione, verrà creato nella stessa directory un file denominato sfdc_lead_to_cash_event_log.csv. Questo file CSV è l’Event Log finale, formattato per essere caricato in uno strumento di Process Mining.

Configurazione

Prerequisiti: un account Salesforce Enterprise, Unlimited o Developer Edition, che includa l’accesso API. Un profilo utente Salesforce con l’autorizzazione «API Enabled» e accesso in lettura ai seguenti oggetti: Lead, Opportunity, OpportunityFieldHistory, Quote, Contract e Order. Anche gli eventuali oggetti personalizzati per la fatturazione o i pagamenti richiedono l’accesso in lettura.
Autenticazione: lo script utilizza l’autenticazione con nome utente, password e token di sicurezza. Per una maggiore sicurezza in produzione, valuti l’implementazione di OAuth 2.0 JWT Bearer Flow, supportato anche da simple-salesforce.
Intervallo di date: le variabili start_date e end_date nello script definiscono l’intervallo di estrazione. Per l’analisi iniziale si consiglia un periodo da 3 a 6 mesi, sufficiente a raccogliere dati utili senza generare volumi eccessivi. I filtri temporali vengono applicati al campo timestamp principale di ciascuna attività, ad esempio CreatedDate o ConvertedDate.
Utilizzo dell’API: lo script esegue diverse query distinte. Ogni query e il successivo recupero di tutti i risultati comportano chiamate API, conteggiate nei limiti giornalieri dell’organizzazione. Tenga presenti questi limiti, soprattutto se sono attive molte altre integrazioni. Per estrarre milioni di record, è necessario adattare lo script per utilizzare Salesforce Bulk API.
Personalizzazioni: ove possibile, lo script presuppone l’utilizzo di nomi standard per oggetti e campi. La Sua organizzazione potrebbe avere campi personalizzati, ad esempio Discount_Percentage__c, oggetti personalizzati, ad esempio Invoice__c e Payment__c, o relazioni personalizzate, come un campo di ricerca dall’oggetto Contract all’oggetto Opportunity. Modifichi le query SOQL nello script in base alla configurazione specifica della Sua istanza Salesforce.

Query di esempio python

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

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Salesforce credentials and instance URL
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]'
SF_INSTANCE_URL = class="hl-string">'[your_salesforce_instance_url]'

class=class="hl-string">"hl-comment"># Define 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"># --- Main Script ---
def main():
    class=class="hl-string">"hl-comment"># Establish connection to Salesforce
    try:
        sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
        print(fclass="hl-string">"Successfully connected to Salesforce instance: {sf.sf_instance}")
    except Exception as e:
        print(fclass="hl-string">"Salesforce connection failed: {e}")
        return

    class=class="hl-string">"hl-comment"># List to hold DataFrames for each activity
    event_log_parts = []

    class=class="hl-string">"hl-comment"># Define common fields to query for Opportunity context
    common_opp_fields = class="hl-string">"Opportunity.Id, Opportunity.Owner.Name, Opportunity.StageName, Opportunity.Amount, Opportunity.IsWon, Opportunity.Discount_Percentage__c"

    class=class="hl-string">"hl-comment"># 1. Lead Converted to Opportunity
    print(class="hl-string">"Extracting: Lead Converted to Opportunity")
    query = fclass="hl-string">"SELECT ConvertedOpportunityId, ConvertedDate, (SELECT Name FROM Owner) FROM Lead WHERE IsConverted = TRUE AND ConvertedDate >= {start_date}T00:00:00Z AND ConvertedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df[class="hl-string">'ActivityName'] = class="hl-string">'Lead Converted to Opportunity'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'ConvertedDate']).dt.tz_localize(None)
        df[class="hl-string">'SalesOpportunity'] = df[class="hl-string">'ConvertedOpportunityId']
        df[class="hl-string">'OpportunityOwner'] = df[class="hl-string">'Owner'].apply(lambda x: x[class="hl-string">'Name'] if x else None)
        df = df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner']]
        event_log_parts.append(df)

    class=class="hl-string">"hl-comment"># 2. Opportunity Created
    print(class="hl-string">"Extracting: Opportunity Created")
    query = fclass="hl-string">"SELECT Id, CreatedDate, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df[class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'Id': class="hl-string">'SalesOpportunity', class="hl-string">'Name': class="hl-string">'OpportunityOwner', class="hl-string">'Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        df[class="hl-string">'OpportunityOwner'] = df.apply(lambda row: row[class="hl-string">'Owner'][class="hl-string">'Name'] if row[class="hl-string">'Owner'] else None, axis=1)
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 3, 4, 11, 16. Opportunity Stage Changes (includes Proposal, Closed Won, Closed Lost)
    print(class="hl-string">"Extracting: Opportunity Stage Changes")
    query = fclass="hl-string">"SELECT OpportunityId, CreatedDate, NewValue, OldValue, {common_opp_fields} FROM OpportunityFieldHistory WHERE Field = 'StageName' AND CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Stage Changed'
        class=class="hl-string">"hl-comment"># Specific stage milestones
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Proposal/Price Quote', class="hl-string">'ActivityName'] = class="hl-string">'Proposal Stage Reached'
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Closed Won', class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Closed Won'
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Closed Lost', class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Closed Lost'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 5. Quote Created
    print(class="hl-string">"Extracting: Quote Created")
    query = fclass="hl-string">"SELECT CreatedDate, OpportunityId, {common_opp_fields} FROM Quote WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Quote Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 6, 7, 8. Quote Status Changes (Presented, Modified, Accepted)
    print(class="hl-string">"Extracting: Quote Status Changes")
    query = fclass="hl-string">"SELECT LastModifiedDate, CreatedDate, Status, OpportunityId, {common_opp_fields} FROM Quote WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
        df[class="hl-string">'CreatedTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        class=class="hl-string">"hl-comment"># Presented
        df_presented = df[df[class="hl-string">'Status'] == class="hl-string">'Presented'].copy()
        if not df_presented.empty: df_presented[class="hl-string">'ActivityName'] = class="hl-string">'Quote Presented to Customer'; event_log_parts.append(df_presented)
        class=class="hl-string">"hl-comment"># Accepted
        df_accepted = df[df[class="hl-string">'Status'] == class="hl-string">'Accepted'].copy()
        if not df_accepted.empty: df_accepted[class="hl-string">'ActivityName'] = class="hl-string">'Quote Accepted by Customer'; event_log_parts.append(df_accepted)
        class=class="hl-string">"hl-comment"># Modified (any change after creation)
        df_modified = df[df[class="hl-string">'EventTimestamp'] > df[class="hl-string">'CreatedTimestamp']].copy()
        if not df_modified.empty: df_modified[class="hl-string">'ActivityName'] = class="hl-string">'Quote Modified'; event_log_parts.append(df_modified)

    class=class="hl-string">"hl-comment"># 9, 10. Contract Status Changes (Sent, Activated)
    print(class="hl-string">"Extracting: Contract Events")
    query = fclass="hl-string">"SELECT LastModifiedDate, ActivatedDate, Status, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Contract WHERE (LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z) OR (ActivatedDate >= {start_date} AND ActivatedDate <= {end_date}) AND Opportunity__c != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
        df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        class=class="hl-string">"hl-comment"># Sent for Signature
        df_sent = df[df[class="hl-string">'Status'] == class="hl-string">'Sent'].copy()
        if not df_sent.empty: df_sent[class="hl-string">'ActivityName'] = class="hl-string">'Contract Sent for Signature'; df_sent[class="hl-string">'EventTimestamp'] = pd.to_datetime(df_sent[class="hl-string">'LastModifiedDate']).dt.tz_localize(None); event_log_parts.append(df_sent)
        class=class="hl-string">"hl-comment"># Activated
        df_activated = df[df[class="hl-string">'Status'] == class="hl-string">'Activated'].copy()
        if not df_activated.empty: df_activated[class="hl-string">'ActivityName'] = class="hl-string">'Contract Activated'; df_activated[class="hl-string">'EventTimestamp'] = pd.to_datetime(df_activated[class="hl-string">'ActivatedDate']).dt.tz_localize(None); event_log_parts.append(df_activated)

    class=class="hl-string">"hl-comment"># 12. Order Created
    print(class="hl-string">"Extracting: Order Created")
    query = fclass="hl-string">"SELECT CreatedDate, OpportunityId, {common_opp_fields} FROM Order WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z AND OpportunityId != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Order Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df)
        
    class=class="hl-string">"hl-comment"># 13. Order Fulfilled
    print(class="hl-string">"Extracting: Order Fulfilled")
    query = fclass="hl-string">"SELECT LastModifiedDate, Status, OpportunityId, {common_opp_fields} FROM Order WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z AND Status = 'Fulfilled' AND OpportunityId != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Order Fulfilled'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df)

    class=class="hl-string">"hl-comment"># 14. Invoice Generated (using placeholder custom object Invoice__c)
    print(class="hl-string">"Extracting: Invoice Generated")
    query = fclass="hl-string">"SELECT CreatedDate, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Invoice__c WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z AND Opportunity__c != NULL"
    try:
        df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
        if not df.empty:
            df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
            df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
            df[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
            df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
            event_log_parts.append(df)
    except Exception as e:
        print(class="hl-string">"Could not extract 'Invoice Generated'. Check if 'Invoice__c' object and 'Opportunity__c' field exist and are accessible.")

    class=class="hl-string">"hl-comment"># 15. Payment Received (using placeholder custom object Invoice__c status change)
    print(class="hl-string">"Extracting: Payment Received")
    query = fclass="hl-string">"SELECT LastModifiedDate, Status__c, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Invoice__c WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z AND Status__c = 'Paid' AND Opportunity__c != NULL"
    try:
        df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
        if not df.empty:
            df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
            df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
            df[class="hl-string">'ActivityName'] = class="hl-string">'Payment Received'
            df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
            df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
            event_log_parts.append(df)
    except Exception as e:
        print(class="hl-string">"Could not extract 'Payment Received'. Check if 'Invoice__c' object and relevant fields exist and are accessible.")

    class=class="hl-string">"hl-comment"># --- Finalize Event Log ---
    if not event_log_parts:
        print(class="hl-string">"No data extracted. The event log is empty.")
        return

    print(class="hl-string">"Concatenating and cleaning final event log...")
    final_event_log = pd.concat(event_log_parts, ignore_index=True)

    class=class="hl-string">"hl-comment"># Select and order final columns
    final_columns = [
        class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', 
        class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage'
    ]
    class=class="hl-string">"hl-comment"># Add any missing columns with null values
    for col in final_columns:
        if col not in final_event_log.columns:
            final_event_log[col] = None
    
    final_event_log = final_event_log[final_columns]

    class=class="hl-string">"hl-comment"># Sort the event log
    final_event_log = final_event_log.sort_values(by=[class="hl-string">'SalesOpportunity', class="hl-string">'EventTimestamp'])

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

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

È pronto a iniziare?

Utilizzi questo template per semplificare la preparazione dei dati e sfruttare appieno il Process Mining nelle attività Lead to Cash. Inizi oggi a migliorare l’efficienza.

Torna alla guida al miglioramento

Scarica il template

Non perda altre trattative: ottimizzi subito il processo Lead to Cash

Ottimizzi il processo Lead to Cash in Salesforce e aumenti del 20% il tasso di successo.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito

Il Suo template dei dati Lead to Cash

Il Suo template dei dati Lead to Cash

Attributi Lead to Cash

Attività Lead to Cash

Guide all’estrazione

Generatore di report Salesforce e servizio di esportazione dati

Passaggi

Configurazione

Query di esempio sql

Query diretta con Salesforce Object Query Language (SOQL)

Passaggi

Configurazione

Query di esempio sql

Script Python con Salesforce REST API o Bulk API

Passaggi

Configurazione

Query di esempio python

È pronto a iniziare?

Non perda altre trattative: ottimizzi subito il processo Lead to Cash