> Miglioramento continuo dei processi > Crediti verso clienti > Microsoft Dynamics 365 > Template dei dati

Il Suo template dei dati per i crediti verso clienti

Microsoft Dynamics 365

Attributi dei crediti verso clienti(21) Attività dei crediti verso clienti(15) Guide all’estrazione(2)

Il Suo template dei dati per i crediti verso clienti

Questo template offre un quadro completo per mappare in Microsoft Dynamics 365 il processo dalla fatturazione all’incasso. Descrive i campi dati e le tappe fondamentali necessari per creare un Event Log di qualità per il Process Mining. Seguendo questa struttura, potrà individuare con precisione i ritardi nei pagamenti e rendere più efficienti i flussi di lavoro di recupero crediti.

Campi dati essenziali per l’analisi contabile
Tappe standard del processo da monitorare
Indicazioni tecniche per l’estrazione dei dati da Microsoft Dynamics 365

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

Scarica il template

Attributi dei crediti verso clienti

Questi sono i campi dati consigliati da includere nell’Event Log per analizzare in modo completo le prestazioni della gestione dei crediti verso clienti.

5 Obbligatorio 8 Consigliato 8 Facoltativo

	Nome	Descrizione
	Attività Activity	Evento o attività specifica svolta sulla fattura.
Descrizione Questo attributo descrive il passaggio del processo, ad esempio Fattura registrata, Pagamento ricevuto o Contestazione aperta. In Microsoft Dynamics 365, spesso viene ricavato dal tipo di transazione (TransType) o dalla tabella specifica in cui è registrato il record, ad esempio CustSettlement per i pagamenti. È essenziale per visualizzare la mappa del processo. Perché è importante Definisce i nodi della mappa del processo e consente di analizzare il flusso del processo e individuare le varianti. Dove reperirli Ricavato dall’enumerazione TransType o dal contesto della tabella (CustTrans, CustSettlement e così via). Esempi Fattura registrataPagamento ricevutoLettera di sollecito inviataNota di interessi registrata
	Data e ora dell’evento EventTimestamp	Data e ora esatte in cui si è verificata l’attività.
Descrizione Questo attributo registra il momento preciso in cui un evento è stato registrato nel sistema. Serve a calcolare la durata tra le attività, determinare i tempi di attraversamento del processo e ordinare gli eventi in sequenza. In D365, corrisponde in genere a CreatedDateTime o TransDate, insieme a un componente orario. Perché è importante Le date e le ore sono fondamentali per calcolare tutti gli indicatori basati sul tempo, come il tempo di ciclo della fattura e il tempo di attraversamento fino all’invio. Dove reperirli In genere, i campi CreatedDateTime o TransDate presenti nelle diverse tabelle Esempi 2023-10-15T08:30:00Z2023-10-15T14:45:22Z2023-11-01T09:00:00Z
	Numero di fattura InvoiceNumber	Identificativo univoco del documento finanziario della fattura.
Descrizione Il numero di fattura è la chiave primaria per monitorare il ciclo di vita di un credito in Microsoft Dynamics 365. Collega l’ordine di vendita iniziale, la fattura registrata, i pagamenti successivi e le eventuali attività di recupero in un unico caso. Nell’analisi, questo attributo funge da identificativo del caso e consente di ricostruire l’intero flusso del processo. Perché è importante È l’unità fondamentale di analisi per la gestione dei crediti e consente al motore di Process Mining di raggruppare eventi distinti in un unico caso coerente. Dove reperirli CustInvoiceJour.InvoiceId o CustTrans.Invoice Esempi INV-2023-001CIV-88921US-004321DE-99120
	Sistema di origine SourceSystem	Nome del sistema da cui provengono i dati.
Descrizione Questo attributo identifica il sistema di registrazione dei dati, che in questo caso è Microsoft Dynamics 365. È utile quando si combinano dati provenienti da più istanze ERP o da strumenti esterni di raccolta in un’unica vista. Consente agli analisti di filtrare o segmentare i processi in base all’ambiente di origine. Perché è importante Garantisce la provenienza e la tracciabilità dei dati, soprattutto in architetture con più sistemi. Dove reperirli Impostato durante l’estrazione o ricavato dalla stringa di connessione Esempi D365 F&O ProdD365 FinanceDynamics AX 2012
	Ultimo aggiornamento dei dati LastDataUpdate	Data e ora dell’estrazione o dell’ultimo aggiornamento dei dati.
Descrizione Questo attributo indica quando i dati sono stati estratti per l’ultima volta da Microsoft Dynamics 365. Aiuta a valutare quanto siano aggiornati i dati dell’analisi e quanto siano attendibili i KPI. In genere, viene generato dallo strumento di estrazione al momento dell’interrogazione. Perché è importante Fornisce informazioni sulla latenza dei dati e aiuta a valutare l’aggiornamento delle Dashboard. Dove reperirli Generato dallo script ETL o di estrazione Esempi 2023-11-05T00:00:00Z2023-11-05T12:00:00Z
	Codice società CompanyCode	Identificativo della persona giuridica in D365.
Descrizione Questo attributo rappresenta DataAreaId in D365, che corrisponde alla persona giuridica o alla società in cui è avvenuta la transazione. È essenziale per filtrare i dati nelle installazioni con più società e garantisce che i numeri di fattura, che possono coincidere tra società diverse, siano trattati come distinti. Perché è importante Essenziale per distinguere le entità negli ambienti con più società e per le analisi regionali. Dove reperirli Campo DataAreaId in tutte le tabelle Esempi USMFDEMFGBSI
	Conto cliente CustomerAccount	Identificativo univoco o numero di conto del cliente.
Descrizione Il conto cliente identifica il soggetto a cui viene emessa la fattura. In D365 corrisponde al campo AccountNum. Raggruppare i dati in base a questo attributo consente di analizzare le modalità di pagamento, la frequenza delle contestazioni e i tempi di chiusura per ciascun cliente. Perché è importante Essenziale per individuare i clienti ad alto rischio e confrontare le prestazioni per cliente. Dove reperirli CustInvoiceJour.InvoiceAccount o CustTrans.AccountNum Esempi US-001DE-550CUST-9921
	Data di scadenza DueDate	Data entro la quale è previsto il pagamento.
Descrizione La data di scadenza è il termine per il pagamento stabilito dalle condizioni concordate. Viene confrontata con la data effettiva del pagamento per verificare il rispetto delle scadenze e calcolare i giorni medi di incasso (DSO). È un campo standard del record delle transazioni cliente. Perché è importante Essenziale per calcolare il tasso di pagamenti puntuali e analizzare le fatture scadute. Dove reperirli CustTrans.DueDate Esempi 2023-11-302023-12-15
	È automatizzato IsAutomated	Indicatore che specifica se l’attività è stata eseguita da un account di sistema.
