> Miglioramento continuo dei processi > Dal lead all’incasso > Oracle CX Sales > Template dei dati

Il Suo template dei dati Lead to Cash

Oracle CX Sales

Attributi Lead to Cash(20) Attività Lead to Cash(14) Guide all’estrazione(2)

Il Suo template dei dati Lead to Cash

Questo template La guida nella preparazione dei dati Lead to Cash per il Process Mining. Illustra gli attributi essenziali da raccogliere e le attività principali da monitorare, oltre a fornire indicazioni utili per estrarre queste informazioni da Oracle CX Sales. Seguendo il template, potrà ottenere un’analisi completa e accurata del processo.

Attributi consigliati per l’analisi Lead to Cash
Attività principali da monitorare nei cicli di vendita e pagamento
Indicazioni dettagliate per estrarre i dati da Oracle CX Sales

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

Scarica il template

Attributi Lead to Cash

Questi sono i campi dati consigliati da includere nell’Event Log per analizzare in modo completo il processo Lead to Cash.

5 Obbligatorio 5 Consigliato 10 Facoltativo

	Nome	Descrizione
	Nome dell’attività ActivityName	Nome dell’attività aziendale o dell’evento che si è verificato in un determinato momento per un’opportunità di vendita.
Descrizione Questo attributo descrive una fase o un traguardo specifico del processo Lead to Cash, come «Lead convertito in opportunità», «Preventivo creato» o «Pagamento ricevuto». Queste attività costituiscono gli elementi fondamentali della mappa del processo. Analizzarne la sequenza e la frequenza aiuta a visualizzare il flusso del processo, individuare i percorsi più comuni e quelli alternativi e rilevare deviazioni o colli di bottiglia. È inoltre la base per misurare i tempi di transizione tra le fasi e capire come viene svolto il lavoro nella pratica. Perché è importante Questo attributo è fondamentale per creare la mappa del processo e comprendere la sequenza degli eventi nel ciclo di vendita. Dove reperirli In genere si ricava dalle modifiche di stato, dai registri degli eventi o dai record di completamento di attività specifiche associate agli oggetti Opportunity, Quote o Order. Esempi Opportunità qualificataPreventivo inviato al clienteOrdine evasoPagamento ricevuto
	Opportunità di vendita SalesOpportunity	Identificativo univoco di un’opportunità di vendita, che funge da caso per il processo Lead to Cash.
Descrizione L’opportunità di vendita è l’oggetto centrale che consente di seguire una trattativa potenzialmente redditizia dalla fase iniziale di lead fino alla conclusione, positiva o negativa. Collega tutte le attività correlate, come la qualificazione, la creazione dei preventivi, l’invio degli ordini e il pagamento. Nell’analisi di Process Mining, questo identificativo è fondamentale per ricostruire il percorso completo di ogni trattativa. Consente di analizzarne l’intero ciclo di vita, compresi i tempi di ciclo tra le fasi, i tassi di conversione e i percorsi che portano a un esito positivo o alla perdita della trattativa. Perché è importante È l’ID caso essenziale che collega tutti gli eventi del processo e consente di ottenere una visione completa e accurata dell’intero ciclo di vendita per ogni potenziale trattativa. Dove reperirli È un identificativo primario nell’oggetto Oracle CX Sales Opportunity. Esempi OPP-0012345OPP-0023456OPP-0034567
	Ora dell’evento EventTime	Data e ora in cui si è verificata una specifica attività o un evento.
Descrizione L’ora dell’evento indica la data e l’ora in cui è stata registrata un’attività. È essenziale per ordinare gli eventi cronologicamente e calcolare la durata tra le diverse fasi del processo. Questo dato temporale è alla base di tutte le analisi basate sul tempo, dal calcolo dei tempi di ciclo all’individuazione dei colli di bottiglia tramite la misurazione dei tempi di attesa, fino al monitoraggio dei risultati rispetto agli accordi sui livelli di servizio. Per un’analisi di Process Mining affidabile, è fondamentale disporre di date e orari precisi. Perché è importante Definisce l’ordine cronologico degli eventi, indispensabile per calcolare tutte le metriche temporali, come i tempi di ciclo e le durate. Dove reperirli Corrisponde alla data di creazione o di ultimo aggiornamento dei record relativi ad attività specifiche, ad esempio alle date e agli orari delle modifiche di stato. Esempi 2023-04-15T10:00:00Z2023-05-01T14:30:00Z2023-05-20T09:15:00Z
	Sistema di origine SourceSystem	Il sistema da cui sono stati estratti i dati.
Descrizione Questo attributo identifica l’origine dei dati del processo, che in questo caso è Oracle CX Sales. Negli ambienti con più sistemi, il campo consente di distinguere le diverse fonti. In fase di analisi, fornisce informazioni sull’origine dei dati, utili quando si combinano dati provenienti da più sistemi o si esaminano comportamenti specifici di un sistema. È un campo standard per la governance e la tracciabilità dei dati. Perché è importante Fornisce informazioni essenziali sull’origine dei dati, ne garantisce la tracciabilità e aiuta a gestire dati provenienti da più sistemi integrati. Dove reperirli In genere è un valore statico aggiunto durante l’estrazione dei dati per indicarne la fonte. Esempi Oracle CX Sales
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’ultimo aggiornamento o dell’ultima estrazione dei dati dal sistema di origine.
Descrizione Questo attributo indica quanto sono aggiornati i dati analizzati. Riporta la data e l’ora dell’ultima estrazione da Oracle CX Sales. Nelle Dashboard e nei report, questo dato è fondamentale per informare gli utenti sull’attualità dei dati visualizzati. Aiuta a capire se l’analisi include le attività più recenti. Perché è importante Informa gli utenti sull’attualità dei dati, un aspetto fondamentale per interpretare le Dashboard e prendere decisioni consapevoli. Dove reperirli Questo dato temporale viene generato e aggiunto durante il processo di estrazione, trasformazione e caricamento dei dati (ETL). Esempi 2024-06-10T02:00:00Z
	Fase di vendita SalesStage	Fase attuale dell’opportunità di vendita nella pipeline commerciale.
Descrizione La fase di vendita indica l’avanzamento dell’opportunità nel processo commerciale definito, con valori come «Qualificazione», «Soluzione proposta» o «Negoziazione». È un attributo chiave per comprendere lo stato dell’opportunità in un determinato momento. Questo attributo è fondamentale per creare visualizzazioni del funnel di vendita e per la Dashboard «Analisi delle fasi delle opportunità in stallo». Analizzando il tempo trascorso in ogni fase, i team possono individuare dove le trattative rallentano e concentrarsi su come sbloccare la pipeline. Perché è importante È fondamentale per analizzare il funnel di vendita e individuare i colli di bottiglia in cui le opportunità si bloccano o vengono perse con frequenza. Dove reperirli È un campo standard dell’oggetto Opportunity in Oracle CX Sales, spesso denominato «SalesStage» o «StageName». Esempi 01 - Qualificazione03 - Proposta05 - NegoziazioneChiuso con esito positivo
	Motivo della perdita LossReason	Motivo indicato per la perdita di un’opportunità.
