> Amélioration Continue des Processusus > Comptes Clients > Microsoft Dynamics 365 > Template de données

Votre modèle de données des créances clients

Microsoft Dynamics 365

Attributs des Comptes Clients (21) Activités des Comptes Clients (15) Guides d'extraction (2)

Votre modèle de données des créances clients

Ce modèle fournit une structure détaillée pour la cartographie de votre processus de la facture au paiement dans Microsoft Dynamics 365. Il décrit les champs de données et les jalons essentiels nécessaires pour générer un journal d'événements de haute qualité pour le Process Mining. En suivant cette structure, vous pouvez obtenir une visibilité approfondie sur les retards de paiement et rationaliser vos workflows de recouvrement.

Champs de données essentiels pour l'analyse du grand livre
Jalons de processus standard pour le suivi
Guide d'extraction technique pour Microsoft Dynamics 365

Vous découvrez les journaux d'événements ? Apprenez comment créer un journal d'événements Process Mining.

Télécharger le modèle

Attributs des Comptes Clients

Ce sont les champs de données recommandés à inclure dans votre journal d'événements pour une analyse complète de la performance de vos créances clients.

5 Obligatoire 8 Recommandé 8 Facultatif

	Nom	Descriptionn
	Activité Activity	L'événement ou la tâche spécifique effectuée sur la facture.
Descriptionn Cet attribut décrit l'étape en cours dans le processus, comme Facture Comptabilisée, paiement reçu ou Litige Ouvert. Dans Microsoft Dynamics 365, ces informations sont souvent dérivées du type de transaction (TransType) ou de la table spécifique où l'enregistrement est consigné (par exemple, CustSettlement pour les paiements). Cet attribut est indispensable pour visualiser la cartographie des processus. Pourquoi est-ce important ? : Il définit les nœuds de la cartographie de processus et permet l'analyse du flux de processus et la découverte des variantes. Source des données : Dérivé de l'énumération TransType ou du contexte de table (CustTrans, CustSettlement, etc.) Exemples Facture comptabiliséepaiement reçuLettre de relance envoyéeNote d'intérêt comptabilisée
	Horodatage de l'événement EventTimestamp	La date et l'heure exactes de l'activité.
Descriptionn Cet attribut enregistre le moment précis où un événement a été consigné dans le système. Il est utilisé pour calculer les durées entre les activités, déterminer les délais des processus et ordonner les événements séquentiellement. Dans D365, il s'agit généralement du CreatedDateTime ou de TransDate combiné à un composant temporel. Pourquoi est-ce important ? : Les horodatages sont essentiels pour le calcul de tous les KPI basés sur le temps, tels que le temps de cycle des factures et le délai d'envoi. Source des données : Champs CreatedDateTime ou TransDate couramment utilisés dans diverses tables Exemples 2023-10-15T08:30:00Z2023-10-15T14:45:22Z2023-11-01T09:00:00Z
	Numéro de facture InvoiceNumber	L'identifiant unique du document de facture financière.
Descriptionn Le numéro de facture est la clé primaire pour suivre le cycle de vie d'une créance dans Microsoft Dynamics 365. Il lie la commande client initiale, la facture enregistrée, les paiements ultérieurs et toutes les activités de recouvrement en un seul dossier. En analyse, cet attribut sert d'identifiant de cas pour reconstruire le flux de processus complet. Pourquoi est-ce important ? : C'est l'unité d'analyse clée pour les Comptes Clients, permettant au moteur de Process Mining de regrouper des événements disparates en un cas cohérent. Source des données : CustInvoiceJour.InvoiceId ou CustTrans.Invoice Exemples INV-2023-001CIV-88921US-004321DE-99120
	Dernière mise à jour des données LastDataUpdate	L'horodatage du moment où les données ont été extraites ou rafraîchies.
