> Miglioramento continuo dei processi > Lead to Cash > Oracle CX Sales > Template dei dati

Il Suo Template dati Lead to Cash

Oracle CX Sales

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

Il Suo Template dati Lead to Cash

Questo Template La guida nella preparazione dei dati Lead to Cash per il Process Mining. Descrive gli attributi essenziali da raccogliere e le attività principali da monitorare, offrendo inoltre indicazioni utili per estrarre queste informazioni da Oracle CX Sales. Seguendo questo Template, potrà garantire 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 l’estrazione dei 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 un’analisi completa del processo Lead to Cash.

5 Obbligatorio 5 Consigliato 10 Facoltativo

	Nome	Descrizione
	Nome dell’attività ActivityName	Il nome dell’attività aziendale o dell’evento che si è verificato in un determinato momento per una Sales Opportunity.
Descrizione Questo Attributo descrive un passaggio o un traguardo specifico del processo Lead to Cash, come «Lead Converted To Opportunity», «Quote Created» o «Payment Received». Queste attività costituiscono gli elementi fondamentali della mappa del processo. Analizzare la sequenza e la frequenza di queste attività aiuta a visualizzare il flusso del processo, individuare i percorsi comuni e alternativi e rilevare deviazioni o colli di bottiglia. Costituisce inoltre la base per misurare i tempi di transizione tra i passaggi e comprendere come viene effettivamente svolto il lavoro. Perché è importante Questo Attributo è fondamentale per costruire la mappa del processo e comprendere la sequenza degli eventi nel ciclo di vita commerciale. Dove reperirlo In genere deriva da modifiche di stato, Event Log o 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	L’identificativo univoco di una Sales Opportunity, che funge da Case ID per il processo Lead to Cash.
Descrizione La Sales Opportunity è l’oggetto centrale che monitora una potenziale trattativa generatrice di ricavi, dalla fase iniziale di lead fino all’esito finale positivo o negativo. Collega tutte le attività correlate, come qualificazione, preventivazione, ordinazione e pagamento. Nell’analisi di Process Mining, questo identificativo è fondamentale per ricostruire il percorso end-to-end di ogni trattativa. Consente di analizzare l’intero ciclo di vita, inclusi i tempi di attraversamento tra le fasi, i tassi di conversione e i percorsi che portano a esiti positivi rispetto a quelli che conducono alla perdita della trattativa. Perché è importante È il Case ID essenziale che collega tutti gli eventi del processo, consentendo una visione completa e accurata dell’intero ciclo di vita commerciale di ogni potenziale trattativa. Dove reperirlo È un identificativo primario nell’oggetto Oracle CX Sales Opportunity. Esempi OPP-0012345OPP-0023456OPP-0034567
	Ora dell’evento EventTime	Il timestamp che indica quando si è verificata una specifica attività o un determinato evento.
Descrizione L’Event Time è la data e l’ora in cui un’attività è stata registrata. È essenziale per ordinare cronologicamente gli eventi e calcolare la durata tra i diversi passaggi del processo. Questo timestamp costituisce la base di tutte le analisi basate sul tempo, inclusi il calcolo dei tempi di attraversamento, l’identificazione dei colli di bottiglia attraverso la misurazione dei tempi di attesa e il monitoraggio delle prestazioni rispetto agli accordi sui livelli di servizio. Timestamp accurati sono fondamentali per un’analisi di Process Mining affidabile. Perché è importante Fornisce l’ordine cronologico degli eventi, essenziale per calcolare tutte le metriche di prestazione, come tempi di attraversamento e durate. Dove reperirlo Corrisponde alla data di creazione o alla data dell’ultimo aggiornamento dei record relativi ad attività specifiche, come i timestamp delle modifiche di stato. Esempi 2023-04-15T10:00:00Z2023-05-01T14:30:00Z2023-05-20T09:15:00Z
	Sistema sorgente SourceSystem	Il sistema dal quale sono stati estratti i dati.
Descrizione Questo Attributo identifica l’origine dei dati di processo, che in questo contesto è Oracle CX Sales. Negli ambienti con più sistemi, questo campo aiuta a distinguere le fonti dei dati. Ai fini dell’analisi, fornisce il contesto sull’origine dei dati, un elemento importante quando si combinano dati provenienti da più sistemi o si analizzano comportamenti specifici di un sistema. È un campo standard per la governance e la tracciabilità dei dati. Perché è importante Fornisce il contesto essenziale sull’origine dei dati, garantendo la tracciabilità e aiutando a gestire dati potenzialmente provenienti da più sistemi integrati. Dove reperirlo In genere è un valore statico aggiunto durante il processo di estrazione dei dati per identificare la fonte dei dati. Esempi Oracle CX Sales
	Ultimo aggiornamento dei dati LastDataUpdate	Il timestamp dell’ultimo aggiornamento o dell’ultima estrazione dei dati dal sistema sorgente.