Descrizione Quando un’opportunità viene chiusa senza una vendita, il motivo della perdita registra la causa principale, ad esempio «Persa a favore di un concorrente», «Prezzo» o «Nessuna decisione». Queste informazioni sono fondamentali per l’analisi strategica e il miglioramento del processo. Questo attributo è alla base della Dashboard «Opportunità perse e motivi dell’abbandono». Analizzare i motivi della perdita insieme alla fase in cui si è verificata aiuta le aziende a comprendere i propri punti deboli rispetto alla concorrenza e a perfezionare la strategia di vendita, l’offerta di prodotti o i modelli di prezzo. Perché è importante Fornisce informazioni fondamentali sui motivi per cui le trattative non si concludono con una vendita e consente di migliorare strategicamente il processo commerciale e l’offerta di prodotti. Dove reperirli È un campo standard registrato quando lo stato di un’opportunità viene impostato su «Closed Lost» in Oracle CX Sales. Esempi PrezzoPersa a favore di un concorrenteAdeguatezza del prodottoNessuna decisione
	Regione Region	Area geografica o territorio commerciale associato all’opportunità.
Descrizione L’attributo Regione classifica le opportunità in base all’area geografica, ad esempio «Nord America», «EMEA» o «APAC». È una dimensione comunemente utilizzata per segmentare i risultati aziendali. Questo attributo è essenziale per la Dashboard «Parametri di riferimento dei risultati di vendita per area geografica». Consente di confrontare metriche chiave, come il tempo del ciclo di vendita, i tassi di conversione e le varianti del processo, tra diverse regioni, così da individuare le aree con i risultati migliori e quelle che richiedono interventi mirati. Perché è importante Consente di confrontare i risultati del processo tra diverse aree geografiche, mettendo in luce le differenze regionali e le buone pratiche. Dove reperirli Spesso disponibile come campo standard o personalizzato dell’oggetto Account o Opportunity in Oracle CX Sales. Esempi Nord AmericaEMEAAPACAmerica Latina
	Responsabile dell’opportunità OpportunityOwner	Il rappresentante commerciale principalmente responsabile dell’opportunità di vendita.
Descrizione Il responsabile dell’opportunità è l’utente incaricato di gestire e concludere la trattativa. Questo attributo consente di analizzare i risultati a livello individuale o di team. Nel Process Mining, filtrare per responsabile dell’opportunità può rivelare diversi metodi di lavoro, parametri di riferimento e livelli di conformità al processo di vendita standard. Aiuta i responsabili commerciali a individuare opportunità di formazione e a capire come i migliori venditori gestiscono il ciclo di vendita. Perché è importante Consente di analizzare i risultati per rappresentante commerciale o team, aiutando a individuare le buone pratiche e le aree in cui è utile fornire supporto. Dove reperirli Disponibile come campo standard «Owner» o «AssignedTo» dell’oggetto Opportunity in Oracle CX Sales. Esempi John SmithJane DoePeter Jones
	Valore dell’opportunità OpportunityValue	Valore monetario stimato o effettivo dell’opportunità di vendita.
Descrizione Questo attributo rappresenta i ricavi potenziali o finali associati a un’opportunità di vendita. Può essere utilizzato per segmentare e definire le priorità delle opportunità durante il loro ciclo di vita. Nel Process Mining, analizzare il valore dell’opportunità aiuta a capire in che modo le diverse varianti del processo incidono sulle trattative di valore alto o basso. È essenziale per le Dashboard che monitorano la perdita di ricavi, come l’analisi «Opportunità perse e motivi dell’abbandono», perché consente di correlare i percorsi del processo ai risultati finanziari. Perché è importante Consente di quantificare l’impatto finanziario delle inefficienze del processo e aiuta a stabilire le priorità per le opportunità e gli interventi di miglioramento. Dove reperirli In Oracle CX Sales è probabilmente disponibile in un campo come «Revenue» o «Amount» dell’oggetto Opportunity. Esempi 50000.00125000.0025000.00
	Fattura prima dell’evasione InvoiceBeforeFulfillment	Indicatore che segnala se una fattura è stata generata prima dell’evasione dell’ordine.
Descrizione Questo attributo booleano assume il valore true se, per un determinato caso, l’evento «Fattura generata» si verifica prima dell’evento «Ordine evaso». Si tratta di un percorso del processo non conforme o rischioso. Questo attributo alimenta direttamente il KPI «Tasso di fatture emesse prima dell’evasione» e viene utilizzato nelle Dashboard di conformità del processo. Monitorare questa deviazione aiuta le organizzazioni a rispettare le procedure di fatturazione, ridurre le contestazioni dei clienti e limitare i rischi legati alla rilevazione dei ricavi. Perché è importante Segnala una grave violazione della conformità del processo: i clienti vengono fatturati prima che l’ordine sia evaso, con possibili conseguenze negative sulla loro soddisfazione e rischi finanziari. Dove reperirli Si calcola confrontando le date e gli orari delle attività «Fattura generata» e «Ordine evaso» all’interno dello stesso caso. Esempi truefalse
	ID fattura InvoiceId	Identificativo univoco della fattura generata per un ordine di vendita.
Descrizione L’ID fattura è il numero di riferimento del documento di fatturazione inviato al cliente dopo l’evasione dell’ordine. È il documento chiave nelle fasi finanziarie finali del processo. Questo identificativo è essenziale per analizzare il «Tempo di ciclo di generazione della fattura» e il «Ciclo di incasso dei pagamenti». Consente di seguire ogni fattura dalla creazione al pagamento finale, un aspetto fondamentale per monitorare i flussi di cassa e i risultati della contabilità clienti. Perché è importante Consente di seguire la transazione finanziaria finale, un aspetto essenziale per analizzare i tempi del ciclo di fatturazione e l’efficienza degli incassi. Dove reperirli Consultare la documentazione di Oracle CX Sales o il sistema ERP o finanziario integrato per individuare l’identificativo dell’oggetto Invoice. Esempi INV-2023-001INV-2023-002INV-2023-003
	ID ordine OrderId	Identificativo univoco dell’ordine di vendita creato a partire da un’opportunità conclusa con esito positivo.
Descrizione L’ID ordine è il riferimento dell’ordine di vendita ufficiale inviato per l’evasione dopo che il cliente ha accettato un preventivo e l’opportunità si è conclusa con esito positivo. Segna un passaggio fondamentale dalla vendita alle attività operative. Questo identificativo è essenziale per seguire il processo a partire dall’attività «Ordine inviato per l’evasione». Collega la fase di vendita a quella di evasione dell’ordine nel ciclo Lead to Cash e consente un’analisi completa dei tempi di elaborazione ed evasione. Perché è importante Collega l’opportunità di vendita al processo di evasione dell’ordine e consente una vera analisi end-to-end, dal lead alla consegna finale. Dove reperirli Consultare la documentazione di Oracle CX Sales o il sistema ERP integrato per individuare l’identificativo primario dell’oggetto Sales Order. Esempi SO-554433SO-554434SO-554435
	ID preventivo QuoteId	Identificativo univoco di un preventivo di vendita associato a un’opportunità.
Descrizione L’ID preventivo è il numero di riferimento di uno specifico documento di preventivo generato per un’opportunità. Nel corso del suo ciclo di vita, un’opportunità può avere più preventivi, soprattutto se sono necessarie rilavorazioni. Tenere traccia di questo identificativo è importante per analizzare il «Tempo di ciclo dal preventivo all’ordine» e il «Tasso di rilavorazione dei preventivi». Consente di misurare con precisione il tempo che intercorre tra l’emissione e l’accettazione del preventivo e di distinguere le versioni iniziali da quelle riviste. Perché è importante Identifica in modo univoco i preventivi di vendita e consente di analizzare con precisione il ciclo di creazione, comprese le rilavorazioni e i tempi di conversione. Dove reperirli È l’identificativo primario dell’oggetto Quote in Oracle CX Sales, collegato all’oggetto Opportunity. Esempi QUO-98765QUO-98766QUO-98767
	Nome del cliente CustomerName	Nome del cliente o dell’account associato all’opportunità di vendita.
