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

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

Salesforce Sales Cloud

← Torna alla guida al miglioramento

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

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

Questo template offre una panoramica completa degli attributi e delle attività essenziali per analizzare efficacemente il processo Order to Cash - fatturazione ed emissione delle fatture. Indica quali informazioni raccogliere per l’Event Log e fornisce indicazioni pratiche su come estrarre i dati. Utilizzi questa risorsa per semplificare le iniziative di Process Mining e ottenere informazioni utili.

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

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

Scarica il template

Attributi di Order to Cash - fatturazione ed emissione delle fatture

Questi sono i campi dati consigliati da includere nell’Event Log per un’analisi completa del processo Order to Cash - fatturazione ed emissione delle fatture, così da acquisire tutte le informazioni essenziali.

3 Obbligatorio 5 Consigliato 11 Facoltativo

	Nome	Descrizione
	Data e ora dell’evento EventTime	Data e ora che indicano quando si è verificata una specifica attività.
Descrizione Questo attributo fornisce la data e l’ora di ogni attività, indispensabili per ordinarle cronologicamente e analizzare le prestazioni. Le date e le ore consentono di ricostruire la sequenza degli eventi e calcolare gli intervalli tra un’attività e l’altra. Nell’analisi dei processi, la data e ora dell’evento serve a calcolare tutte le metriche temporali, inclusi i tempi di ciclo, i tempi di attesa e la durata delle singole attività. È alla base di KPI come il 'Tempo medio del ciclo della fattura' e il 'DSO' e alimenta Dashboard come 'Tempo di ciclo di approvazione delle fatture' e 'Prestazioni della riconciliazione dei pagamenti'. Perché è importante Questa data e ora è fondamentale per ordinare correttamente gli eventi e calcolare tutte le metriche temporali, come i tempi di ciclo e le durate, indispensabili per individuare i ritardi. Dove reperirli Questi dati provengono spesso da campi data e ora generati dal sistema, come `CreatedDate` o `LastModifiedDate` dell’oggetto Invoice o dei record Task/Event correlati. Esempi 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-05-20T09:05:12Z
	Nome dell’attività ActivityName	Nome dello specifico evento aziendale che si è verificato nel processo di fatturazione.
Descrizione Questo attributo descrive la fase o la tappa raggiunta nel ciclo di vita della fattura, ad esempio 'Fattura generata' o 'Pagamento ricevuto'. Le attività costituiscono i nodi della mappa del processo. Analizzare la sequenza dei nomi delle attività è fondamentale per il Process Mining. Rivela il flusso effettivo del processo e consente di confrontarlo con quello previsto. Aiuta a individuare deviazioni, colli di bottiglia tra fasi specifiche e cicli di rilavorazione, fornendo un supporto diretto a Dashboard come 'Rilavorazioni ed errori nel processo di fatturazione' e 'Rapporto sulle violazioni della conformità nella fatturazione'. Perché è importante Definisce le fasi del processo, costituisce la struttura portante della mappa e consente di analizzare il flusso di lavoro, i colli di bottiglia e le deviazioni. Dove reperirli In genere si ricava dalle modifiche al campo Stato dell’oggetto Invoice o dai record di oggetti correlati, come Task o Event, che registrano azioni specifiche. Esempi Fattura generataFattura approvataFattura inviata al clientePagamento ricevuto
	Numero di fattura InvoiceNumber	Identificativo univoco di ogni fattura, utilizzato come identificativo principale del caso nel processo di fatturazione.
Descrizione Il numero di fattura è l’attributo centrale che raggruppa in un unico caso tutte le attività di fatturazione correlate. Ogni numero corrisponde a un documento di fatturazione distinto, inviato a un cliente. Nell’analisi di Process Mining, questo attributo consente di seguire l’intero ciclo di vita della fattura, dalla generazione al pagamento e alla chiusura. È essenziale per creare la mappa del processo e calcolare KPI a livello di caso, come il 'Tempo medio del ciclo della fattura' e i 'Giorni medi di incasso'. Analizzare i processi in base al numero di fattura aiuta a individuare colli di bottiglia, cicli di rilavorazione e deviazioni dalla conformità nei singoli casi di fatturazione. Perché è importante È la chiave essenziale per collegare tutti gli eventi di fatturazione correlati e ottenere una visione completa, dall’inizio alla fine, del processo di fatturazione per ogni singola transazione. Dove reperirli In genere è la chiave primaria dell’oggetto Invoice in Salesforce Sales Cloud, spesso rappresentata dal campo `InvoiceNumber` o da un campo ID univoco analogo. Esempi INV-00582INV-01934INV-10345
	Data di scadenza del pagamento PaymentDueDate	La data entro cui il cliente deve pagare la fattura.
Descrizione Questo attributo specifica il termine di pagamento indicato in fattura. Viene calcolato in base alla data della fattura e alle condizioni di pagamento concordate. La data di scadenza del pagamento è un dato fondamentale per la pianificazione finanziaria e la gestione del recupero crediti. Costituisce la base di riferimento per misurare la puntualità dei pagamenti effettivi. È indispensabile per calcolare il KPI 'Tasso di pagamenti puntuali' e per le Dashboard che monitorano la puntualità dei pagamenti, come 'Andamento dei Giorni medi di incasso (DSO)'. Perché è importante È il riferimento per misurare le prestazioni dei pagamenti, calcolare i giorni medi di incasso e avviare le attività di recupero crediti, come l’invio di solleciti di pagamento. Dove reperirli È un campo data standard dell’oggetto Invoice di Salesforce, spesso denominato `DueDate`. Esempi 2023-05-152023-06-302023-07-01
	Importo totale della fattura InvoiceTotalAmount	Valore monetario complessivo della fattura.
Descrizione Questo attributo rappresenta l’importo totale dovuto dal cliente per i beni o i servizi forniti. È una metrica finanziaria fondamentale associata a ogni caso di fatturazione. Analizzare l’importo totale della fattura aiuta a dare la priorità alle fatture di valore elevato e a capire come le prestazioni del processo variano tra le transazioni di importo minore e maggiore. È possibile segmentare l’analisi nelle Dashboard, ad esempio per verificare se le fatture di importo più elevato richiedono tempi di approvazione più lunghi o vengono pagate in ritardo. Questo è importante per gestire il rischio finanziario e concentrare in modo efficace le attività di recupero crediti. Perché è importante Consente di analizzare l’impatto finanziario, dare la priorità alle fatture di valore elevato e capire come l’importo influisce sul processo, ad esempio sui tempi di approvazione o sui ritardi di pagamento. Dove reperirli Probabilmente è un campo valuta standard dell’oggetto Invoice, denominato `GrandTotal` o con un nome analogo, come un campo di riepilogo. Esempi 5400.5012500.00850.75
	Reparto fatturazione BillingDepartment	Il reparto o il team responsabile dell’attività di fatturazione.