Descrizione Questo Attributo indica l’aggiornamento dei dati analizzati. Mostra la data e l’ora dell’ultimo prelievo di dati da Oracle CX Sales. Nei Dashboard e nei report, questo timestamp è fondamentale per informare gli utenti sulla tempestività dei dati visualizzati. Aiuta a comprendere se le attività più recenti sono incluse nell’analisi. Perché è importante Informa gli utenti sull’aggiornamento dei dati, un elemento fondamentale per interpretare i Dashboard e prendere decisioni consapevoli. Dove reperirlo Questo timestamp 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	La fase attuale della Sales Opportunity all’interno della pipeline di vendita.
Descrizione La Sales Stage indica l’avanzamento di un’opportunità nel processo di vendita definito, con valori come «Qualification», «Solution Proposed» o «Negotiation». È un Attributo chiave per comprendere lo stato di un’opportunità in qualsiasi momento. Questo Attributo è fondamentale per creare visualizzazioni del funnel di vendita e per il Dashboard «Stalled Opportunity Stage Analysis». Analizzando il tempo trascorso in ogni fase, i team possono individuare i punti in cui le trattative rallentano e concentrare gli sforzi per sbloccare la pipeline. Perché è importante È fondamentale per l’analisi del funnel di vendita e per individuare i colli di bottiglia nei quali le opportunità rimangono frequentemente bloccate o vengono perse. Dove reperirlo È un campo standard dell’oggetto Opportunity in Oracle CX Sales, spesso denominato «SalesStage» o «StageName». Esempi 01 - Qualificazione03 - Proposta05 - NegoziazioneChiusa con esito positivo
	Motivo della perdita LossReason	Il motivo indicato per la perdita di un’opportunità.
Descrizione Quando un’opportunità viene chiusa senza una vendita, Loss Reason registra la causa principale, ad esempio «Lost to Competitor», «Price» o «No Decision». Queste informazioni sono fondamentali per l’analisi strategica e il miglioramento del processo. Questo Attributo costituisce il fulcro del Dashboard «Opportunity Loss & Drop-Off Reasons». Analizzare i motivi della perdita insieme alla fase in cui si è verificata aiuta le aziende a comprendere le proprie debolezze competitive e a perfezionare la strategia di vendita, l’offerta di prodotti o i modelli di prezzo. Perché è importante Fornisce insight fondamentali sui motivi per cui le trattative non vengono vinte, consentendo miglioramenti strategici al processo di vendita e all’offerta di prodotti. Dove reperirlo È un campo standard acquisito 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	La regione geografica o il territorio commerciale associato all’opportunità.
Descrizione L’Attributo Region classifica le opportunità in base alla posizione geografica, ad esempio «North America», «EMEA» o «APAC». È una dimensione comune per segmentare le prestazioni aziendali. Questo Attributo è essenziale per il Dashboard «Regional Sales Performance Benchmarks». Consente di confrontare metriche chiave come durata del ciclo di vendita, tassi di conversione e varianti di processo tra regioni diverse, individuando le aree più performanti e quelle che richiedono miglioramenti mirati. Perché è importante Consente di confrontare le prestazioni del processo tra diverse aree geografiche, facendo emergere variazioni regionali e best practice. Dove reperirlo Spesso disponibile come campo standard o personalizzato sull’oggetto Account o Opportunity in Oracle CX Sales. Esempi Nord AmericaEMEAAPACLATAM
	Responsabile dell’opportunità OpportunityOwner	Il rappresentante commerciale principalmente responsabile della Sales Opportunity.
Descrizione L’Opportunity Owner è l’utente assegnato alla gestione e alla conclusione della trattativa. Questo Attributo consente di analizzare le prestazioni a livello individuale o di team. Nel Process Mining, filtrare per Opportunity Owner può far emergere modalità operative, benchmark di prestazione e livelli di conformità al processo di vendita standard differenti. Aiuta i responsabili delle vendite a individuare opportunità di coaching e a comprendere come i migliori performer gestiscono il ciclo di vendita. Perché è importante Consente di analizzare le prestazioni per rappresentante commerciale o team, aiutando a individuare le best practice e le aree in cui è necessario il coaching. Dove reperirlo Disponibile come campo standard «Owner» o «AssignedTo» sull’oggetto Opportunity in Oracle CX Sales. Esempi John SmithJane DoePeter Jones
	Valore dell’opportunità OpportunityValue	Il valore monetario stimato o effettivo della Sales Opportunity.