Descrizione Questo attributo identifica il cliente potenziale o esistente a cui si riferisce la trattativa. È una dimensione fondamentale per segmentare e analizzare il processo di vendita. Filtrare per cliente consente di analizzare nel dettaglio il percorso di vendita di account specifici, un aspetto utile per la gestione dei clienti strategici. Permette inoltre di segmentare i risultati del processo in base alle dimensioni del cliente, al settore o ad altre caratteristiche, così da adattare l’approccio commerciale. Perché è importante Consente di segmentare l’analisi del processo per cliente, un aspetto essenziale per comprendere i comportamenti specifici e gestire gli account strategici. Dove reperirli Il nome dell’account collegato all’oggetto Opportunity in Oracle CX Sales. Esempi Global Tech Inc.Innovate Solutions LLCPioneer Corp
	Nome del prodotto ProductName	Prodotto o servizio principale venduto nell’ambito dell’opportunità.
Descrizione Questo attributo specifica il prodotto o la famiglia di prodotti associati all’opportunità di vendita. Se l’opportunità comprende più prodotti, può indicare il prodotto principale di interesse oppure essere ripetuto per ogni riga di prodotto. Analizzare i flussi del processo per prodotto può rivelare se alcuni prodotti comportano cicli di vendita più lunghi o complessi. Queste informazioni possono orientare le strategie di vendita, la formazione e gli interventi di ottimizzazione specifici per prodotto. Perché è importante Consente di analizzare le differenze del processo di vendita tra prodotti o servizi e di individuare i colli di bottiglia specifici per prodotto. Dove reperirli Si trova nell’oggetto Product, collegato tramite Opportunity Product Line Item in Oracle CX Sales. Esempi Licenza CRM EnterpriseArchiviazione cloud, livello 1Pacchetto di servizi professionali
	Nome utente UserName	L’utente che ha eseguito una specifica attività o un evento.
Descrizione Questo attributo identifica la persona che ha eseguito una specifica attività, come «Preventivo creato» o «Ordine inviato». Il responsabile dell’opportunità è responsabile della trattativa nel suo complesso, mentre il nome utente indica chi ha svolto le singole operazioni. Questo livello di dettaglio è utile per comprendere l’allocazione delle risorse, la distribuzione del carico di lavoro e il rispetto di ruoli e responsabilità. Può aiutare a individuare se alcuni utenti costituiscono colli di bottiglia nel processo o se determinate attività vengono affidate sistematicamente a personale non autorizzato. Perché è importante Registra chi ha eseguito ogni singola operazione e consente un’analisi dettagliata del carico di lavoro e la verifica delle attività. Dove reperirli In genere si trova nei campi «CreatedBy» o «LastUpdatedBy» degli oggetti relativi alle attività in Oracle CX Sales. Esempi Alice WilliamsBob BrownCharlie Davis
	Opportunità in stallo IsStalled	Indicatore che segnala se un’opportunità è rimasta nella stessa fase di vendita per un periodo eccessivo.
Descrizione Questo attributo booleano assume il valore true quando il tempo tra due attività consecutive di un’opportunità supera una soglia aziendale predefinita, ad esempio 30 giorni. Viene utilizzato per calcolare il KPI «Tasso di opportunità in stallo» ed è essenziale per la Dashboard «Analisi delle fasi delle opportunità in stallo». Individuare le trattative bloccate consente ai responsabili commerciali di intervenire tempestivamente, fornire supporto e migliorare la velocità complessiva della pipeline di vendita. Perché è importante Aiuta a individuare in anticipo le trattative a rischio di perdita per inattività, consentendo di intervenire tempestivamente. Dove reperirli Si calcola misurando il tempo tra eventi consecutivi di un caso e confrontandolo con una soglia definita. Esempi truefalse
	Percentuale di sconto DiscountPercentage	Percentuale di sconto applicata al preventivo o all’opportunità di vendita.
Descrizione Questo attributo registra la percentuale di sconto concessa per una determinata trattativa. Incide direttamente sul prezzo finale e sulla redditività della vendita. Analizzare i livelli di sconto è fondamentale per il KPI «Utilizzo medio degli sconti». Aiuta le aziende a comprendere l’impatto degli sconti sui margini e può rivelare se vengono applicati in modo incoerente o senza la dovuta approvazione, mettendo in luce potenziali problemi nel flusso di lavoro di approvazione dei preventivi. Perché è importante Aiuta ad analizzare la redditività e l’efficacia delle strategie di sconto e a individuare eventuali sconti concessi senza adeguato controllo. Dove reperirli Consultare la documentazione di Oracle CX Sales per individuare un campo relativo agli sconti negli oggetti Quote o Opportunity Product Line Item. Esempi 0.050.100.150.20
	Preventivo rilavorato IsQuoteRework	Indicatore che segnala se un preventivo è stato rilavorato o creato più di una volta per la stessa opportunità.
Descrizione Questo attributo booleano assume il valore true se, per una singola opportunità di vendita, si verifica un’attività come «Preventivo rilavorato» o un secondo evento «Preventivo creato». Aiuta a isolare i casi di inefficienza nella fase di creazione dei preventivi. L’indicatore viene utilizzato per calcolare il KPI «Tasso di rilavorazione dei preventivi» e alimentare la Dashboard «Analisi delle deviazioni e delle rilavorazioni del processo». Evidenziare le rilavorazioni aiuta a individuare problemi nella raccolta iniziale dei requisiti, nei prezzi o nella configurazione dei prodotti, che comportano ulteriore lavoro e ritardi. Perché è importante Segnala direttamente inefficienze e deviazioni nella creazione dei preventivi, aiutando a individuare le cause profonde dei ritardi e del lavoro ripetuto. Dove reperirli Si calcola analizzando l’event log. Assume il valore true se l’attività «Preventivo creato» o «Preventivo rilavorato» compare più di una volta per una determinata opportunità di vendita. Esempi truefalse

Obbligatorio Consigliato Facoltativo

Attività Lead to Cash

Questi sono i passaggi e le tappe fondamentali da registrare nell’Event Log per individuare correttamente i processi e i colli di bottiglia.

6 Consigliato 8 Facoltativo

	Attività	Descrizione
	Lead convertito in opportunità	Indica la creazione di un’opportunità di vendita a partire da un lead qualificato. Questo evento segna l’inizio dell’analisi del processo incentrata sulle opportunità e si verifica quando un utente converte un lead nel sistema.
Perché è importante È l’evento di inizio principale del processo. Analizzare il volume e la provenienza dei lead convertiti è fondamentale per valutare l’efficacia delle attività di generazione e qualificazione dei lead. Dove reperirli L’evento viene rilevato alla creazione di un record di opportunità di vendita (oggetto Opportunity) in cui il campo «LeadId» o un campo di origine equivalente è valorizzato, a indicare che l’opportunità deriva da un lead convertito. Acquisizione Acquisire il timestamp di creazione dell’oggetto Opportunity con un riferimento non nullo al lead di origine. Tipo di evento explicit
	Opportunità persa	Indica un esito negativo: l’opportunità viene chiusa senza una vendita. L’evento si deduce quando lo stato dell’opportunità viene aggiornato a «Closed - Lost».
