> Miglioramento continuo dei processi > Gestione delle note spese > SAP Concur > Template dei dati

Il template dei dati per la gestione delle spese

SAP Concur

Attributi per la gestione delle spese (18) Attività di gestione delle spese (14) Guide all’estrazione (2)

Il template dei dati per la gestione delle spese

Questo template offre indicazioni complete per raccogliere i dati necessari a ottimizzare il processo di gestione delle spese. Descrive gli attributi essenziali da acquisire, le attività principali da monitorare e le modalità pratiche per estrarre queste informazioni dai sistemi di origine. Utilizzi questa risorsa per creare un Event Log affidabile e ottenere informazioni approfondite sulle prestazioni del processo.

Attributi consigliati per un’analisi dettagliata
Attività principali da monitorare durante il ciclo di vita delle spese
Indicazioni per estrarre i dati da SAP Concur

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

Scarica il template

Attributi per la gestione delle spese

Questi sono i campi dati consigliati da includere nell’Event Log per analizzare in modo completo il processo di gestione delle spese.

5 Obbligatorio 6 Consigliato 7 Facoltativo

	Nome	Descrizione
	ID della nota spese ExpenseReportId	Identificativo univoco della nota spese, utilizzato come identificativo principale del caso.
Descrizione L’ID della nota spese è la chiave univoca che raggruppa tutte le attività relative a una singola richiesta di rimborso. Consente di seguire l’intero ciclo di vita della nota, dalla creazione da parte del dipendente fino al rimborso e alla registrazione contabile. Nel Process Mining, questo ID è essenziale per ricostruire il percorso end-to-end di ogni nota spese e costituisce la base di tutte le analisi del processo e dell’esplorazione delle varianti. Perché è importante È il fondamento dell’analisi, perché collega tutti i singoli eventi in un flusso di processo coerente per ciascuna nota spese. Dove reperirli Nella maggior parte delle estrazioni di dati e delle API di SAP Concur per la gestione delle note spese, questo campo è una chiave primaria, spesso indicata come ‘ID nota spese’ o ‘Chiave nota spese’. Esempi C6B2F1A8-4D4F-4C8D-9E9C-1F0D5B5A4B3CER-2023-08-1001400012345
	Nome dell’attività ActivityName	Nome dell’evento aziendale che si è verificato in un determinato momento del processo di gestione delle note spese.
Descrizione Il nome dell’attività descrive una fase o una tappa specifica del ciclo di vita della nota spese, ad esempio ‘Nota spese inviata’ o ‘Approvata dal responsabile’. Questo attributo è fondamentale per il Process Mining, perché definisce i nodi della mappa del processo e ne consente la visualizzazione e l’analisi. Analizzare la sequenza e la frequenza delle attività aiuta a individuare i percorsi più comuni, le deviazioni e i colli di bottiglia. Perché è importante Definisce le fasi della mappa del processo e consente di visualizzare e analizzare il percorso della nota spese. Dove reperirli Ricavato dagli Event Log o dai registri di audit di SAP Concur, che tracciano le modifiche di stato e le azioni eseguite su una nota spese. Esempi Nota spese inviataApprovata dal responsabileApprovata dall’ufficio finanziarioRimborso erogato
	Timestamp dell’evento EventTimestamp	Data e ora esatte in cui si è verificata una specifica attività.
Descrizione Questo timestamp indica il momento esatto in cui si è verificato un evento nel processo di gestione delle note spese. È fondamentale per il Process Mining, perché stabilisce l’ordine cronologico delle attività. La precisione di questi dati è essenziale per calcolare tempi di ciclo, durate e tempi di attesa tra le diverse fasi, così da individuare ritardi e colli di bottiglia nelle prestazioni del processo. Perché è importante Definisce la sequenza cronologica di tutti gli eventi e permette di calcolare le durate e analizzare nel tempo le prestazioni del processo. Dove reperirli Disponibile nei dati del registro di audit o dell’Event Log per ogni nota spese in SAP Concur e associato a ciascuna azione registrata. Esempi 2023-10-26T10:00:00Z2023-10-26T14:35:10Z2023-10-27T09:00:00Z
	Sistema di origine SourceSystem	Identifica il sistema da cui provengono i dati.
Descrizione Questo attributo indica l’applicazione di origine in cui sono stati generati i dati del processo di gestione delle note spese, in questo caso SAP Concur. È importante per la governance dei dati e per comprenderne il contesto, soprattutto quando un’analisi più ampia combina dati provenienti da più sistemi. Indicare esplicitamente l’origine aiuta a mantenere la tracciabilità dei dati e a risolvere i problemi di qualità. Perché è importante Garantisce la tracciabilità e la chiarezza dei dati, aspetti fondamentali quando si integrano dati provenienti da più sistemi aziendali. Dove reperirli In genere, è un valore statico aggiunto durante l’estrazione e la trasformazione dei dati per indicare l’origine del set di dati. Esempi SAP ConcurConcur Expense ProfessionalConcur Standard
	Ultimo aggiornamento dei dati LastDataUpdate	Timestamp che indica l’ultimo aggiornamento dei dati di questo record dal sistema di origine.
Descrizione Questo attributo registra la data e l’ora dell’ultima estrazione o dell’ultimo aggiornamento dei dati da SAP Concur. È un metadato fondamentale per valutare quanto siano aggiornati i dati analizzati. Aiuta analisti e utenti aziendali a capire quanto siano recenti le informazioni sul processo ed è essenziale per garantire l’integrità dei dati e pianificarne gli aggiornamenti. Perché è importante Fornisce informazioni essenziali sull’aggiornamento dei dati e garantisce che le analisi si basino su informazioni aggiornate. Dove reperirli Questo timestamp viene generato e aggiunto al set di dati durante il processo di acquisizione dei dati. Esempi 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	Categoria di spesa ExpenseCategory	La classificazione della spesa, ad esempio viaggio, pasti o materiale per ufficio.
Descrizione La categoria di spesa, detta anche tipo di spesa, classifica la natura dell’importo sostenuto. Questi dati sono fondamentali per la pianificazione finanziaria, la rendicontazione e l’analisi. Nel Process Mining, aiutano a verificare se alcune categorie sono più soggette a violazioni delle policy, tempi di approvazione più lunghi o rilavorazioni. Questo attributo è alla base della Dashboard «Precisione della classificazione delle spese». Perché è importante Consente di analizzare il comportamento del processo in base al tipo di spesa e di individuare eventuali problemi specifici di una categoria, legati alla conformità o all’efficienza. Dove reperirli In SAP Concur, questo dettaglio è disponibile a livello di singola voce. Per l’analisi a livello di caso, può essere aggregato oppure si può utilizzare la categoria più frequente. Esempi Biglietto aereoHotelPasto con un clienteAbbonamento software
	Flag di violazione della policy PolicyViolationFlag	Indica se la nota spese è stata segnalata per una violazione della policy.