Descrizione Questo attributo specifica il gruppo funzionale a cui appartiene l’utente responsabile, ad esempio 'Crediti verso clienti' o 'Gestione commerciale'. In genere si ricava dal profilo o dal ruolo dell’utente in Salesforce. Analizzare le prestazioni per reparto è fondamentale per comprendere le responsabilità sui processi e individuare problemi sistemici nei singoli team. L’attributo viene utilizzato nelle Dashboard 'Prestazioni della riconciliazione dei pagamenti' e 'Carico di lavoro e prestazioni del team di fatturazione' per confrontare l’efficienza e l’utilizzo delle risorse tra diverse aree funzionali. Perché è importante Consente di analizzare le prestazioni a livello di team o reparto e aiuta a individuare colli di bottiglia specifici, vincoli sulle risorse o lacune nella formazione. Dove reperirli Queste informazioni sono in genere memorizzate nell’oggetto User di Salesforce, in campi come `Reparto` o `Role.Name`. Esempi Crediti verso clientiAttività finanziarieTeam recupero crediti
	Stato della fattura InvoiceStatus	Stato corrente della fattura nel suo ciclo di vita.
Descrizione Questo attributo indica lo stato attuale della fattura, ad esempio 'Bozza', 'In attesa di approvazione', 'Inviata', 'Pagata' o 'Annullata'. Fornisce un quadro della fase in cui si trova la fattura in un determinato momento. Lo stato della fattura è una dimensione fondamentale per filtrare e segmentare i dati. Consente agli analisti di concentrarsi su gruppi specifici, ad esempio tutte le fatture in attesa di pagamento o quelle respinte. In questo modo è possibile stabilire le priorità del lavoro e analizzare le caratteristiche delle fatture che si bloccano in determinate fasi. Perché è importante Fornisce un quadro chiaro dello stato attuale della fattura e consente di filtrare e analizzare i casi aperti, chiusi o problematici. Dove reperirli In genere è un campo elenco standard denominato `Stato` nell’oggetto Invoice di Salesforce. Esempi In attesa di approvazioneApprovatoInviata al clientePagataStralciata
	Utente responsabile UserResponsible	L’utente o l’agente che ha svolto l’attività.
Descrizione Questo attributo identifica l’utente Salesforce responsabile di una determinata attività, ad esempio l’approvazione di una fattura o la registrazione di un pagamento. Spesso è collegato all’utente che ha modificato il record per ultimo o a cui è assegnata l’attività. Analizzare il processo in base all’utente responsabile è fondamentale per comprendere le prestazioni del team, distribuire il carico di lavoro e individuare le esigenze di formazione. Supporta direttamente la Dashboard 'Carico di lavoro e prestazioni del team di fatturazione', consentendo di confrontare le prestazioni e analizzare l’allocazione delle risorse. Aiuta inoltre a individuare le cause profonde di ritardi o errori. Perché è importante Consente di analizzare le prestazioni individuali e del team, bilanciare il carico di lavoro e individuare gli utenti con i risultati migliori o che necessitano di ulteriore formazione. Dove reperirli Il dato può trovarsi in campi come `LastModifiedById` dell’oggetto Invoice o `OwnerId` di oggetti Task o personalizzati correlati. Questi ID devono essere collegati all’oggetto User per recuperare il nome dell’utente. Esempi Alice JohnsonBob WilliamsCharlie Brown
	È una rilavorazione IsRework	Un indicatore calcolato che segnala se una fattura è passata attraverso un ciclo di rilavorazione.
Descrizione Questo attributo booleano viene calcolato durante l’elaborazione dei dati. Assume il valore true se la sequenza di attività di una fattura mostra una rilavorazione, ad esempio quando si torna a una fase precedente dopo averla superata (per esempio, «Fattura corretta» dopo «Fattura approvata»). Questo indicatore è fondamentale per individuare e quantificare rapidamente le inefficienze del processo. Alimenta direttamente il KPI «Tasso di rilavorazione delle fatture» e la Dashboard «Rilavorazioni ed errori nel processo di fatturazione», consentendo agli analisti di isolare e rivedere i casi in cui le rilavorazioni comportano costi e tempi elevati. Perché è importante Questo indicatore quantifica direttamente le inefficienze del processo individuando i casi con cicli di correzione; aiuta così a individuare le cause degli errori e a calcolare il costo della scarsa qualità. Dove reperirli Questo attributo non è presente nel sistema di origine. Viene calcolato dallo strumento di Process Mining o nel livello ETL, in base alla sequenza di attività di ciascun caso. Esempi truefalse
	Giorni medi di incasso DaysSalesOutstanding	Il numero di giorni che intercorre tra l’invio della fattura e la ricezione del pagamento.
Descrizione I giorni medi di incasso (DSO) sono un indicatore finanziario fondamentale che misura il numero medio di giorni necessari a un’azienda per incassare un pagamento dopo una vendita. Si calcolano come intervallo tra l’evento «Fattura inviata al cliente» e l’evento «Pagamento ricevuto dal cliente». Questo KPI è uno degli obiettivi principali del processo Order to Cash e l’attributo consente di rilevarlo per ogni singola fattura. Supporta direttamente la Dashboard «Andamento dei giorni medi di incasso (DSO)» ed è essenziale per monitorare e migliorare il flusso di cassa. Perché è importante È un KPI fondamentale per misurare l’efficacia del processo di recupero crediti e il suo impatto diretto sul flusso di cassa dell’azienda. Dove reperirli È un attributo calcolato. Il calcolo è `(Timestamp('Customer Payment Received') - Timestamp('Invoice Sent to Customer'))`. Esempi 32 giorni58 giorni29 giorni
	Nome del cliente CustomerName	Nome del cliente o dell’account a cui viene fatturato l’importo.