Descrizione Questo Attributo rappresenta i ricavi potenziali o finali associati a una Sales Opportunity. Può essere utilizzato per segmentare e assegnare priorità alle opportunità durante il loro ciclo di vita. Nel Process Mining, analizzare il valore dell’opportunità aiuta a comprendere in che modo le diverse varianti di processo incidano sulle trattative di valore elevato rispetto a quelle di valore ridotto. È essenziale per i Dashboard che monitorano la dispersione dei ricavi, come l’analisi «Opportunity Loss & Drop-Off Reasons», correlando i percorsi di processo agli esiti finanziari. Perché è importante Consente di quantificare l’impatto finanziario delle inefficienze di processo e aiuta ad assegnare priorità alle opportunità e alle iniziative di miglioramento. Dove reperirlo È probabilmente disponibile in un campo come «Revenue» o «Amount» sull’oggetto Opportunity in Oracle CX Sales. Esempi 50000.00125000.0025000.00
	È in stallo IsStalled	Un indicatore che segnala se un’opportunità è rimasta nella stessa fase di vendita per un periodo eccessivamente lungo.
Descrizione Questo attributo è un indicatore booleano impostato su 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 «Stalled Opportunity Rate» ed è essenziale per la Dashboard «Stalled Opportunity Stage Analysis». Individuare le trattative in stallo consente ai responsabili commerciali di intervenire in modo proattivo, fornire supporto e migliorare la velocità complessiva della pipeline di vendita. Perché è importante Aiuta a individuare in anticipo le trattative a rischio di perdita a causa dell’inattività, consentendo un intervento tempestivo. Dove reperirlo Viene calcolato misurando il tempo tra eventi consecutivi di un caso e confrontandolo con una soglia definita. Esempi truefalse
	È una rilavorazione del preventivo IsQuoteRework	Un indicatore che segnala se un preventivo è stato rilavorato o creato più di una volta per la stessa opportunità.
Descrizione Questo attributo booleano è impostato su true se, per una singola opportunità di vendita, si verifica un’attività come «Quote Reworked» oppure un secondo evento «Quote Created». Aiuta a isolare i casi di inefficienza del processo nella fase di preventivazione. Questo indicatore viene utilizzato per calcolare il KPI «Quote Rework Rate» e alimentare la Dashboard «Process Deviation & Rework Analysis». Evidenziare le rilavorazioni aiuta a individuare i problemi nella raccolta iniziale dei requisiti, nella definizione dei prezzi o nella configurazione del prodotto, che comportano attività aggiuntive e ritardi. Perché è importante Segnala direttamente i casi di inefficienza e deviazione nel processo di preventivazione, aiutando a individuare le cause alla radice dei ritardi e delle attività ripetute. Dove reperirlo Viene calcolato analizzando l’event log. È true se l’attività «Quote Created» o «Quote Reworked» compare più di una volta per una determinata Sales Opportunity. Esempi truefalse
	Fattura prima dell’evasione InvoiceBeforeFulfillment	Un indicatore che segnala se una fattura è stata generata prima dell’evasione dell’ordine.
Descrizione Questo attributo booleano è impostato su true se, per un determinato caso, l’evento «Invoice Generated» si verifica prima dell’evento «Order Fulfilled». Rappresenta un percorso di processo non conforme o rischioso. Questo attributo supporta direttamente il KPI «Invoice Before Fulfillment Rate» e viene utilizzato nelle Dashboard di conformità del processo. Monitorare questa deviazione aiuta le organizzazioni a garantire procedure di fatturazione corrette, ridurre le contestazioni dei clienti e mitigare i rischi legati alla rilevazione dei ricavi. Perché è importante Segnala una violazione critica della conformità del processo, nella quale i clienti vengono fatturati prima dell’evasione dell’ordine, con possibili conseguenze sulla soddisfazione del cliente e rischi finanziari. Dove reperirlo Viene calcolato confrontando i timestamp delle attività «Invoice Generated» e «Order Fulfilled» all’interno dello stesso caso. Esempi truefalse
	ID fattura InvoiceId	L’identificativo univoco della fattura generata per un ordine di vendita.
Descrizione L’Invoice ID è il numero di riferimento del documento di fatturazione inviato al cliente dopo l’evasione dell’ordine. Rappresenta il documento principale nelle fasi finanziarie finali del processo. Questo identificativo è essenziale per analizzare l’«Invoice Generation Cycle Time» e il «Payment Collection Cycle». Consente di monitorare ogni fattura dalla creazione al pagamento finale, un’attività fondamentale per controllare il flusso di cassa e le prestazioni della gestione dei crediti commerciali. Perché è importante Monitora la transazione finanziaria finale, essenziale per analizzare i tempi del ciclo di fatturazione e l’efficienza della riscossione dei pagamenti. Dove reperirlo Consulti la documentazione di Oracle CX Sales o del sistema ERP/finanziario integrato per individuare l’identificativo dell’oggetto Invoice. Esempi INV-2023-001INV-2023-002INV-2023-003
	ID ordine OrderId	L’identificativo univoco dell’ordine di vendita creato a partire da un’opportunità vinta.