Descrizione Attributo booleano che assume il valore vero se un controllo automatico o manuale rileva una violazione della policy nella nota spese. La violazione può riguardare il superamento dei limiti di spesa, l’uso di fornitori non preferenziali o la mancanza della documentazione richiesta. Questo flag è fondamentale per la Dashboard ‘Panoramica della conformità alla policy sulle spese’ e per il KPI ‘Tasso di violazione delle policy’, perché aiuta le organizzazioni a monitorare e applicare le proprie policy sulle spese. Perché è importante Supporta direttamente l’analisi della conformità e aiuta a misurare e migliorare il rispetto delle policy aziendali sulle spese, riducendo i rischi finanziari. Dove reperirli Spesso si tratta di un flag generato dal sistema in SAP Concur in base alle policy sulle spese configurate. È disponibile nei dati a livello di nota spese. Esempi truefalse
	ID dell’approvatore ApproverId	L’identificativo del responsabile o dell’utente dell’ufficio finanziario incaricato di approvare la nota spese.
Descrizione Questo attributo registra l’ID utente della persona che svolge un’attività di approvazione. Si distingue dall’ID utente generico del responsabile dell’elaborazione, perché riguarda nello specifico le fasi di approvazione. Questi dati sono essenziali per la Dashboard «Prestazioni e assegnazione degli approvatori», che consente di analizzare i tempi di approvazione, i tassi di rifiuto e i carichi di lavoro per approvatore. Aiuta inoltre a individuare assegnazioni non coerenti e opportunità per bilanciare i carichi di lavoro. Perché è importante Consente di analizzare nel dettaglio le prestazioni degli approvatori, ottimizzare i flussi di lavoro di approvazione e individuare opportunità di formazione. Dove reperirli Queste informazioni fanno parte dei dati del flusso di lavoro o della traccia di audit e sono associate alle fasi di approvazione in SAP Concur. Esempi m.joness.lee987654
	ID utente che ha elaborato l’attività ProcessorUserId	Identificativo del dipendente o dell’utente di sistema che ha eseguito l’attività.
Descrizione Questo attributo identifica la persona responsabile di una determinata attività, ad esempio il dipendente che invia la nota spese, il responsabile che la approva o il membro del team finanziario che la elabora. Analizzare chi ha eseguito l’attività consente di valutare la distribuzione del carico di lavoro, confrontare le prestazioni di utenti o team e comprendere come viene assegnato il lavoro. È fondamentale per le Dashboard dedicate alle prestazioni degli approvatori e al carico di lavoro dell’ufficio finanziario. Perché è importante Consente di analizzare la distribuzione del carico di lavoro, le prestazioni degli utenti e l’allocazione delle risorse, aspetti essenziali per individuare le esigenze di formazione e le opportunità di miglioramento del processo. Dove reperirli Disponibile nei dati del registro di audit di una nota spese, spesso associato a fasi del flusso di lavoro come l’approvazione o l’invio. Esempi j.doe789123asmith
	Importo totale della nota spese ReportTotalAmount	Importo complessivo della nota spese.
Descrizione Questo attributo registra la somma di tutte le spese incluse in una singola nota. È una metrica fondamentale per l’analisi finanziaria, perché consente di suddividere le note spese in base all’importo. Le note di importo elevato possono seguire percorsi di approvazione diversi o richiedere controlli più approfonditi; analizzare gli importi aiuta a comprendere i fattori che determinano i costi, i rischi di conformità e l’impatto finanziario. Perché è importante Fornisce un contesto finanziario essenziale e consente di analizzare i dati in base agli importi, ad esempio individuando le note spese di valore elevato che potrebbero richiedere ulteriori verifiche. Dove reperirli È un campo dell’intestazione della nota spese, disponibile nelle estrazioni standard dei dati di SAP Concur. Esempi 150.752500.0089.50
	Reparto del dipendente EmployeeDepartment	Reparto o centro di costo a cui appartiene il dipendente che ha inviato la nota spese.
Descrizione Questo attributo identifica l’unità organizzativa del dipendente che ha inviato la nota spese. Viene utilizzato per l’allocazione finanziaria e per analizzare le prestazioni del processo nelle diverse aree aziendali. Filtrando o confrontando i reparti, i responsabili possono individuare differenze nei tempi di approvazione, nella conformità alle policy e nei tassi di rilavorazione, così da indirizzare gli interventi di miglioramento dove sono più necessari. Perché è importante Consente di analizzare il processo per unità aziendale e di individuare comportamenti specifici dei reparti, colli di bottiglia o problemi di conformità. Dove reperirli Queste informazioni provengono in genere dal profilo del dipendente in SAP Concur, spesso sincronizzato con un sistema informativo delle risorse umane. Esempi VenditeMarketingRicerca e sviluppoFinanza
	È una rilavorazione IsRework	Un indicatore calcolato che segnala se la nota spese è stata restituita per una revisione.
Descrizione Questo attributo booleano derivato assume valore vero se la nota spese ha attraversato almeno un ciclo di revisione, identificato dalla presenza dell’attività «Nota spese restituita per revisione». L’indicatore semplifica il calcolo del KPI «Tasso di rilavorazione delle note spese» e permette di filtrare e confrontare facilmente le note spese approvate al primo tentativo con quelle che hanno richiesto una rilavorazione. L’analisi di questi casi aiuta a individuare le cause più comuni dei rifiuti e a migliorare la qualità al primo tentativo. Perché è importante Semplifica l’analisi delle inefficienze del processo segnalando direttamente i casi che hanno richiesto ulteriore lavoro e aiutando a quantificare e ridurre le rilavorazioni. Dove reperirli Questo attributo non è presente nel sistema di origine. Viene calcolato durante la trasformazione dei dati verificando se, per un determinato ID del caso, è presente l’attività «Nota spese restituita per revisione». Esempi truefalse
	Esito dell’audit AuditOutcome	Esito di un audit manuale o automatico della nota spese.
Descrizione Questo attributo registra la decisione finale della revisione di audit, che può essere «Superato», «Non superato» o «Superato con avvertenza». È un dato di input diretto per il KPI «Frequenza dei rilievi di audit». Analizzare gli esiti degli audit aiuta a individuare le cause più comuni degli esiti negativi, come ricevute mancanti o mancato rispetto delle policy, e fornisce riscontri utili per migliorare i controlli iniziali e la formazione dei dipendenti. Perché è importante Misura direttamente l’efficacia dei controlli di conformità ed è essenziale per monitorare e ridurre i rischi e i costi legati agli audit. Dove reperirli Queste informazioni provengono dal modulo o dal servizio di audit di SAP Concur e sono disponibili se l’organizzazione utilizza questa funzionalità. Esempi SuperatoNon superato: ricevuta mancanteSuperato con avvertenzaNon sottoposto ad audit
	Paese del dipendente EmployeeCountry	Il paese del dipendente che invia la nota spese.