Descrizione Questo attributo identifica il cliente o l’azienda a cui viene emessa la fattura. In genere è collegato al record Account associato in Salesforce. Analizzare il processo per cliente è essenziale per comprendere i comportamenti specifici e individuare i problemi che possono interessare gli account più importanti. Può rivelare se alcuni clienti pagano regolarmente in ritardo, richiedono più rilavorazioni o hanno cicli di approvazione complessi. Queste informazioni aiutano a gestire i rapporti con i clienti e ad adattare le strategie di recupero crediti. Perché è importante Consente un’analisi incentrata sul cliente per individuare schemi ricorrenti, ad esempio quali clienti pagano spesso in ritardo o richiedono più correzioni delle fatture, migliorando la gestione dei rapporti con i clienti. Dove reperirli Il dato proviene dal campo `Account.Name`, collegato tramite una relazione di ricerca tra l’oggetto Invoice e l’oggetto Account. Esempi ABC CorporationGlobal Tech Inc.Innovate Solutions LLC
	Ora di fine dell’evento EventEndTime	Il timestamp che indica quando è stata completata un’attività.
Descrizione Questo attributo registra l’ora di completamento di un’attività. Nel processo di fatturazione molte attività sono eventi istantanei, per i quali l’ora di inizio coincide con quella di fine; altre, come una fase di approvazione, possono invece avere una durata misurabile. L’ora di fine consente di calcolare con precisione il tempo di elaborazione dell’attività, ovvero il tempo durante il quale un operatore o un sistema lavora effettivamente su un’attività. Aiuta a distinguere il tempo di lavoro effettivo da quello di attesa, offrendo una visione più dettagliata dell’efficienza del processo. Perché è importante Consente di calcolare con precisione i tempi di elaborazione delle attività e di distinguere il lavoro effettivo dai tempi di attesa, per un’analisi dell’efficienza più accurata. Dove reperirli Spesso non è un campo standard. Potrebbe essere necessario ricavarlo dall’ora di inizio dell’attività successiva nel caso oppure registrarlo in un campo personalizzato. Esempi 2023-04-15T10:05:00Z2023-04-16T14:32:10Z2023-05-20T09:05:12Z
	Paese di fatturazione BillingCountry	Il paese indicato nell’indirizzo di fatturazione della fattura.
Descrizione Questo attributo registra il paese dell’indirizzo di fatturazione del cliente. È una dimensione geografica importante per segmentare i dati del processo. Analizzare il processo di fatturazione per paese è essenziale per individuare differenze regionali nelle prestazioni, nella conformità e nei comportamenti dei clienti. Può rivelare se in alcuni paesi i tempi di pagamento sono più lunghi, i tassi di rilavorazione sono diversi o vigono requisiti normativi specifici che incidono sul processo. Queste informazioni favoriscono l’armonizzazione globale dei processi e gli interventi di ottimizzazione a livello locale. Perché è importante Consente di analizzare i dati per area geografica e individuare differenze regionali nelle prestazioni, nei requisiti di conformità e nei comportamenti di pagamento. Dove reperirli Fa parte del campo composto standard dell’indirizzo nell’oggetto Invoice, in genere `BillingCountry`. Esempi USAGermaniaGiapponeBrasile
	Pagamento in ritardo IsLatePayment	Un indicatore calcolato che segnala se il pagamento è stato ricevuto dopo la data di scadenza.
Descrizione Questo attributo booleano viene calcolato confrontando il timestamp di «Pagamento ricevuto dal cliente» con la «Data di scadenza del pagamento». Assume il valore true se il pagamento è in ritardo e false negli altri casi. L’indicatore semplifica l’analisi dei comportamenti di pagamento e dell’efficacia delle attività di recupero crediti. È alla base del KPI «Tasso di pagamenti puntuali» e permette di segmentare i clienti in base alla puntualità dei pagamenti per ulteriori analisi. Per ogni fattura, fornisce un esito chiaro e binario sulle prestazioni di pagamento. Perché è importante Fornisce una misura chiara dei risultati delle attività di recupero crediti, supporta direttamente il KPI «Tasso di pagamenti puntuali» e consente di analizzare i fattori che causano i ritardi nei pagamenti. Dove reperirli Questo attributo non è presente nel sistema di origine. Viene calcolato nel livello ETL o nello strumento di Process Mining confrontando la data di pagamento con il campo `PaymentDueDate`. Esempi truefalse
	Responsabile dell’account AccountOwner	Il rappresentante commerciale o account manager responsabile dell’account cliente.
Descrizione Questo attributo identifica il referente interno del rapporto con il cliente, in genere il venditore o l’account manager assegnato all’Account in Salesforce. Anche se non partecipa direttamente alla fatturazione, il responsabile dell’Account può essere una dimensione utile per l’analisi. I problemi nel processo di fatturazione possono influire sul rapporto con il cliente e questo attributo permette di collegare i dati sulle prestazioni del processo all’area commerciale. Può servire a verificare se gli account gestiti da determinati responsabili presentano più problemi di fatturazione. Perché è importante Collega le prestazioni del processo di fatturazione al responsabile del rapporto commerciale, aiutando a comprendere l’impatto aziendale di errori o ritardi nell’emissione delle fatture. Dove reperirli È il campo `Owner.Name` dell’oggetto Account, collegato a Invoice. Esempi David MillerSophia GarciaJames Wilson
	Sistema di origine SourceSystem	Identifica il sistema da cui provengono i dati.
Descrizione Questo attributo specifica l’applicazione di origine in cui sono stati generati i dati degli eventi. Per questo processo, in genere si tratta di 'Salesforce Sales Cloud'. Negli ambienti con più sistemi integrati, questo campo è fondamentale per ricostruire la provenienza dei dati e risolvere i problemi. Aiuta a comprenderne il contesto e a garantire che gli eventi provenienti da sistemi diversi vengano uniti e interpretati correttamente nello strumento di Process Mining. Perché è importante Fornisce informazioni essenziali sull’origine dei dati, indispensabili per la governance, la convalida e l’analisi dei dati in ambienti con più sistemi. Dove reperirli In genere è un valore statico aggiunto durante il processo di estrazione, trasformazione e caricamento dei dati (ETL) per indicare l’origine del set di dati. Esempi Salesforce Sales CloudSFSC
	Termini di pagamento PaymentTerms	Le condizioni concordate per il pagamento della fattura, ad esempio «30 giorni» o «pagamento alla ricezione».