Descrizione L’Order ID è il riferimento dell’ordine di vendita ufficiale inviato per l’evasione dopo che il cliente ha accettato il preventivo e l’opportunità è stata vinta. Segna un passaggio fondamentale dalle vendite alle operations. Questo identificativo è essenziale per monitorare il processo a partire dall’attività «Order Submitted For Fulfillment». Collega la fase commerciale a quella di evasione dell’ordine nel ciclo Lead to Cash, consentendo un’analisi end-to-end dei tempi di elaborazione ed evasione. Perché è importante Collega l’opportunità di vendita al processo di evasione, consentendo una reale analisi end-to-end, dalla lead alla consegna finale. Dove reperirlo Consulti la documentazione di Oracle CX Sales o del sistema ERP integrato per individuare l’identificativo principale dell’oggetto Sales Order. Esempi SO-554433SO-554434SO-554435
	ID preventivo QuoteId	L’identificativo univoco del preventivo di vendita associato a un’opportunità.
Descrizione Il Quote ID è 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 quando sono necessarie rilavorazioni. Il monitoraggio di questo identificativo è importante per analizzare il «Quote-to-Order Cycle Time» e il «Quote Rework Rate». Consente di misurare con precisione il tempo che intercorre dall’emissione del preventivo alla sua accettazione e di distinguere i preventivi iniziali dalle versioni revisionate. Perché è importante Identifica in modo univoco i preventivi di vendita e consente un’analisi accurata del ciclo di preventivazione, comprese le rilavorazioni e i tempi di conversione. Dove reperirlo È l’identificativo principale dell’oggetto Quote in Oracle CX Sales, collegato all’Opportunity. Esempi QUO-98765QUO-98766QUO-98767
	Nome cliente CustomerName	Il nome del cliente o dell’account associato all’opportunità di vendita.
Descrizione Questo attributo identifica il cliente potenziale o esistente associato alla trattativa. Rappresenta una dimensione fondamentale per segmentare e analizzare il processo di vendita. Il filtro per cliente consente di analizzare in dettaglio il percorso di vendita di account specifici, un’informazione utile per la gestione dei key account. Permette inoltre di segmentare le prestazioni del processo in base alle dimensioni del cliente, al settore o ad altre caratteristiche, così da personalizzare l’approccio commerciale. Perché è importante Consente di segmentare l’analisi del processo per cliente, un elemento fondamentale per comprendere i comportamenti specifici dei clienti e gestire i key account. Dove reperirlo L’Account Name collegato all’oggetto Opportunity in Oracle CX Sales. Esempi Global Tech Inc.Innovate Solutions LLCPioneer Corp
	Nome prodotto ProductName	Il prodotto o servizio principale venduto nell’ambito dell’opportunità.
Descrizione Questo attributo specifica il prodotto o la famiglia di prodotti associata all’opportunità di vendita. Nel caso di opportunità con più prodotti, può rappresentare il prodotto principale di interesse oppure essere ripetuto per ogni voce della riga prodotto. L’analisi dei flussi di processo per prodotto può evidenziare se determinati prodotti presentano cicli di vendita più lunghi o complessi. Queste informazioni possono orientare le strategie commerciali specifiche per prodotto, la formazione e le iniziative di ottimizzazione del processo. Perché è importante Consente di analizzare come il processo di vendita varia a seconda dei prodotti o servizi, mettendo in evidenza i colli di bottiglia specifici del prodotto. Dove reperirlo Si trova nell’oggetto Product, collegato tramite Opportunity Product Line Item in Oracle CX Sales. Esempi Licenza CRM EnterpriseLivello 1 di archiviazione cloudPacchetto di servizi professionali
	Nome utente UserName	L’utente che ha eseguito una specifica attività o un determinato evento.
Descrizione Questo Attributo identifica la persona specifica che ha eseguito un’attività, come «Quote Created» o «Order Submitted». Mentre l’Opportunity Owner è responsabile della trattativa nel suo complesso, User Name indica chi ha eseguito le singole azioni. Questo livello di dettaglio è utile per comprendere l’allocazione delle risorse, la distribuzione dei carichi di lavoro e il rispetto di ruoli e responsabilità. Può aiutare a individuare se determinati utenti costituiscono colli di bottiglia del processo o se alcune attività vengono gestite sistematicamente da personale non autorizzato. Perché è importante Tiene traccia di chi ha eseguito ogni singola azione, consentendo un’analisi dettagliata dei carichi di lavoro e la verifica delle attività. Dove reperirlo In genere si trova nei campi «CreatedBy» o «LastUpdatedBy» degli oggetti correlati alle attività in Oracle CX Sales. Esempi Alice WilliamsBob BrownCharlie Davis
	Percentuale di sconto DiscountPercentage	La 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 «Average Discount Utilization». Aiuta le aziende a comprendere l’impatto degli sconti sui margini e può evidenziare se gli sconti vengono applicati in modo incoerente o senza la necessaria approvazione, facendo emergere potenziali problemi nel Workflow di approvazione dei preventivi. Perché è importante Aiuta ad analizzare la redditività e l’efficacia delle strategie di sconto, oltre a individuare eventuali sconti non controllati. Dove reperirlo Consulti la documentazione di Oracle CX Sales per individuare un campo relativo allo sconto negli oggetti Quote o Opportunity Product Line Item. Esempi 0.050.100.150.20