Descrizione Questo attributo identifica il paese in cui ha sede il dipendente. Nelle organizzazioni globali è una dimensione di analisi importante, perché consente di confrontare le prestazioni del processo, i livelli di conformità e i costi nelle diverse aree geografiche. Le normative, le policy e i comportamenti degli utenti specifici di ciascun paese possono generare variazioni significative del processo, che è importante comprendere. Perché è importante Consente di confrontare le prestazioni del processo e la conformità a livello regionale e nazionale, un aspetto fondamentale per armonizzare i processi a livello globale. Dove reperirli Questi dati fanno parte del profilo utente del dipendente in SAP Concur e in genere vengono sincronizzati da un sistema HR centrale. Esempi USADEUGBRJPN
	Stato della nota spese ReportStatus	Lo stato corrente della nota spese nel suo ciclo di vita.
Descrizione Questo attributo indica lo stato corrente del caso relativo alla nota spese, ad esempio «In attesa di approvazione», «Approvata per il pagamento» o «Pagata». Sebbene il Process Mining si basi principalmente sulla sequenza delle attività, lo stato finale del caso è utile per filtrare e segmentare le note spese. Ad esempio, l’analisi può concentrarsi solo su quelle completate («Pagata») oppure individuare le note spese che restano a lungo in un determinato stato. Perché è importante Fornisce un quadro dello stato corrente di un caso, utile per filtrare le note spese in corso o completate e per il monitoraggio operativo. Dove reperirli In SAP Concur, questo è un campo di stato principale nell’intestazione della nota spese. Esempi Inviata e in attesa di approvazioneApprovata e in revisione contabilePagataRifiutata
	Tempo di ciclo complessivo EndToEndCycleTime	Il tempo totale dalla creazione della nota spese alla registrazione contabile finale.
Descrizione Questa metrica calcolata misura la durata complessiva del processo di gestione delle spese per una singola nota. In genere si calcola come differenza tra il primo evento, «Nota spese creata», e l’ultimo, «Registrazione contabile effettuata». Offre una visione d’insieme delle prestazioni del processo ed è alla base del KPI «Tempo medio di ciclo complessivo», utilizzato per monitorare i miglioramenti dell’efficienza generale del processo. Perché è importante Fornisce una misura complessiva della velocità del processo, dall’inizio alla fine, ed è un indicatore chiave dell’efficienza generale. Dove reperirli Questa metrica viene calcolata durante l’analisi dei dati, sottraendo il timestamp dell’evento più recente da quello dell’evento più remoto per ciascun caso completato. Esempi 10 giorni e 2 ore15 giorni8 giorni e 12 ore
	Tipo di pagamento PaymentType	Indica il metodo di pagamento delle spese, ad esempio carta aziendale o anticipo personale.
Descrizione Questo attributo distingue le spese pagate con una carta di credito aziendale da quelle anticipate personalmente dal dipendente, in attesa di rimborso. Il tipo di pagamento può influire in modo significativo sul flusso del processo. Ad esempio, le transazioni con carta aziendale possono richiedere ulteriori fasi di riconciliazione, mentre per le spese anticipate dal dipendente la rapidità del rimborso incide direttamente sulla sua soddisfazione. Perché è importante Aiuta a distinguere le varianti del processo per le spese con carta aziendale e quelle anticipate dal dipendente, che spesso comportano requisiti di elaborazione e rischi diversi. Dove reperirli In SAP Concur, questo è un campo standard a livello di registrazione della spesa. Esempi Carta aziendaleAnticipo personaleAnticipo in contanti
	Valuta della nota spese ReportCurrency	Valuta in cui è stata inviata la nota spese.
Descrizione Questo attributo indica il codice della valuta, ad esempio USD o EUR, dell’importo totale richiesto nella nota spese. È essenziale per interpretare e confrontare correttamente gli importi nelle analisi finanziarie. Nelle organizzazioni internazionali, analizzare le spese per valuta può fornire informazioni sui modelli di spesa regionali e sull’impatto dei cambi. Perché è importante È essenziale per una rendicontazione e un’analisi finanziaria accurate, soprattutto nelle aziende multinazionali che gestiscono più valute. Dove reperirli È un campo standard dell’intestazione della nota spese in SAP Concur. Esempi USDEURGBPJPY

Obbligatorio Consigliato Facoltativo

Attività di gestione delle spese

Queste sono le fasi e le tappe fondamentali da acquisire nell’Event Log per individuare e ottimizzare con precisione il processo di gestione delle spese.

6 Consigliato 8 Facoltativo

	Attività	Descrizione
	Approvata dal responsabile	Il responsabile diretto esamina e approva la nota spese, che passa così alla fase successiva del flusso di lavoro. L’azione viene registrata come modifica di stato, insieme ai dati dell’approvatore e al timestamp.
Perché è importante È una tappa fondamentale dell’approvazione. Monitorarla consente di analizzare i tempi di approvazione dei responsabili e di individuare i colli di bottiglia nella prima fase di revisione. Dove reperirli L’evento è registrato nelle tabelle della cronologia del flusso di lavoro o delle approvazioni di SAP Concur ed è associato all’ID della nota spese. Include l’identità dell’approvatore e il timestamp dell’approvazione. Acquisizione Evento registrato nella cronologia delle approvazioni quando il responsabile approva la nota spese. Tipo di evento explicit
	Approvata dall’ufficio finanziario	Il team finanziario o di audit completa la revisione e approva definitivamente il rimborso. Questa tappa fondamentale è registrata esplicitamente nella cronologia delle approvazioni.
Perché è importante Questo evento segna la fine dell’intero ciclo di approvazione. È il punto finale per misurare il tempo complessivo di approvazione e dà avvio al processo di rimborso. Dove reperirli L’evento è registrato nelle tabelle della cronologia del flusso di lavoro di SAP Concur e include l’identità dell’approvatore e il timestamp dell’approvazione finale. Acquisizione Evento registrato nella cronologia delle approvazioni quando il team finanziario approva la nota spese. Tipo di evento explicit
	Nota spese creata	Indica l’avvio di una nuova nota spese da parte di un dipendente. L’evento viene registrato quando un utente salva per la prima volta una nuova nota spese, generando un ID univoco della nota spese.
Perché è importante È il punto di partenza per tutti i calcoli del tempo di ciclo end-to-end e costituisce la base di riferimento per misurare la durata complessiva del processo. Dove reperirli Di norma, l’evento è registrato esplicitamente nelle tabelle di audit di SAP Concur, ad esempio nella tabella delle intestazioni delle note spese, con il timestamp di creazione generato insieme al nuovo ID. Acquisizione Evento registrato alla creazione di una nuova nota spese. Tipo di evento explicit
	Nota spese inviata	Il dipendente invia formalmente la nota spese completata per l’approvazione. Questa azione, avviata dall’utente, cambia lo stato della nota da ‘Bozza’ a ‘Inviata’ e avvia il flusso di lavoro di approvazione.