Descrizione Questo attributo definisce le regole che stabiliscono quando e come pagare una fattura. Spesso determina il calcolo della data di scadenza del pagamento e può includere sconti per il pagamento anticipato. L’analisi per termini di pagamento aiuta a capire come i diversi accordi influiscono sui comportamenti di pagamento. È fondamentale per la Dashboard «Utilizzo degli sconti per pagamento anticipato», che confronta le date di pagamento con i termini concordati per individuare le opportunità di risparmio non sfruttate. Fornisce inoltre un contesto utile per capire perché alcune fatture hanno tempi di pagamento più lunghi o più brevi. Perché è importante Fornisce un contesto sulle scadenze di pagamento ed è essenziale per analizzare i comportamenti di pagamento, i giorni medi di incasso e l’efficacia dei programmi di sconto per pagamento anticipato. Dove reperirli Queste informazioni sono probabilmente memorizzate in un elenco di selezione o in un campo di testo dell’oggetto Invoice o dell’oggetto Account associato in Salesforce. Esempi 30 giorni60 giorni2% entro 10 giorni, 30 giorniPagamento alla ricezione
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’ultimo aggiornamento dei dati dal sistema di origine.
Descrizione Questo attributo indica quando sono stati estratti per l’ultima volta da Salesforce Sales Cloud i dati utilizzati nell’analisi di Process Mining. È un campo di metadati applicato all’intero set di dati a ogni aggiornamento. Questa data e ora è importante perché consente di valutare quanto siano aggiornati i dati. Aiuta a capire se le Dashboard e i KPI visualizzati riflettono la situazione corrente, un aspetto essenziale per prendere decisioni aziendali tempestive e informate sulla base dei risultati dell’analisi dei processi. Perché è importante Indica quanto sono aggiornati i dati, affinché le decisioni si basino su una visione attuale e pertinente del processo. Dove reperirli Questo valore viene generato e aggiunto al set di dati dallo strumento ETL o dalla pipeline di dati durante ogni esecuzione. Esempi 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	Valuta della fattura InvoiceCurrency	Il codice della valuta dell’importo della fattura, ad esempio USD o EUR.
Descrizione Questo attributo indica la valuta in cui è espresso l’importo della fattura. È particolarmente importante per le organizzazioni che operano in più paesi. Il campo fornisce un contesto essenziale per qualsiasi analisi finanziaria: consente di aggregare correttamente gli importi e confrontare le metriche di processo tra diverse aree valutarie. È un filtro necessario per analizzare gli indicatori finanziari ed evitare di mescolare valute diverse. Perché è importante Fornisce il contesto necessario per tutti gli importi, garantendo analisi e rendicontazioni finanziarie accurate, soprattutto nelle attività che coinvolgono più paesi. Dove reperirli In genere è il campo standard `CurrencyIsoCode`, disponibile nelle istanze Salesforce in cui è attivata la gestione multivaluta. Esempi USDEURGBPJPY

Obbligatorio Consigliato Facoltativo

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

Queste sono le fasi e i traguardi principali da registrare nell’Event Log per individuare il processo con precisione e valutarne le prestazioni.

5 Consigliato 8 Facoltativo

	Attività	Descrizione
	Fattura approvata	Un utente autorizzato ha esaminato e approvato la fattura, confermandone la correttezza e l’idoneità all’invio al cliente. In genere, l’evento viene rilevato quando lo stato della fattura passa a 'Approvato'.
Perché è importante È una tappa fondamentale, da cui dipende il proseguimento del processo di fatturazione. I ritardi in questa fase creano colli di bottiglia significativi e incidono sui Giorni medi di incasso e sui tempi complessivi del ciclo, misurati dalla Dashboard 'Tempo di ciclo di approvazione delle fatture'. Dove reperirli Si deduce dalla modifica del campo di stato dell’oggetto Invoice in 'Approvato'. Se si utilizzano i processi di approvazione di Salesforce, l’evento può essere rilevato direttamente dalla cronologia dell’oggetto ProcessInstance. Acquisizione Modifica del campo di stato della fattura in 'Approvato' oppure completamento di una fase formale del processo di approvazione. Tipo di evento inferred
	Fattura chiusa	Il ciclo di vita della fattura è concluso: il pagamento è stato ricevuto per intero e riconciliato. Questa è l’ultima attività per una fattura gestita correttamente e viene in genere registrata con un aggiornamento dello stato.
Perché è importante Questa attività segna la conclusione principale del processo e consente di calcolare con precisione il tempo complessivo del ciclo. Definisce chiaramente il completamento ai fini dell’analisi del processo. Dove reperirli Si deduce dalla data e ora in cui il campo di stato dell’oggetto Invoice viene aggiornato a 'Chiuso', 'Pagato per intero' o a un altro stato finale analogo. Acquisizione Modifica del campo di stato della fattura al valore finale 'Chiuso'. Tipo di evento inferred
	Fattura generata	Questa attività indica la creazione di una nuova fattura in Salesforce. Segna l’avvio ufficiale del processo di fatturazione per una specifica transazione e viene in genere attivata dopo l’evasione di un ordine o il raggiungimento di una tappa contrattuale. L’evento viene rilevato dalla data e ora di creazione della fattura.
Perché è importante È il principale evento di inizio del processo di fatturazione. Analizzare il tempo che intercorre da questo momento al pagamento consente di misurare il tempo complessivo del ciclo dall’ordine all’incasso e di individuare eventuali ritardi iniziali nell’inserimento dei dati. Dove reperirli L’evento viene rilevato dalla data di creazione (campo CreatedDate) dell’oggetto personalizzato Invoice o di un oggetto analogo che rappresenta la fattura in Salesforce. Acquisizione Data e ora di creazione del record della fattura. Tipo di evento explicit
	Fattura inviata al cliente	La fattura approvata è stata inviata ufficialmente al cliente tramite e-mail, posta o portale. Spesso l’evento viene rilevato quando viene compilato il campo 'Data di invio' o lo stato passa a 'Inviato'.
Perché è importante Segna l’inizio del periodo di riscossione del pagamento ed è il punto di partenza per calcolare i Giorni medi di incasso (DSO). È una tappa fondamentale per monitorare le comunicazioni con il cliente e le tempistiche di pagamento. Dove reperirli Si deduce dalla compilazione del campo 'Data di invio' nell’oggetto Invoice o dall’aggiornamento dello stato a 'Inviato'. Se l’invio avviene tramite uno strumento di posta elettronica integrato, l’evento può essere registrato esplicitamente nella cronologia delle attività. Acquisizione Data e ora di compilazione del campo 'Sent_Date__c'. Tipo di evento inferred
	Pagamento del cliente ricevuto	Il cliente ha effettuato il pagamento della fattura e i fondi sono stati ricevuti. In genere, l’operazione viene registrata creando un record 'Payment' collegato alla fattura.