Obbligatorio Consigliato Facoltativo

Attività Lead to Cash

Queste sono le fasi critiche del processo e le tappe fondamentali da acquisire nell’Event Log per una corretta individuazione del processo e l’identificazione dei colli di bottiglia.

6 Consigliato 8 Facoltativo

	Attività	Descrizione
	Lead convertito in opportunità	Indica la creazione di una Sales Opportunity a partire da un Sales Lead qualificato. Questo evento rappresenta il punto di avvio dell’analisi del processo incentrata sull’opportunità e viene attivato esplicitamente quando un utente converte un lead nel sistema.
Perché è importante Questo è il principale evento di avvio del processo. Analizzare il volume e la provenienza dei lead convertiti è fondamentale per comprendere l’efficacia delle attività di generazione e qualificazione dei lead. Dove reperirlo Questo evento viene rilevato alla creazione di un record Sales Opportunity, ovvero dell’oggetto Opportunity, in cui il campo «LeadId» o un campo sorgente analogo è valorizzato, indicando che l’opportunità deriva da un lead convertito. Acquisizione Rilevi il timestamp di creazione dell’oggetto Opportunity che presenta un riferimento non nullo al lead di origine. Tipo di evento explicit
	Opportunità persa	Rappresenta un esito negativo, nel quale l’opportunità viene chiusa senza una vendita. Viene dedotto quando lo stato dell’opportunità viene aggiornato a «Closed - Lost».
Perché è importante È il punto finale critico di un insuccesso. Analizzare quando, perché e per quale valore le opportunità vengono perse aiuta a individuare le debolezze del processo e le difficoltà del mercato. Dove reperirlo Viene dedotto dall’aggiornamento del campo «StatusCode» sull’oggetto Opportunity al valore «LOST». Il campo «ReasonWonLostCode» fornisce spesso il contesto. Acquisizione Rilevi il momento in cui il campo di stato dell’Opportunity viene aggiornato allo stato «Lost» definito dal sistema. Tipo di evento inferred
	Opportunità vinta	Rappresenta la conclusione positiva di una trattativa, nella quale il cliente si è impegnato all’acquisto. Viene dedotto quando lo stato dell’opportunità passa allo stato finale «Closed - Won».
Perché è importante Questo è il principale traguardo positivo del funnel di vendita. Costituisce l’evento che attiva i processi successivi di evasione e fatturazione. Dove reperirlo Viene dedotto dall’aggiornamento del campo «StatusCode» sull’oggetto Opportunity al valore «WON». In genere anche il campo «WinProb» (Win Probability) passa al 100%. Acquisizione Rilevi il momento in cui il campo di stato dell’Opportunity viene aggiornato allo stato «Won» definito dal sistema. Tipo di evento inferred
	Pagamento ricevuto	Segna il completamento finale e positivo del ciclo Lead to Cash, quando il pagamento del cliente è stato ricevuto e registrato. Questo evento proviene da un sistema finanziario.
Perché è importante È il punto finale positivo del processo e indica la realizzazione dei ricavi. È fondamentale per misurare la durata complessiva del ciclo di vendita e l’efficienza del flusso di cassa. Dove reperirlo Proviene da un sistema esterno di contabilità clienti o finanziario. I dati devono essere ricollegati alla Sales Opportunity per completare l’analisi del processo. Acquisizione Il timestamp dell’evento proviene dal record di registrazione del pagamento nel sistema finanziario. Tipo di evento explicit
	Preventivo accettato dal cliente	Indica che il cliente ha accettato formalmente i termini e i prezzi del preventivo. Si tratta di un traguardo fondamentale, spesso rilevato da una modifica dello stato dell’oggetto Quote al valore «Accepted».
Perché è importante È un segnale chiave dell’intenzione di acquisto e un prerequisito per la creazione di un ordine di vendita. Segna la conclusione positiva della fase di negoziazione e rappresenta un traguardo nel ciclo Quote-to-Order. Dove reperirlo Viene dedotto da una modifica dello stato dell’oggetto Quote verso lo stato «Accepted» o «Customer Approved». Acquisizione Rilevi la modifica del campo di stato dell’oggetto Quote verso il valore designato «Accepted». Tipo di evento inferred
	Preventivo creato	Rappresenta la generazione di un documento formale di preventivo associato all’opportunità. Si tratta di un evento esplicito, contrassegnato dalla creazione di un nuovo record Quote collegato all’opportunità.