Perché è importante È un punto di arrivo negativo fondamentale. Analizzare quando, perché e per quale valore si perdono le opportunità aiuta a individuare le debolezze del processo e le difficoltà del mercato. Dove reperirli Si deduce dall’aggiornamento del campo «StatusCode» dell’oggetto Opportunity al valore «LOST». Il campo «ReasonWonLostCode» fornisce spesso ulteriori informazioni. Acquisizione Rileva quando il campo dello stato dell’opportunità viene aggiornato allo stato «Lost» definito dal sistema. Tipo di evento inferred
	Opportunità vinta	Indica la conclusione positiva di una trattativa, quando il cliente si impegna ad acquistare. Si deduce dalla modifica dello stato dell’opportunità allo stato finale «Closed - Won».
Perché è importante È la principale tappa di successo nel processo di vendita e avvia i successivi processi di evasione e fatturazione. Dove reperirli Si deduce dall’aggiornamento del campo «StatusCode» nell’oggetto Opportunity al valore «WON». In genere anche il campo «WinProb» (probabilità di successo) passa al 100%. Acquisizione Rilevare l’aggiornamento del campo di stato dell’opportunità allo stato «Won» definito dal sistema. Tipo di evento inferred
	Pagamento ricevuto	Indica il completamento positivo del ciclo Lead to Cash, quando il pagamento del cliente è stato ricevuto e registrato. L’evento proviene da un sistema finanziario.
Perché è importante È il punto di arrivo positivo del processo e indica la realizzazione dei ricavi. È fondamentale per misurare il tempo complessivo del ciclo di vendita e l’efficienza dei flussi di cassa. Dove reperirli I dati provengono da un sistema esterno di contabilità clienti o finanziario. Per completare l’analisi del processo, devono essere ricollegati all’opportunità di vendita. Acquisizione La data e l’ora dell’evento corrispondono a quelle registrate nell’applicazione del pagamento nel sistema finanziario. Tipo di evento explicit
	Preventivo accettato dal cliente	Indica che il cliente ha accettato formalmente le condizioni e i prezzi del preventivo. È una tappa fondamentale, spesso registrata dalla modifica dello stato dell’oggetto Quote a «Accepted».
Perché è importante È un segnale chiave di acquisto e un prerequisito per la creazione di un ordine di vendita. Segna la conclusione positiva della fase di negoziazione ed è una tappa del ciclo dal preventivo all’ordine. Dove reperirli Si deduce dalla modifica dello stato dell’oggetto Quote a «Accepted» o «Customer Approved». Acquisizione Rilevare la modifica del campo di stato dell’oggetto Quote al valore designato «Accepted». Tipo di evento inferred
	Preventivo creato	Indica la generazione di un documento formale con l’offerta economica associata all’opportunità. È un evento esplicito, registrato alla creazione di un nuovo record Quote collegato all’opportunità.
Perché è importante È una tappa importante, che indica un concreto interesse all’acquisto. Analizzare il tempo che intercorre tra la creazione dell’opportunità e quella del preventivo aiuta a misurare la rapidità del processo di vendita. Dove reperirli Rilevato alla creazione di un record Quote (oggetto Q_Quote) collegato all’ID dell’opportunità di vendita (OptyId). Acquisizione Utilizzare il timestamp di creazione dell’oggetto Quote associato all’opportunità. Tipo di evento explicit
	Analisi delle esigenze completata	Indica che il team di vendita ha raccolto e documentato i requisiti del cliente. In genere si deduce dal passaggio dell’opportunità a una fase successiva a quella di scoperta o analisi.
Perché è importante Questa attività è una tappa fondamentale prima di poter proporre una soluzione. Eventuali ritardi possono indicare difficoltà nel coinvolgimento del cliente o nella disponibilità di risorse per approfondimenti tecnici. Dove reperirli Si deduce da una modifica del campo «Sales Stage» nell’oggetto Opportunity, ad esempio dal passaggio da «2 - Discovery» a «3 - Solution Building». Acquisizione Rilevare una modifica del campo della fase di vendita dell’opportunità a uno stato che indica il completamento della fase di scoperta. Tipo di evento inferred
	Fattura generata	Indica la creazione della fattura per l’ordine evaso. Questa attività avviene in un sistema di fatturazione o finanziario, non in Oracle CX Sales, e i relativi dati devono essere integrati.
Perché è importante Questo evento avvia il ciclo di riscossione dei pagamenti. I ritardi tra l’evasione dell’ordine e la fatturazione possono incidere negativamente sul flusso di cassa e sull’indicatore KPI del tempo del ciclo dalla fattura al pagamento. Dove reperirli I dati provengono da un sistema ERP esterno o da un sistema di contabilità clienti. Per l’analisi del processo, gli eventi devono essere correlati all’ID dell’opportunità di vendita. Acquisizione La data e l’ora dell’evento provengono dal registro di creazione delle fatture del sistema finanziario. Tipo di evento explicit
	Opportunità qualificata	Indica il completamento della fase iniziale di qualificazione di un’opportunità. In genere si deduce dall’aggiornamento della fase di vendita dell’opportunità, che segnala la conclusione della valutazione preliminare e la conferma della sua validità.
Perché è importante Monitorare questa tappa aiuta a misurare l’efficienza delle prime fasi del processo di vendita e a capire quanto tempo le opportunità trascorrono in fase di qualificazione, un dato essenziale per l’indicatore KPI del tasso di conversione da lead a opportunità. Dove reperirli Si deduce da una modifica del campo «Sales Stage» (StgId) nell’oggetto Opportunity a un valore che indica la qualificazione, ad esempio il passaggio da «1 - Qualification» a «2 - Discovery». Acquisizione Rilevare una modifica del campo della fase di vendita dell’opportunità a uno stato designato come «Qualificata». Tipo di evento inferred
	Ordine evaso	Indica che i prodotti sono stati spediti o che i servizi sono stati erogati al cliente. Questi dati non sono nativi di Oracle CX Sales e devono provenire da un sistema ERP o di gestione degli ordini integrato.
Perché è importante Segna il completamento della consegna promessa al cliente e avvia la fatturazione. È essenziale per misurare i tempi del ciclo di evasione. Dove reperirli È necessaria l’integrazione con un sistema ERP o di evasione esterno. I dati devono essere collegati all’ID dell’opportunità di vendita di origine. Acquisizione Il timestamp dell’evento viene acquisito dal sistema di evasione tramite un’integrazione. Tipo di evento explicit
	Ordine inviato per l’evasione	Segna il passaggio delle consegne dal team di vendita al team che si occupa dell’evasione degli ordini. In Oracle CX Sales, può essere dedotto dalla vincita dell’opportunità, che avvia la creazione di un ordine di vendita in un sistema ERP integrato.
Perché è importante Questa attività collega le vendite alle operazioni. Analizzare questo passaggio è fondamentale per comprendere e ottimizzare l’indicatore KPI del tempo di evasione dell’ordine. Dove reperirli In CX Sales questo evento è spesso concettuale e rappresenta l’avvio della creazione dell’ordine in un sistema separato. Può essere associato al timestamp dell’evento «Opportunità vinta» o a una successiva conferma dello stato dell’integrazione. Acquisizione Spesso si utilizza come riferimento il timestamp dell’evento «Opportunità vinta»; in alternativa, possono servire dati provenienti da un sistema integrato di gestione degli ordini. Tipo di evento inferred
	Preventivo inviato al cliente	Indica il momento in cui il preventivo viene inviato formalmente al cliente per la revisione. In genere si deduce da una modifica dello stato dell’oggetto Quote, ad esempio al passaggio a «Presented» o «Sent».