Perché è importante È la tappa più importante della fase di incasso. Segna il termine del periodo considerato nel calcolo dei Giorni medi di incasso e conferma la ricezione dei ricavi. Dove reperirli Rilevato dalla data di creazione di un record dell’oggetto personalizzato 'Payment' collegato all’oggetto Invoice. Può anche essere dedotto quando lo stato della fattura passa a 'Pagato'. Acquisizione Creazione di un record Payment collegato. Tipo di evento explicit
	Fattura corretta	Indica una correzione o un aggiornamento manuale della fattura dopo che è stata respinta o ne è stato rilevato un errore. Spesso si deduce quando lo stato della fattura torna a una fase precedente, ad esempio da 'Respinto' a 'Bozza'.
Perché è importante Individuare i cicli di correzione è fondamentale per misurare il KPI 'Tasso di rilavorazione delle fatture'. Un numero elevato di correzioni segnala problemi nella generazione iniziale delle fatture, che possono causare ritardi. Dove reperirli Si deduce dalla cronologia delle modifiche dei campi, rilevando il passaggio da uno stato avanzato, ad esempio 'Respinto' o 'Approvato', a uno precedente, come 'Bozza' o 'In corso'. Acquisizione Lo stato della fattura torna a una fase precedente del flusso di processo. Tipo di evento inferred
	Fattura inviata per l’approvazione	La fattura è stata completata e inviata per la revisione interna prima di essere trasmessa al cliente. In genere, l’attività viene rilevata quando cambia il valore del campo di stato del record della fattura, ad esempio da 'Bozza' a 'In attesa di approvazione'.
Perché è importante Monitorare questa attività consente di isolare il tempo trascorso in attesa di approvazione. È un passaggio fondamentale per calcolare il KPI 'Tempo medio di approvazione delle fatture'. Dove reperirli Si deduce dalla cronologia delle modifiche dei campi dell’oggetto Invoice, quando il campo di stato viene aggiornato con un valore come 'Inviata per l’approvazione' o 'In revisione'. Acquisizione Modifica del campo di stato della fattura in 'In attesa di approvazione'. Tipo di evento inferred
	Fattura respinta	Un approvatore ha respinto la fattura, in genere a causa di errori o discrepanze, rendendo necessarie una correzione e un nuovo invio. L’evento viene rilevato quando lo stato del record della fattura passa a 'Respinto'.
Perché è importante Questa attività segnala una rilavorazione e un’inefficienza del processo. Analizzare la frequenza dei rifiuti aiuta a individuare le cause più comuni degli errori e supporta l’analisi delle cause profonde nella Dashboard 'Rilavorazioni ed errori nel processo di fatturazione'. Dove reperirli Si deduce dalla modifica del campo di stato dell’oggetto Invoice in 'Respinto'. Questi dati possono trovarsi anche nei commenti della cronologia di un processo formale di approvazione. Acquisizione Modifica del campo di stato della fattura in 'Respinto'. Tipo di evento inferred
	Fattura stralciata	È stata presa la decisione di annullare il credito e la fattura viene chiusa senza essere pagata per intero. Si tratta di una modalità alternativa e non riuscita di conclusione del processo di fatturazione.
Perché è importante Monitorare gli stralci aiuta a quantificare le perdite di ricavi e a individuare i clienti o le situazioni che generano crediti inesigibili. È un’eccezione importante da tenere sotto controllo per valutare la salute finanziaria. Dove reperirli Si deduce dalla data e ora in cui il campo di stato dell’oggetto Invoice viene aggiornato a 'Stralciato' o 'Annullato - credito inesigibile'. Acquisizione Modifica del campo di stato della fattura in 'Stralciato'. Tipo di evento inferred
	Incasso applicato e riconciliato	Il pagamento ricevuto è stato abbinato e applicato interamente alla fattura specifica nel sistema, chiudendo il credito. L’evento viene rilevato dalla modifica finale dello stato del pagamento o della fattura.
Perché è importante Segna la fase conclusiva del ciclo di conversione della liquidità. La Dashboard 'Prestazioni della riconciliazione dei pagamenti' utilizza questa attività per misurare l’efficienza con cui il team finanziario registra gli incassi. Dove reperirli Si deduce dalla modifica dello stato dell’oggetto Invoice o di un oggetto Payment collegato a uno stato finale come 'Riconciliato' o 'Applicato'. Acquisizione Modifica dello stato della fattura o del pagamento in 'Riconciliato'. Tipo di evento inferred
	Pagamento registrato nel libro mastro	Il pagamento ricevuto è stato registrato formalmente nel sistema contabile o nel libro mastro dell’azienda. L’evento può essere rilevato da un aggiornamento dello stato del pagamento o della fattura dopo l’esecuzione di un’integrazione.
Perché è importante Questa attività distingue la ricezione del pagamento dalla riconciliazione contabile. Il tempo che intercorre tra la ricezione e la registrazione può mettere in luce ritardi nei processi contabili interni. Dove reperirli Si deduce dalla modifica di un campo di stato dell’oggetto Payment o Invoice a un valore come 'Registrato' o 'Esportato all’ERP', spesso aggiornato tramite un’integrazione API. Acquisizione Modifica dello stato del pagamento o della fattura in 'Registrato'. Tipo di evento inferred
	Scadenza del pagamento	È un evento calcolato che indica il momento in cui il pagamento della fattura diventa esigibile secondo le condizioni di pagamento. Non corrisponde a un’azione dell’utente, ma viene ricavato dai dati della fattura.
Perché è importante Questa attività fornisce un riferimento fondamentale per analizzare le abitudini di pagamento e misurare il KPI 'Tasso di pagamenti puntuali'. Consente di distinguere i pagamenti puntuali da quelli in ritardo. Dove reperirli È un evento calcolato, ricavato confrontando la data e ora corrente con il campo 'Data di scadenza' dell’oggetto Invoice. Non è registrato come evento in Salesforce. Acquisizione Calcolato confrontando la data corrente con il campo Data di scadenza della fattura. Tipo di evento calculated
	Sollecito di pagamento inviato	È stato inviato al cliente un messaggio per ricordargli un pagamento in scadenza o scaduto. Spesso viene registrato come record di attività specifico (Task o e-mail) collegato alla fattura.