Descrizione Questo attributo determina se una specifica fase è stata eseguita da un utente o da un processo batch automatico. Il valore viene calcolato confrontando l’attributo Utente con un elenco di account di sistema noti, ad esempio “Workflow” o “Batch”. Consente di calcolare il KPI sul tasso di compensazione manuale. Perché è importante Fondamentale per individuare opportunità di automazione e misurare il livello di automazione attuale. Dove reperirli Ricavato dalla logica applicata al campo User Esempi truefalse
	Gruppo cliente CustomerGroup	Classificazione o segmento di appartenenza del cliente.
Descrizione Questo attributo suddivide i clienti in gruppi omogenei, ad esempio all’ingrosso, al dettaglio o intercompany. Consente di confrontare i segmenti e verificare, per esempio, se alcuni presentano cicli di pagamento più lunghi o un maggior numero di contestazioni. In D365 corrisponde al campo CustGroup. Perché è importante Consente di confrontare le prestazioni del processo tra diversi segmenti di mercato. Dove reperirli CustTable.CustGroup Esempi All’ingrossoAl dettaglioIntercompanyEsportazione
	Importo della fattura InvoiceAmount	Valore monetario totale della fattura.
Descrizione Questo attributo rappresenta il valore finanziario della fattura. Viene utilizzato per calcolare l’esposizione totale dei crediti verso clienti e stabilire le priorità delle attività di recupero per gli importi più elevati. In genere, il campo si trova nella tabella del giornale delle fatture. Perché è importante Fondamentale per analizzare l’impatto finanziario e individuare i colli di bottiglia associati agli importi più elevati. Dove reperirli CustInvoiceJour.InvoiceAmount Esempi 1500.00250.5010000.00
	Unità aziendale BusinessUnit	Unità operativa o divisione responsabile della fattura.
Descrizione Questo attributo suddivide i dati in base alla struttura organizzativa interna, ad esempio la divisione elettronica o la divisione servizi. In D365 corrisponde spesso a una dimensione finanziaria associata alla transazione. Consente di confrontare le unità nella Dashboard dei tempi di emissione delle fatture. Perché è importante Consente confronti interni per individuare le divisioni più efficienti. Dove reperirli Dimensioni finanziarie (DefaultDimension) in CustInvoiceJour Esempi BU-001Vendite-NordServizi-Globali
	Utente User	ID utente della persona o dell’account di sistema che ha eseguito l’attività.
Descrizione Questo attributo identifica chi ha eseguito una specifica fase del processo, sulla base dei campi CreatedBy o ModifiedBy. Aiuta ad analizzare l’utilizzo delle risorse, individuare le esigenze di formazione e distinguere le attività automatiche di sistema dagli interventi manuali degli utenti. Perché è importante Consente di analizzare le prestazioni delle risorse e calcolare il tasso di automazione. Dove reperirli Campo CreatedBy nelle tabelle delle transazioni Esempi AmministratoreJSmithWorkflowAgentBSmith
	Condizioni di pagamento PaymentTerms	Codice che definisce le scadenze di pagamento concordate.
Descrizione Questo attributo contiene il codice che stabilisce quando è dovuto il pagamento, ad esempio Net30 o Net60. Consente di verificare se i clienti rispettano le condizioni concordate e se la data di scadenza è stata calcolata correttamente. Perché è importante Fornisce il contesto per la data di scadenza e aiuta a individuare condizioni troppo permissive o troppo rigide. Dove reperirli CustInvoiceJour.Payment o CustTable.PaymTermId Esempi Net30Net45CODEOM
	Data di scadenza dello sconto CashDiscountDate	Data entro la quale è valido lo sconto per pagamento anticipato.
Descrizione Questo attributo indica il termine entro il quale il cliente può usufruire dello sconto per pagamento anticipato. Viene confrontato con la data di pagamento per calcolare il KPI sul tasso di sconti non usufruiti e analizzare l’efficacia degli incentivi. Perché è importante Essenziale per la Dashboard di ottimizzazione degli sconti per pagamento anticipato. Dove reperirli CustTrans.CashDisc o calcolato da CashDiscCode Esempi 2023-11-102023-11-15
	È saldata IsCleared	Indicatore che specifica se la fattura è stata saldata interamente.
Descrizione Questo attributo booleano indica se il saldo della fattura è arrivato a zero tramite pagamento o stralcio. Consente di filtrare rapidamente le pratiche aperte e chiuse per calcolare il tempo medio di ciclo delle fatture. Perché è importante Distingue le pratiche attive da quelle storiche. Dove reperirli Ricavato dalla presenza della data CustTrans.Closed Esempi truefalse
	È una nota di credito IsCreditMemo	Indicatore che specifica se il documento è una nota di credito.
Descrizione Questo attributo booleano indica se la transazione rappresenta una nota di credito emessa al cliente. Viene utilizzato per calcolare il tasso di emissione delle note di credito ed escludere le fatture standard dall’analisi della rilavorazione. Perché è importante Supporta direttamente la Dashboard delle note di credito e della frequenza di rilavorazione. Dove reperirli Ricavato da CustInvoiceJour.InvoiceAmount < 0 o da TransType Esempi truefalse
	Giorni di ritardo DaysOverdue	Numero di giorni di ritardo del pagamento rispetto alla data di scadenza.
Descrizione Questa metrica calcola la differenza tra la data di pagamento e la data di scadenza. I valori positivi indicano pagamenti in ritardo, quelli negativi pagamenti anticipati. Offre un’analisi dettagliata delle prestazioni di pagamento, oltre alla semplice indicazione sì/no. Perché è importante Approfondisce l’analisi del KPI sul tasso di pagamenti puntuali. Dove reperirli Calcolato: PaymentDate - DueDate Esempi 50-230
	ID ordine di vendita SalesOrderId	Numero di riferimento dell’ordine di vendita associato alla fattura.
Descrizione Questo attributo collega la fattura all’ordine di vendita da cui ha origine. Se sono disponibili dati del processo Order-to-Cash, consente di svolgere analisi tra processi e aiuta a indagare sulle cause a monte dei problemi di fatturazione. Perché è importante Collega il processo di fatturazione al processo di vendita. Dove reperirli CustInvoiceJour.SalesId Esempi SO-10022SO-55912
	Motivo della contestazione DisputeReason	Codice del motivo assegnato a una pratica contestata.
Descrizione Questo attributo registra la categoria del motivo per cui una fattura è stata contestata, ad esempio “Errore di prezzo” o “Merce danneggiata”. È fondamentale per la Dashboard del ciclo di gestione delle contestazioni, che consente di individuare le cause profonde dei ritardi di pagamento. Perché è importante Consente di analizzare le cause profonde del KPI relativo ai tempi di risoluzione delle contestazioni. Dove reperirli CustTrans.ReasonRefRecId o tabella correlata delle pratiche di recupero crediti Esempi Prezzo non corrispondenteMerce danneggiataOrdine di acquisto mancanteQualità del servizio
	Valuta Currency	Codice della valuta della transazione associata alla fattura.