Descriptionn Cet attribut indique la dernière date d'extraction des données de Microsoft Dynamics 365. Il aide les utilisateurs à comprendre la récence de l'analyse et la validité des KPI. Il est généralement généré par l'outil d'extraction au moment de la requête. Pourquoi est-ce important ? : Il fournit un contexte sur la latence des données et aide les utilisateurs à faire confiance à la pertinence des dashboards. Source des données : Généré par le script ETL / d'extraction Exemples 2023-11-05T00:00:00Z2023-11-05T12:00:00Z
	Système source SourceSystem	Le nom du système d'où proviennent les données.
Descriptionn Cet attribut identifie le système d'enregistrement des données, qui est Microsoft Dynamics 365 dans ce contexte. Il est utile lors de la combinaison de données provenant de plusieurs instances ERP ou d'outils de recouvrement externes dans une vue unique. Cela permet aux analystes de filtrer ou de segmenter les processus par leur environnement d'origine. Pourquoi est-ce important ? : Il assure la traçabilité des données et la traçabilité, en particulier dans les environnements multi-systèmes. Source des données : Codé en dur lors de l'extraction ou dérivé de la chaîne de connexion Exemples D365 F&O ProdD365 FinanceDynamics AX 2012
	Code société CompanyCode	L'identifiant de l'entité juridique dans D365.
Descriptionn Cet attribut représente le DataAreaId dans D365, qui correspond à l'entité juridique ou à l'entreprise où la transaction a eu lieu. Il est indispensable pour filtrer les données dans les déploiements multi-sociétés et garantit que les numéros de facture, qui peuvent se chevaucher entre les entreprises, sont traités de manière distincte. Pourquoi est-ce important ? : Primordial pour l'unicité dans les environnements multi-entités et l'analyse régionale. Source des données : Champ DataAreaId sur toutes les tables Exemples USMFDEMFGBSI
	Compte client CustomerAccount	L'identifiant unique ou le numéro de compte du client.
Descriptionn Le Compte Client identifie l'entité spécifique facturée. Dans D365, il s'agit du champ AccountNum. Le regroupement par cet attribut permet d'analyser les comportements de paiement, les fréquences de litiges et les temps de compensation entre différents clients. Pourquoi est-ce important ? : Primordial pour identifier les clients à risque élevé et segmenter la performance par client. Source des données : CustInvoiceJour.InvoiceAccount ou CustTrans.AccountNum Exemples US-001DE-550CUST-9921
	Date d'échéance DueDate	La date à laquelle le paiement est censé être reçu.
Descriptionn La Date d'Échéance est la date limite de paiement telle que définie par les conditions de paiement. Elle est comparée à la date de paiement réelle pour déterminer la performance de paiement à temps et calculer le délai moyen de recouvrement (DSO). C'est un champ standard de l'enregistrement de transaction client. Pourquoi est-ce important ? : Fondamental pour le calcul du Taux de paiement ponctuel et l'analyse des factures en retard. Source des données : CustTrans.DueDate Exemples 2023-11-302023-12-15
	Est Automatisé IsAutomated	Indicateur spécifiant si l'activité a été effectuée par un compte système.
Descriptionn Cet attribut détermine si une étape spécifique a été exécutée par un utilisateur ou un job de traitement par lots automatisé. Il est calculé en comparant l'attribut Utilisateur à une liste de comptes système connus (par exemple, « Workflow », « Batch »). Il prend en charge le KPI du taux de compensation manuelle. Pourquoi est-ce important ? : Critique pour l'identification des opportunités d'automatisation et la mesure des niveaux d'automatisation actuels. Source des données : Dérivé de la logique du champ Utilisateur Exemples truefaux
	Groupe de clients CustomerGroup	La classification ou le segment auquel appartient le client.