Perché è importante Questa attività avvia il periodo di revisione e negoziazione da parte del cliente. È il punto di partenza per misurare l’indicatore KPI del tempo dalla creazione del preventivo alla creazione dell’ordine. Dove reperirli Si deduce da una modifica dello stato dell’oggetto Quote associato all’opportunità. Il campo dello stato può chiamarsi «StatusCode» o avere un nome simile. Acquisizione Rilevare la modifica del campo di stato dell’oggetto Quote a un valore «Sent» o «Presented». Tipo di evento inferred
	Preventivo rielaborato	Registra i casi in cui un preventivo viene rivisto e inviato nuovamente al cliente. Si deduce dalla presenza di più eventi «Preventivo creato» per la stessa opportunità o dalla gestione delle versioni di un singolo record Quote.
Perché è importante Rilavorazioni frequenti possono indicare proposte iniziali imprecise o negoziazioni prolungate, allungando il ciclo di vendita. Questo dato contribuisce direttamente all’indicatore KPI del tasso di rilavorazione dei preventivi e alle Dashboard di analisi della rilavorazione. Dove reperirli Si deduce rilevando la creazione di una nuova versione di un Quote o un aggiornamento significativo di un preventivo esistente, ad esempio il ripristino dello stato «Draft», dopo che il preventivo è già stato inviato al cliente. Acquisizione Individuare gli eventi «Preventivo creato» successivi o gli incrementi di versione per la stessa opportunità. Tipo di evento inferred
	Soluzione proposta	Indica che al cliente è stata presentata una soluzione o una proposta formale. Si deduce quando l’opportunità passa a una fase «Proposal» o «Presentation».
Perché è importante Monitorare questa fase aiuta ad analizzare il tempo necessario per sviluppare e proporre le soluzioni. È inoltre una fase chiave per l’indicatore KPI del tasso di opportunità bloccate, poiché le opportunità spesso vi rimangono a lungo. Dove reperirli Si deduce da una modifica del campo «Sales Stage» nell’oggetto Opportunity a un valore come «4 - Proposal» o «Presentation». Acquisizione Rilevare una modifica del campo della fase di vendita dell’opportunità allo stato di proposta. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i dati da Oracle CX Sales

Passaggi

Prerequisiti e autenticazione: verifichi di disporre di un account utente Oracle CX Sales con i privilegi necessari, ad esempio Sales Administrator o un ruolo equivalente, per accedere alle API REST di opportunità e preventivi. Richieda all’amministratore Oracle Cloud le credenziali client OAuth 2.0 (Client ID e Client Secret) per autenticare le richieste API e generare un token bearer.
Configurazione dell’ambiente: configuri un ambiente Node.js sul computer locale o su un server. Installi le librerie necessarie per inviare richieste HTTP e gestire file CSV. Apra un terminale ed esegua i comandi seguenti: npm install axios npm install json2csv
Individuazione degli endpoint API: gli endpoint principali per questa estrazione riguardano gli oggetti Opportunity e Quote. L’URL di base dipende dalla Sua istanza Oracle, ad esempio https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.com. Le risorse principali sono:

Opportunità: /salesApi/resources/latest/opportunities
Preventivi (oggetto figlio di Opportunity): /salesApi/resources/latest/opportunities/{OptyId}/child/Quote

Configurazione dello script di estrazione: copi il codice JavaScript fornito in un file, ad esempio extract.js. Aggiorni le variabili segnaposto all’inizio dello script con l’URL host di Oracle CX Cloud, il Client ID, il Client Secret e l’intervallo di date desiderato per l’estrazione.
Esecuzione dello script: esegua lo script dal terminale con il comando node extract.js. Lo script recupererà prima un token di autenticazione, quindi inizierà a richiedere le opportunità all’API, una pagina alla volta.
Recupero dei dati e paginazione: lo script gestisce automaticamente la paginazione dell’API. Richiede un numero prestabilito di opportunità per chiamata e utilizza il parametro offset per richiedere le pagine successive, finché non avrà recuperato tutte le opportunità comprese nell’intervallo di date specificato.
Recupero dei dati dei preventivi associati: per ogni opportunità recuperata, lo script effettua una seconda chiamata API per ottenere tutti i preventivi associati. Questi dati sono essenziali per generare attività relative ai preventivi, come 'Quote Created' e 'Quote Accepted'.
Trasformazione dei dati in Event Log: la logica principale dello script elabora ogni opportunità e i relativi preventivi. Trasforma i dati JSON gerarchici in un Event Log tabellare. Genera una riga distinta per ogni attività aziendale, deducendo gli eventi dai codici di stato, dalle fasi di vendita e dalle date di creazione, secondo necessità.
Gestione delle dipendenze da sistemi esterni: attività come 'Order Fulfilled', 'Invoice Generated' e 'Payment Received' si verificano in sistemi esterni. Lo script genera attività segnaposto per il passaggio dalle vendite all’evasione. Dovrà estrarre separatamente i dati dai sistemi ERP o finanziari e unirli all’Event Log utilizzando SalesOpportunity come chiave comune.
Esportazione in CSV: una volta recuperati e trasformati tutti i dati, lo script utilizza la libreria json2csv per convertire l’array finale di record dell’Event Log in un file CSV denominato oracle_cx_sales_event_log.csv. Il file verrà salvato nella stessa cartella da cui è stato eseguito lo script.
Preparazione al caricamento: riveda il file CSV generato per verificarne la correttezza e la completezza. Il file contiene le colonne richieste (SalesOpportunity, ActivityName, EventTime e così via) ed è pronto per essere caricato in ProcessMind per l’analisi.

Configurazione

URL host API: l’URL di base dell’ambiente Oracle CX Sales, ad esempio https://[your-instance].fa.us2.oraclecloud.com.
Autenticazione: lo script utilizza OAuth 2.0 con un Client ID e un Client Secret per l’autenticazione tra server. Queste credenziali devono essere configurate nelle impostazioni di gestione delle identità di Oracle Cloud.
Intervallo di date: lo script filtra le opportunità in base al campo LastUpdateDate. Per gestire il volume dei dati e il carico dell’API, si consiglia di iniziare con un periodo recente, ad esempio gli ultimi 3-6 mesi. Il formato deve essere YYYY-MM-DD.
Selezione dei campi: lo script utilizza il parametro di query fields per richiedere all’API solo i campi necessari. Questo migliora sensibilmente le prestazioni e riduce il traffico di rete. Se utilizza campi personalizzati, dovrà aggiungerli a questo parametro.
Limite di paginazione: il parametro limit determina quanti record vengono restituiti in una singola chiamata API. Lo script imposta il limite a 500, un valore massimo comune, per ridurre il numero di chiamate necessarie.
Privilegi richiesti: l’utente o le credenziali dell’applicazione OAuth utilizzati devono disporre dell’accesso in lettura alle risorse REST 'Opportunity' e 'Quote', inclusi tutti i campi standard e quelli personalizzati pertinenti.

Query di esempio javascript

const axios = require('axios');
const { Parser } = require('json2csv');
const fs = require('fs');

// --- Configuration --- //
const ORACLE_CX_HOST = 'https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.com';
const CLIENT_ID = '[Your Client ID]';
const CLIENT_SECRET = '[Your Client Secret]';
const START_DATE = '2023-01-01'; // YYYY-MM-DD
const END_DATE = '2023-06-30'; // YYYY-MM-DD
const PAGE_LIMIT = 500;
// --- End Configuration --- //

const tokenUrl = `${ORACLE_CX_HOST}/fscmRestApi/tokenrelay`;
const opportunitiesUrl = `${ORACLE_CX_HOST}/salesApi/resources/latest/opportunities`;