Perché è importante Monitorare i solleciti aiuta a valutare l’efficacia delle strategie di recupero crediti. È essenziale per la Dashboard 'Efficacia dei solleciti di pagamento' e per il KPI 'Tasso di attivazione dei solleciti di pagamento'. Dove reperirli Rilevato dalla creazione di un record di attività (Task o e-mail) collegato all’oggetto Invoice, il cui oggetto o tipo indica che si tratta di un sollecito di pagamento. Acquisizione Creazione di un record Task o e-mail collegato, con un tipo o un oggetto specifico. Tipo di evento explicit

Consigliato Facoltativo

Guide all’estrazione

Come estrarre i dati da Salesforce Sales Cloud

Passaggi

Verifica dei prerequisiti: Si assicuri di disporre delle autorizzazioni necessarie in Salesforce, tra cui «Esegui report», «Crea e personalizza report» ed «Esporta report». Verifichi che il monitoraggio della cronologia dei campi sia attivato per i campi di stato chiave degli oggetti Invoice e Payment. Per farlo, acceda a Setup > Object Manager, individui l’oggetto pertinente, apra Fields & Relationships e selezioni «Set History Tracking».
Definizione della strategia per i report: Questa procedura richiede la creazione di più report, perché le attività hanno origine da record o eventi diversi, come la creazione di una fattura, le modifiche di stato e i pagamenti associati. Crei un report distinto per ogni origine, quindi combini i risultati esternamente.
Creazione di un report per la creazione dei record: Inizi dagli eventi più semplici. Crei un report per «Fattura generata» e «Pagamento ricevuto dal cliente». Acceda alla scheda Reports e selezioni «New Report». Scelga un tipo di report che includa l’oggetto Invoice, ad esempio «Invoices», oppure l’oggetto Payment. Aggiunga le colonne corrispondenti agli attributi dell’Event Log. Per l’attività «Fattura generata», CreatedDate del record della fattura corrisponde a EventTime.
Creazione di un report sulla cronologia dei campi: Per acquisire le modifiche di stato, come «Fattura inviata per approvazione», «Fattura approvata», «Fattura rifiutata» e «Fattura corretta», crei un report basato sul tipo di report «Invoice History». Questo tipo di report speciale mostra le modifiche registrate dal monitoraggio della cronologia dei campi. Imposti un filtro per le modifiche al campo Stato.
Creazione di un report per gli eventi basati su date: Per eventi come «Fattura inviata al cliente» o «Data di scadenza del pagamento raggiunta», crei un report sull’oggetto Invoice. Utilizzi i campi data stessi, come Sent_Date__c o Payment_Due_Date__c, come EventTime. Applichi un filtro per includere solo i record in cui queste date non sono nulle.
Creazione di un report per le attività correlate: Per eventi come «Sollecito di pagamento inviato», occorre un report che colleghi le attività (Task o Event) alle fatture. Utilizzi un tipo di report come «Activities with Invoices» oppure ne crei uno personalizzato. Applichi un filtro per includere le attività con un oggetto o un tipo specifico che indichi un sollecito.
Aggiunta delle colonne standard a tutti i report: In ogni report, aggiunga le colonne che possono essere associate alla struttura richiesta dell’Event Log: InvoiceNumber, un campo per EventTime (come CreatedDate o la data della modifica del campo), UserResponsible (ad esempio LastModifiedById) e gli altri attributi consigliati.
Esportazione dei report in CSV: Esegua ogni report singolarmente. Nella schermata dei risultati, apra il menu a discesa, selezioni «Esporta» e scelga il formato «Solo dettagli» con estensione .csv. Ripeta l’operazione per tutti i report creati.
Unione e trasformazione dei dati: Apra i file CSV esportati in un foglio di calcolo oppure utilizzi uno strumento di preparazione dei dati. Per ogni file, aggiunga una colonna denominata ActivityName e inserisca il nome dell’attività corrispondente, ad esempio «Fattura generata» per tutte le righe del primo report. Associ le colonne di origine, come Invoice: Created Date, alle intestazioni standard dell’Event Log, come EventTime.
Creazione dell’Event Log finale: Riunisca in un unico file principale tutti i dati trasformati dei singoli file CSV. Verifichi che le intestazioni delle colonne siano esattamente InvoiceNumber, ActivityName, EventTime, UserResponsible e così via. Questo file unificato costituisce l’Event Log finale.
Formattazione finale: Salvi il file consolidato in formato CSV con codifica UTF-8. Il file è ora pronto per essere caricato in ProcessMind.

Configurazione

Tipi di report: Probabilmente dovrà creare più tipi di report personalizzati per collegare oggetti principali, come Account, a oggetti secondari e di livello successivo, come Invoice, Payment e Activity. Li crei in Setup > Report Types.
Monitoraggio della cronologia dei campi: È fondamentale. Per l’oggetto Invoice, attivi il monitoraggio della cronologia per qualsiasi campo Stato. Senza questa impostazione non sarà possibile acquisire attività legate alle modifiche di stato, come «Approvato» o «Rifiutato». La cronologia non viene registrata retroattivamente.
Filtri sui dati: Applichi sempre un filtro per data ai report, così da mantenere gestibile il volume dei dati. È buona prassi filtrare la data di creazione dell’oggetto principale, limitandola agli ultimi 3-6 mesi, ad esempio Invoice: Created Date uguale a LAST 180 DAYS.
Servizio di esportazione dei dati: In alternativa all’esecuzione di singoli report, può utilizzare il servizio nativo di esportazione dei dati (Setup > Data Export). Il servizio esporta tutti i dati dell’organizzazione con cadenza settimanale o mensile. Offre un backup completo, ma richiede una fase significativa di elaborazione successiva per filtrare, collegare e trasformare i dati in un Event Log.
Autorizzazioni utente: L’utente che esegue l’estrazione deve disporre dell’accesso in lettura a tutti gli oggetti pertinenti, ad esempio Account, Order, Invoice__c, Payment__c e Activity, e ai relativi campi, oltre alle autorizzazioni per creare ed esportare report.

Query di esempio config

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

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

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

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

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

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

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

Passaggi