Descriptionn Cet attribut catégorise les clients en groupes logiques, tels que Gros, Détail ou Inter-sociétés. Il est utilisé pour effectuer des analyses comparatives, comme vérifier si certains segments ont des cycles de paiement plus longs ou des taux de litige plus élevés. Dans D365, il s'agit du champ CustGroup. Pourquoi est-ce important ? : Permet la comparaison des performances des processus sur différents segments de marché. Source des données : CustTable.CustGroup Exemples Vente en grosCommerce de détailInterentrepriseExportation
	Montant de la facture InvoiceAmount	La valeur monétaire totale de la facture.
Descriptionn Cet attribut représente la valeur financière du document de facture. Il est utilisé pour calculer l'exposition totale des créances clients et pour prioriser les recouvrements de grande valeur. Ce champ se trouve généralement dans la table du journal des factures. Pourquoi est-ce important ? : Critique pour l'analyse de l'impact financier et l'identification des points de blocage à forte valeur. Source des données : CustInvoiceJour.InvoiceAmount Exemples 1500.00250.5010000.00
	Unité commerciale BusinessUnit	L'unité opérationnelle ou la division responsable de la facture.
Descriptionn Cet attribut segmente les données par structure organisationnelle interne, comme la Division Électronique ou la Division Services. Dans D365, il s'agit souvent d'une dimension financière liée à la transaction. Il prend en charge le tableau de bord des délais d'émission des factures en permettant des comparaisons entre les unités. Pourquoi est-ce important ? : Permet la référence interne pour trouver les divisions les plus efficaces. Source des données : Dimensions Financières (DefaultDimension) sur CustInvoiceJour Exemples BU-001Ventes-NordServices-Global
	Utilisateur User	L'identifiant utilisateur de la personne ou du compte système qui a effectué l'activité.
Descriptionn Cet attribut identifie qui a exécuté l'étape de processus spécifique, dérivé des champs CreatedBy ou ModifiedBy. Il aide à analyser l'utilisation des ressources, à identifier les besoins en formation et à distinguer les tâches système automatisées des interventions manuelles des utilisateurs. Pourquoi est-ce important ? : Permet l'analyse des performances des ressources et le calcul du taux d'automatisation. Source des données : Champ CreatedBy sur les tables de transaction Exemples AdminJSmithWorkflowAgentBSmith
	Conditions de paiement PaymentTerms	Le code définissant l'échéancier de paiement convenu.
Descriptionn Cet attribut contient le code qui dicte la date d'échéance du paiement (par exemple, Net30, Net60). Il est utilisé pour analyser si les clients respectent leurs conditions spécifiques et pour valider si la date d'échéance a été calculée correctement. Pourquoi est-ce important ? : Fournit le contexte pour la date d'échéance et aide à identifier si les conditions sont trop indulgentes ou strictes. Source des données : CustInvoiceJour.Payment ou CustTable.PaymTermId Exemples Net30Net45CODEOM
	Date d'escompte CashDiscountDate	La date jusqu'à laquelle un escompte pour paiement anticipé est valide.
Descriptionn Cet attribut indique la date limite à laquelle le client peut bénéficier d'un escompte pour paiement anticipé. Il est comparé à la date de paiement pour calculer le KPI du taux d'escompte manqué et analyser l'efficacité des incitations à l'escompte. Pourquoi est-ce important ? : Clé pour le tableau de bord d'optimisation des escomptes pour paiement anticipé. Source des données : CustTrans.CashDisc ou calculé à partir de CashDiscCode Exemples 2023-11-102023-11-15
	Devise Currency	Le code de devise de la transaction de facture.
Descriptionn Cet attribut spécifie la devise dans laquelle la facture a été émise (par exemple, USD, EUR). Il est important pour normaliser les valeurs financières si une analyse globale est requise dans différentes régions. Pourquoi est-ce important ? : Nécessaire pour comprendre la répartition des valeurs dans les systèmes multi-devises. Source des données : CustInvoiceJour.CurrencyCode Exemples USDEURGBPJPY
	Est apuré IsCleared	Indicateur spécifiant si la facture a été entièrement réglée.