const getAuthToken = async () => {
    try {
        const response = await axios.post(tokenUrl, 'grant_type=client_credentials', {
            headers: {
                'Content-Type': 'application/x-www-form-urlencoded',
                'Authorization': `Basic ${Buffer.from(`${CLIENT_ID}:${CLIENT_SECRET}`).toString('base64')}`
            }
        });
        console.log('Successfully obtained authentication token.');
        return response.data.access_token;
    } catch (error) {
        console.error('Error fetching auth token:', error.response ? error.response.data : error.message);
        throw new Error('Authentication failed.');
    }
};

const fetchAllOpportunities = async (token) => {
    let allOpportunities = [];
    let hasMore = true;
    let offset = 0;

    console.log(`Fetching opportunities updated between ${START_DATE} and ${END_DATE}...`);

    while (hasMore) {
        const params = {
            q: `LastUpdateDate between '${START_DATE}' and '${END_DATE}'`,
            onlyData: true,
            limit: PAGE_LIMIT,
            offset: offset,
            fields: 'OptyId,CreationDate,LastUpdateDate,Name,SalesStage,StatusCode,RevnAmount,OwnerResourcePartyId,PrimaryContactPartyName,LossReasonCode,LeadId,OrganizationName,OptyNumber,OwnerName'
        };

        try {
            const response = await axios.get(opportunitiesUrl, { headers: { Authorization: `Bearer ${token}` }, params });
            const opportunities = response.data.items;
            if (opportunities && opportunities.length > 0) {
                allOpportunities.push(...opportunities);
                offset += opportunities.length;
                console.log(`Fetched ${opportunities.length} opportunities, total so far: ${allOpportunities.length}`);
            } else {
                 hasMore = false;
            }
            hasMore = response.data.hasMore;
        } catch (error) {
            console.error(`Error fetching opportunities at offset ${offset}:`, error.response ? error.response.data : error.message);
            hasMore = false; // Stop on error
        }
    }
    return allOpportunities;
};

const fetchQuotesForOpportunity = async (token, optyId) => {
    const quotesUrl = `${opportunitiesUrl}/${optyId}/child/Quote`;
    try {
        const response = await axios.get(quotesUrl, {
            headers: { Authorization: `Bearer ${token}` },
            params: { fields: 'QuoteId,CreationDate,LastUpdateDate,QuoteStatus,QuoteNumber', onlyData: true }
        });
        return response.data.items;
    } catch (error) {
        console.error(`Error fetching quotes for opportunity ${optyId}:`, error.response ? error.response.data : error.message);
        return [];
    }
};

const transformToEventLog = async (token, opportunities) => {
    const eventLog = [];
    const now = new Date().toISOString();

    for (const opp of opportunities) {
        const commonAttributes = {
            SalesOpportunity: opp.OptyNumber,
            SourceSystem: 'Oracle CX Sales',
            LastDataUpdate: now,
            OpportunityValue: opp.RevnAmount,
            SalesStage: opp.SalesStage,
            OpportunityOwner: opp.OwnerName,
            Region: opp.OrganizationName, // Example mapping, adjust as needed
            LossReason: opp.LossReasonCode
        };

        // Activity: Lead Converted To Opportunity
        if (opp.LeadId) {
            eventLog.push({ ...commonAttributes, ActivityName: 'Lead Converted To Opportunity', EventTime: opp.CreationDate });
        }
        
        // Inferred stage-based activities. Using LastUpdateDate as proxy.
        // A more accurate method requires audit trail data which is more complex to extract.
        const stageNumber = parseInt(opp.SalesStage?.split('-')[0], 10);
        if (stageNumber >= 2) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Qualified', EventTime: opp.LastUpdateDate });
        }
        if (stageNumber >= 3) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Needs Analysis Completed', EventTime: opp.LastUpdateDate });
        }
        if (stageNumber >= 4) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Solution Proposed', EventTime: opp.LastUpdateDate });
        }

        // Fetch and process quotes
        const quotes = await fetchQuotesForOpportunity(token, opp.OptyId);
        let quoteCreationCount = 0;
        for (const quote of quotes) {
            quoteCreationCount++;
            // Activity: Quote Created
            eventLog.push({ ...commonAttributes, ActivityName: 'Quote Created', EventTime: quote.CreationDate });
            // Activity: Quote Reworked (inferred from second or later quote creation)
            if (quoteCreationCount > 1) {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Reworked', EventTime: quote.CreationDate });
            }
            // Activity: Quote Sent To Customer
            if (['PRESENTED', 'SENT'].includes(quote.QuoteStatus)) {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Sent To Customer', EventTime: quote.LastUpdateDate });
            }
            // Activity: Quote Accepted By Customer
            if (quote.QuoteStatus === 'ACCEPTED') {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Accepted By Customer', EventTime: quote.LastUpdateDate });
            }
        }

        // Final Opportunity Status activities
        if (opp.StatusCode === 'WON') {
            eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Won', EventTime: opp.LastUpdateDate });
            // Activity: Order Submitted For Fulfillment (inferred from Opportunity Won)
            eventLog.push({ ...commonAttributes, ActivityName: 'Order Submitted For Fulfillment', EventTime: opp.LastUpdateDate });
            
            // Placeholder for events from external systems. Data should be merged from other sources.
            // eventLog.push({ ...commonAttributes, ActivityName: 'Order Fulfilled', EventTime: [Timestamp from ERP] });
            // eventLog.push({ ...commonAttributes, ActivityName: 'Invoice Generated', EventTime: [Timestamp from Financials] });
            // eventLog.push({ ...commonAttributes, ActivityName: 'Payment Received', EventTime: [Timestamp from Financials] });

        } else if (opp.StatusCode === 'LOST') {
            eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Lost', EventTime: opp.LastUpdateDate });
        }
    }
    return eventLog;
};

const main = async () => {
    try {
        const token = await getAuthToken();
        const opportunities = await fetchAllOpportunities(token);
        console.log(`Total opportunities to process: ${opportunities.length}`);

        if (opportunities.length > 0) {
            console.log('Transforming data into event log...');
            const eventLog = await transformToEventLog(token, opportunities);
            console.log(`Generated ${eventLog.length} event records.`);
            
            const parser = new Parser();
            const csv = parser.parse(eventLog);
            fs.writeFileSync('oracle_cx_sales_event_log.csv', csv);
            console.log('Event log saved to oracle_cx_sales_event_log.csv');
        }
    } catch (error) {
        console.error('An error occurred during the extraction process:', error.message);
    }
};

main();

Passaggi