Perché è importante È una tappa fondamentale che segna l’inizio del ciclo di approvazione ed è indispensabile per misurare i tempi di approvazione dei responsabili e dell’ufficio finanziario. Dove reperirli L’evento è registrato esplicitamente nel registro di audit di SAP Concur. Lo stato dell’intestazione della nota spese cambia e viene salvato il timestamp dell’invio. Acquisizione Evento ricavato dal campo del timestamp di invio della nota spese o dal log del flusso di lavoro. Tipo di evento explicit
	Registrazione contabile completata	La transazione finanziaria relativa al rimborso viene registrata ufficialmente nel libro mastro generale dell’azienda. Questa fase finale viene spesso rilevata quando i dati sono estratti e caricati nel sistema ERP.
Perché è importante È l’ultima attività del processo end-to-end. È essenziale per misurare il tempo di ciclo complessivo e il ritardo nella registrazione contabile. Dove reperirli In genere, l’evento proviene dal sistema ERP finanziario collegato ed è ricavato dalla data di registrazione associata alla scrittura contabile della nota spese. Acquisizione Evento ricavato dalla data di registrazione nel sistema finanziario e associato all’ID della nota spese. Tipo di evento explicit
	Rimborso erogato	Il pagamento viene elaborato e i fondi sono versati al dipendente. In genere, il sistema di pagamento genera un evento esplicito e aggiorna quindi lo stato in SAP Concur.
Perché è importante Segna il completamento del pagamento, un passaggio fondamentale per la soddisfazione dei dipendenti. È il punto finale per misurare l’efficienza dei rimborsi. Dove reperirli L’evento è ricavato dal campo della data di elaborazione del pagamento o da un aggiornamento di stato proveniente da un sistema di pagamento integrato. Spesso si utilizza il campo ‘Data di pagamento’ della nota spese. Acquisizione L’evento è ricavato dal campo della data di elaborazione del pagamento o da un aggiornamento di stato proveniente da un sistema di pagamento integrato. Tipo di evento explicit
	Immagine della ricevuta allegata	Indica che un utente carica l’immagine di una ricevuta e la allega a una nota spese. In genere, il sistema registra esplicitamente questa operazione nei log di audit per ogni allegato.
Perché è importante Analizzare quando e con quale frequenza si svolge questa attività aiuta a comprendere il comportamento degli utenti e a individuare i ritardi tra la creazione della nota spese e la sua preparazione per l’invio. Dove reperirli L’operazione è registrata nei log delle immagini o degli allegati di SAP Concur e associata all’ID della nota spese. Spesso il registro di audit del sistema riporta l’azione dell’utente e il relativo timestamp. Acquisizione Evento registrato quando un’immagine viene caricata correttamente e associata alla nota spese. Tipo di evento explicit
	Nota spese restituita per la revisione	Un approvatore, responsabile o revisore dell’ufficio finanziario, restituisce la nota spese al dipendente perché la corregga. Questa azione esplicita riporta lo stato della nota a ‘Bozza’ o a uno stato in attesa di intervento del dipendente.
Perché è importante Questa attività è il principale indicatore di rilavorazione e inefficienza del processo. Analizzarne la frequenza aiuta a individuare gli errori più comuni e ad aumentare la percentuale di approvazioni al primo invio. Dove reperirli L’evento è registrato nella cronologia del flusso di lavoro di SAP Concur. Il sistema registra l’azione ‘Restituisci’ con un timestamp e spesso richiede all’approvatore di aggiungere un commento. Acquisizione Evento ricavato dal log del flusso di lavoro quando un approvatore esegue l’azione ‘Restituisci’. Tipo di evento explicit
	Respinta dal responsabile	Il responsabile diretto respinge la nota spese, interrompendo in genere il processo, a meno che non sia possibile inviarla nuovamente. Per il flusso di lavoro in corso, si tratta di un evento conclusivo, registrato con lo stato finale ‘Respinta’.
Perché è importante Questa attività rappresenta un’eccezione o un esito negativo del processo. Analizzare i respingimenti aiuta a comprendere le cause delle violazioni delle policy o delle richieste non valide. Dove reperirli L’evento è registrato nella cronologia delle approvazioni di SAP Concur con lo stato ‘Respinta’ e un timestamp. Il flusso di lavoro della nota spese viene interrotto. Acquisizione Evento registrato nella cronologia delle approvazioni quando il responsabile respinge la nota spese. Tipo di evento explicit
	Respinta dall’ufficio finanziario	Il team finanziario respinge la nota spese, interrompendo in genere il processo per quella richiesta. Si tratta di un esito negativo definitivo, registrato dall’approvatore dell’ufficio finanziario con lo stato ‘Respinta’.
Perché è importante Rappresenta un’interruzione definitiva del processo da parte dell’approvatore finale. Analizzare questi respingimenti è essenziale per migliorare la conformità e la qualità dei dati. Dove reperirli L’evento è registrato nella cronologia delle approvazioni di SAP Concur con lo stato ‘Respinta’, il timestamp e l’identità dell’approvatore dell’ufficio finanziario. Acquisizione Evento registrato nella cronologia delle approvazioni quando il team finanziario respinge la nota spese. Tipo di evento explicit
	Revisione dell’ufficio finanziario avviata	La nota spese entra nella coda del team finanziario o della contabilità fornitori per la revisione finale. L’evento si deduce dal timestamp della modifica di stato della nota a ‘In attesa di revisione finanziaria’ o a uno stato analogo.
Perché è importante Segna l’inizio del ciclo di revisione dell’ufficio finanziario. È il punto di partenza per misurare il carico di lavoro e l’efficienza del team. Dove reperirli L’evento si deduce dal log del flusso di lavoro o dalla cronologia degli stati, in particolare dal timestamp associato al passaggio della nota spese allo stato ‘In attesa di revisione contabile’ o a uno stato analogo. Acquisizione Evento dedotto dal timestamp della modifica di stato a ‘In attesa di revisione finanziaria’. Tipo di evento inferred
	Revisione di audit richiesta	La nota spese viene inoltrata a un team di audit o di conformità per ulteriori verifiche. Spesso l’inoltro è determinato da specifiche tipologie di spesa o da determinati importi e viene registrato con una modifica di stato che indica l’ingresso nella coda di audit.