Descriptionn Cet attribut booléen indique si la facture a atteint un solde nul par le paiement ou le passage en perte. Il permet un filtrage rapide des dossiers ouverts ou fermés pour calculer le temps de cycle moyen des factures. Pourquoi est-ce important ? : Distingue les cas actifs des cas historiques. Source des données : Dérivé de la présence de la date de clôture dans CustTrans.Closed Exemples truefaux
	Est un avoir IsCreditMemo	Indicateur spécifiant si le document est une note de crédit.
Descriptionn Cet attribut booléen identifie si la transaction représente un avoir émis au client. Il est utilisé pour calculer le taux d'efficacité.x d'émission d'avoirs et pour filtrer les factures standard de l'analyse des reprises. Pourquoi est-ce important ? : Supporte directement le tableau de bord de fréquence des avoirs et des retouches. Source des données : Dérivé de CustInvoiceJour.InvoiceAmount < 0 ou TransType Exemples truefaux
	ID de commande client SalesOrderId	Le numéro de référence de la commande client associée à la facture.
Descriptionn Cet attribut relie la facture à la commande client d'origine. Il permet une analyse inter-processus si les données du processus Order-to-Cash sont disponibles et aide à enquêter sur les causes en amont des problèmes de facturation. Pourquoi est-ce important ? : Relie le processus de facturation au processus de vente. Source des données : CustInvoiceJour.SalesId Exemples SO-10022SO-55912
	Jours de retard DaysOverdue	Le nombre de jours de retard du paiement par rapport à la date d'échéance.
Descriptionn Cette métrique calcule la différence entre la date de paiement et la date d'échéance. Les valeurs positives indiquent des paiements en retard, tandis que les valeurs négatives indiquent des paiements anticipés. Elle offre une vue granulaire de la performance de paiement au-delà des simples indicateurs booléens. Pourquoi est-ce important ? : Apporte de la profondeur à l'analyse du KPI du taux de paiement à temps. Source des données : Calculé : Date de paiement - Date d'échéance Exemples 50-230
	Motif du Litige DisputeReason	Le code motif attribué lorsqu'un dossier est en litige.
Descriptionn Cet attribut capture le motif catégorique pour lequel une facture a été contestée, tel que « Erreur de prix » ou « Marchandises endommagées ». Il est indispensable pour le tableau de bord du cycle de vie de la résolution des litiges afin d'identifier les causes profondes des retards de paiement. Pourquoi est-ce important ? : Permet l'analyse des causes profondes pour l'indicateur clé de performance (KPI) du temps de résolution des litiges. Source des données : CustTrans.ReasonRefRecId ou table de dossier de recouvrement associée Exemples PriceDiscrepancyMarchandises endommagéesMissingPOServiceQuality

Obligatoire Recommandé Facultatif

Activités des Comptes Clients

Ce sont les étapes clés du processus et les jalons à capturer dans votre journal d'événements pour une découverte précise de votre flux de règlement des paiements.

8 Recommandé 7 Facultatif

	Activité	Descriptionn
	Dossier de litige ouvert	La création d'un dossier dans le module de gestion des cas lié à la facture, signalant un désaccord client. Bloque les flux de recouvrement standard.
Pourquoi est-ce important ? : Les litiges sont une cause principale des retards de paiement. Leur suivi permet d'identifier les problèmes de qualité dans les processus en amont comme la tarification ou l'exécution. Source des données : Table CaseDetailBase où la catégorie est liée aux recouvrements/comptes clients (AR) et où RefRecId renvoie au contexte de la facture. Capture Comptabilisé lors de l'exécution de la transaction X dans Case Management Type d'événement explicit
	Facture apurée	Le changement de statut final où le solde de la facture devient nul et la transaction est marquée comme « Clôturée » dans le système.
Pourquoi est-ce important ? : La fin absolue de l'instance de processus. Utilisée pour le calcul du temps de cycle total. Source des données : Champ CustTrans.Closed (date). Cette date est renseignée lorsque la somme des règlements est égale au montant de la facture. Capture Déduit du champ de date CustTrans.Closed Type d'événement inferred
	Facture comptabilisée	L'enregistrement initial de la facture dans le grand livre financier. Cette activité capture la création de l'obligation financière dans la table CustInvoiceJour.