Preparazione dell’ambiente Python: verifichi che Python sia installato nel sistema. Installi le librerie necessarie con pip: pip install requests pandas.
Ottenimento delle credenziali API: acceda alla Sua istanza Oracle CX Sales con un account amministratore. Apra Security Console (Navigator > Tools > Security Console) e crei un nuovo utente con il ruolo 'Sales Representative' o con un ruolo di integrazione personalizzato. L’utente deve poter accedere tramite API a salesLeads, opportunities, quotes e agli oggetti correlati. Annoti il nome utente e la password.
Individuazione del dominio Oracle CX: individui l’URL del dominio specifico di Oracle CX Sales, che in genere segue il formato https://[your-pod-name].fa.em2.oraclecloud.com.
Configurazione dello script: apra lo script Python fornito in un editor. Sostituisca i valori segnaposto di ORACLE_CX_DOMAIN, USERNAME, PASSWORD, START_DATE e END_DATE con le credenziali effettive e l’intervallo di date desiderato per l’estrazione.
Personalizzazione degli endpoint API e dei campi: riveda le chiamate API contenute nello script. I campi richiesti, ad esempio OptyId, Nome, SalesStage e StatusCode, sono standard. Se utilizza campi personalizzati, identificati dal suffisso _c, importanti per l’analisi, li aggiunga al parametro fields nelle richieste API pertinenti.
Integrazione con i sistemi esterni: lo script include funzioni segnaposto (get_order_data_from_erp, get_invoice_data_from_finance, get_payment_data_from_finance) per le attività che avvengono al di fuori di Oracle CX Sales. Dovrà sostituire la logica segnaposto con chiamate API effettive ai sistemi ERP e finanziari, per recuperare i dati relativi agli eventi Order Submitted, Order Fulfilled, Invoice Generated e Payment Received. Questa integrazione è essenziale per ottenere una visione completa del processo Lead to Cash.
Esecuzione dello script: esegua lo script dalla riga di comando con python your_script_name.py. Lo script effettuerà una serie di chiamate API a Oracle CX Sales, elaborerà i dati e li riunirà in un unico Event Log.
Revisione dell’output: lo script genererà un file denominato lead_to_cash_event_log.csv. Lo apra con un’applicazione per fogli di calcolo e ne verifichi la struttura e i contenuti. Controlli che siano presenti le colonne previste: SalesOpportunity, ActivityName, EventTime, SourceSystem e così via.
Gestione della paginazione API: lo script fornito include un ciclo di paginazione di base. Per insiemi di dati molto grandi, potrebbe essere necessario aggiungere una gestione degli errori più robusta o brevi pause tra le richieste, per evitare di superare i limiti di frequenza dell’API.
Preparazione al caricamento: il file CSV finale è strutturato per essere caricato direttamente in ProcessMind. Verifichi che le intestazioni delle colonne corrispondano alla mappatura del progetto ProcessMind. Non dovrebbe essere necessaria un’ulteriore formattazione.

Configurazione

Credenziali API: è necessario un utente API dedicato con privilegi sufficienti per leggere gli oggetti Sales Lead, Sales Opportunity e Quote. L’accesso deve includere i dati storici o le tracce di audit delle modifiche a stati e fasi.
Dominio Oracle CX: nello script deve essere specificato correttamente l’URL di base dell’istanza Oracle CX Sales.
Intervallo di date: imposti nello script le variabili START_DATE e END_DATE per definire il periodo di estrazione. Per l’analisi iniziale si consiglia un intervallo di 3-6 mesi, così da bilanciare il volume dei dati e le prestazioni.
Filtri sulle opportunità: è possibile personalizzare lo script per filtrare le opportunità in base a criteri specifici. Ad esempio, può aggiungere parametri di query all’URL dell’API per filtrare in base a Organization_Id o a campi personalizzati, limitando l’estrazione a determinate unità aziendali o tipologie di opportunità.
Endpoint dei sistemi esterni: dovrà specificare gli endpoint API effettivi, le credenziali e la logica dei sistemi ERP e finanziari per estrarre i dati di ordini, fatture e pagamenti. Lo script presuppone che sia possibile correlare questi sistemi utilizzando l’ID dell’opportunità di vendita o un ID ordine associato.
Limite di paginazione: nelle chiamate API il parametro limit è impostato su 100. È possibile modificarlo, ma valori più elevati possono aumentare il rischio di timeout per le query complesse.

Query di esempio python

import requests
import pandas as pd
from requests.auth import HTTPBasicAuth
import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Oracle CX Sales domain, username, and password
ORACLE_CX_DOMAIN = class="hl-string">"https://[your-pod-name].fa.em2.oraclecloud.com"
USERNAME = class="hl-string">"[Your_API_Username]"
PASSWORD = class="hl-string">"[Your_API_Password]"

class=class="hl-string">"hl-comment"># Define the date range for the extraction (YYYY-MM-DD format)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># --- Helper Function for API Calls ---
def fetch_all_pages(endpoint, q_filter):
    all_items = []
    url = fclass="hl-string">"{ORACLE_CX_DOMAIN}/salesApi/resources/latest/{endpoint}"
    params = {
        class="hl-string">'q': q_filter,
        class="hl-string">'onlyData': class="hl-string">'true',
        class="hl-string">'limit': 100, class=class="hl-string">"hl-comment"># Max records per page
        class="hl-string">'offset': 0
    }
    
    while True:
        try:
            response = requests.get(url, auth=HTTPBasicAuth(USERNAME, PASSWORD), params=params)
            response.raise_for_status()
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            if not items:
                break
            all_items.extend(items)
            if data.get(class="hl-string">'hasMore', False):
                params[class="hl-string">'offset'] += params[class="hl-string">'limit']
            else:
                break
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching {url}: {e}")
            break
    return all_items