Perché è importante Individua una fase aggiuntiva del processo, spesso dispendiosa in termini di tempo. Analizzare questo percorso è importante per comprendere i ritardi relativi a specifiche tipologie di note spese. Dove reperirli L’evento si deduce da una modifica dello stato nel flusso di lavoro della nota spese, ad esempio il passaggio allo stato ‘In attesa di audit’ o ‘Nella coda di audit’. Acquisizione Evento dedotto dalla modifica del campo di stato della nota spese a un valore relativo all’audit. Tipo di evento inferred
	Rimborso programmato	Dopo l’approvazione finale, la nota spese viene inviata a un sistema di pagamento e inserita nella coda dei rimborsi. L’evento si deduce spesso dal passaggio allo stato ‘In attesa di pagamento’ o ‘Approvata per il pagamento’.
Perché è importante Questa attività segna il passaggio dall’approvazione al pagamento ed è il punto di partenza per misurare i tempi di erogazione del rimborso. Dove reperirli L’evento si può dedurre dalla modifica di stato a ‘Inviata per il pagamento’. Nei sistemi integrati, può corrispondere a un evento esplicito generato dalla creazione di un lotto di pagamento. Acquisizione Evento dedotto dal timestamp della modifica di stato a uno stato di attesa del pagamento. Tipo di evento inferred
	Violazione della policy segnalata	Una regola automatica del sistema o un revisore segnala una violazione della policy nella nota spese. La segnalazione può essere dedotta dall’applicazione di un flag specifico o di un codice di eccezione alla nota o a una sua voce.
Perché è importante Questo evento è fondamentale per la Dashboard Panoramica della conformità alle policy sulle spese. Consente di analizzare le violazioni più frequenti e aiuta a migliorare il rispetto delle policy. Dove reperirli L’evento si deduce dalle modifiche al flag di violazione della policy o al campo del codice di eccezione nei dati della nota spese. Potrebbe non corrispondere a un evento distinto, ma a una variazione dello stato di un attributo. Acquisizione Evento dedotto dalla modifica dell’attributo ‘Flag di violazione della policy’ da falso a vero. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione

Come estrarre i dati da SAP Concur

Passaggi

Acceda a SAP Concur: acceda a SAP Concur con un account utente dotato delle autorizzazioni necessarie, ad esempio Web Services Administrator o Expense Processor, per configurare ed eseguire le estrazioni.
Apra la configurazione dell’estrazione: acceda al menu Administration. Selezioni Company, quindi apra Tools. Nell’elenco degli strumenti, scelga Standard Accounting Extract.
Definisca l’estrazione: crei una nuova definizione oppure ne selezioni una esistente da modificare. Assegni all’estrazione un nome descrittivo, ad esempio ProcessMind_Event_Log_Extract.
Configuri i campi dell’estrazione: questa è la fase più importante. Esamini le schede di configurazione e selezioni i campi necessari per creare l’Event Log. Si assicuri di includere:
- Dati di intestazione della nota spese: i campi Report ID, Report Create Date, Report Submit Date, Report Total, Employee Org Unit, Paid Date e Processing Payment Date.
- Cronologia del flusso di lavoro: abiliti l’esportazione dei dati della traccia di controllo del flusso di lavoro. È essenziale per acquisire gli eventi di approvazione, rifiuto e restituzione. Includa campi come Workflow Step Code, Workflow Step Date e Approver Login ID.
- Dati delle eccezioni: includa campi come Has Exception o codici di eccezione specifici per individuare le violazioni delle policy.
Imposti il formato e la modalità di consegna del file: configuri il file di output come file di testo delimitato, ad esempio con separatore pipe (|) o virgola. Si assicuri che la codifica dei caratteri sia UTF-8. Specifichi la modalità di consegna, che in genere prevede l’invio al sito SFTP designato dall’azienda.
Pianifichi l’estrazione: configuri un’esecuzione automatica ricorrente. Si consiglia una pianificazione giornaliera per mantenere aggiornati i dati del processo.
Esegua l’estrazione iniziale: per il caricamento iniziale, esegua manualmente l’estrazione su un periodo storico, ad esempio gli ultimi 3-6 mesi. L’operazione si svolge dalla schermata 'Run Extract'.
Scarichi i file estratti: al termine dell’estrazione, i file di output saranno disponibili sul server SFTP. Potrebbero essere presenti più file, ad esempio un file con le intestazioni delle note spese, uno con le registrazioni contabili e uno con la cronologia del flusso di lavoro.
Trasformi i dati: i file estratti non sono già in formato Event Log. Utilizzi uno script, ad esempio in Python o PowerShell, oppure uno strumento ETL per elaborare e combinare i file. Lo script deve riorganizzare i dati creando una riga distinta per ogni attività aziendale, ad esempio Created, Submitted e Approved, in base alle date e alle fasi del flusso di lavoro presenti nei file.
Generi l’Event Log: lo script di trasformazione deve produrre un unico file CSV con le colonne indicate nei requisiti dei dati, tra cui ExpenseReportId, ActivityName, EventTimestamp e gli altri attributi.
Carichi i dati in ProcessMind: carichi il file CSV finale trasformato nel progetto ProcessMind per avviare l’analisi.

Configurazione

Definizione dell’estrazione: utilizzi la funzionalità Standard Accounting Extract, disponibile in Administration > Tools.
Fonti di dati principali: la configurazione deve acquisire dati da più tipi di record in Concur. Si assicuri che nella definizione dell’estrazione siano inclusi:
- Record di intestazione della nota spese: contiene i dettagli principali e le date rilevanti.
- Record della traccia di controllo del flusso di lavoro: essenziale per acquisire tutte le fasi di approvazione, rifiuto e revisione, con i relativi timestamp e ID utente.
- Dati del profilo dipendente: per includere attributi come EmployeeDepartment.
Intervallo di date: l’estrazione riguarda i record modificati in un intervallo di date specifico. Per il caricamento iniziale, configuri un periodo storico di 3-6 mesi. Per gli aggiornamenti successivi, l’estrazione dovrebbe essere eseguita ogni giorno sui dati del giorno precedente.
Formato del file: si consiglia un file di testo delimitato da pipe (|) per evitare conflitti con le virgole presenti nei campi di testo. Utilizzi la codifica UTF-8.
Prerequisiti: l’utente che configura ed esegue l’estrazione deve disporre di ruoli amministrativi in Concur, in genere 'Web Services Administrator', oppure delle autorizzazioni 'Expense Configuration' e 'Processor'. È inoltre necessario poter accedere al server SFTP su cui Concur invia i file.

a Query di esempio sql

-- This is a logical representation of the transformation required to convert the
-- SAP Concur Standard Accounting Extract files into a process mining event log.
-- The source files (e.g., ReportHeader.csv, WorkflowHistory.csv) are the output of the extract.

-- Activity: Expense Report Created
SELECT
    ReportID AS ExpenseReportId,
    'Expense Report Created' AS ActivityName,
    ReportCreateDate AS EventTimestamp,
    EmployeeLoginID AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv

UNION ALL