Pourquoi est-ce important ? : Marque le début officiel du cycle de vie des créances clients et le démarrage du décompte des délais de paiement. Primordial pour le calcul du délai moyen de recouvrement (DSO). Source des données : Table CustInvoiceJour. Le champ CreatedDateTime ou InvoiceDate sert de horodatage. Capture Comptabilisé lors de la comptabilisation de la transaction dans CustInvoiceJour Type d'événement explicit
	Facture expédiée	L'événement où la facture est envoyée au client par e-mail, impression ou EDI. Ceci est souvent déduit de l'incrémentation du compteur « Imprimé » ou des journaux de gestion d'impression.
Pourquoi est-ce important ? : Les délais entre la comptabilisation et l'envoi raccourcissent directement la fenêtre de paiement effective pour le client, entraînant des retards de paiement perçus. Source des données : Déduit de la modification de CustInvoiceJour.PrintedOriginals de 0 à 1, ou suivi via la table PrintJobHeader si la journalisation est activée. Capture Comparer le champ de statut avant/après ou le journal PrintJobHeader Type d'événement inferred
	Note de crédit émise	L'enregistrement d'un avoir qui compense le montant original de la facture. Souvent le résultat d'un litige résolu ou d'un retour.
Pourquoi est-ce important ? : Une fréquence élevée indique des fuites de revenus et des problèmes de qualité en amont. Distinct du paiement, car il représente un règlement non monétaire. Source des données : Table CustTrans où le Type est 'Note de crédit' ou CustInvoiceJour avec un InvoiceAmount négatif. Capture Comptabilisé lors de la comptabilisation de la transaction dans CustTrans Type d'événement explicit
	Paiement Intégral Reçu	L'enregistrement d'une transaction de paiement qui couvre le solde restant de la facture. C'est l'événement d'entrée de trésorerie.
Pourquoi est-ce important ? : L'événement de succès le plus critique. Utilisé pour calculer le taux d'efficacité.x de paiement à temps et l'efficacité des conditions d'escompte. Source des données : Table CustTrans de type 'Paiement', liée via CustSettlement à la facture, ramenant le solde à zéro. Capture Comptabilisé lorsque la transaction est comptabilisée dans CustTrans et réglée Type d'événement explicit
	Paiement Partiel Comptabilisé	L'enregistrement d'un paiement qui ne couvre pas entièrement le solde ouvert de la facture. Déclenche souvent la poursuite d'un solde restant.
Pourquoi est-ce important ? : Distingue les comportements de paiement échelonné des règlements complets. Important pour la précision des prévisions de trésorerie. Source des données : Table CustSettlement reliant un Paiement (CustTrans) à la Facture (CustTrans) lorsque SettlementAmount < InvoiceAmount. Capture Comptabilisé lors de l'exécution de la transaction X dans CustSettlement Type d'événement explicit
	Rappel de Paiement Envoyé	Enregistre l'émission d'une lettre de relance formelle au client. Ceci est extrait du journal des lettres de relance.
Pourquoi est-ce important ? : Indique le début des efforts de recouvrement actifs. L'analyse de la fréquence aide à optimiser la stratégie de relance et à réduire les coûts administratifs. Source des données : Table CustCollectionLetterJour. Capture la date à laquelle le code de lettre a été comptabilisé pour la transaction de facture spécifique. Capture Comptabilisé lors de la comptabilisation de la transaction dans CustCollectionLetterJour Type d'événement explicit
	Date d'échéance dépassée	Un jalon calculé indiquant que la date actuelle a dépassé la date d'échéance de la facture tant que celle-ci reste ouverte. Cela marque la facture comme en retard.