Prerequisiti e configurazione: verifichi che sul sistema sia installato Python 3.6 o una versione successiva. Installi le librerie necessarie eseguendo questo comando nel terminale: pip install simple-salesforce pandas. Le serviranno anche il nome utente e la password Salesforce, oltre al token di sicurezza. Per ottenere il token, acceda a Salesforce, apra le impostazioni personali e selezioni 'Reset My Security Token'.
Attivi il tracciamento della cronologia dei campi: acceda all’organizzazione Salesforce come amministratore. Apra Setup, quindi Object Manager. Individui l’oggetto principale delle fatture, ad esempio Invoice__c, e selezioni 'Fields & Relationships'. Faccia clic su 'Set History Tracking' e attivi il tracciamento del campo che rappresenta lo stato della fattura, ad esempio Status__c. Ripeta la procedura per l’oggetto dei pagamenti, ad esempio Payment__c, e per il relativo campo di stato.
Scarichi e configuri lo script: salvi lo script Python fornito in un file denominato extract_invoices.py. Apra il file con un editor di testo e aggiorni i valori segnaposto nella sezione 'Salesforce Credentials and Settings'. Inserisca SF_USERNAME, SF_PASSWORD, SF_SECURITY_TOKEN e SF_INSTANCE_URL. Modifichi START_DATE e END_DATE per definire il periodo di estrazione.
Personalizzi i nomi di oggetti e campi: controlli attentamente le query SOQL incluse nello script. Sono utilizzati nomi segnaposto come Invoice__c, Payment__c, Status__c, Total_Amount__c e così via. Li sostituisca con i nomi API effettivi degli oggetti e dei campi utilizzati nell’istanza Salesforce per la fatturazione e la gestione delle fatture.
Esegua lo script di estrazione: apra un terminale o il prompt dei comandi, raggiunga la cartella in cui ha salvato lo script e lo esegua con il comando python extract_invoices.py. Lo script si collegherà all’API Salesforce, eseguirà le query e elaborerà i dati.
Controlli l’avanzamento dello script: durante il recupero e l’elaborazione dei dati per ciascun tipo di attività, lo script mostrerà messaggi di stato nella console. L’operazione può richiedere tempo, a seconda del volume dei dati e dei limiti dell’API. Verifichi la presenza di eventuali messaggi di errore, che potrebbero indicare credenziali o nomi API non corretti.
Verifichi il file di output: al termine dell’esecuzione, lo script genererà nella stessa cartella un file denominato salesforce_billing_event_log.csv. Lo apra con un programma per fogli di calcolo e ne controlli il contenuto, verificando che includa i dati previsti.
Prepari il caricamento: il file CSV generato contiene le colonne richieste InvoiceNumber, ActivityName e EventTime, oltre ad altri attributi consigliati. È pronto per essere caricato direttamente nello strumento di Process Mining, senza ulteriori operazioni di formattazione.

Configurazione

Credenziali Salesforce: inserisca il nome utente e la password Salesforce, oltre al token di sicurezza. Il token è necessario per accedere all’API da indirizzi IP esterni agli intervalli considerati attendibili dall’organizzazione.
URL dell’istanza Salesforce: specifichi il dominio dell’istanza Salesforce, ad esempio your_instance.my.salesforce.com. Se utilizza una sandbox, l’URL sarà diverso, ad esempio test.salesforce.com.
Filtri per intervallo di date: lo script include le variabili START_DATE e END_DATE. Per gestire il volume dei dati e rispettare i limiti dell’API, è consigliabile iniziare con un intervallo più breve, ad esempio da 3 a 6 mesi. Queste date filtrano la query iniziale in base alla data di creazione delle fatture.
Nomi API di oggetti e campi: lo script utilizza nomi API segnaposto per oggetti e campi, ad esempio Invoice__c e Status__c. Li sostituisca con i nomi API esatti del modello dati Salesforce, disponibili in Setup, nella sezione Object Manager.
Prerequisiti per il tracciamento: l’accuratezza dell’Event Log, soprattutto per le modifiche di stato, dipende interamente dall’attivazione del tracciamento della cronologia dei campi Salesforce per i campi pertinenti prima che avvenissero le transazioni. Se non era attivo, le modifiche storiche non verranno registrate.
Limiti delle chiamate API: Salesforce impone limiti al numero di chiamate API consentite nell’arco di 24 ore. Per insiemi di dati molto ampi, valuti di eseguire l’estrazione in intervalli di date più brevi oppure di programmarla nelle ore di minore attività, così da non superare tali limiti.

Query di esempio python

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

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

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

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

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

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

    all_events = []

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Passaggi