Descrizione Questo attributo specifica la valuta in cui è stata emessa la fattura, ad esempio USD o EUR. È importante per uniformare i valori finanziari quando si svolgono analisi globali su più regioni. Perché è importante Necessario per comprendere la distribuzione dei valori nei sistemi multivaluta. Dove reperirli CustInvoiceJour.CurrencyCode Esempi USDEURGBPJPY

Obbligatorio Consigliato Facoltativo

Attività dei crediti verso clienti

Questi sono i passaggi e le tappe principali del processo da registrare nell’Event Log per ricostruire con precisione il flusso di saldo dei pagamenti.

8 Consigliato 7 Facoltativo

	Attività	Descrizione
	Contestazione aperta	Creazione di un caso nel modulo di gestione dei casi, collegato alla fattura e indicativo di una contestazione da parte del cliente. Interrompe i normali flussi di incasso.
Perché è importante Le contestazioni sono una delle principali cause dei ritardi di pagamento. Monitorarle aiuta a individuare problemi di qualità nei processi a monte, ad esempio nella definizione dei prezzi o nell’evasione degli ordini. Dove reperirli Tabella CaseDetailBase, in cui Category è associato a Collections/AR e RefRecId collega il caso alla fattura. Acquisizione Registrato quando viene eseguita la transazione X in Case Management Tipo di evento explicit
	Fattura compensata	Modifica finale dello stato, in cui il saldo della fattura diventa zero e la transazione viene contrassegnata come Closed nel sistema.
Perché è importante Segna la conclusione definitiva dell’istanza del processo. Serve a calcolare il tempo di ciclo totale. Dove reperirli Campo CustTrans.Closed (data). La data viene valorizzata quando la somma dei saldi compensati è pari all’importo della fattura. Acquisizione Deducibile dal campo data CustTrans.Closed Tipo di evento inferred
	Fattura inviata	Evento in cui la fattura viene inviata al cliente tramite e-mail, stampa o EDI. Spesso viene dedotto dall’incremento del conteggio Printed o dai registri di gestione della stampa.
Perché è importante I ritardi tra la registrazione e l’invio riducono direttamente il tempo effettivo a disposizione del cliente per pagare e possono far apparire il pagamento in ritardo. Dove reperirli Deducibile dalla modifica di CustInvoiceJour.PrintedOriginals da 0 a 1 oppure rilevabile tramite la tabella PrintJobHeader, se la registrazione è attiva. Acquisizione Confrontare il campo di stato prima e dopo la modifica oppure consultare il registro PrintJobHeader Tipo di evento inferred
	Fattura registrata	Registrazione iniziale della fattura nella contabilità finanziaria. Questa attività rileva la creazione dell’obbligazione finanziaria nella tabella CustInvoiceJour.
Perché è importante Segna l’inizio ufficiale del ciclo di gestione dei crediti e l’avvio del conteggio dei termini di pagamento. È essenziale per calcolare i Giorni medi di incasso (DSO). Dove reperirli Tabella CustInvoiceJour. Il campo CreatedDateTime o InvoiceDate funge da data e ora dell’evento. Acquisizione Registrato al momento della registrazione della transazione in CustInvoiceJour Tipo di evento explicit
	Nota di credito emessa	Registrazione di una nota di credito che compensa l’importo della fattura originale. Spesso è conseguente alla risoluzione di una contestazione o a un reso.
Perché è importante Una frequenza elevata segnala perdite di ricavi e problemi di qualità nei processi a monte. A differenza di un pagamento, rappresenta un saldo non monetario. Dove reperirli Tabella CustTrans con Type impostato su Credit Note oppure CustInvoiceJour con InvoiceAmount negativo. Acquisizione Registrato al momento della contabilizzazione della transazione in CustTrans Tipo di evento explicit
	Pagamento integrale ricevuto	Registrazione di una transazione di pagamento che copre il saldo residuo della fattura. Segna l’entrata di liquidità.
Perché è importante È l’evento di esito positivo più importante. Serve a calcolare la percentuale di pagamenti puntuali e l’efficacia delle condizioni di sconto. Dove reperirli Tabella CustTrans con Type impostato su Payment, collegata alla fattura tramite CustSettlement e con saldo portato a zero. Acquisizione Registrato al momento della contabilizzazione e della compensazione della transazione in CustTrans Tipo di evento explicit
	Pagamento parziale registrato	Registrazione di un pagamento che non copre interamente il saldo aperto della fattura. Spesso resta un importo residuo da recuperare.
Perché è importante Consente di distinguere i pagamenti rateali dai saldi integrali. È importante per l’accuratezza delle previsioni sui flussi di cassa. Dove reperirli Tabella CustSettlement, che collega un pagamento (CustTrans) alla fattura (CustTrans) quando SettlementAmount < InvoiceAmount. Acquisizione Registrato quando viene eseguita la transazione X in CustSettlement Tipo di evento explicit
	Sollecito di pagamento inviato	Registra l’invio al cliente di una lettera formale di sollecito. Il dato viene acquisito dal giornale delle lettere di sollecito.
Perché è importante Segna l’inizio delle attività di recupero crediti. Analizzare la frequenza dei solleciti aiuta a ottimizzare la strategia di recupero e a ridurre i costi amministrativi. Dove reperirli Tabella CustCollectionLetterJour. Registra la data di contabilizzazione del codice della lettera per la specifica transazione della fattura. Acquisizione Registrato al momento della contabilizzazione della transazione in CustCollectionLetterJour Tipo di evento explicit
	Contestazione in revisione	Indica che il caso di contestazione è passato dallo stato Opened allo stato In Process. Rappresenta il tempo di lavoro del team incaricato della risoluzione.
Perché è importante I colli di bottiglia in questa fase allungano il ciclo di conversione della liquidità. Consentono di distinguere i tempi di attesa da quelli dedicati alla risoluzione. Dove reperirli Deducibile dalle modifiche al campo CaseDetailBase.Status o dalle voci della tabella CaseLog corrispondenti all’avanzamento dello stato. Acquisizione Confrontare il campo di stato prima e dopo la modifica in CaseDetailBase Tipo di evento inferred
	Contestazione risolta	Chiusura del caso di contestazione, che consente alla fattura di proseguire verso il pagamento o l’emissione di una nota di credito. Segna la fine del sottoprocesso di gestione delle eccezioni.