Pourquoi est-ce important ? : Critique pour l'analyse du vieillissement et le déclenchement des workflows de recouvrement. Il segmente le processus entre la facturation standard et la gestion des recouvrements. Source des données : Calculé en comparant la date d'échéance (CustInvoiceJour.DueDate) au temps de simulation actuel ou au horodatage de paiement. Capture Dérivé de la comparaison du champ DueDate à l'heure actuelle Type d'événement calculated
	Litige en Cours d'Examen	Indique que le dossier de litige est passé de l'état 'Ouvert' à l'état 'En cours'. Représente le temps de travail de l'équipe de résolution.
Pourquoi est-ce important ? : Les points de blocage ici augmentent le Cycle de Conversion de Trésorerie. Sépare le temps d'attente du temps de résolution active. Source des données : Déduit des changements du champ CaseDetailBase.Status ou des entrées de la table CaseLog correspondant à la progression du statut. Capture Comparer le champ de statut avant/après dans CaseDetailBase Type d'événement inferred
	Litige résolu	La clôture du cas de litige, permettant à la facture de procéder au paiement ou à l'avoir. Marque la fin du sous-processus de gestion des exceptions.
Pourquoi est-ce important ? : Le delta temporel entre Ouvert et Résolu est un KPI clé pour l'efficacité administrative. Source des données : Table CaseDetailBase où le statut passe à Fermé/Résolu. Capture Comparer le champ de statut avant/après dans CaseDetailBase Type d'événement inferred
	Note d'intérêt générée	La création d'une note d'intérêt pour les paiements en retard. Représente une pénalité financière appliquée au compte client.
Pourquoi est-ce important ? : Indique une défaillance grave. L'analyse aide à déterminer si les pénalités accélèrent efficacement le paiement ou nuisent aux relations client. Source des données : Table CustInterestJour. Cette table enregistre les notes d'intérêt générées pour des transactions client spécifiques. Capture Comptabilisé lors de la comptabilisation de la transaction dans CustInterestJour Type d'événement explicit
	Paiement Passé en Perte	L'acte de déclarer la facture irrécouvrable et de retirer le solde via un journal de passage en perte. Représente une perte financière.
Pourquoi est-ce important ? : État final des processus de recouvrement échoués. Primordial pour analyser les ratios de créances douteuses et l'efficacité de la politique de crédit. Source des données : Table CustTrans où le Type est 'Passer en perte' (WriteOff) ou GeneralJournalEntry spécifiquement marqué avec des codes de motif de radiation. Capture Comptabilisé lorsque la transaction est comptabilisée avec le type WriteOff Type d'événement explicit
	Promesse de paiement reçue	Un engagement spécifique enregistré par un agent de recouvrement selon lequel le client paiera à une certaine date. Capturé à partir du module de gestion des recouvrements.
Pourquoi est-ce important ? : Mesure l'efficacité des appels de recouvrement. La comparaison de cette date avec le paiement réel révèle la fiabilité des promesses clients. Source des données : Table CustPromiseToPay. Liée à la transaction client via TransRecId. Capture Comptabilisé lors de la création d'un enregistrement dans CustPromiseToPay Type d'événement explicit
	Relevé Bancaire Apparié	L'événement de rapprochement où le paiement enregistré dans les créances clients est mis en correspondance avec une ligne du relevé bancaire importé.
Pourquoi est-ce important ? : Valide que les fonds sont effectivement en banque. Des retards à ce niveau indiquent des inefficacités dans les processus de gestion de trésorerie et bancaire. Source des données : Statut de rapprochement de BankReconciliationLine ou BankAccountTrans. Nécessite le module de Rapprochement Bancaire Avancé. Capture Comptabilisé lors du rapprochement de la transaction dans le Rapprochement Bancaire Type d'événement explicit

Recommandé Facultatif

Guides d'extraction

Comment obtenir vos données de Microsoft Dynamics 365

Étapes