-- Activity: Expense Report Submitted
SELECT
    ReportID AS ExpenseReportId,
    'Expense Report Submitted' AS ActivityName,
    ReportSubmitDate AS EventTimestamp,
    EmployeeLoginID AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv
WHERE ReportSubmitDate IS NOT NULL

UNION ALL

-- Activity: Manager Approved
SELECT
    ReportID AS ExpenseReportId,
    'Manager Approved' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    w.ApproverLoginID AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    w.ApproverLoginID AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepAction = 'Approve' AND w.ApproverRole = 'Manager'

UNION ALL

-- Activity: Report Sent Back for Revision
SELECT
    ReportID AS ExpenseReportId,
    'Report Sent Back for Revision' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    w.ApproverLoginID AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    w.ApproverLoginID AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepAction = 'Send Back'

UNION ALL

-- Activity: Manager Rejected
SELECT
    ReportID AS ExpenseReportId,
    'Manager Rejected' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    w.ApproverLoginID AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    w.ApproverLoginID AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepAction = 'Reject' AND w.ApproverRole = 'Manager'

UNION ALL

-- Activity: Finance Approved
SELECT
    ReportID AS ExpenseReportId,
    'Finance Approved' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    w.ApproverLoginID AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    w.ApproverLoginID AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepAction = 'Approve' AND w.ApproverRole = 'Processor'

UNION ALL

-- Activity: Finance Rejected
SELECT
    ReportID AS ExpenseReportId,
    'Finance Rejected' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    w.ApproverLoginID AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    w.ApproverLoginID AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepAction = 'Reject' AND w.ApproverRole = 'Processor'

UNION ALL

-- Activity: Reimbursement Scheduled
SELECT
    ReportID AS ExpenseReportId,
    'Reimbursement Scheduled' AS ActivityName,
    PaymentProcessingDate AS EventTimestamp,
    'SYSTEM' AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv
WHERE PaymentProcessingDate IS NOT NULL

UNION ALL

-- Activity: Reimbursement Executed
SELECT
    ReportID AS ExpenseReportId,
    'Reimbursement Executed' AS ActivityName,
    PaidDate AS EventTimestamp,
    'SYSTEM' AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv
WHERE PaidDate IS NOT NULL

UNION ALL

-- Activity: Accounting Posted
SELECT
    ReportID AS ExpenseReportId,
    'Accounting Posted' AS ActivityName,
    ExtractDate AS EventTimestamp,
    'SYSTEM' AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv
WHERE ExtractDate IS NOT NULL

-- The following activities are more complex and may require specific configuration or inference.
-- The logic provided is a common approach.

UNION ALL

-- Activity: Receipts Image Attached (inferred from first submission)
SELECT
    ReportID AS ExpenseReportId,
    'Receipts Image Attached' AS ActivityName,
    ReportSubmitDate AS EventTimestamp, -- This is an approximation; precise time is not in standard extracts
    EmployeeLoginID AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv
WHERE HasImage = 'Y' AND ReportSubmitDate IS NOT NULL

UNION ALL

-- Activity: Policy Violation Flagged (inferred from exception flag at time of submission)
SELECT
    ReportID AS ExpenseReportId,
    'Policy Violation Flagged' AS ActivityName,
    ReportSubmitDate AS EventTimestamp,
    'SYSTEM' AS ProcessorUserId,
    ReportTotal AS ReportTotalAmount,
    EmployeeOrgUnit AS EmployeeDepartment,
    HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM ReportHeader.csv
WHERE HasException = 'Y' AND ReportSubmitDate IS NOT NULL

UNION ALL

-- Activity: Audit Review Required (inferred from workflow step)
SELECT
    ReportID AS ExpenseReportId,
    'Audit Review Required' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    w.ApproverLoginID AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    w.ApproverLoginID AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepName LIKE '%Audit%'

UNION ALL

-- Activity: Finance Review Started (inferred from entering Processor queue)
SELECT
    ReportID AS ExpenseReportId,
    'Finance Review Started' AS ActivityName,
    WorkflowStepDate AS EventTimestamp,
    'SYSTEM' AS ProcessorUserId,
    h.ReportTotal AS ReportTotalAmount,
    h.EmployeeOrgUnit AS EmployeeDepartment,
    h.HasException AS PolicyViolationFlag,
    NULL AS ApproverId,
    NULL AS ExpenseCategory,
    'SAP Concur' as SourceSystem,
    GETDATE() as LastDataUpdate
FROM WorkflowHistory.csv w
JOIN ReportHeader.csv h ON w.ReportID = h.ReportID
WHERE w.WorkflowStepName LIKE '%Processor Review%';

Passaggi

Prerequisiti e configurazione dell’ambiente: si assicuri che sul sistema sia installato Python 3.6 o una versione successiva. Installi le librerie Python necessarie, pandas per la manipolazione dei dati e requests per le chiamate API, eseguendo il comando: pip install pandas requests.
Ottenga le credenziali API: acceda alla Sua istanza SAP Concur con un utente che dispone del ruolo "Web Services Administrator". Acceda a Administration > Company > Web Services per registrare una nuova applicazione. Prenda nota di Client ID, Client Secret e Base URI dell’azienda, ad esempio https://us.api.concursolutions.com. Queste credenziali sono necessarie per l’autenticazione OAuth 2.0.
Configuri lo script Python: copi lo script Python fornito in un file, ad esempio extract_concur_events.py. Nella sezione di configurazione dello script, individui le variabili segnaposto e le sostituisca con i valori effettivi di Client ID, Client Secret e Base URI.
Imposti i parametri di estrazione: definisca l’intervallo di date impostando nello script le variabili START_DATE e END_DATE. Per verificare il processo di estrazione, si consiglia di iniziare con un intervallo più breve, ad esempio un mese.
Esegua lo script: avvii lo script dal terminale con il comando python extract_concur_events.py. Lo script si autenticherà presso l’API SAP Concur, recupererà l’elenco delle note spese nell’intervallo specificato e ne acquisirà i dettagli.
Elaborazione dei dati API: lo script esamina l’intestazione, le voci e la traccia di controllo di ogni nota spese. Associa i dati dell’API, come CreateDate, SubmitDate, gli stati di pagamento e le voci della traccia di controllo, alle attività di processo necessarie, ad esempio 'Expense Report Created', 'Manager Approved' e 'Reimbursement Executed'.
Gestione della paginazione API: l’API Concur Reports v4 restituisce risultati suddivisi in pagine. Lo script gestisce automaticamente la paginazione, verificando la presenza di un URL nextPage nella risposta API ed effettuando le richieste successive finché non ha recuperato tutte le note spese del periodo indicato.
Composizione dell’Event Log: per ogni attività individuata, lo script crea un record contenente ExpenseReportId, ActivityName, EventTimestamp e tutti gli altri attributi necessari e consigliati. I record vengono raccolti in un unico elenco.
Trasformi ed esporti i dati: una volta elaborate tutte le note spese, lo script utilizza la libreria pandas per convertire l’elenco dei record degli eventi in un DataFrame strutturato. Il DataFrame viene quindi esportato in un file CSV denominato concur_event_log.csv, nella stessa cartella da cui è stato eseguito lo script.
Prepari il caricamento: il file concur_event_log.csv generato è formattato e pronto per essere caricato nella piattaforma ProcessMind. Non sono necessarie ulteriori modifiche alla struttura.