Perché è importante La differenza tra le date di apertura e risoluzione è un indicatore chiave dell’efficienza amministrativa. Dove reperirli Tabella CaseDetailBase, in cui Status passa a Closed/Resolved. Acquisizione Confrontare il campo di stato prima e dopo la modifica in CaseDetailBase Tipo di evento inferred
	Movimento bancario abbinato	Evento di riconciliazione in cui il pagamento registrato nella gestione dei crediti viene abbinato a una riga dell’estratto conto importato.
Perché è importante Conferma che i fondi sono effettivamente disponibili sul conto bancario. I ritardi in questa fase segnalano inefficienze nei processi di gestione della cassa e delle banche. Dove reperirli Stato di abbinamento in BankReconciliationLine o BankAccountTrans. Richiede il modulo Advanced Bank Reconciliation. Acquisizione Registrato quando la transazione viene abbinata in Bank Reconciliation Tipo di evento explicit
	Nota di interessi generata	Creazione di una nota di interessi per pagamenti scaduti. Rappresenta una penale finanziaria applicata al conto del cliente.
Perché è importante Indica un ritardo grave nel pagamento. L’analisi aiuta a capire se le penali accelerano effettivamente i pagamenti o compromettono il rapporto con il cliente. Dove reperirli Tabella CustInterestJour. Registra le note di interessi generate per specifiche transazioni dei clienti. Acquisizione Registrato al momento della contabilizzazione della transazione in CustInterestJour Tipo di evento explicit
	Pagamento stornato come inesigibile	Dichiarazione della fattura come inesigibile e rimozione del saldo tramite un giornale di stralcio. Rappresenta una perdita finanziaria.
Perché è importante Stato finale dei processi di recupero crediti non riusciti. È essenziale per analizzare il rapporto tra crediti inesigibili e crediti totali e l’efficacia delle politiche di credito. Dove reperirli Tabella CustTrans con Type impostato su WriteOff oppure GeneralJournalEntry contrassegnato con codici causale di stralcio. Acquisizione Registrato al momento della contabilizzazione della transazione con tipo WriteOff Tipo di evento explicit
	Promessa di pagamento ricevuta	Impegno specifico registrato da un addetto al recupero crediti, in cui il cliente si impegna a pagare entro una certa data. Il dato viene acquisito dal modulo di gestione degli incassi.
Perché è importante Misura l’efficacia delle telefonate di recupero crediti. Confrontare questa data con quella del pagamento effettivo permette di valutare l’affidabilità degli impegni presi dai clienti. Dove reperirli Tabella CustPromiseToPay. Collegata alla transazione del cliente tramite TransRecId. Acquisizione Registrato al momento della creazione del record in CustPromiseToPay Tipo di evento explicit
	Scadenza superata	Tappa calcolata che indica che la data corrente ha superato la scadenza della fattura, che risulta ancora aperta. La fattura viene quindi segnalata come scaduta.
Perché è importante È fondamentale per l’analisi dell’anzianità dei crediti e per avviare i flussi di lavoro di incasso. Segna il passaggio dalla fatturazione ordinaria alla gestione degli incassi. Dove reperirli Calcolato confrontando CustInvoiceJour.DueDate con l’ora corrente della simulazione o con la data e ora del pagamento. Acquisizione Ricavare il dato confrontando il campo DueDate con l’ora corrente Tipo di evento calculated

Consigliato Facoltativo

Guide all’estrazione

Come ottenere i dati da Microsoft Dynamics 365

Passaggi

Configuri le risorse Azure: crei un database Azure SQL da utilizzare come destinazione Bring Your Own Database (BYOD). Verifichi che la stringa di connessione includa credenziali con autorizzazioni di lettura e scrittura.
Configuri Data Management in D365: acceda a System Administration > Workspaces > Data Management. Selezioni il riquadro 'Configure Entity Export to Database'. Inserisca la stringa di connessione del passaggio precedente per registrare il database esterno.
Selezioni le entità necessarie: crei un nuovo progetto di esportazione nell’area di lavoro Data Management. Aggiunga al progetto le seguenti entità standard: CustInvoiceJournalHeaderEntity, CustTransactionEntity, CustSettlementEntity, CustCollectionLetterJournalHeaderEntity, CaseDetailEntity, CaseAssociationEntity, CustInterestJournalEntity, BankAccountTransEntity e CustPromiseToPayEntity.
Mappi l’origine alla destinazione: verifichi che tutti i campi siano mappati correttamente e che siano inclusi, in particolare, i campi RecId e CreatedDateTime, fondamentali per ordinare gli eventi.
Esegua l’esportazione iniziale: avvii manualmente il processo di esportazione (tipo di processo: Export) per caricare tutti i dati storici nel database Azure SQL. Controlli il riepilogo dell’esecuzione per verificare che tutti i record siano stati trasferiti correttamente.
Pianifichi gli aggiornamenti incrementali: configuri un processo dati ricorrente per eseguire periodicamente il progetto di esportazione, ad esempio ogni 4 ore o ogni notte, utilizzando 'Incremental push' per aggiornare solo i record modificati.
Si colleghi ad Azure SQL: utilizzi SQL Server Management Studio (SSMS) o uno strumento equivalente per collegarsi al database Azure SQL BYOD.
Esegua lo script di trasformazione: applichi alle tabelle BYOD lo script SQL riportato nella sezione Query qui sotto. Lo script riunisce le diverse tabelle in un’unica struttura di Event Log.
Verifichi ed estragga i dati: controlli la coerenza dei risultati (vedere i passaggi di convalida). Esporti il risultato in un file CSV o Parquet da importare in ProcessMind.

Configurazione

Metodo di esportazione: Bring Your Own Database (BYOD) o Azure Data Lake Storage Gen2 (ADLS).
Strategia di aggiornamento: Full push per il caricamento iniziale e Incremental push per gli aggiornamenti ricorrenti, così da ridurre al minimo l’impatto sulle prestazioni.
Entità necessarie: CustInvoiceJournalHeaderEntity (fatture), CustSettlementEntity (pagamenti/compensazioni), CustCollectionLetterJournalHeaderEntity (solleciti), CaseDetailEntity (contestazioni), BankAccountTransEntity (abbinamento bancario).
Filtro aziendale: applichi filtri alla colonna 'DataAreaId' se l’analisi deve riguardare solo determinate entità giuridiche.
Intervallo di date: si consiglia una finestra mobile di 12 mesi basata su 'InvoiceDate' o 'TransDate'.
Rilevamento delle modifiche: deve essere abilitato sulle tabelle SQL in D365 affinché l’esportazione incrementale funzioni in modo efficiente.

Query di esempio sql

/* SQL Transformation Script for D365 BYOD Tables */
/* Target: Azure SQL Database containing exported entities */