Scelga una piattaforma ETL o iPaaS con un connettore Salesforce Sales Cloud supportato e crei una connessione utilizzando il metodo di autenticazione Salesforce richiesto. Inserisca nella configurazione della piattaforma solo la stringa di connessione, le credenziali, l’identificativo dell’organizzazione o i valori specifici dell’ambiente.
Verifichi che l’organizzazione Salesforce collegata esponga l’oggetto delle fatture, la cronologia degli stati delle fatture o la relativa fonte di audit, i record delle attività correlate, i record dei pagamenti e gli eventuali record d’integrazione contabile richiesti dal processo. Sostituisca ogni riferimento tra parentesi quadre a oggetti o campi nella query con i nomi corrispondenti configurati nell’ambiente Salesforce.
Configuri i parametri di estrazione incrementale con una data iniziale e una finale. Utilizzi, ove applicabile, la data di creazione della fattura, la data della modifica di stato, la data dell’attività, la data del pagamento, la data di registrazione contabile, la data di riconciliazione e quella di chiusura. Includa un periodo retrospettivo sufficiente per comprendere i casi creati prima dell’intervallo selezionato ma ancora attivi durante tale periodo.
Aggiunga la query completa riportata di seguito al componente di query Salesforce o di trasformazione dello strumento ETL. Se il connettore non supporta la sintassi mostrata, riproduca la stessa logica con componenti visuali per fonti, filtri, join, campi calcolati e unioni. Non faccia affidamento su ProcessMind per dedurre gli eventi dalle modifiche di stato: ogni attività deve essere generata come riga esplicita dell’Event Log.
Configuri le mappature delle fonti per l’oggetto delle fatture, la cronologia degli stati delle fatture o la relativa fonte di audit, i record delle attività correlate, i record dei pagamenti, i record delle registrazioni contabili e quelli delle riconciliazioni. Mappi il numero della fattura su InvoiceNumber, l’etichetta dell’attività su ActivityName e il timestamp pertinente su EventTime. Mantenga gli attributi consigliati quando i relativi valori sono disponibili nella fonte.
Applichi le regole di trasformazione. Converta tutti i timestamp in un unico fuso orario concordato, normalizzi i valori di stato, converta InvoiceTotalAmount in un tipo numerico e PaymentDueDate in un tipo data o timestamp, quindi rimuova i record privi di InvoiceNumber o EventTime. Per Payment Due Date Reached, generi una riga esplicita utilizzando PaymentDueDate come EventTime solo se la data di scadenza rientra nell’intervallo di estrazione e il record della fattura è disponibile.
Elimini i duplicati utilizzando InvoiceNumber, ActivityName, EventTime e, se disponibile, l’identificativo del record di origine. Mantenga le occorrenze distinte quando la fonte contiene più invii, rifiuti, promemoria, correzioni, pagamenti, registrazioni contabili o riconciliazioni effettivi.
Verifichi che l’output contenga tutti e 13 i valori ActivityName richiesti, che ogni riga includa InvoiceNumber ed EventTime e che, quando i dati di origine lo consentono, i timestamp degli eventi siano ordinati correttamente per ciascuna fattura.
Carichi il risultato trasformato in un file CSV, Parquet o in un altro formato di Event Log supportato da ProcessMind. Utilizzi InvoiceNumber come identificativo del caso, ActivityName come colonna delle attività ed EventTime come colonna dell’ora dell’evento. Includa UserResponsible, BillingDepartment, InvoiceStatus, InvoiceTotalAmount e PaymentDueDate come attributi aggiuntivi.
Esporti l’Event Log finale e lo carichi in ProcessMind. Durante l’importazione, verifichi che ProcessMind legga le righe così come sono state fornite e non debba ricavare attività mancanti.

Configurazione

Connettore: utilizzi il connettore Salesforce preconfigurato della piattaforma ETL o iPaaS e si autentichi con un utente d’integrazione che disponga dell’accesso in lettura a tutte le fonti configurate relative a fatture, cronologia degli stati, attività, pagamenti, registrazioni contabili e riconciliazioni.
Mappatura di oggetti e campi: sostituisca [Invoice object], [Invoice Number field], [Invoice Created Date field] e tutti gli altri riferimenti tra parentesi quadre con i nomi presenti nell’organizzazione Salesforce di destinazione. Le configurazioni Salesforce utilizzano spesso oggetti e campi personalizzati: verifichi quindi le mappature anziché darli per scontati.
Intervallo di date: inizi con dati relativi a un periodo da 3 a 6 mesi. Estenda il periodo retrospettivo se le fatture possono rimanere aperte tra periodi di rendicontazione e includa un margine temporale per le modifiche di stato, i pagamenti, i promemoria e gli eventi di riconciliazione.
Estrazione incrementale: ove disponibile, utilizzi come watermark il timestamp dell’ultima modifica della fonte estratta correttamente. Memorizzi il watermark al di fuori dell’Event Log e rielabori un breve intervallo sovrapposto per evitare di perdere aggiornamenti arrivati in ritardo.
Filtri: applichi filtri per società, unità aziendale, entità giuridica, valuta, tipo di fattura e ciclo di vita solo quando sono esplicitamente richiesti dall’analisi. Sostituisca [Company filter] e [Document type filter] con i criteri specifici dell’organizzazione oppure li rimuova se non pertinenti.
Cronologia degli stati: preferisca una fonte che conservi ogni transizione di stato. Il solo campo dello stato corrente della fattura non consente di ricostruire in modo affidabile le precedenti approvazioni, i rifiuti, le correzioni, gli invii, le chiusure o le cancellazioni contabili.
Evento calcolato sulla data di scadenza: Payment Due Date Reached viene generato a partire da PaymentDueDate e non corrisponde a un’azione di un utente Salesforce. Definisca se l’evento debba essere generato per tutte le fatture o solo per quelle rimaste aperte fino alla data di scadenza.
Record correlati: configuri le join utilizzando le chiavi di relazione effettive dell’organizzazione Salesforce. Non presuma che fatture, pagamenti, attività, registrazioni contabili e riconciliazioni utilizzino lo stesso campo di relazione in tutte le implementazioni.
Prestazioni: filtri i record della fonte per data prima delle join, selezioni solo i campi necessari, utilizzi la paginazione del connettore, attivi l’estrazione incrementale e, se supportato, suddivida gli intervalli di date più ampi. Eviti di estrarre ripetutamente l’intera cronologia.
Tipi di dati: normalizzi i timestamp in un unico fuso orario, conservi il timestamp originale della fonte quando è necessario garantire la verificabilità e utilizzi un tipo decimale per InvoiceTotalAmount.
Prerequisiti: la licenza ETL o iPaaS deve includere il connettore Salesforce, l’accesso API deve essere attivo per l’utente d’integrazione e l’utente deve disporre delle autorizzazioni a livello di oggetto, campo e record per ogni fonte configurata.
Sicurezza: conservi le credenziali nel gestore dei segreti della piattaforma, limiti l’accesso ai dati estratti agli utenti autorizzati e rispetti i limiti Salesforce e quelli dell’organizzazione relativi alle chiamate API e alla conservazione dei dati.

Query di esempio config

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

È pronto a iniziare?

Utilizzi questo template per avviare l’analisi dei processi e individuare opportunità di miglioramento significative. Inizi oggi a ottimizzare il processo di fatturazione e di emissione delle fatture.

Torna alla guida al miglioramento

Scarica il template

Pagamenti più rapidi: ottimizzi subito la fatturazione O2C

Riduca del 30% il tempo di ciclo della fatturazione e migliori il flusso di cassa, senza complicazioni.

Inizi la prova gratuita

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

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

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

Attributi di Order to Cash - fatturazione ed emissione delle fatture

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

Guide all’estrazione

Generatore di report Salesforce e servizio di esportazione dei dati

Passaggi

Configurazione

Query di esempio config

Script Python con la Salesforce REST API

Passaggi

Configurazione

Query di esempio python

Estrazione con uno strumento ETL tramite connettore Salesforce preconfigurato

Passaggi

Configurazione

Query di esempio config

È pronto a iniziare?

Pagamenti più rapidi: ottimizzi subito la fatturazione O2C