Configurazione

Credenziali API: è necessario disporre di un’applicazione client registrata nell’area di amministrazione Web Services di SAP Concur. Per l’autenticazione, lo script richiede:
- Client ID: identificativo univoco dell’applicazione.
- Client Secret: chiave segreta dell’applicazione.
- Base URI: URL di base dell’API dell’istanza Concur, ad esempio https://us.api.concursolutions.com.
Filtri per intervallo di date: lo script utilizza un filtro lastModifiedDate per recuperare le note spese modificate in un determinato periodo. È fondamentale impostare i parametri START_DATE e END_DATE per controllare il volume dei dati. Per la prima estrazione si consiglia un periodo di 3-6 mesi.
Endpoint API: lo script interagisce principalmente con i seguenti endpoint SAP Concur Platform REST API v4:
- POST /oauth2/v0/token: per ottenere un token di accesso OAuth 2.0.
- GET /expensereports/v4/reports: per recuperare l’elenco delle note spese in base ai filtri.
- GET /expensereports/v4/reports/{reportId}: per recuperare tutti i dettagli di una nota spese specifica, inclusi la traccia di controllo e i dati di pagamento.
Considerazioni sulle prestazioni: l’estrazione di dati relativi a periodi lunghi può comportare un numero elevato di chiamate API. L’API Concur applica limiti alle richieste. Per insiemi di dati molto ampi, potrebbe essere necessario aggiungere allo script intervalli di attesa o una gestione degli errori più robusta, così da rispettare i limiti ed evitare timeout.
Autorizzazioni utente: i dati restituiti dall’API dipendono dalle autorizzazioni dell’account associato alle credenziali API. Si assicuri che l’utente possa visualizzare tutti i dati necessari delle note spese dell’organizzazione.

a Query di esempio python

import requests
import pandas as pd
import json
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Section --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Concur API credentials and settings
CLIENT_ID = class="hl-string">'YOUR_CLIENT_ID'
CLIENT_SECRET = class="hl-string">'YOUR_CLIENT_SECRET'
BASE_URI = class="hl-string">'https://us.api.concursolutions.com' class=class="hl-string">"hl-comment"># Or your specific regional URI

class=class="hl-string">"hl-comment"># Define the date range for the extraction
START_DATE = class="hl-string">'2023-01-01T00:00:00.000Z'
END_DATE = class="hl-string">'2023-06-30T23:59:59.000Z'

class=class="hl-string">"hl-comment"># --- End Configuration Section --- #

def get_access_token():
    class="hl-string">"""Authenticates with Concur API to get an OAuth 2.0 access token."""
    token_url = fclass="hl-string">'{BASE_URI}/oauth2/v0/token'
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/x-www-form-urlencoded'}
    data = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    try:
        response = requests.post(token_url, headers=headers, data=data)
        response.raise_for_status()
        token_data = response.json()
        return token_data.get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">'Error getting access token: {e}')
        return None

def get_reports(token, next_page_url=None):
    class="hl-string">"""Fetches a paginated list of expense reports."""
    if next_page_url:
        url = next_page_url
    else:
        url = fclass="hl-string">'{BASE_URI}/expensereports/v4/reports?lastModifiedDateAfter={START_DATE}&lastModifiedDateBefore={END_DATE}'
    
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}', class="hl-string">'Accept': class="hl-string">'application/json'}
    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">'Error fetching reports list: {e}')
        return None

def get_report_details(token, report_id):
    class="hl-string">"""Fetches the full details for a single expense report."""
    url = fclass="hl-string">'{BASE_URI}/expensereports/v4/reports/{report_id}'
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}', class="hl-string">'Accept': class="hl-string">'application/json'}
    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">'Error fetching details for report {report_id}: {e}')
        return None