WITH InvoiceBasics AS (
    SELECT 
        InvoiceNumber AS InvoiceId,
        InvoiceDate,
        DueDate,
        InvoiceAccount AS CustomerAccount,
        SalesId,
        DataAreaId AS CompanyCode,
        InvoiceAmount,
        Currency
    FROM dbo.CustInvoiceJournalHeaderEntity
    WHERE InvoiceDate >= DATEADD(month, -12, GETDATE())
)

/* 1. Invoice Posted */
SELECT 
    T1.InvoiceId AS InvoiceNumber,
    'Invoice Posted' AS Activity,
    CAST(T1.InvoiceDate AS DATETIME) AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL AS CustomerGroup,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL AS [User],
    NULL AS BusinessUnit,
    T1.CompanyCode,
    1 AS IsAutomated
FROM InvoiceBasics T1

UNION ALL

/* 2. Invoice Dispatched (Inferred from Document Date as Proxy if Print Log unavailable) */
SELECT 
    T1.InvoiceId,
    'Invoice Dispatched' AS Activity,
    DATEADD(minute, 5, CAST(T1.InvoiceDate AS DATETIME)) AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL,
    NULL,
    T1.CompanyCode,
    1
FROM InvoiceBasics T1

UNION ALL

/* 3. Due Date Passed (Synthetic Event) */
SELECT 
    T1.InvoiceId,
    'Due Date Passed' AS Activity,
    CAST(T1.DueDate AS DATETIME) AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL,
    NULL,
    T1.CompanyCode,
    1
FROM InvoiceBasics T1
WHERE GETDATE() > T1.DueDate

UNION ALL

/* 4. Payment Reminder Sent */
SELECT 
    Inv.InvoiceId,
    'Payment Reminder Sent' AS Activity,
    CL.JournalDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CL.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustCollectionLetterJournalHeaderEntity CL
JOIN dbo.CustCollectionLetterLineEntity CLL ON CL.JournalNumber = CLL.JournalNumber AND CL.DataAreaId = CLL.DataAreaId
JOIN InvoiceBasics Inv ON CLL.InvoiceId = Inv.InvoiceId AND CLL.DataAreaId = Inv.CompanyCode

UNION ALL

/* 5. Promise to Pay Received */
SELECT 
    Inv.InvoiceId,
    'Promise to Pay Received' AS Activity,
    PTP.PromiseDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    NULL,
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustPromiseToPayEntity PTP
JOIN InvoiceBasics Inv ON PTP.Invoice = Inv.InvoiceId AND PTP.DataAreaId = Inv.CompanyCode

UNION ALL

/* 6. Dispute Case Opened */
SELECT 
    Inv.InvoiceId,
    'Dispute Case Opened' AS Activity,
    CD.CreatedDateTime AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CD.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CaseDetailEntity CD
JOIN dbo.CaseAssociationEntity CA ON CD.CaseId = CA.CaseId AND CD.DataAreaId = CA.DataAreaId
JOIN InvoiceBasics Inv ON CA.RefRecId = Inv.InvoiceId /* Logic assumes linking via Invoice Number or manual mapping might be needed depending on RefTableId */
WHERE CA.RefEntityName = 'CustInvoiceTable'

UNION ALL

/* 7. Dispute Under Review */
SELECT 
    Inv.InvoiceId,
    'Dispute Under Review' AS Activity,
    CD.ModifiedDateTime AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CD.ModifiedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CaseDetailEntity CD
JOIN dbo.CaseAssociationEntity CA ON CD.CaseId = CA.CaseId AND CD.DataAreaId = CA.DataAreaId
JOIN InvoiceBasics Inv ON CA.RefRecId = Inv.InvoiceId
WHERE CD.Status = 'InProcess'

UNION ALL

/* 8. Dispute Resolved */
SELECT 
    Inv.InvoiceId,
    'Dispute Resolved' AS Activity,
    CD.ClosedDateTime AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CD.ModifiedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CaseDetailEntity CD
JOIN dbo.CaseAssociationEntity CA ON CD.CaseId = CA.CaseId AND CD.DataAreaId = CA.DataAreaId
JOIN InvoiceBasics Inv ON CA.RefRecId = Inv.InvoiceId
WHERE CD.Status = 'Closed'

UNION ALL

/* 9. Credit Memo Issued */
SELECT 
    T1.InvoiceId,
    'Credit Memo Issued' AS Activity,
    T1.InvoiceDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL,
    NULL,
    T1.CompanyCode,
    0
FROM dbo.CustInvoiceJournalHeaderEntity T1
WHERE T1.InvoiceAmount < 0

UNION ALL

/* 10. Interest Note Generated */
SELECT 
    Inv.InvoiceId,
    'Interest Note Generated' AS Activity,
    IJ.InterestDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    IJ.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    1
FROM dbo.CustInterestJournalEntity IJ
JOIN InvoiceBasics Inv ON IJ.AccountDisplayValue = Inv.CustomerAccount AND IJ.DataAreaId = Inv.CompanyCode
/* Note: Direct link to specific Invoice ID is often via CustInterestTrans, requiring an additional join */

UNION ALL

/* 11. Partial Payment Posted */
SELECT 
    Inv.InvoiceId,
    'Partial Payment Posted' AS Activity,
    Sett.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Sett.SettleAmountCur AS InvoiceAmount,
    Inv.DueDate,
    Sett.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustSettlementEntity Sett
JOIN dbo.CustTransactionEntity Trans ON Sett.TransRecId = Trans.RecId
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE ABS(Sett.SettleAmountCur) < ABS(Trans.AmountCur) AND Sett.SettleAmountCur <> 0

UNION ALL

/* 12. Full Payment Received */
SELECT 
    Inv.InvoiceId,
    'Full Payment Received' AS Activity,
    Sett.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Sett.SettleAmountCur AS InvoiceAmount,
    Inv.DueDate,
    Sett.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustSettlementEntity Sett
JOIN dbo.CustTransactionEntity Trans ON Sett.TransRecId = Trans.RecId
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE ABS(Sett.SettleAmountCur) >= ABS(Trans.AmountCur)

UNION ALL

/* 13. Bank Statement Matched */
SELECT 
    Inv.InvoiceId,
    'Bank Statement Matched' AS Activity,
    Bank.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Bank.AmountCur AS InvoiceAmount,
    Inv.DueDate,
    NULL,
    NULL,
    Inv.CompanyCode,
    1
FROM dbo.BankAccountTransEntity Bank
JOIN dbo.CustSettlementEntity Sett ON Bank.Voucher = Sett.OffsetTransVoucher AND Bank.DataAreaId = Sett.DataAreaId
JOIN dbo.CustTransactionEntity Trans ON Sett.TransRecId = Trans.RecId
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId

UNION ALL

/* 14. Payment Written Off */
SELECT 
    Inv.InvoiceId,
    'Payment Written Off' AS Activity,
    Trans.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Trans.AmountCur AS InvoiceAmount,
    Inv.DueDate,
    Trans.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustTransactionEntity Trans
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE Trans.TransactionType = 'WriteOff'