Perché è importante Questo è un traguardo importante, che indica una concreta intenzione di acquisto. Analizzare il tempo che intercorre tra la creazione dell’opportunità e quella del preventivo aiuta a misurare la velocità di vendita. Dove reperirlo Viene rilevato dall’evento di creazione di un record Quote, ovvero dell’oggetto Q_Quote, collegato all’ID della Sales Opportunity (OptyId). Acquisizione Utilizzi 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 viene dedotto quando la fase di vendita dell’opportunità supera la fase di discovery o di analisi.
Perché è importante Questa attività rappresenta un traguardo fondamentale prima di poter proporre una soluzione. Eventuali ritardi possono indicare problemi nel coinvolgimento del cliente o nella disponibilità di risorse per approfondimenti tecnici. Dove reperirlo Viene dedotto da una modifica del campo «Sales Stage» sull’oggetto Opportunity, ad esempio dal valore «2 - Discovery» a «3 - Solution Building». Acquisizione Rilevi una modifica del campo relativo alla fase di vendita dell’Opportunity verso uno stato che indica il completamento della discovery. Tipo di evento inferred
	Fattura generata	Rappresenta la creazione della fattura del cliente per l’ordine evaso. Questa attività avviene in un sistema di fatturazione o finanziario, non in Oracle CX Sales, e i dati devono essere integrati.
Perché è importante Questo evento avvia il ciclo di riscossione dei pagamenti. I ritardi tra evasione e fatturazione possono incidere negativamente sul flusso di cassa e sul KPI «Invoice to Payment Cycle Time». Dove reperirlo Proviene da un sistema ERP esterno o da un sistema di contabilità clienti. I dati dell’evento devono essere correlati all’ID della Sales Opportunity per l’analisi del processo. Acquisizione Il timestamp dell’evento proviene dal log di creazione della fattura del sistema finanziario. Tipo di evento explicit
	Opportunità qualificata	Rappresenta il completamento della fase iniziale di qualificazione di un’opportunità. In genere viene dedotto quando la fase di vendita dell’opportunità viene aggiornata per indicare che la valutazione iniziale è conclusa e che l’opportunità è concreta.
Perché è importante Monitorare questo traguardo aiuta a misurare l’efficienza delle prime fasi del processo di vendita e a individuare quanto tempo le opportunità trascorrono nella qualificazione, un elemento fondamentale per il KPI Lead to Opportunity Conversion Rate. Dove reperirlo Viene dedotto da una modifica del campo «Sales Stage» (StgId) sull’oggetto Opportunity verso un valore che rappresenta la qualificazione, ad esempio dal valore «1 - Qualification» a «2 - Discovery». Acquisizione Rilevi una modifica del campo relativo alla fase di vendita dell’Opportunity verso lo stato designato «Qualified». Tipo di evento inferred
	Ordine evaso	Indica che i prodotti sono stati spediti o che i servizi sono stati erogati al cliente. Questi dati dell’evento non sono nativi di Oracle CX Sales e devono essere acquisiti da un sistema integrato di gestione degli ordini o da un sistema ERP.
Perché è importante Segna il completamento della promessa di consegna al cliente e attiva la fatturazione. È essenziale per misurare la durata del ciclo di evasione. Dove reperirlo Richiede l’integrazione con un sistema ERP o un sistema esterno di evasione. I dati devono essere ricollegati all’ID della Sales Opportunity 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	Indica il passaggio dal team di vendita al team responsabile dell’evasione degli ordini. In Oracle CX Sales, questo evento può essere dedotto quando l’opportunità viene vinta e attiva un processo per creare una Sales Order in un sistema ERP integrato.
Perché è importante Questa attività collega le vendite alle operations. Analizzare questo passaggio è fondamentale per comprendere e ottimizzare il KPI «Order Fulfillment Time». Dove reperirlo Questo evento è spesso concettuale all’interno di CX Sales e rappresenta l’attivazione della creazione dell’ordine in un sistema separato. Può essere associato al timestamp di «Opportunity Won» o a uno stato di conferma dell’integrazione successivo. Acquisizione Spesso utilizza il timestamp di «Opportunity Won» come proxy oppure richiede dati provenienti da un sistema integrato di gestione degli ordini. Tipo di evento inferred
	Preventivo inviato al cliente	Indica il momento in cui un preventivo viene formalmente consegnato al cliente per la revisione. In genere questo evento viene dedotto da una modifica dello stato dell’oggetto Quote, ad esempio al valore «Presented» o «Sent».