def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">'Could not obtain access token. Exiting.')
        return

    print(class="hl-string">'Successfully obtained access token. Starting report extraction...')
    event_log = []
    last_data_update = datetime.utcnow().isoformat() + class="hl-string">'Z'

    next_page = None
    page_count = 1

    while True:
        print(fclass="hl-string">'Fetching page {page_count} of reports...')
        reports_data = get_reports(access_token, next_page)
        if not reports_data or not reports_data.get(class="hl-string">'value'):
            print(class="hl-string">'No more reports found or API error.')
            break

        for report_summary in reports_data[class="hl-string">'value']:
            report_id = report_summary.get(class="hl-string">'id')
            if not report_id:
                continue

            details = get_report_details(access_token, report_id)
            if not details:
                continue

            class=class="hl-string">"hl-comment"># --- Base Attributes for all events related to this report --- #
            base_event = {
                class="hl-string">'ExpenseReportId': report_id,
                class="hl-string">'ReportTotalAmount': details.get(class="hl-string">'approvedAmount', {}).get(class="hl-string">'value'),
                class="hl-string">'EmployeeDepartment': details.get(class="hl-string">'orgUnit', {}).get(class="hl-string">'name'),
                class="hl-string">'PolicyViolationFlag': details.get(class="hl-string">'hasExceptions'),
                class="hl-string">'SourceSystem': class="hl-string">'SAP Concur',
                class="hl-string">'LastDataUpdate': last_data_update
            }

            class=class="hl-string">"hl-comment"># --- Activity: Expense Report Created --- #
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Expense Report Created',
                class="hl-string">'EventTimestamp': details.get(class="hl-string">'createDate'),
                class="hl-string">'ProcessorUserId': details.get(class="hl-string">'owner', {}).get(class="hl-string">'id'),
                class="hl-string">'ApproverId': None,
                class="hl-string">'ExpenseCategory': None
            })

            class=class="hl-string">"hl-comment"># --- Activities from Audit Trail --- #
            for audit_entry in details.get(class="hl-string">'auditTrail', []):
                action = audit_entry.get(class="hl-string">'action')
                activity_name = None
                processor = audit_entry.get(class="hl-string">'processor', {}).get(class="hl-string">'id')
                approver = audit_entry.get(class="hl-string">'approver', {}).get(class="hl-string">'id')
                
                if action == class="hl-string">'Submit':
                    activity_name = class="hl-string">'Expense Report Submitted'
                elif action == class="hl-string">'Approve':
                    class=class="hl-string">"hl-comment"># This logic assumes any approval is class="hl-string">'Manager Approved'. 
                    class=class="hl-string">"hl-comment"># A more complex system might check processor roles.
                    activity_name = class="hl-string">'Manager Approved'
                elif action == class="hl-string">'Reject':
                    class=class="hl-string">"hl-comment"># Differentiating manager vs finance rejection may require checking processor role.
                    activity_name = class="hl-string">'Manager Rejected'
                elif action == class="hl-string">'Recall':
                    activity_name = class="hl-string">'Report Sent Back for Revision'
                
                if activity_name:
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': activity_name,
                        class="hl-string">'EventTimestamp': audit_entry.get(class="hl-string">'entryDate'),
                        class="hl-string">'ProcessorUserId': processor,
                        class="hl-string">'ApproverId': approver,
                        class="hl-string">'ExpenseCategory': None
                    })

            class=class="hl-string">"hl-comment"># --- Activities from Statuses and Dates --- #
            if details.get(class="hl-string">'approvalStatus', {}).get(class="hl-string">'code') == class="hl-string">'A_APPR': class=class="hl-string">"hl-comment"># Approved
                class=class="hl-string">"hl-comment"># Inferring Finance Approval from final approval date
                event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Finance Approved',
                        class="hl-string">'EventTimestamp': details.get(class="hl-string">'approvedDate'),
                        class="hl-string">'ProcessorUserId': details.get(class="hl-string">'lastApprover', {}).get(class="hl-string">'id'),
                        class="hl-string">'ApproverId': details.get(class="hl-string">'lastApprover', {}).get(class="hl-string">'id'),
                        class="hl-string">'ExpenseCategory': None
                    })

            payment_status = details.get(class="hl-string">'paymentStatus', {}).get(class="hl-string">'code')
            if payment_status == class="hl-string">'P_PROC': class=class="hl-string">"hl-comment"># Processing Payment
                event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': class="hl-string">'Reimbursement Scheduled',
                    class="hl-string">'EventTimestamp': details.get(class="hl-string">'paymentProcessingDate'),
                    class="hl-string">'ProcessorUserId': class="hl-string">'System',
                    class="hl-string">'ApproverId': None,
                    class="hl-string">'ExpenseCategory': None
                })
            
            if payment_status == class="hl-string">'P_PAID': class=class="hl-string">"hl-comment"># Paid
                event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': class="hl-string">'Reimbursement Executed',
                    class="hl-string">'EventTimestamp': details.get(class="hl-string">'paidDate'),
                    class="hl-string">'ProcessorUserId': class="hl-string">'System',
                    class="hl-string">'ApproverId': None,
                    class="hl-string">'ExpenseCategory': None
                })

            if details.get(class="hl-string">'isPosted'):
                 event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': class="hl-string">'Accounting Posted',
                    class="hl-string">'EventTimestamp': details.get(class="hl-string">'postDate'),
                    class="hl-string">'ProcessorUserId': class="hl-string">'System',
                    class="hl-string">'ApproverId': None,
                    class="hl-string">'ExpenseCategory': None
                })
            
            class=class="hl-string">"hl-comment"># --- Other Inferred Activities --- #
            class=class="hl-string">"hl-comment"># Note: The following are examples and may need adjustment based on specific Concur configuration.
            if details.get(class="hl-string">'hasExceptions'):
                 event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': class="hl-string">'Policy Violation Flagged',
                    class="hl-string">'EventTimestamp': details.get(class="hl-string">'lastModifiedDate'), class=class="hl-string">"hl-comment"># Best guess timestamp
                    class="hl-string">'ProcessorUserId': class="hl-string">'System',
                    class="hl-string">'ApproverId': None,
                    class="hl-string">'ExpenseCategory': None
                })

            if details.get(class="hl-string">'workflow', {}).get(class="hl-string">'currentStep', {}).get(class="hl-string">'name', class="hl-string">'').lower().find(class="hl-string">'audit') != -1:
                 event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': class="hl-string">'Audit Review Required',
                    class="hl-string">'EventTimestamp': details.get(class="hl-string">'lastModifiedDate'),
                    class="hl-string">'ProcessorUserId': class="hl-string">'System',
                    class="hl-string">'ApproverId': None,
                    class="hl-string">'ExpenseCategory': None
                })

            class=class="hl-string">"hl-comment"># Placeholder for activities not directly available via standard fields
            class=class="hl-string">"hl-comment"># e.g., class="hl-string">'Receipts Image Attached', class="hl-string">'Finance Review Started' may require parsing specific audit trail descriptions

        next_page = reports_data.get(class="hl-string">'nextPage')
        if not next_page:
            break
        page_count += 1
    
    print(fclass="hl-string">'Extraction complete. Total events generated: {len(event_log)}')

    if event_log:
        df = pd.DataFrame(event_log)
        class=class="hl-string">"hl-comment"># Reorder columns for clarity
        cols = [class="hl-string">'ExpenseReportId', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'ProcessorUserId', 
                class="hl-string">'ReportTotalAmount', class="hl-string">'EmployeeDepartment', class="hl-string">'PolicyViolationFlag', class="hl-string">'ApproverId', 
                class="hl-string">'ExpenseCategory', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate']
        df = df[cols]
        df.to_csv(class="hl-string">'concur_event_log.csv', index=False)
        print(class="hl-string">'Event log saved to concur_event_log.csv')
    else:
        print(class="hl-string">'No events were generated.')

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

È pronto a iniziare?

Questo template è il primo passo per rendere più efficiente la gestione delle note spese. Inizi oggi a creare il Suo Event Log per ottenere informazioni utili e migliorare il processo.

Torna alla guida al miglioramento Scarica il template

Più efficienza nella gestione delle note spese: inizi subito a ottimizzare il processo

Scopra come ridurre del 30% il tempo di ciclo delle note spese e migliorare la conformità.

Inizi la prova gratuita

Non è necessaria una carta di credito. Inizi a ottimizzare in pochi minuti.

Il template dei dati per la gestione delle spese

Il template dei dati per la gestione delle spese

Attributi per la gestione delle spese

Attività di gestione delle spese

Guide all’estrazione

Configurazione dell’estrazione contabile standard di SAP Concur

Passaggi

Configurazione

a Query di esempio sql

Script Python che utilizza le API REST della piattaforma SAP Concur

Passaggi

Configurazione

a Query di esempio python

È pronto a iniziare?

Più efficienza nella gestione delle note spese: inizi subito a ottimizzare il processo

Il template dei dati per la gestione delle spese

Il template dei dati per la gestione delle spese

Attributi per la gestione delle spese

Attività di gestione delle spese

Guide all’estrazione

Configurazione dell’estrazione contabile standard di SAP Concur

Passaggi

Configurazione

a Query di esempio sql

Script Python che utilizza le API REST della piattaforma SAP Concur

Passaggi

Configurazione

a Query di esempio python

È pronto a iniziare?

Più efficienza nella gestione delle note spese: inizi subito a ottimizzare il processo

La Sua privacy è importante