UNION ALL

/* 15. Invoice Cleared */
SELECT 
    Inv.InvoiceId,
    'Invoice Cleared' AS Activity,
    Trans.ClosedDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    NULL,
    NULL,
    Inv.CompanyCode,
    1
FROM dbo.CustTransactionEntity Trans
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE Trans.ClosedDate IS NOT NULL AND Trans.ClosedDate <> '1900-01-01'

Passaggi

Prepari i prerequisiti: verifichi che sulla macchina di esecuzione sia installato Python 3.x. Installi con pip le librerie necessarie: pandas, requests e msal (se utilizza Microsoft Authentication Library, anche se per semplicità questo script usa REST diretto).
Registri l’applicazione Azure: registri un’applicazione in Azure Active Directory (Entra ID) per consentire l’accesso a Dynamics 365. Annoti l’ID client, il segreto client e l’ID Tenant. Verifichi che l’app disponga delle autorizzazioni API per Dynamics ERP (OData).
Configuri lo script: apra lo script Python fornito. Aggiorni il dizionario config all’inizio inserendo l’URL D365, l’ID client, il segreto client, l’ID Tenant e il codice aziendale di destinazione (dataAreaId).
Definisca l’intervallo di date: modifichi nello script le variabili start_date e end_date per stabilire la finestra di estrazione. Per i caricamenti incrementali si consiglia una finestra mobile degli ultimi 90-180 giorni.
Esegua l’estrazione: avvii lo script. Questo eseguirà l’autenticazione tramite Azure AD, recupererà un token di accesso e interrogherà diverse entità OData (CustomerInvoices, PaymentJournals, CaseDetails e altre) per acquisire i dati.
Elabori i dati: lo script trasforma automaticamente i dati, ad esempio rinomina le colonne per adeguarle allo schema di ProcessMind, calcola gli eventi 'Scadenza superata' in base alla data di sistema e distingue i pagamenti parziali da quelli integrali in base agli importi delle transazioni.
Unisca e ordini i dati: lo script concatena tutti i dataframe delle attività in un unico Event Log e li ordina per InvoiceNumber ed EventTimestamp.
Esporti i dati: il dataframe finale viene esportato in un file CSV denominato AR_Event_Log.csv. Verifichi che il file sia stato creato nella cartella dello script.
Convalidi i dati: apra il file CSV e controlli che le date siano nel formato ISO (YYYY-MM-DD HH:MM:SS) e che tutte le colonne obbligatorie siano compilate.
Carichi i dati: importi il file CSV generato in ProcessMind utilizzando la procedura guidata standard di caricamento dei file. Mappi la colonna InvoiceNumber su ID caso, Activity su Attività e EventTimestamp su Timestamp.

Configurazione

Dimensione dei batch: lo script utilizza una dimensione di pagina predefinita, spesso di 1000 record, stabilita dal server. Gestisce automaticamente la paginazione tramite la proprietà @odata.nextLink.
Filtri per data: il parametro OData $filter limita il recupero dei dati agli intervalli di date pertinenti, ad esempio InvoiceDate ge 2023-01-01T00:00:00Z. Questo migliora notevolmente le prestazioni.
Filtro aziendale: D365 archivia i dati di più entità giuridiche. Lo script filtra per dataAreaId per estrarre solo i dati dell’unità aziendale pertinente.
Autenticazione: utilizza OAuth 2.0 (Client Credentials Flow). È necessario disporre di un segreto client e di una registrazione dell’app validi.
Selezione delle entità: utilizza entità standard come CustomerInvoices, CustomerPaymentJournalLines e CaseDetail. Se l’organizzazione utilizza entità personalizzate, occorre aggiornare gli endpoint nel dizionario endpoints.
Eventi calcolati: eventi come 'Scadenza superata' vengono calcolati durante l’esecuzione dello script, perché nel database non generano un log di transazione specifico.

Query di esempio python

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

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
config = {
    class="hl-string">"resource": class="hl-string">"https://[YourOrg].operations.dynamics.com",
    class="hl-string">"tenant_id": class="hl-string">"[Your-Tenant-ID]",
    class="hl-string">"client_id": class="hl-string">"[Your-Client-ID]",
    class="hl-string">"client_secret": class="hl-string">"[Your-Client-Secret]",
    class="hl-string">"company_code": class="hl-string">"USMF",  class=class="hl-string">"hl-comment"># Example Company Code
    class="hl-string">"start_date": class="hl-string">"2023-01-01T00:00:00Z"
}

class=class="hl-string">"hl-comment"># === AUTHENTICATION ===
def get_token(config):
    token_url = fclass="hl-string">"https://login.microsoftonline.com/{config['tenant_id']}/oauth2/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': config[class="hl-string">'client_id'],
        class="hl-string">'client_secret': config[class="hl-string">'client_secret'],
        class="hl-string">'resource': config[class="hl-string">'resource']
    }
    response = requests.post(token_url, data=payload)
    if response.status_code == 200:
        return response.json().get(class="hl-string">'access_token')
    else:
        raise Exception(fclass="hl-string">"Auth Failed: {response.text}")

class=class="hl-string">"hl-comment"># === ODATA FETCHER ===
def get_odata_data(token, entity_url, filter_str):
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}', class="hl-string">'Accept': class="hl-string">'application/json'}
    results = []
    next_link = fclass="hl-string">"{config['resource']}/data/{entity_url}?$filter={filter_str}&$format=json"
    
    while next_link:
        print(fclass="hl-string">"Fetching: {next_link}")
        try:
            res = requests.get(next_link, headers=headers)
            if res.status_code != 200:
                print(fclass="hl-string">"Error fetching data: {res.text}")
                break
            data = res.json()
            results.extend(data.get(class="hl-string">'value', []))
            next_link = data.get(class="hl-string">'@odata.nextLink', None)
        except Exception as e:
            print(fclass="hl-string">"Exception: {e}")
            break
    return pd.DataFrame(results)