Perché è importante Questa attività avvia il conteggio dei cicli di revisione e negoziazione da parte del cliente. Rappresenta il punto di partenza per misurare il KPI «Quote to Order Creation Time». Dove reperirlo Viene dedotto da una modifica dello stato dell’oggetto Quote associato all’opportunità. Il campo dello stato può chiamarsi «StatusCode» o avere un nome analogo. Acquisizione Rilevi la modifica del campo di stato dell’oggetto Quote verso il valore «Sent» o «Presented». Tipo di evento inferred
	Preventivo rielaborato	Rileva i casi in cui un preventivo viene modificato e nuovamente emesso al cliente. Viene dedotto osservando più eventi «Quote Created» per la stessa opportunità oppure il versionamento di un singolo record Quote.
Perché è importante Una rielaborazione frequente può indicare proposte iniziali imprecise o negoziazioni prolungate, estendendo il ciclo di vendita. Questo supporta direttamente il KPI «Quote Rework Rate» e i Dashboard dedicati all’analisi delle rielaborazioni. Dove reperirlo Viene dedotto rilevando la creazione di una nuova versione di un Quote o un aggiornamento significativo di un preventivo esistente, ad esempio il ripristino dello stato a «draft», dopo che il preventivo è già stato inviato al cliente. Acquisizione Individui gli eventi «Quote Created» 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. Questa attività viene dedotta quando un’opportunità passa a una fase «Proposal» o «Presentation».
Perché è importante Monitorare questo passaggio aiuta ad analizzare il tempo necessario per sviluppare e proporre le soluzioni. È inoltre una fase chiave per il KPI «Stalled Opportunity Rate», poiché le opportunità vi rimangono spesso bloccate. Dove reperirlo Viene dedotto da una modifica del campo «Sales Stage» sull’oggetto Opportunity verso un valore come «4 - Proposal» o «Presentation». Acquisizione Rilevi una modifica del campo relativo alla fase di vendita dell’Opportunity verso lo stato di proposta. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i Suoi dati da Oracle CX Sales

Passaggi

Prerequisiti e autenticazione: verifichi di disporre di un account utente in Oracle CX Sales con i privilegi necessari, ad esempio Sales Administrator o un ruolo equivalente, per accedere alle REST API relative a opportunità e preventivi. Ottenga le credenziali client OAuth 2.0, ovvero Client ID e Client Secret, dall’amministratore Oracle Cloud per autenticare le richieste API e generare un bearer token.
Configurazione dell’ambiente: configuri un ambiente Node.js sul computer locale o su un server. Installi le librerie necessarie per effettuare richieste HTTP e gestire file CSV. Apra un terminale ed esegua i seguenti comandi: npm install axios npm install json2csv
Individui gli 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:

Opportunities: /salesApi/resources/latest/opportunities
Quotes, come elemento figlio di Opportunity: /salesApi/resources/latest/opportunities/{OptyId}/child/Quote

Configuri lo 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 specifico di Oracle CX Cloud, il Client ID, il Client Secret e l’intervallo di date desiderato per l’estrazione.
Esegua lo script: esegua lo script dal terminale utilizzando il comando node extract.js. Lo script otterrà prima un token di autenticazione, quindi inizierà a recuperare le opportunità pagina per pagina dall’API.
Recupero dei dati e paginazione: lo script gestisce automaticamente la paginazione dell’API. Richiede un numero definito di opportunità per chiamata e utilizza il parametro offset per richiedere le pagine successive, fino a recuperare tutte le opportunità comprese nell’intervallo di date specificato.
Recuperi i dati dei preventivi correlati: per ogni opportunità recuperata, lo script effettua una seconda chiamata API per recuperare tutti i preventivi associati. Questi dati sono fondamentali 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 questi dati JSON gerarchici in un event log tabellare e piatto. 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à.
Gestisca le dipendenze da sistemi esterni: tenga presente che 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 a questo event log utilizzando SalesOpportunity come chiave comune.
Esporti in CSV: dopo aver recuperato e trasformato tutti i dati, lo script utilizza la libreria json2csv per convertire l’array finale dei record dell’event log in un file CSV denominato oracle_cx_sales_event_log.csv. Il file verrà salvato nella stessa directory dalla quale è stato eseguito lo script.
Prepari il caricamento: verifichi che il file CSV generato sia corretto e completo. Il file è formattato con le colonne richieste, tra cui SalesOpportunity, ActivityName ed EventTime, 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 Client ID e Client Secret per l’autenticazione server-to-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 sull’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 significativamente le prestazioni e riduce il traffico di rete. Se utilizza campi personalizzati, dovrà aggiungerli a questo parametro.
Limite di paginazione: il parametro limit controlla il numero di record restituiti in una singola chiamata API. Lo script utilizza un limite di 500, un valore massimo comune che consente di ottimizzare 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 personalizzati pertinenti.

a 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