Configurer les ressources Azure : Provisionnez une base de données Azure SQL pour servir de cible Bring Your Own Database (BYOD). Assurez-vous que la chaîne de connexion inclut des identifiants avec des autorisations de lecture/écriture.
Configurer la gestion des données dans D365 : Naviguez vers Administration système > Espaces de travail > Gestion des données. Cliquez sur la vignette 'Configurer l'exportation d'entités vers la base de données'. Entrez la chaîne de connexion de l'étape précédente pour enregistrer la base de données externe.
Sélectionner les entités requises : Créez un nouveau projet d'exportation dans l'espace de travail de gestion des données. Ajoutez les entités standard suivantes au projet : CustInvoiceJournalHeaderEntity, CustTransactionEntity, CustSettlementEntity, CustCollectionLetterJournalHeaderEntity, CaseDetailEntity, CaseAssociationEntity, CustInterestJournalEntity, BankAccountTransEntity et CustPromiseToPayEntity.
Mapper la source à la cible : Assurez-vous que tous les champs sont correctement associés, en veillant spécifiquement à ce que les champs RecId et CreatedDateTime soient inclus, car ils sont essentiels pour le séquençage des événements.
Exécuter l'exportation initiale : Exécutez manuellement la tâche d'exportation (type de tâche : Export) pour effectuer un chargement complet des données historiques dans la base de données Azure SQL. Surveillez le résumé d'exécution pour vous assurer que tous les enregistrements ont été transférés avec succès.
Planifier les mises à jour incrémentales : Configurez une tâche de données récurrente pour exécuter le projet d'exportation périodiquement (par exemple, toutes les 4 heures ou toutes les nuits) en utilisant le 'push incrémental' pour mettre à jour uniquement les enregistrements modifiés.
Se connecter à Azure SQL : Utilisez SQL Server Management Studio (SSMS) ou un outil similaire pour vous connecter à la base de données BYOD Azure SQL.
Exécuter le script de transformation : Exécutez le script SQL fourni dans la section Requête ci-dessous sur les tables BYOD. Ce script unifie les tables disparates en une structure de journal d'événements unique.
Vérifier et extraire : Vérifiez la cohérence de la sortie (voir Étapes de validation). Exportez l'ensemble de résultats vers un fichier CSV ou Parquet pour l'ingestion dans ProcessMind.

Configuration

Méthode d'exportation : Bring Your Own Database (BYOD) ou Azure Data Lake Storage Gen2 (ADLS).
Stratégie de rafraîchissement : Chargement complet pour la charge initiale, push incrémental pour les mises à jour récurrentes afin de minimiser l'impact sur les performances.
Entités requises : CustInvoiceJournalHeaderEntity (Factures), CustSettlementEntity (Paiements/Apurements), CustCollectionLetterJournalHeaderEntity (Relances), CaseDetailEntity (Litiges), BankAccountTransEntity (Rapprochement bancaire).
Filtre d'entreprise : Appliquez des filtres sur la colonne 'DataAreaId' si l'analyse doit être limitée à des entités légales spécifiques.
Plage de dates : Fenêtre glissante de 12 mois recommandée basée sur 'InvoiceDate' ou 'TransDate'.
Suivi des modifications : Doit être activé sur les tables SQL dans D365 pour que l'exportation incrémentale fonctionne efficacement.

a Exemple de requête config