class=class="hl-string">"hl-comment"># === MAIN EXTRACTION ===
def main():
    token = get_token(config)
    all_events = []
    company_filter = fclass="hl-string">"dataAreaId eq '{config['company_code']}'"
    date_filter = fclass="hl-string">"InvoiceDate ge {config['start_date']}"

    class=class="hl-string">"hl-comment"># 1. INVOICE BASIC EVENTS (Posted, Dispatched, Credit Memo, Cleared)
    class=class="hl-string">"hl-comment"># Entity: CustomerInvoices (or SalesInvoiceHeaders)
    print(class="hl-string">"Processing Invoices...")
    df_inv = get_odata_data(token, class="hl-string">"CustomerInvoices", fclass="hl-string">"{company_filter} and {date_filter}")
    
    if not df_inv.empty:
        class=class="hl-string">"hl-comment"># Activity: Invoice Posted
        posted = df_inv.copy()
        posted[class="hl-string">'Activity'] = class="hl-string">'Invoice Posted'
        posted[class="hl-string">'EventTimestamp'] = posted[class="hl-string">'InvoiceDate']
        all_events.append(posted)

        class=class="hl-string">"hl-comment"># Activity: Invoice Dispatched (Assumed same day as posted if not tracked separately)
        dispatched = df_inv.copy()
        dispatched[class="hl-string">'Activity'] = class="hl-string">'Invoice Dispatched'
        dispatched[class="hl-string">'EventTimestamp'] = dispatched[class="hl-string">'InvoiceDate']  class=class="hl-string">"hl-comment"># Often inferred
        all_events.append(dispatched)

        class=class="hl-string">"hl-comment"># Activity: Credit Memo Issued
        credit_memos = df_inv[df_inv[class="hl-string">'InvoiceAmount'] < 0].copy()
        credit_memos[class="hl-string">'Activity'] = class="hl-string">'Credit Memo Issued'
        credit_memos[class="hl-string">'EventTimestamp'] = credit_memos[class="hl-string">'InvoiceDate']
        all_events.append(credit_memos)

        class=class="hl-string">"hl-comment"># Activity: Invoice Cleared (Closed)
        class=class="hl-string">"hl-comment"># Note: ClosedDate might need to be cast to datetime
        cleared = df_inv[df_inv[class="hl-string">'ClosedDate'].notnull()].copy()
        if not cleared.empty:
            cleared[class="hl-string">'Activity'] = class="hl-string">'Invoice Cleared'
            cleared[class="hl-string">'EventTimestamp'] = cleared[class="hl-string">'ClosedDate']
            all_events.append(cleared)

        class=class="hl-string">"hl-comment"># Activity: Due Date Passed (Calculated)
        class=class="hl-string">"hl-comment"># Logic: If not closed, and DueDate < Now
        now = datetime.datetime.now()
        overdue = df_inv[(df_inv[class="hl-string">'ClosedDate'].isnull())].copy()
        class=class="hl-string">"hl-comment"># Convert DueDate to datetime objects for comparison
        overdue[class="hl-string">'DueDate_DT'] = pd.to_datetime(overdue[class="hl-string">'DueDate'])
        overdue = overdue[overdue[class="hl-string">'DueDate_DT'] < now]
        if not overdue.empty:
            overdue[class="hl-string">'Activity'] = class="hl-string">'Due Date Passed'
            class=class="hl-string">"hl-comment"># Timestamp is the day it became overdue
            overdue[class="hl-string">'EventTimestamp'] = overdue[class="hl-string">'DueDate'] 
            all_events.append(overdue)

    class=class="hl-string">"hl-comment"># 2. PAYMENTS (Partial, Full, WriteOff)
    class=class="hl-string">"hl-comment"># Entity: CustomerPaymentJournalLines
    print(class="hl-string">"Processing Payments...")
    class=class="hl-string">"hl-comment"># Note: Filter by TransDate usually
    df_pay = get_odata_data(token, class="hl-string">"CustomerPaymentJournalLines", fclass="hl-string">"{company_filter}")
    
    if not df_pay.empty:
        class=class="hl-string">"hl-comment"># Activity: Partial vs Full Payment
        class=class="hl-string">"hl-comment"># Logic requires comparing payment amount to invoice balance. simplified here based on Amount
        class=class="hl-string">"hl-comment"># Assuming we join with invoices later, strictly classifying based on available fields
        class=class="hl-string">"hl-comment"># Here we assume a field class="hl-string">'PaymentStatus' or we treat all as Partial unless marked Settled
        
        class=class="hl-string">"hl-comment"># Full Payment
        full_pay = df_pay.copy()
        full_pay[class="hl-string">'Activity'] = class="hl-string">'Full Payment Received'
        full_pay[class="hl-string">'EventTimestamp'] = full_pay[class="hl-string">'TransDate']
        all_events.append(full_pay)
        
        class=class="hl-string">"hl-comment"># Partial Payment (In a real scenario, this requires logic checking settlement vs invoice total)
        class=class="hl-string">"hl-comment"># Adding a duplicate row for demonstration of structure
        partial_pay = df_pay[df_pay[class="hl-string">'Amount'] < 1000].copy() class=class="hl-string">"hl-comment"># Placeholder logic
        partial_pay[class="hl-string">'Activity'] = class="hl-string">'Partial Payment Posted'
        partial_pay[class="hl-string">'EventTimestamp'] = partial_pay[class="hl-string">'TransDate']
        all_events.append(partial_pay)

        class=class="hl-string">"hl-comment"># Activity: Payment Written Off
        class=class="hl-string">"hl-comment"># Filter by specific Transaction Type or Journal Name
        write_off = df_pay[df_pay[class="hl-string">'JournalName'].str.contains(class="hl-string">'WriteOff', case=False, na=False)].copy()
        write_off[class="hl-string">'Activity'] = class="hl-string">'Payment Written Off'
        write_off[class="hl-string">'EventTimestamp'] = write_off[class="hl-string">'TransDate']
        all_events.append(write_off)

    class=class="hl-string">"hl-comment"># 3. COLLECTIONS (Reminders, Promise to Pay)
    class=class="hl-string">"hl-comment"># Entity: CollectionLetterJournals
    print(class="hl-string">"Processing Collections...")
    df_col = get_odata_data(token, class="hl-string">"CollectionLetterJournals", fclass="hl-string">"{company_filter}")
    if not df_col.empty:
        reminders = df_col.copy()
        reminders[class="hl-string">'Activity'] = class="hl-string">'Payment Reminder Sent'
        reminders[class="hl-string">'EventTimestamp'] = reminders[class="hl-string">'LetterDate']
        all_events.append(reminders)

    class=class="hl-string">"hl-comment"># Entity: CustomerPromiseToPay
    df_promise = get_odata_data(token, class="hl-string">"CustomerPromiseToPay", fclass="hl-string">"{company_filter}")
    if not df_promise.empty:
        promises = df_promise.copy()
        promises[class="hl-string">'Activity'] = class="hl-string">'Promise to Pay Received'
        promises[class="hl-string">'EventTimestamp'] = promises[class="hl-string">'CreatedDateTime']
        all_events.append(promises)

    class=class="hl-string">"hl-comment"># 4. DISPUTES (Opened, Review, Resolved)
    class=class="hl-string">"hl-comment"># Entity: CaseDetails (requires filtering for Collections/Dispute category)
    print(class="hl-string">"Processing Disputes...")
    df_case = get_odata_data(token, class="hl-string">"CaseDetails", fclass="hl-string">"{company_filter} and Category eq 'Collections'")
    if not df_case.empty:
        class=class="hl-string">"hl-comment"># Opened
        opened = df_case.copy()
        opened[class="hl-string">'Activity'] = class="hl-string">'Dispute Case Opened'
        opened[class="hl-string">'EventTimestamp'] = opened[class="hl-string">'CreatedDateTime']
        all_events.append(opened)

        class=class="hl-string">"hl-comment"># Under Review (In Process)
        in_process = df_case[df_case[class="hl-string">'Status'] == class="hl-string">'InProcess'].copy()
        in_process[class="hl-string">'Activity'] = class="hl-string">'Dispute Under Review'
        in_process[class="hl-string">'EventTimestamp'] = in_process[class="hl-string">'ModifiedDateTime']
        all_events.append(in_process)

        class=class="hl-string">"hl-comment"># Resolved (Closed)
        resolved = df_case[df_case[class="hl-string">'Status'] == class="hl-string">'Closed'].copy()
        resolved[class="hl-string">'Activity'] = class="hl-string">'Dispute Resolved'
        resolved[class="hl-string">'EventTimestamp'] = resolved[class="hl-string">'ClosedDateTime']
        all_events.append(resolved)

    class=class="hl-string">"hl-comment"># 5. INTEREST
    class=class="hl-string">"hl-comment"># Entity: InterestNotes
    print(class="hl-string">"Processing Interest Notes...")
    df_interest = get_odata_data(token, class="hl-string">"InterestNotes", fclass="hl-string">"{company_filter}")
    if not df_interest.empty:
        interest = df_interest.copy()
        interest[class="hl-string">'Activity'] = class="hl-string">'Interest Note Generated'
        interest[class="hl-string">'EventTimestamp'] = interest[class="hl-string">'NoteDate']
        all_events.append(interest)

    class=class="hl-string">"hl-comment"># 6. BANK RECONCILIATION
    class=class="hl-string">"hl-comment"># Entity: BankReconciliationLines (Placeholder for matching)
    print(class="hl-string">"Processing Bank Reconciliation...")
    class=class="hl-string">"hl-comment"># This entity availability varies by version
    df_bank = get_odata_data(token, class="hl-string">"BankReconciliationLines", fclass="hl-string">"{company_filter}")
    if not df_bank.empty:
        matched = df_bank[df_bank[class="hl-string">'Reconciled'] == True].copy()
        matched[class="hl-string">'Activity'] = class="hl-string">'Bank Statement Matched'
        matched[class="hl-string">'EventTimestamp'] = matched[class="hl-string">'TransactionDate']
        class=class="hl-string">"hl-comment"># Need to join with Invoice via Payment Reference ideally
        class=class="hl-string">"hl-comment"># For this script, we assume InvoiceNumber is present or mapped
        all_events.append(matched)

    class=class="hl-string">"hl-comment"># === UNIFICATION & EXPORT ===
    if not all_events:
        print(class="hl-string">"No events extracted.")
        return

    final_df = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Map columns to schema
    class=class="hl-string">"hl-comment"># Note: Column names class="hl-string">'InvoiceNumber', class="hl-string">'InvoiceAccount' etc. depend on exact Entity schema
    class=class="hl-string">"hl-comment"># You may need to rename based on your D365 entity fields, e.g., class="hl-string">'InvoiceNum' -> class="hl-string">'InvoiceNumber'
    schema_map = {
        class="hl-string">'InvoiceNumber': class="hl-string">'InvoiceNumber',
        class="hl-string">'InvoiceId': class="hl-string">'InvoiceNumber', class=class="hl-string">"hl-comment"># Alternative common name
        class="hl-string">'InvoiceAccount': class="hl-string">'CustomerAccount',
        class="hl-string">'CustomerAccount': class="hl-string">'CustomerAccount',
        class="hl-string">'InvoiceAmount': class="hl-string">'InvoiceAmount',
        class="hl-string">'Amount': class="hl-string">'InvoiceAmount', class=class="hl-string">"hl-comment"># Fallback for payments
        class="hl-string">'CurrencyCode': class="hl-string">'Currency',
        class="hl-string">'DueDate': class="hl-string">'DueDate',
        class="hl-string">'CreatedBy': class="hl-string">'User',
        class="hl-string">'BusinessUnit': class="hl-string">'BusinessUnit',
        class="hl-string">'DataAreaId': class="hl-string">'CompanyCode'
    }
    
    class=class="hl-string">"hl-comment"># Normalize columns
    for col in final_df.columns:
        if col in schema_map:
            final_df.rename(columns={col: schema_map[col]}, inplace=True)

    class=class="hl-string">"hl-comment"># Add constant fields
    final_df[class="hl-string">'SourceSystem'] = class="hl-string">'Microsoft D365'
    final_df[class="hl-string">'LastDataUpdate'] = datetime.datetime.now().isoformat()
    
    class=class="hl-string">"hl-comment"># Select final columns (fill missing with None)
    required_cols = [
        class="hl-string">'InvoiceNumber', class="hl-string">'Activity', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'CustomerAccount', class="hl-string">'CustomerGroup', class="hl-string">'InvoiceAmount', class="hl-string">'DueDate', class="hl-string">'User',
        class="hl-string">'BusinessUnit', class="hl-string">'CompanyCode', class="hl-string">'IsAutomated'
    ]
    
    for col in required_cols:
        if col not in final_df.columns:
            final_df[col] = None
            
    output_df = final_df[required_cols]
    
    class=class="hl-string">"hl-comment"># Export
    output_df.to_csv(class="hl-string">"AR_Event_Log.csv", index=False)
    print(class="hl-string">"Extraction complete. Saved to AR_Event_Log.csv")

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

È pronto per iniziare?

Inizi a trasformare le Sue operazioni finanziarie implementando oggi questo template di dati. Il nostro team è pronto ad aiutarLa a mappare i dati di Microsoft Dynamics 365 in base a questi requisiti.

Torna alla guida al miglioramento

Scarica il template

Ottimizzi subito i crediti verso clienti e migliori il flusso di cassa

Si unisca ai team che riducono di 15-20 giorni i tempi medi di incasso in Microsoft Dynamics 365

Inizi la prova gratuita

Non è richiesta la carta di credito; configurazione in 5 minuti

Il Suo template dei dati per i crediti verso clienti

Il Suo template dei dati per i crediti verso clienti

Attributi dei crediti verso clienti

Attività dei crediti verso clienti

Guide all’estrazione

Esportazione di entità tramite Data Management Framework di D365

Passaggi

Configurazione

Query di esempio sql

Estrazione degli eventi dei crediti verso clienti tramite API OData di Python

Passaggi

Configurazione

Query di esempio python

È pronto per iniziare?

Ottimizzi subito i crediti verso clienti e migliori il flusso di cassa