Prepari l’ambiente Python: verifichi che Python sia installato sul sistema. Installi le librerie necessarie utilizzando pip: pip install requests pandas.
Ottenga le credenziali API: acceda alla Sua istanza Oracle CX Sales con un account amministratore. Acceda alla Console di sicurezza (Navigatore > Strumenti > Console di sicurezza) e crei un nuovo utente con il ruolo 'Sales Representative' oppure con un ruolo personalizzato per l’integrazione. Questo utente deve disporre dell’accesso API agli oggetti salesLeads, opportunities, quotes e agli oggetti correlati. Annoti il nome utente e la password.
Individui il dominio Oracle CX: trovi l’URL specifico del dominio Oracle CX Sales. In genere segue il formato https://[your-pod-name].fa.em2.oraclecloud.com.
Configuri lo 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.
Personalizzi gli endpoint e i campi API: riveda le chiamate API contenute nello script. I campi richiesti, ad esempio OptyId, Nome, SalesStage e StatusCode, sono standard. Se dispone di campi personalizzati con suffisso _c importanti per l’analisi, li aggiunga al parametro fields nelle richieste API pertinenti.
Implementi l’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 si verificano al di fuori di Oracle CX Sales. Sostituisca la logica segnaposto con chiamate API effettive ai sistemi ERP e finanziari, così da 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.
Esegua lo script: esegua lo script dalla riga di comando utilizzando 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.
Riveda l’output: lo script genererà un file denominato lead_to_cash_event_log.csv. Apra il file in un’applicazione per fogli di calcolo per verificarne struttura e contenuto. Controlli la presenza delle colonne previste: SalesOpportunity, ActivityName, EventTime, SourceSystem e così via.
Gestisca la paginazione API: lo script fornito include un ciclo di paginazione di base. Per dataset molto grandi, potrebbe essere necessario aggiungere una gestione degli errori più robusta o brevi pause tra le richieste, così da evitare il superamento dei limiti di frequenza API.
Prepari il caricamento: il file CSV finale è strutturato per il caricamento diretto in ProcessMind. Verifichi che le intestazioni delle colonne corrispondano alla mappatura del progetto ProcessMind. Non dovrebbe essere necessaria alcuna ulteriore formattazione.

Configurazione

Credenziali API: è necessario un utente API dedicato, dotato di privilegi sufficienti per leggere gli oggetti Sales Lead, Sales Opportunity e Quote. Ciò include l’accesso ai dati storici o agli audit trail relativi alle modifiche di stato e fase.
Dominio Oracle CX: l’URL di base dell’istanza Oracle CX Sales deve essere specificato correttamente nello script.
Intervallo di date: imposti le variabili START_DATE ed END_DATE nello script per definire la finestra di estrazione. Per l’analisi iniziale si consiglia un intervallo di 3-6 mesi, così da bilanciare volume dei dati e prestazioni.
Filtri sulle opportunità: lo script può essere personalizzato per filtrare le opportunità in base a criteri specifici. Ad esempio, può aggiungere parametri di query all’URL API per filtrare in base a Organization_Id o a campi personalizzati, limitando l’estrazione a specifiche business unit o tipologie di opportunità.
Endpoint dei sistemi esterni: dovrà fornire gli endpoint API effettivi, le credenziali e la logica necessari per estrarre dai sistemi ERP e finanziari i dati relativi a ordini, fatture e pagamenti. Lo script presuppone che questi sistemi possano essere correlati utilizzando il Sales Opportunity ID o un Order ID associato.
Limite di paginazione: il parametro limit nelle chiamate API è impostato su 100. Può modificarlo, ma valori più elevati possono aumentare il rischio di timeout per le query complesse.

a 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 per iniziare?

Utilizzi questo Template per preparare i Suoi dati con sicurezza e iniziare a scoprire informazioni preziose sul processo Lead to Cash. Inizi oggi stesso a ottimizzare le operations per raggiungere la massima efficienza.

Torna alla guida al miglioramento Scarica il Template

Aumenti oggi del 20% il win rate del Suo Lead to Cash

Individui i colli di bottiglia, elimini le trattative perse e aumenti del 20% il win rate.

Inizi la prova gratuita

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

Il Suo Template dati Lead to Cash

Il Suo Template dati Lead to Cash

Attributi Lead to Cash

Attività Lead to Cash

Guide all’estrazione

Estrazione diretta tramite query REST API di Oracle CX Sales

Passaggi

Configurazione

a Query di esempio javascript

Script Python che utilizza la REST API di Oracle CX Sales

Passaggi

Configurazione

a Query di esempio python

È pronto per iniziare?

Aumenti oggi del 20% il win rate del Suo Lead to Cash

Il Suo Template dati Lead to Cash

Il Suo Template dati Lead to Cash

Attributi Lead to Cash

Attività Lead to Cash

Guide all’estrazione

Estrazione diretta tramite query REST API di Oracle CX Sales

Passaggi

Configurazione

a Query di esempio javascript

Script Python che utilizza la REST API di Oracle CX Sales

Passaggi

Configurazione

a Query di esempio python

È pronto per iniziare?

Aumenti oggi del 20% il win rate del Suo Lead to Cash

La Sua privacy è importante