/* 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'

Étapes

Configuration des prérequis : Assurez-vous que Python 3.x est installé sur la machine d'exécution. Installez les bibliothèques requises à l'aide de pip : pandas, requests et msal (si vous utilisez la Microsoft Authentication Library, bien que ce script utilise REST direct par simplicité).
Enregistrement d'application Azure : Enregistrez une application dans Azure Active Directory (Entra ID) pour permettre l'accès à Dynamics 365. Notez l'ID client, le secret client et l'ID de locataire. Assurez-vous que l'application dispose des autorisations d'API pour Dynamics ERP (OData).
Configurer le script : Ouvrez le script Python fourni. Mettez à jour le dictionnaire config en haut avec votre URL D365 spécifique, l'ID client, le secret client, l'ID de locataire et le code d'entreprise cible (dataAreaId).
Définir la plage de dates : Modifiez les variables start_date et end_date dans le script pour définir la fenêtre d'extraction. Une fenêtre glissante des 90 à 180 derniers jours est recommandée pour les chargements incrémentaux.
Exécuter l'extraction : Exécutez le script. Il s'authentifiera auprès d'Azure AD, récupérera un jeton d'accès et itérera sur plusieurs entités OData (CustomerInvoices, PaymentJournals, CaseDetails, etc.) pour récupérer les données.
Traitement des facturess factures fournisseurs factures fournisseurs données : Le script effectue automatiquement des transformations de données, telles que le renommage des colonnes pour correspondre au schéma ProcessMind, le calcul des événements 'Due Date Passed' basé sur la date du système, et la distinction entre les paiements partiels et complets en fonction des montants des transactions.
Fusionner et trier : Le script concatène tous les donnéesframes d'activités en un seul journal d'événements et les trie par InvoiceNumber et EventHorodatage.
Exporter : Le dataframe final est exporté vers un fichier CSV nommé AR_Event_Log.csv. Vérifiez que ce fichier est créé dans le répertoire du script.
Validation : Ouvrez le fichier CSV et vérifiez que les dates sont au format ISO (AAAA-MM-JJ HH:MM:SS) et que toutes les colonnes requises sont renseignées.
Téléchargement : Importez le fichier CSV généré dans ProcessMind à l'aide de l'assistant de téléchargement de fichiers standard. Mappez les colonnes InvoiceNumber à ID du cas, Activity à Activity et EventHorodatage à Horodatage.

Configuration

Taille de lot : Le script utilise une taille de page par défaut (souvent 1000 enregistrements) contrôlée par le serveur. Le script gère la pagination automatiquement en utilisant la propriété @odata.nextLink.
Filtres de dates : Le paramètre OData $filter est utilisé pour limiter la récupération des données à des plages de dates pertinentes (par exemple, InvoiceDate ge 2023-01-01T00:00:00Z). Cela améliore significativement les performances.
Filtrage par entreprise : D365 stocke des données pour plusieurs entités légales. Le script filtre par dataAreaId pour garantir que seules les données de l'unité commerciale pertinente sont extraites.
Authentification : Utilise OAuth 2.0 (Client Credentials Flow). Vous devez disposer d'un Client Secret et d'une App Registration valides.
Sélection d'entités : Utilise des entités standard telles que CustomerInvoices, CustomerPaymentJournalLines et CaseDetail. Si votre organisation utilise des entités personnalisées, les endpoints du dictionnaire endpoints doivent être mis à jour.
Événements calculés : Des événements tels que 'Due Date Passed' sont calculés pendant l'exécution du script, car ils ne génèrent pas de journal de transactions spécifique dans la base de données.

a Exemple de requête 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()

Votre modèle de données des créances clients

Votre modèle de données des créances clients

Attributs des Comptes Clients

Activités des Comptes Clients

Guides d'extraction

Exportation d'Entités du Cadre de Gestion des Données D365

Étapes

Configuration

a Exemple de requête config

Extraction Python OData API pour les événements des créances clients

Étapes

Configuration

a Exemple de requête python

Prêt(e) à démarrer ?

Optimisez vos créances clients et dynamisez votre trésorerie dès maintenant

Votre modèle de données des créances clients

Votre modèle de données des créances clients

Attributs des Comptes Clients

Activités des Comptes Clients

Guides d'extraction

Exportation d'Entités du Cadre de Gestion des Données D365

Étapes

Configuration

a Exemple de requête config

Extraction Python OData API pour les événements des créances clients

Étapes

Configuration

a Exemple de requête python

Nous respectons votre vie privée

Prêt(e) à démarrer ?

Optimisez vos créances clients et dynamisez votre trésorerie dès maintenant