class=class="hl-string">"hl-comment"># --- Placeholder Functions for External Systems ---
def get_order_data_from_erp(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your ERP system.
    class=class="hl-string">"hl-comment"># This function should return a list of dictionaries.
    class=class="hl-string">"hl-comment"># Each dictionary should have class="hl-string">'OptyId', class="hl-string">'EventTime', class="hl-string">'ActivityName'.
    print(class="hl-string">"Fetching placeholder Order data from ERP...")
    placeholder_data = []
    class=class="hl-string">"hl-comment"># Example: placeholder_data.append({class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-25T10:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Order Submitted For Fulfillment'})
    class=class="hl-string">"hl-comment"># Example: placeholder_data.append({class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-28T14:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Order Fulfilled'})
    return placeholder_data

def get_invoice_data_from_finance(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your financial system.
    print(class="hl-string">"Fetching placeholder Invoice data...")
    return [] class=class="hl-string">"hl-comment"># Example: [{class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-29T11:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Invoice Generated'}]

def get_payment_data_from_finance(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your financial system.
    print(class="hl-string">"Fetching placeholder Payment data...")
    return [] class=class="hl-string">"hl-comment"># Example: [{class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-11-15T09:30:00Z', class="hl-string">'ActivityName': class="hl-string">'Payment Received'}]


class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
print(class="hl-string">"Starting Lead to Cash extraction...")

class=class="hl-string">"hl-comment"># 1. Fetch all relevant opportunities within the date range
date_filter = fclass="hl-string">"LastUpdateDate between '{START_DATE}' and '{END_DATE}'"
opportunities = fetch_all_pages(class="hl-string">'opportunities', date_filter)

if not opportunities:
    print(class="hl-string">"No opportunities found for the given date range. Exiting.")
    exit()

print(fclass="hl-string">"Found {len(opportunities)} opportunities to process.")
opp_ids = [opp[class="hl-string">'OptyId'] for opp in opportunities]

class=class="hl-string">"hl-comment"># DataFrame to hold all events
event_log_df = pd.DataFrame()

class=class="hl-string">"hl-comment"># 2. Extract activities from Opportunity and related objects
all_events = []

for opp in opportunities:
    opp_id = opp[class="hl-string">'OptyId']
    last_update = datetime.datetime.now().isoformat()

    base_attributes = {
        class="hl-string">'SalesOpportunity': opp_id,
        class="hl-string">'OpportunityValue': opp.get(class="hl-string">'Revenue'),
        class="hl-string">'SalesStage': opp.get(class="hl-string">'SalesStage'),
        class="hl-string">'OpportunityOwner': opp.get(class="hl-string">'OwnerResourcePartyName'),
        class="hl-string">'Region': opp.get(class="hl-string">'TerritoryName_c'), class=class="hl-string">"hl-comment"># Example custom field
        class="hl-string">'LossReason': opp.get(class="hl-string">'ReasonWonLostCode'),
        class="hl-string">'SourceSystem': class="hl-string">'Oracle CX Sales',
        class="hl-string">'LastDataUpdate': last_update
    }
    
    class=class="hl-string">"hl-comment"># Activity: Lead Converted To Opportunity (inference)
    if opp.get(class="hl-string">'PrimaryContactEmailAddress') and opp.get(class="hl-string">'SalesMethod') != class="hl-string">'Renewal': class=class="hl-string">"hl-comment"># Heuristic for lead-based opportunities
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Lead Converted To Opportunity', class="hl-string">'EventTime': opp.get(class="hl-string">'CreationDate')})
        
    class=class="hl-string">"hl-comment"># Activities from Sales Stage history
    stage_history = opp.get(class="hl-string">'ChildSalesStage', [])
    for stage in stage_history:
        stage_name = stage.get(class="hl-string">'SalesStageCode')
        event_time = stage.get(class="hl-string">'LastUpdateDate')
        activity = None
        if stage_name in [class="hl-string">'01-QUALIFICATION', class="hl-string">'QUALIFIED']: activity = class="hl-string">'Opportunity Qualified'
        elif stage_name in [class="hl-string">'02-DISCOVERY', class="hl-string">'ANALYSIS']: activity = class="hl-string">'Needs Analysis Completed'
        elif stage_name in [class="hl-string">'03-PROPOSAL', class="hl-string">'SOLUTION_PROPOSED']: activity = class="hl-string">'Solution Proposed'
        
        if activity:
            all_events.append({**base_attributes, class="hl-string">'ActivityName': activity, class="hl-string">'EventTime': event_time})

    class=class="hl-string">"hl-comment"># Activities: Opportunity Won / Lost
    if opp.get(class="hl-string">'StatusCode') == class="hl-string">'WON':
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Opportunity Won', class="hl-string">'EventTime': opp.get(class="hl-string">'LastUpdateDate')})
    elif opp.get(class="hl-string">'StatusCode') == class="hl-string">'LOST':
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Opportunity Lost', class="hl-string">'EventTime': opp.get(class="hl-string">'LastUpdateDate')})

    class=class="hl-string">"hl-comment"># Activities from Quotes
    quotes = opp.get(class="hl-string">'ChildQuote', [])
    quote_creation_dates = []
    for quote in quotes:
        quote_creation_dates.append(quote.get(class="hl-string">'CreationDate'))
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Created', class="hl-string">'EventTime': quote.get(class="hl-string">'CreationDate')})
        
        class=class="hl-string">"hl-comment"># Infer other quote events from status or custom date fields
        if quote.get(class="hl-string">'QuoteStatus_c') == class="hl-string">'SENT' and quote.get(class="hl-string">'DateSent_c'):
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Sent To Customer', class="hl-string">'EventTime': quote.get(class="hl-string">'DateSent_c')})
        if quote.get(class="hl-string">'QuoteStatus_c') == class="hl-string">'ACCEPTED' and quote.get(class="hl-string">'DateAccepted_c'):
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Accepted By Customer', class="hl-string">'EventTime': quote.get(class="hl-string">'DateAccepted_c')})
    
    class=class="hl-string">"hl-comment"># Activity: Quote Reworked (inference)
    if len(quote_creation_dates) > 1:
        class=class="hl-string">"hl-comment"># Mark all but the first creation as a rework event
        sorted_dates = sorted(quote_creation_dates)
        for rework_date in sorted_dates[1:]:
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Reworked', class="hl-string">'EventTime': rework_date})

class=class="hl-string">"hl-comment"># 3. Add data from external systems
print(class="hl-string">"Fetching data from external systems...")
order_events = get_order_data_from_erp(opp_ids)
invoice_events = get_invoice_data_from_finance(opp_ids)
payment_events = get_payment_data_from_finance(opp_ids)

external_system_events = []
last_update = datetime.datetime.now().isoformat()

for event in order_events + invoice_events + payment_events:
    opp_id = event[class="hl-string">'OptyId']
    class=class="hl-string">"hl-comment"># Find the corresponding opportunity to get base attributes
    opp_data = next((item for item in opportunities if item[class="hl-string">"OptyId"] == opp_id), None)
    if opp_data:
         base_attributes = {
            class="hl-string">'SalesOpportunity': opp_id,
            class="hl-string">'OpportunityValue': opp_data.get(class="hl-string">'Revenue'),
            class="hl-string">'SalesStage': opp_data.get(class="hl-string">'SalesStage'),
            class="hl-string">'OpportunityOwner': opp_data.get(class="hl-string">'OwnerResourcePartyName'),
            class="hl-string">'Region': opp_data.get(class="hl-string">'TerritoryName_c'),
            class="hl-string">'LossReason': opp_data.get(class="hl-string">'ReasonWonLostCode'),
            class="hl-string">'SourceSystem': class="hl-string">'ERP/Finance',
            class="hl-string">'LastDataUpdate': last_update
        }
    else:
        base_attributes = {class="hl-string">'SalesOpportunity': opp_id, class="hl-string">'SourceSystem': class="hl-string">'ERP/Finance', class="hl-string">'LastDataUpdate': last_update}
    
    external_system_events.append({**base_attributes, class="hl-string">'ActivityName': event[class="hl-string">'ActivityName'], class="hl-string">'EventTime': event[class="hl-string">'EventTime']})

all_events.extend(external_system_events)

class=class="hl-string">"hl-comment"># 4. Finalize the DataFrame
if all_events:
    event_log_df = pd.DataFrame(all_events)
    class=class="hl-string">"hl-comment"># Standardize column names
    event_log_df = event_log_df.rename(columns={class="hl-string">'ActivityName': class="hl-string">'ActivityName', class="hl-string">'EventTime': class="hl-string">'EventTime'})
    
    class=class="hl-string">"hl-comment"># Ensure required columns exist
    required_cols = [class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate', class="hl-string">'OpportunityValue', class="hl-string">'SalesStage', class="hl-string">'OpportunityOwner', class="hl-string">'Region', class="hl-string">'LossReason']
    for col in required_cols:
        if col not in event_log_df.columns:
            event_log_df[col] = None
            
    class=class="hl-string">"hl-comment"># Select and order columns
    event_log_df = event_log_df[required_cols]
    
    class=class="hl-string">"hl-comment"># Clean up and sort
    event_log_df = event_log_df.dropna(subset=[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTime'])
    event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'])
    event_log_df = event_log_df.sort_values(by=[class="hl-string">'SalesOpportunity', class="hl-string">'EventTime'])
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'lead_to_cash_event_log.csv'
    event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")
else:
    print(class="hl-string">"No events were generated.")

È pronto a iniziare?

Utilizzi questo template per preparare i dati con sicurezza e iniziare a individuare informazioni utili sul processo Lead to Cash. Inizi oggi a ottimizzare le operazioni per ottenere la massima efficienza.

Torna alla guida al miglioramento

Scarica il template

Aumenti oggi del 20% il tasso di successo del processo Lead to Cash

Individui i colli di bottiglia, eviti di perdere opportunità e aumenti del 20% il tasso di successo.

Inizi la prova gratuita

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

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

Estrazione diretta tramite query dell’API REST di Oracle CX Sales

Passaggi

Configurazione

Query di esempio javascript

Script Python che utilizza l’API REST di Oracle CX Sales

Passaggi

Configurazione

Query di esempio python

È pronto a iniziare?

Aumenti oggi del 20% il tasso di successo del processo Lead to Cash