> Amélioration continue des processus > Gestion du crédit et recouvrement > HighRadius > Modèle de données

Votre modèle de données pour la gestion du crédit et recouvrement

HighRadius

Attributs de gestion du crédit et de recouvrement (22) Activités de gestion du crédit et de recouvrement (15) Guides d'extraction (2)

Votre modèle de données pour la gestion du crédit et recouvrement

Ce modèle fournit un guide structuré pour la collecte des données nécessaires à l'analyse de votre processus de gestion du crédit et recouvrement. Il décrit les attributs essentiels à capturer, les activités clés à suivre et offre des conseils pratiques sur la façon d'extraire ces informations de votre système HighRadius. L'utilisation de ce modèle vous aidera à préparer efficacement vos données pour le Process Mining.

Attributs recommandés à collecter
Activités clés à suivre pour la visibilité du processus
Guide d'extraction spécifique à HighRadius

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

Télécharger le modèle

Attributs de gestion du crédit et de recouvrement

Voici les champs de données recommandés à inclure dans votre journal d'événements pour une analyse complète de votre processus de gestion du crédit et recouvrement.

3 Obligatoire 7 Recommandé 12 Facultatif

	Nom	Description
	Heure de l'événement EventTime	L'horodatage indiquant quand l'activité s'est produite, y compris la date et l'heure.
Description L'Heure de l'événement fournit la date et l'heure précises pour chaque activité du processus. Ces données chronologiques sont l'épine dorsale du Process Mining, permettant l'ordonnancement correct des événements et le calcul des durées entre eux. Cet attribut est utilisé pour calculer tous les KPI basés sur le temps, tels que les temps de cycle pour la résolution des litiges, l'approbation du crédit et la comptabilisation des paiements. Il est également utilisé pour analyser les performances des processus au fil du temps, identifier les activités qui causent des retards et mesurer le respect des accords de niveau de service. Pourquoi c'est important Il fournit le contexte chronologique de toutes les activités, ce qui est essentiel pour calculer les temps de cycle, découvrir les goulots d'étranglement et comprendre la dynamique des processus. Où obtenir Chaque enregistrement transactionnel ou journal d'événements dans HighRadius doit avoir un champ d'horodatage correspondant, souvent nommé « Date de création » ou « Horodatage ». Exemples 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Nom de l'activité ActivityName	Le nom de l'événement commercial spécifique qui s'est produit à un moment donné pour une facture.
Description Le nom de l'activité décrit une étape du processus de crédit et recouvrement, telle que 'Facture générée', 'Rappel de retard envoyé' ou 'Paiement reçu'. Cette séquence d'activités forme le flux de processus pour chaque dossier. L'analyse de cet attribut permet la découverte et la visualisation de la carte de processus réelle. Elle aide à identifier les goulots d'étranglement, les écarts par rapport à la procédure standard et les boucles de retravail. La fréquence et l'ordre des activités comme 'Appel de recouvrement enregistré' ou 'Litige enregistré' sont essentiels pour comprendre l'efficacité du processus. Pourquoi c'est important Cet attribut définit les étapes du processus, permettant la reconstruction et l'analyse du flux de processus pour chaque facture. Où obtenir Ceci est généralement dérivé des journaux d'événements, des changements de statut ou des enregistrements d'actions spécifiques au sein des différents modules de la plateforme HighRadius. Exemples Facture Envoyée au ClientProcédure de relance initiéePaiement ReçuLitige résolu
	Numéro de facture InvoiceNumber	L'identifiant unique de chaque facture, servant d'identifiant principal de dossier pour le processus crédit-client.
Description Le numéro de facture est la clé centrale qui relie toutes les activités liées à une seule transaction de comptes clients. Il permet de suivre l'intégralité du cycle de vie, de la génération de la facture, en passant par diverses activités de gestion du crédit et de recouvrement, jusqu'au règlement final ou à l'annulation de créance. Dans l'analyse Process Mining, cet attribut est essentiel pour regrouper tous les événements connexes en un seul dossier. Cela permet la visualisation des flux de processus de bout en bout, le calcul des durées des dossiers comme les Jours de Vente en Suspens (DSO) et l'analyse des différents chemins qu'une facture pourrait prendre, tels que la résolution de litiges ou les procédures de relance. Pourquoi c'est important C'est l'identifiant fondamental qui relie toutes les étapes du processus, permettant d'analyser le parcours complet d'une facture de sa création à sa clôture. Où obtenir C'est un champ principal dans HighRadius, généralement trouvé dans les objets de données de facture ou de créances principaux. Exemples INV-2023-001239876543210SI-55482
	Conditions de paiement PaymentTerms	Les conditions convenues qui définissent quand un client est censé payer une facture.
Description Les conditions de paiement spécifient les modalités de règlement, telles que 'Net 30', 'Net 60' ou 'Dû à réception'. Cet attribut est la base du calcul de la date d'échéance de la facture. Il s'agit d'un attribut clé pour le tableau de bord et le KPI d'"Adhérence aux conditions de paiement". Son analyse permet d'identifier si les conditions standard sont appliquées de manière cohérente et quelles conditions de paiement sont associées à des taux plus élevés de retards. Cette information peut éclairer la politique de crédit et les négociations avec les clients. Pourquoi c'est important Il établit la référence pour les délais de paiement attendus, ce qui est crucial pour calculer les dates d'échéance et mesurer le respect des accords de paiement par les clients. Où obtenir Ceci est généralement trouvé sur l'en-tête de facture ou les données de base client au sein de HighRadius ou de l'ERP source. Exemples Net 30Net 60Payable à réception
	Date d'échéance DueDate	La date calculée à laquelle le paiement de la facture est dû.
Description La date d'échéance est la date calendaire spécifique à laquelle une facture doit être payée pour éviter d'être considérée comme en retard. Elle est généralement calculée à partir de la date de facture et des conditions de paiement. Cet attribut est fondamental pour toutes les analyses de retard. C'est l'entrée principale pour le calcul des 'Jours de retard', le déclenchement des procédures de relance et la mesure du KPI de 'Taux de respect des conditions de paiement'. Il soutient directement les tableaux de bord liés à l'ancienneté des factures et à l'efficacité de la relance. Pourquoi c'est important C'est la date critique qui détermine si une facture est à temps ou en retard, déclenchant toutes les activités de recouvrement et les KPI ultérieurs. Où obtenir C'est un champ standard dans l'enregistrement de la facture dans HighRadius. Il peut être renseigné à partir de l'ERP source ou calculé au sein de HighRadius. Exemples 2023-04-142023-05-312023-06-20
	ID client CustomerId	L'identifiant unique du client associé à la facture.
Description L'ID Client lie une facture à l'entité client spécifique. Cela permet d'agréger et d'analyser les données de processus sous une perspective centrée sur le client. Cet attribut est essentiel pour analyser les comportements de paiement de différents clients ou segments de clientèle. Il aide à répondre à des questions comme : Quels clients sont fréquemment en retard ? Quels clients génèrent le plus de litiges ? Il prend en charge des tableaux de bord comme "Adhérence aux conditions de paiement" et permet de segmenter les KPI par client. Pourquoi c'est important Il permet une analyse au niveau du client du comportement de paiement, de la fréquence des litiges et de l'interaction globale du processus, aidant à adapter les stratégies de recouvrement. Où obtenir C'est un champ standard dans les données d'en-tête de facture ou de compte client au sein de HighRadius. Exemples CUST-001ACME-CORPGLOBEX-US
	Montant de la facture InvoiceAmount	La valeur monétaire totale de la facture.
Description Cet attribut représente le montant total dû sur la facture. C'est une métrique financière critique pour comprendre la valeur associée à chaque dossier. En Process Mining, le Montant de la Facture est utilisé pour prioriser les efforts de recouvrement, par exemple, en se concentrant sur les factures en retard de grande valeur. Il est fondamental pour les KPI financiers comme les Jours de Vente en Suspens (DSO) et est utilisé dans le tableau de bord d'"Analyse des créances irrécouvrables" pour quantifier l'impact financier des créances douteuses. Pourquoi c'est important Il fournit le contexte financier pour chaque cas, permettant une analyse basée sur la valeur, la priorisation du travail et la quantification des impacts financiers comme les passages en perte. Où obtenir C'est un champ standard dans les données d'en-tête de facture au sein de HighRadius. Exemples 5000.001250.7525000.50
	Motif du litige DisputeReason	Le code motif ou la description fournis lorsqu'une facture est contestée par un client.
Description Lorsqu'un client soulève un litige, il fournit généralement une raison, telle que 'Prix incorrect', 'Marchandises endommagées' ou 'Facture en double'. Cet attribut capture cette raison. L'analyse de la raison du litige est essentielle pour le tableau de bord 'Temps de résolution des litiges de facturation'. Elle aide à identifier les causes profondes des litiges, permettant à l'entreprise de résoudre les problèmes systémiques de tarification, d'expédition ou de facturation. La réduction des litiges à la source peut considérablement accélérer les flux de trésorerie. Pourquoi c'est important Il fournit un aperçu des causes profondes des retards de paiement, permettant des améliorations de processus ciblées pour prévenir les futurs litiges. Où obtenir Cette information est capturée dans le module de gestion des litiges ou des déductions de HighRadius lorsqu'un litige est enregistré. Exemples Quantité incorrecteÉcart de prixMarchandises EndommagéesFacturation en double
	Nom de l'agent de recouvrement CollectorName	Le nom de l'utilisateur ou de l'agent responsable de l'exécution d'une activité de recouvrement.
Description Cet attribut identifie l'agent de recouvrement, l'analyste de crédit ou tout autre utilisateur ayant exécuté une activité manuelle, telle que 'Appel de recouvrement enregistré' ou 'Litige résolu'. En analyse, cela permet des comparaisons de performance entre différents agents ou équipes. Cela aide à comprendre la répartition de la charge de travail, à évaluer l'efficacité des stratégies individuelles (par exemple, le taux de réussite des appels de recouvrement par agent) et à identifier les opportunités de coaching. C'est également un élément clé pour la gestion des ressources et la planification des capacités. Pourquoi c'est important Il relie les activités du processus à des individus spécifiques, permettant l'analyse de la performance de l'équipe, de la charge de travail et de l'efficacité des interventions manuelles. Où obtenir Cette information est généralement stockée dans les journaux d'activités ou les enregistrements d'actions utilisateur au sein du module de recouvrement HighRadius. Exemples John SmithJane DoeEmily Jones
	Statut du paiement PaymentStatus	Le statut financier actuel de la facture, tel que Ouverte, Payée, En retard ou Litigieuse.
Description Le statut de paiement offre une vue d'ensemble de l'emplacement d'une facture dans son cycle de vie. Il indique si elle est toujours en attente de paiement, si elle a été entièrement ou partiellement payée, si sa date d'échéance est dépassée, ou si elle fait l'objet d'une enquête en raison d'un litige. Cet attribut est central au tableau de bord "Statut de paiement et ancienneté des factures". Il permet une segmentation rapide du portefeuille de créances pour comprendre la santé financière globale et prioriser les efforts de recouvrement sur les éléments en retard ou litigieux. Pourquoi c'est important Il catégorise les factures en groupes exploitables, offrant une visibilité immédiate sur l'état des créances et aidant à prioriser les activités de recouvrement. Où obtenir Il s'agit d'un champ de statut essentiel de l'enregistrement de facture ou de compte client au sein de HighRadius. Exemples OuvertPayéEn retardLitigieuxAnnulée
	Date de promesse de paiement PromiseToPayDate	La date à laquelle un client a promis d'effectuer un paiement pour une facture en retard.
Description Lorsqu'un agent de recouvrement contacte un client, il peut obtenir une 'Promesse de paiement', qui est un engagement du client à payer à une certaine date. Cet attribut enregistre cette date promise. L'analyse de ces données est importante pour évaluer la fiabilité des promesses des clients et l'efficacité des agents de recouvrement à obtenir des engagements fermes. Elle peut être utilisée pour suivre le taux de 'promesses tenues', qui est un indicateur clé de performance pour une équipe de recouvrement. Pourquoi c'est important Il capture un résultat clé des activités de recouvrement et est utilisé pour mesurer l'efficacité des suivis et la fiabilité des engagements clients. Où obtenir Cette date est enregistrée lorsqu'une activité de 'Promesse de paiement' est journalisée dans le module de recouvrement HighRadius. Exemples 2023-06-152023-07-012023-06-25
	Dernière mise à jour des données LastDataUpdate	L'horodatage de la dernière actualisation des données de cet enregistrement depuis le système source.
Description Cet attribut indique la fraîcheur des données. Il enregistre la date et l'heure de la dernière extraction ou mise à jour des données depuis HighRadius. Pour l'analyse, ce champ fournit un contexte sur la fraîcheur des informations. Il est crucial pour les tableaux de bord et les rapports d'afficher l'actualité de l'information, garantissant que les décisions commerciales sont basées sur des données à jour. Pourquoi c'est important Il offre une transparence quant à l'actualité des données, ce qui est essentiel pour instaurer la confiance dans l'analyse et prendre des décisions éclairées. Où obtenir Cet horodatage est généré et ajouté à chaque enregistrement par le pipeline d'ingestion de données pendant le processus d'extraction. Exemples 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Devise Currency	Le code de devise pour le montant de la facture.
Description Cet attribut spécifie la devise de la facture, telle que USD, EUR ou JPY. Il fournit un contexte essentiel pour toutes les valeurs monétaires comme le Montant de la Facture. Dans toute entreprise multinationale, ce champ est non négociable pour une analyse financière précise. Il garantit que les valeurs monétaires sont interprétées correctement et permet une conversion de devise appropriée lors de l'agrégation des données pour les rapports mondiaux. Pourquoi c'est important Il est essentiel pour l'interprétation correcte de toutes les valeurs monétaires, prévenant les calculs financiers et les rapports inexacts dans les environnements multi-devises. Où obtenir C'est un champ standard sur l'enregistrement de la facture, généralement situé à côté du Montant de la facture. Exemples USDEURGBP
	Est Automatisé IsAutomated	Un indicateur booléen qui précise si une activité a été réalisée automatiquement par le système ou manuellement par un utilisateur.
Description Cet attribut calculé distingue les événements générés par le système (par exemple, 'Rappel de retard envoyé' par une exécution de relance automatisée) des actions humaines (par exemple, 'Appel de recouvrement enregistré'). Ce drapeau est crucial pour calculer le KPI du 'Taux d'activité de recouvrement automatisé'. Il aide à mesurer le niveau d'automatisation dans le processus de recouvrement, à identifier les opportunités d'automatisation supplémentaire et à analyser l'efficacité relative des contacts automatisés par rapport aux contacts manuels. Pourquoi c'est important Il aide à mesurer le degré d'automatisation du processus, permettant l'analyse de l'efficience et de l'efficacité des systèmes automatisés par rapport aux efforts manuels. Où obtenir Ceci est dérivé pendant la transformation des données. Cela nécessite la création d'un mappage qui marque certains Noms d'activité comme automatisés en fonction des connaissances métier. Exemples truefaux
	Heure de fin EndTime	L'horodatage indiquant quand une activité a été achevée.
Description L'heure de fin marque la conclusion d'une activité. Alors que de nombreuses activités de recouvrement sont des événements instantanés où l'heure de début est égale à l'heure de fin, certaines activités comme la 'Résolution des litiges' peuvent avoir une durée distincte. Cet attribut, lorsqu'il est disponible, est utilisé avec l'heure de début pour calculer le temps de traitement des activités individuelles. Cela aide à identifier quelles étapes spécifiques, et pas seulement les écarts entre elles, consomment le plus de temps et de ressources. Pourquoi c'est important Il permet la mesure précise des durées d'activités individuelles, offrant une vue plus détaillée de la manière dont le temps est dépensé au sein du processus. Où obtenir Consultez la documentation HighRadius. Cela peut être disponible pour certaines activités journalisées qui ont un état de début et de fin. Exemples 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Jours de retard DaysOverdue	Le nombre de jours de retard d'une facture par rapport à sa date d'échéance. Il est nul si la facture n'est pas encore due ou a été payée à temps.
Description Les Jours de retard sont une métrique calculée qui mesure la différence entre la date actuelle (pour les factures ouvertes) ou la date de paiement (pour les factures payées) et la date d'échéance de la facture. C'est un indicateur clé de la délinquance de paiement. Cet attribut est la base du Dashboard « Statut de paiement des factures et ancienneté », où il est utilisé pour regrouper les créances en tranches d'ancienneté (par exemple, 1-30 jours, 31-60 jours). C'est également un composant du calcul des Jours de Ventes en Souffrance (DSO) et aide à prioriser les efforts de recouvrement sur les comptes les plus en retard. Pourquoi c'est important Cette métrique quantifie directement les retards de paiement, la rendant essentielle pour l'analyse de l'ancienneté, la priorisation des recouvrements et le calcul du DSO. Où obtenir Ce n'est pas un champ stocké. Il est calculé lors de la transformation des données en utilisant la date d'échéance et soit la date de paiement, soit la date actuelle. Exemples 1545092
	Motif d'annulation WriteOffReason	Le code motif ou l'explication de l'annulation d'une facture en tant que créance irrécouvrable.
Description Lorsqu'une facture est jugée irrécouvrable, elle est annulée. Cet attribut capture la raison de l'annulation, telle que 'Faillite client', 'Litige non résolu' ou 'Annulation de petit solde'. C'est un attribut critique pour le tableau de bord d'"Analyse des annulations de factures". Il aide à l'analyse des causes profondes des pertes financières, fournissant des informations qui peuvent être utilisées pour affiner les politiques de crédit, améliorer la gestion des litiges ou ajuster les stratégies de recouvrement afin de minimiser les futures annulations. Pourquoi c'est important Il explique les raisons de la perte de revenus, fournissant un retour d'information crucial pour améliorer l'évaluation du risque de crédit et les politiques de recouvrement. Où obtenir Cette information est enregistrée lorsqu'une activité 'Facture annulée' est traitée, généralement au sein du module financier ou de recouvrement de HighRadius. Exemples FailliteDélai de prescription expiréCoût de recouvrement supérieur à la créance
	Niveau de relance DunningLevel	L'étape ou le niveau du processus de relance automatisé atteint pour une facture en retard.
Description Le niveau de relance indique l'intensité de l'effort de recouvrement, correspondant souvent à une séquence de rappels ou d'avis automatisés envoyés au client. Par exemple, le niveau 1 pourrait être un rappel doux, tandis que le niveau 3 est un avis final. Cet attribut est essentiel pour le tableau de bord d'"Efficacité de la stratégie de relance". En analysant quels niveaux de relance mènent le plus souvent au paiement, les entreprises peuvent optimiser leurs flux de travail de relance, s'assurant qu'ils sont efficaces sans être excessivement agressifs et nuire aux relations client. Pourquoi c'est important Il suit l'escalade des activités de recouvrement, permettant d'analyser quelles stratégies de relance sont les plus efficaces pour inciter au paiement. Où obtenir Il s'agit d'un champ de statut géré par le moteur de workflow de recouvrement ou de relance automatisé au sein de HighRadius. Exemples 123 - Avis finalRecouvrement juridique
	Pays Country	Le pays du client associé à la facture.
Description Cet attribut spécifie le pays où le client est situé. Il permet une segmentation géographique du processus de crédit et recouvrement. L'analyse des données par pays peut révéler des différences régionales dans les comportements de paiement, l'efficacité des stratégies de recouvrement et les raisons courantes des litiges. Cette information est vitale pour adapter les politiques régionales et pour les rapports de gestion de haut niveau dans les organisations mondiales. Pourquoi c'est important Il permet une analyse géographique, qui peut révéler des tendances régionales dans le comportement de paiement et aider à adapter les stratégies de recouvrement en conséquence. Où obtenir Cette information fait partie des données de base client, généralement disponibles dans HighRadius ou synchronisées depuis un ERP source. Exemples États-UnisAllemagneBrazil
	Système source SourceSystem	Le système d'où proviennent les données.
Description Cet attribut identifie le système source où les données d'événement ont été générées. Pour cette vue de processus, la valeur sera généralement 'HighRadius'. Dans les environnements multi-systèmes, ce champ est crucial pour comprendre la lignée des données et retracer l'information jusqu'à son origine. Il aide à différencier les processus qui peuvent s'étendre sur différentes plateformes, comme un ERP et un outil de recouvrement spécialisé. Pourquoi c'est important Il clarifie l'origine des données, ce qui est important pour la gouvernance des données, la validation et la compréhension du paysage technologique du processus. Où obtenir C'est généralement une valeur statique ajoutée lors du processus d'extraction et de transformation des données pour étiqueter l'ensemble de données. Exemples HighRadiusHighRadius-RecouvrementsHighRadius-CashApp
	Temps de traitement ProcessingTime	La durée d'une seule activité, calculée comme la différence entre son heure de fin et son heure de début.
Description Le temps de traitement mesure le temps passé à travailler activement sur une tâche spécifique. Pour de nombreuses activités de recouvrement, ce temps sera nul, car il s'agit d'événements instantanés. Cependant, pour les tâches ayant un début et une fin définis, il fournit des informations précieuses. Cette métrique aide à déterminer quelles activités spécifiques, plutôt que le temps d'attente entre elles, consomment le plus de temps. Par exemple, elle pourrait mesurer le temps de travail actif sur un dossier de litige. Cela permet des améliorations plus ciblées sur la manière dont les tâches individuelles sont exécutées. Pourquoi c'est important Il isole la durée du travail à valeur ajoutée du temps d'attente, aidant à identifier les inefficacités au sein d'étapes de processus spécifiques. Où obtenir C'est calculé comme 'EndTime' - 'StartTime' pendant le processus de transformation des données. Cela ne peut être calculé que lorsque les deux champs sont disponibles et significatifs. Exemples 8640036000
	Unité commerciale BusinessUnit	L'unité commerciale interne ou la division responsable de la vente ou de la facture.
Description L'attribut Unité commerciale attribue la facture à une partie spécifique de l'organisation, telle que 'Détail', 'Vente en gros' ou 'Services'. Cela permet d'analyser les performances par différents segments commerciaux. La direction peut comparer des KPI comme le DSO, les taux de litiges et les annulations de créances entre les unités commerciales pour identifier les domaines d'excellence ou ceux nécessitant des améliorations. Cela aide à responsabiliser les différentes parties de l'organisation quant à la performance de leurs créances. Pourquoi c'est important Il permet d'établir des analyses comparatives de performance entre différentes parties de l'organisation, aidant à identifier les divisions qui ont les processus de crédit au comptant les plus efficaces. Où obtenir Ce sont des données organisationnelles, généralement trouvées sur la facture ou dérivées de la commande client ou du compte client associé dans HighRadius ou l'ERP. Exemples BU-Amérique du NordDivision des servicesFabrication

Obligatoire Recommandé Facultatif

Activités de gestion du crédit et de recouvrement

Voici les étapes clés du processus et les jalons à capturer dans votre journal d'événements pour une découverte et une analyse précises de votre processus de gestion du crédit et recouvrement.

7 Recommandé 8 Facultatif

	Activité	Description
	Date d'échéance de paiement dépassée	Un événement calculé qui se produit lorsque la date actuelle dépasse la date d'échéance de paiement de la facture. Cette activité ne représente pas une action utilisateur ou système, mais un changement d'état critique qui déclenche le processus de recouvrement.
Pourquoi c'est important Cette activité est le déclencheur principal de toutes les activités de relance et de recouvrement ultérieures. Elle sépare les factures payées à temps de celles en retard, permettant d'analyser l'efficacité de la stratégie de recouvrement. Où obtenir Cet événement n'est pas stocké directement mais est calculé en comparant le champ de date d'échéance de la facture avec l'horodatage d'autres événements. Il est dérivé lors de la transformation des données de Process Mining. Capture Calculé en comparant la date d'échéance de la facture (`due_date`) avec la date actuelle ou l'horodatage de l'événement (`Timestamp > Due Date`). Type d'événement calculated
	Facture générée	C'est le point de départ du cycle de vie d'une facture dans le processus de recouvrement. Il signifie qu'une facture a été créée dans le système ERP et importée dans HighRadius pour la gestion des créances.
Pourquoi c'est important Cette activité sert d'événement de début principal pour l'analyse du processus facture-à-encaissement. Tous les temps de cycle, tels que les Jours de Vente en Suspens (DSO), sont généralement mesurés à partir de ce point. Où obtenir C'est un événement explicite capturé à partir de la date de création de l'enregistrement de la facture au sein de HighRadius, qui est généralement synchronisé depuis le système ERP source comme SAP ou Oracle. Capture Capturé à partir de l'horodatage de création de l'enregistrement de facture dans les données de créances. Type d'événement explicit
	Facture passée en perte	Représente une fin alternative au cycle de vie de la facture où la dette est jugée irrécouvrable et est annulée en tant que créance douteuse. C'est un résultat indésirable.
Pourquoi c'est important Le suivi des annulations de créances est critique pour calculer le taux d'annulation de factures et analyser les causes profondes des pertes financières. Il aide à identifier les échecs dans l'évaluation du crédit ou les efforts de recouvrement. Où obtenir Cet événement est capturé lorsqu'une transaction spécifique pour annuler le solde de la facture est comptabilisée ou lorsque le statut de la facture est modifié en 'Annulée'. Capture Déduit d'un changement de statut à « Passé en perte » ou d'un type de transaction de passage en perte spécifique comptabilisé contre la facture. Type d'événement inferred
	Facture réglée	Cette activité signifie la fin réussie du cycle de vie de la facture, où la facture est entièrement payée et clôturée. C'est l'état final souhaité pour le processus.
Pourquoi c'est important Cela sert d'événement de fin principal du 'chemin vertueux' pour le processus. L'analyse des chemins menant à ce résultat aide à identifier les meilleures pratiques et les stratégies de recouvrement réussies. Où obtenir Ce n'est généralement pas un événement explicite mais est déduit du changement de statut de la facture à 'Clôturée' ou 'Apureé' et du solde devenant nul. L'horodatage de la comptabilisation finale du paiement sert souvent de temps d'événement. Capture Déduit du statut de la facture passant à « Clos » ou lorsque le champ de solde de la facture devient nul. Type d'événement inferred
	Litige enregistré	Cette activité marque le moment où un client soulève un litige ou une déduction contre une facture, qui est ensuite formellement enregistré dans HighRadius. Cela suspend le processus de recouvrement standard pour le montant contesté.
Pourquoi c'est important C'est l'événement de début pour mesurer le temps moyen de résolution des litiges. Identifier quand et pourquoi les litiges sont soulevés est essentiel pour aborder les causes profondes comme les erreurs de facturation ou les problèmes d'expédition. Où obtenir Cet événement est capturé lorsqu'un utilisateur crée un dossier de litige lié à une facture dans le module Deductions Cloud de HighRadius. Cette action crée un enregistrement de litige horodaté. Capture Capturé à partir de l'horodatage de création de l'enregistrement du cas de litige associé à la facture. Type d'événement explicit
	Litige résolu	Représente la conclusion du processus de gestion des litiges, où le problème a été examiné et une résolution a été trouvée. La facture peut désormais être payée ou annulée.
Pourquoi c'est important C'est l'événement de fin pour mesurer le temps moyen de résolution des litiges. Des cycles longs ici peuvent retarder considérablement l'encaissement et indiquer des inefficacités de processus. Où obtenir Ceci est capturé lorsque le statut du dossier de litige est modifié en 'Résolu', 'Clôturé' ou un état terminal similaire. L'horodatage de ce changement de statut est utilisé pour l'activité. Capture Déduit de l'horodatage lorsque le statut du cas de litige est mis à jour vers un état final « Résolu ». Type d'événement inferred
	Paiement Reçu	Cette activité marque la réception du paiement d'un client, souvent enregistrée à partir d'un relevé bancaire ou d'un fichier "lockbox". Cela signifie que les fonds ont été reçus mais n'ont pas encore été appliqués à la facture spécifique.
Pourquoi c'est important C'est un jalon critique qui arrête souvent le chronomètre du recouvrement. C'est le point de départ pour mesurer le KPI de 'Délai entre réception et comptabilisation du paiement', mettant en évidence les retards dans l'encaissement. Où obtenir Ceci est capturé à partir des enregistrements de paiement dans le Cash Application Cloud de HighRadius. Chaque lot de paiement ou transaction provenant d'un fichier bancaire aura une date de réception. Capture Capturé à partir de l'horodatage de l'enregistrement de paiement lorsqu'il est importé ou saisi dans le module d'application des espèces. Type d'événement explicit
	Appel de recouvrement enregistré	Représente un appel de recouvrement manuel effectué par un agent de recouvrement auprès du client concernant une facture impayée. Les agents enregistrent les détails et le résultat de l'appel directement dans HighRadius.
Pourquoi c'est important Cette activité est cruciale pour évaluer le taux de réussite des appels de recouvrement et l'efficacité des activités de recouvrement. Elle aide à distinguer les efforts de recouvrement automatisés des efforts manuels. Où obtenir C'est un événement explicite créé lorsqu'un agent utilise la fonction 'Enregistrer appel' ou 'Ajouter activité' sur la facture ou le compte client dans l'interface HighRadius. L'entrée inclut un horodatage. Capture Capturé à partir de la table du journal d'activités où les agents de recouvrement enregistrent les actions manuelles. Type d'événement explicit
	Facture Envoyée au Client	Cette activité marque le point auquel la facture a été livrée au client, généralement par e-mail ou via un portail client. HighRadius peut automatiser et enregistrer cet événement de communication.
Pourquoi c'est important Le suivi de cette activité aide à garantir que les clients reçoivent les factures rapidement. Les retards entre la génération et l'envoi des factures peuvent impacter directement les délais de paiement et le DSO. Où obtenir Ceci est souvent explicitement enregistré dans l'historique de correspondance ou d'activité associé à la facture dans le module Collections Cloud. Cela peut également être déduit du statut d'un travail de correspondance automatisé. Capture Enregistré dans l'historique des communications de la facture lors de l'envoi d'un e-mail ou d'une livraison via le portail. Type d'événement explicit
	Limite de crédit approuvée	Représente l'achèvement réussi du processus d'examen de crédit, où une limite de crédit est officiellement accordée au client. Cet événement est capturé lorsqu'un gestionnaire de crédit approuve la demande au sein de la plateforme HighRadius.
Pourquoi c'est important C'est un jalon clé qui débloque le processus de vente. Le suivi de cette activité est essentiel pour calculer le KPI de la durée totale du cycle d'approbation du crédit. Où obtenir Cet événement est généralement capturé à partir d'un changement de statut de la demande de limite de crédit, passant à 'Approuvée'. Il peut également s'agir d'un événement explicite dans le journal d'audit du système. Capture Déduit d'un changement de statut de la demande de crédit à « Approuvé » ou du champ d'horodatage d'approbation. Type d'événement inferred
	Limite de crédit demandée	Cette activité marque l'initiation d'une évaluation de crédit pour un client. Elle est généralement déclenchée avant la finalisation d'une commande et est capturée lorsqu'une demande de limite de crédit nouvelle ou mise à jour est saisie dans le système.
Pourquoi c'est important L'analyse du temps écoulé entre la demande et l'approbation aide à identifier les goulots d'étranglement dans l'intégration des clients et les cycles de vente. C'est un point de départ critique pour mesurer l'efficacité de l'équipe de gestion du crédit. Où obtenir Cet événement est probablement déduit d'un changement de statut sur le profil de crédit du client ou de la date de création d'un enregistrement de demande de limite de crédit dans le module de gestion du crédit de HighRadius. Capture Déduit de l'horodatage de création d'un objet de demande de limite de crédit ou d'un changement de statut à « En attente d'approbation ». Type d'événement inferred
	Paiement comptabilisé	Représente l'achèvement du processus d'encaissement, où un paiement reçu a été correctement rapproché et appliqué à une facture spécifique, soldant le montant dû.
Pourquoi c'est important Cette activité conclut le cycle de traitement des paiements. Le temps entre 'Paiement reçu' et 'Paiement comptabilisé' révèle l'efficacité du processus d'encaissement. Où obtenir Cet événement est capturé à partir du champ de date de comptabilisation ou de date d'apurement de l'enregistrement de la facture. Cet horodatage est enregistré lorsque l'encaissement est finalisé. Capture Capturé à partir de l'horodatage de la « date de comptabilisation » ou de la « date de compensation » sur l'élément de ligne comptable de la facture. Type d'événement explicit
	Procédure de relance initiée	Cette activité signifie le début d'un processus de relance formel ou d'un niveau spécifique au sein de ce processus pour une facture en retard. Elle représente une étape plus systématique qu'un simple rappel.
Pourquoi c'est important Le suivi de l'initiation des procédures de relance aide à analyser l'efficacité des différentes stratégies de recouvrement et des niveaux de relance pour inciter au paiement. Où obtenir Cet événement est généralement déduit d'un changement dans le champ 'Niveau de relance' ou 'Stratégie de recouvrement' associé à l'enregistrement de la facture dans HighRadius. Capture Déduit d'un changement dans l'attribut de niveau de relance de la facture, capturé via les journaux de modifications ou l'historique horodaté. Type d'événement inferred
	Promesse de paiement créée	Cette activité se produit lorsqu'un client s'engage à payer une facture à une date future, et que l'agent de recouvrement enregistre cette promesse dans le système. C'est un résultat intermédiaire positif.
Pourquoi c'est important Le suivi des promesses de paiement aide à prévoir les flux de trésorerie et à évaluer l'efficacité des agents de recouvrement. Il permet également d'analyser les promesses non tenues, lorsque le paiement n'est pas reçu à la date promise. Où obtenir C'est un événement explicite enregistré dans HighRadius lorsqu'un agent crée un enregistrement de 'Promesse de paiement' lié à une facture. Cet enregistrement a son propre horodatage de création. Capture Capturé à partir de l'horodatage de création de l'objet « Promesse de paiement » dans HighRadius. Type d'événement explicit
	Rappel de retard envoyé	Représente un rappel automatisé ou manuel envoyé à un client concernant une facture impayée. HighRadius l'automatise dans le cadre de ses stratégies de relance, créant un journal de la communication.
Pourquoi c'est important Cette activité est fondamentale pour mesurer le taux d'efficacité de la relance. Elle permet d'analyser le nombre de rappels nécessaires avant qu'un paiement ne soit reçu. Où obtenir C'est un événement explicite enregistré dans le journal d'activités ou de correspondance de la facture au sein du HighRadius Collections Cloud. Chaque rappel envoyé aura une entrée et un horodatage correspondants. Capture Capturé à partir du journal de communication horodaté associé à la facture. Type d'événement explicit

Recommandé Facultatif

Guides d'extraction

Comment extraire vos données de HighRadius

Étapes

Accédez au module de Rapports et d'Analyse : Connectez-vous à votre instance HighRadius avec un utilisateur disposant des permissions nécessaires pour créer et exécuter des rapports personnalisés. Naviguez vers la section Rapports et Analyse depuis le Dashboard principal ou le menu de l'application.
Créez un nouveau rapport personnalisé : Lancez le processus de création d'un nouveau rapport. Sélectionnez un objet de base qui sert d'ancrage principal pour vos données, tel que l'objet Factures ou Comptes clients ouverts. Donnez un nom descriptif au rapport, par exemple, ProcessMind_Credit_Collections_Log.
Définissez les attributs principaux des factures : Ajoutez les champs principaux pour la facture à la mise en page de votre rapport. Cela inclut InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate et PaymentStatus. Ceux-ci formeront les colonnes de base pour chaque événement.
Ajoutez des données provenant d'objets liés (Événements) : C'est l'étape la plus critique. Vous devrez joindre ou unir des données de divers objets HighRadius pour capturer les 15 activités requises. Utilisez la fonctionnalité de création de rapports pour ajouter des sources de données liées. Pour chaque activité, vous créerez un ensemble de colonnes représentant les détails de l'événement.
Structurez le rapport au format de journal d'événements : Configurez le rapport pour produire une ligne par événement. Cela implique généralement l'union de différents blocs de données plutôt que leur jointure en colonnes. Pour chaque bloc uni, vous mapperez le champ de date pertinent à une colonne EventTime commune et coderez en dur le ActivityName correspondant.
Configurez l'événement « Date d'échéance de paiement dépassée » : Cet événement est conditionnel. Créez un bloc de données spécifique dans votre rapport pour les factures dont la DueDate est passée et dont le PaymentStatus est toujours « Ouvert » ou « En retard ». Pour ces enregistrements, définissez le ActivityName sur « Date d'échéance de paiement dépassée » et utilisez la DueDate elle-même comme EventTime.
Ajoutez les informations sur le recouvreur et les litiges : Assurez-vous d'inclure les données des modules de recouvrement et de litiges. Joignez aux objets comme CollectorNotes ou ActivityHistory pour obtenir le CollectorName. Joignez à l'objet Disputes pour récupérer le DisputeReason si applicable.
Définissez les filtres de rapport : Appliquez des filtres pour définir la portée de l'extraction. Définissez une plage de dates spécifique pour l'événement EventTime, telle que les 6 derniers mois, pour garder l'ensemble de données gérable. Vous devrez peut-être également filtrer par codes d'entreprise ou unités commerciales spécifiques en fonction de votre structure organisationnelle.
Exécutez et prévisualisez le rapport : Exécutez le rapport pour prévisualiser les données. Vérifiez que la structure correspond au format de journal d'événements requis, avec une ligne par activité et des colonnes pour InvoiceNumber, ActivityName, EventTime et d'autres attributs.
Exportez les données du rapport : Une fois satisfait de l'aperçu, exportez le rapport complet. Sélectionnez CSV comme format d'exportation, car il est facilement ingéré par les outils de Process Mining. Assurez-vous que les paramètres d'exportation utilisent l'encodage UTF-8 pour éviter les problèmes de caractères.
Examen final des données : Ouvrez le fichier CSV exporté dans une application de feuille de calcul. Effectuez une vérification finale pour vous assurer que les 15 activités sont présentes, que les horodatages sont correctement formatés et que les attributs clés sont renseignés comme prévu avant de les télécharger dans ProcessMind.

Configuration

Type de rapport : Un rapport personnalisé combinant des données de plusieurs modules. Il peut être appelé « Rapport joint » ou nécessiter plusieurs « Blocs » de données fusionnés, selon la version spécifique de HighRadius.
Objet de données principal : Commencez avec l'objet Factures ou Comptes clients comme base du rapport.
Objets de données secondaires : Vous devrez lier des objets supplémentaires tels que CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase et CashApplication.
Filtre de plage de dates : Appliquez un filtre sur le champ d'horodatage d'événement principal. Il est recommandé d'extraire les données pour une période de 3 à 6 mois afin d'équilibrer le détail et la performance. Par exemple, EventTime au cours des 180 derniers jours.
Filtres de statut : Envisagez de filtrer les statuts de facture non pertinents, tels que « Annulé » ou « Brouillon », sauf s'ils font partie du processus que vous souhaitez analyser.
Permissions : Le compte utilisateur exécutant le rapport doit disposer d'un accès en lecture à tous les modules pertinents, y compris Crédit, Recouvrement, Litiges et Application des paiements, pour garantir l'extraction d'un ensemble de données complet.

a Exemple de requête config

/*
 This is a configuration model for a HighRadius custom report. 
 It is not an executable SQL script but a blueprint for building the report in the UI.
 The report should be configured to UNION the following data blocks to create a single event log.
*/

// Report Name: ProcessMind_Credit_Collections_Log
// Report Output Format: CSV

// === BLOCK 1: Credit Limit Requested ===
{
  "ActivityName": "Credit Limit Requested",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Requested",
    "EventTime": "CreditRequests.RequestTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 2: Credit Limit Approved ===
{
  "ActivityName": "Credit Limit Approved",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Approved",
    "EventTime": "CreditRequests.ApprovalTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 3: Invoice Generated ===
{
  "ActivityName": "Invoice Generated",
  "Source Object": "Invoices",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Generated",
    "EventTime": "Invoices.CreationTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 4: Invoice Sent to Customer ===
{
  "ActivityName": "Invoice Sent to Customer",
  "Source Object": "CustomerCommunications",
  "Filter": "CustomerCommunications.Type = 'Invoice Delivery'",
  "Columns": {
    "InvoiceNumber": "CustomerCommunications.InvoiceNumber",
    "ActivityName": "Invoice Sent to Customer",
    "EventTime": "CustomerCommunications.SentTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 5: Payment Due Date Passed ===
{
  "ActivityName": "Payment Due Date Passed",
  "Source Object": "Invoices",
  "Filter": "Invoices.DueDate < CURRENT_DATE AND Invoices.PaymentStatus = 'Open'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Payment Due Date Passed",
    "EventTime": "Invoices.DueDate",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 6: Overdue Reminder Sent ===
{
  "ActivityName": "Overdue Reminder Sent",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Reminder'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Overdue Reminder Sent",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 7: Dunning Procedure Initiated ===
{
  "ActivityName": "Dunning Procedure Initiated",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Dunning Level 1'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Dunning Procedure Initiated",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 8: Collection Call Logged ===
{
  "ActivityName": "Collection Call Logged",
  "Source Object": "CollectorActivityLog",
  "Filter": "CollectorActivityLog.Type = 'Call'",
  "Columns": {
    "InvoiceNumber": "CollectorActivityLog.InvoiceNumber",
    "ActivityName": "Collection Call Logged",
    "EventTime": "CollectorActivityLog.ActivityTimestamp",
    "CollectorName": "CollectorActivityLog.CollectorName",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 9: Promise to Pay Created ===
{
  "ActivityName": "Promise to Pay Created",
  "Source Object": "PromiseToPay",
  "Columns": {
    "InvoiceNumber": "PromiseToPay.InvoiceNumber",
    "ActivityName": "Promise to Pay Created",
    "EventTime": "PromiseToPay.CreationTimestamp",
    "CollectorName": "PromiseToPay.CreatedByCollector",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 10: Dispute Registered ===
{
  "ActivityName": "Dispute Registered",
  "Source Object": "DisputeCase",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Registered",
    "EventTime": "DisputeCase.CreationTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "Disputed",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 11: Dispute Resolved ===
{
  "ActivityName": "Dispute Resolved",
  "Source Object": "DisputeCase",
  "Filter": "DisputeCase.Status = 'Closed' OR DisputeCase.Status = 'Resolved'",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Resolved",
    "EventTime": "DisputeCase.ResolutionTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 12: Payment Received ===
{
  "ActivityName": "Payment Received",
  "Source Object": "CashApplication.Payments",
  "Columns": {
    "InvoiceNumber": null, // Often matched later
    "ActivityName": "Payment Received",
    "EventTime": "CashApplication.Payments.PaymentDate",
    "CollectorName": null,
    "CustomerId": "CashApplication.Payments.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 13: Payment Posted ===
{
  "ActivityName": "Payment Posted",
  "Source Object": "CashApplication.AppliedPayments",
  "Columns": {
    "InvoiceNumber": "CashApplication.AppliedPayments.InvoiceNumber",
    "ActivityName": "Payment Posted",
    "EventTime": "CashApplication.AppliedPayments.ApplicationTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 14: Invoice Settled ===
{
  "ActivityName": "Invoice Settled",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Paid'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Settled",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Paid",
    "DisputeReason": null
  }
}

// === BLOCK 15: Invoice Written Off ===
{
  "ActivityName": "Invoice Written Off",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Write-Off'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Written Off",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Written Off",
    "DisputeReason": null
  }
}

Étapes

Prérequis : Assurez-vous d'avoir Python 3.6+ installé ainsi que les bibliothèques pandas et requests. Vous pouvez les installer à l'aide de pip : pip install pandas requests. Vous devez également obtenir des identifiants API (ID client et Secret client) auprès de votre administrateur HighRadius avec un accès en lecture aux objets de données nécessaires tels que les factures, les recouvrements, les litiges et les paiements.
Initialisation du script : Créez un nouveau fichier de script Python, par exemple, extract_hr_data.py. Commencez par importer les bibliothèques nécessaires (requests, pandas, datetime) et définissez des constantes de substitution pour l'URL de base de votre API HighRadius, les identifiants client et la plage de dates souhaitée pour l'extraction.
Implémentez l'authentification : Rédigez une fonction pour gérer l'authentification. Cette fonction prendra votre ID client et votre Secret, effectuera une requête POST vers le point de terminaison d'authentification HighRadius (par exemple, /auth/v1/token) et récupérera un jeton bearer. Ce jeton sera utilisé dans l'en-tête de toutes les requêtes de données ultérieures.
Récupérez les données de facture principales : Développez une fonction pour interroger le point de terminaison principal des factures (par exemple, /invoices/v1/search). Cette fonction doit gérer la pagination pour garantir que tous les enregistrements dans la plage de dates spécifiée sont récupérés. Elle doit appeler l'API de manière itérative, collectant les données de facture jusqu'à ce qu'il n'y ait plus de pages disponibles. Stockez ces données de facture principales dans une liste de dictionnaires.
Récupérez les données d'objets liés : Pour chaque entité de données principale comme les litiges, les notes de recouvrement et les paiements, créez des fonctions distinctes de récupération de données. Ces fonctions interrogeront leurs points de terminaison respectifs (par exemple, /disputes/v1/search, /collections/v1/notes, /cashapp/v1/payments) et devront être conçues pour récupérer efficacement toutes les données pertinentes pour la période spécifiée. Il est souvent préférable de récupérer ces ensembles de données en vrac plutôt que d'interroger une facture à la fois.
Structurez le journal d'événements : Initialisez une liste vide qui contiendra toutes les lignes de votre journal d'événements. Le script itérera sur les données récupérées et transformera chaque action ou changement de statut pertinent en un dictionnaire standardisé représentant une seule ligne d'événement. Chaque dictionnaire doit contenir les clés pour InvoiceNumber, ActivityName, EventTime et tous les autres attributs requis.
Générez les événements du cycle de vie des factures : Itérez sur votre liste principale de factures. Pour chaque facture, créez des événements pour « Facture générée », « Facture envoyée au client », « Facture réglée » et « Facture passée en perte » en fonction de sa date de création, des journaux de correspondance, de la date de clôture et des champs de statut. Stockez-les sous forme de dictionnaires d'événements.
Calculez l'événement « Date d'échéance de paiement dépassée » : Dans la même boucle de facture, ajoutez une logique pour créer un événement « Date d'échéance de paiement dépassée ». Il s'agit d'un événement calculé. La logique doit vérifier si la date d'échéance de la facture est passée, si la facture n'est pas encore payée et si un événement « Date d'échéance de paiement dépassée » n'a pas déjà été généré pour celle-ci. L'EventTime pour cette activité doit être la date d'échéance elle-même.
Générez les événements de recouvrement et de litige : Traitez les données récupérées des points de terminaison de recouvrement et de litige. Pour chaque note, promesse de paiement, action de relance ou enregistrement de litige, créez des lignes de journal d'événements correspondantes (« Rappel de retard envoyé », « Appel de recouvrement enregistré », « Promesse de paiement créée », « Litige enregistré », « Litige résolu »). Mappez les détails pertinents comme CollectorName et DisputeReason à l'enregistrement de l'événement.
Générez les événements de paiement : Traitez les données de paiement du module d'application des espèces. Créez des événements « Paiement reçu » basés sur la date de création du paiement ou de l'extrait bancaire, et des événements « Paiement comptabilisé » basés sur la date à laquelle le paiement a été appliqué avec succès à la facture.
Consolidez et formatez les données : Après avoir traité toutes les sources de données et généré les événements, convertissez la liste des dictionnaires d'événements en un DataFrame pandas. Cela permet un tri facile et des conversions finales de types de données. Assurez-vous que la colonne EventTime est dans un format d'horodatage cohérent (AAAA-MM-JJ HH:MI:SS).
Exportez au format CSV : Utilisez la fonction to_csv de pandas pour exporter le DataFrame final vers un fichier CSV. Nommez le fichier clairement, par exemple, highradius_event_log.csv. Définissez le paramètre index=False pour éviter d'écrire l'index du DataFrame comme colonne. Ce fichier est maintenant prêt à être téléchargé sur ProcessMind.

Configuration

Identifiants API : Un utilisateur API dédié avec un ID Client et un Secret Client est requis. L'utilisateur doit disposer de permissions de lecture pour tous les points de terminaison API pertinents, y compris les factures, les clients, les activités de recouvrement, les litiges et l'application des paiements.
Plage de dates : Le script Python inclut les variables START_DATE et END_DATE. Il est crucial de définir une plage de dates spécifique et raisonnable, telle que 3 à 6 mois, pour limiter le volume de données et éviter des temps d'exécution de script excessivement longs. Filtrez en fonction d'un champ de date indexé comme la date de création ou de modification de la facture.
URL des points de terminaison : Les chemins spécifiques des points de terminaison API (par exemple, /invoices/v1/search) sont des espaces réservés. Vous devez confirmer les URL de points de terminaison correctes à partir de la documentation API HighRadius de votre organisation.
Paramètres de pagination : Le script doit gérer correctement le mécanisme de pagination de l'API. Cela implique généralement l'utilisation de paramètres limit et offset ou une approche basée sur un curseur. Une taille de page de 100 à 500 est généralement un bon point de départ.
Environnement : Le script doit être exécuté dans un environnement stable avec suffisamment de mémoire pour gérer les dataframes, en particulier pour les extractions importantes. Il est préférable de l'exécuter sur un serveur plutôt que sur une machine locale pour les extractions à l'échelle de la production.
Champs personnalisés : Si votre processus repose sur des champs personnalisés dans HighRadius, le script devra être modifié pour interroger et inclure ces champs dans la sortie.

a Exemple de requête python

import requests
import pandas as pd
from datetime import datetime, time

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
HIGH RADIUS_BASE_URL = class="hl-string">"https://[your-highradius-instance].highradius.com/api"
CLIENT_ID = class="hl-string">"[Your_Client_ID]"
CLIENT_SECRET = class="hl-string">"[Your_Client_Secret]"
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-06-30"

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def get_auth_token():
    class="hl-string">"""Authenticates with HighRadius and returns a bearer token."""
    auth_url = fclass="hl-string">"{HIGH RADIUS_BASE_URL}/auth/v1/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    response = requests.post(auth_url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

def fetch_paginated_data(endpoint, params, headers):
    class="hl-string">"""Fetches all pages of data from a given HighRadius endpoint."""
    all_data = []
    page = 0
    limit = 200 class=class="hl-string">"hl-comment"># Records per page
    while True:
        params[class="hl-string">'offset'] = page * limit
        params[class="hl-string">'limit'] = limit
        response = requests.get(fclass="hl-string">"{HIGH RADIUS_BASE_URL}{endpoint}", headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        records = data.get(class="hl-string">'data', []) class=class="hl-string">"hl-comment"># Adjust based on actual API response structure
        if not records:
            break
        all_data.extend(records)
        page += 1
    return all_data

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    class="hl-string">"""Main function to extract, transform, and save the event log."""
    print(class="hl-string">"Starting HighRadius data extraction...")
    auth_token = get_auth_token()
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {auth_token}'}
    events = []

    class=class="hl-string">"hl-comment"># 1. Fetch all relevant invoices in the date range
    print(class="hl-string">"Fetching invoice data...")
    invoice_params = {class="hl-string">'creationDate_gte': START_DATE, class="hl-string">'creationDate_lte': END_DATE}
    invoices = fetch_paginated_data(class="hl-string">"/invoices/v1/search", invoice_params, headers)

    class=class="hl-string">"hl-comment"># Fetch related data in bulk to reduce API calls
    invoice_ids = [inv[class="hl-string">'invoiceNumber'] for inv in invoices]
    print(fclass="hl-string">"Fetching related data for {len(invoice_ids)} invoices...")

    notes = fetch_paginated_data(class="hl-string">"/collections/v1/notes", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    disputes = fetch_paginated_data(class="hl-string">"/disputes/v1/search", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    payments = fetch_paginated_data(class="hl-string">"/cashapp/v1/applications", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    credit_requests = fetch_paginated_data(class="hl-string">"/credit/v1/requests", {class="hl-string">'requestDate_gte': START_DATE, class="hl-string">'requestDate_lte': END_DATE}, headers)

    class=class="hl-string">"hl-comment"># Create dictionaries for quick lookups
    notes_by_invoice = {k: [n for n in notes if n[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    disputes_by_invoice = {k: [d for d in disputes if d[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    payments_by_invoice = {k: [p for p in payments if p[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    
    class=class="hl-string">"hl-comment"># Process each invoice to create events
    print(class="hl-string">"Transforming data into event log...")
    for invoice in invoices:
        common_attrs = {
            class="hl-string">'InvoiceNumber': invoice.get(class="hl-string">'invoiceNumber'),
            class="hl-string">'CustomerId': invoice.get(class="hl-string">'customer', {}).get(class="hl-string">'id'),
            class="hl-string">'InvoiceAmount': invoice.get(class="hl-string">'invoiceAmount'),
            class="hl-string">'PaymentTerms': invoice.get(class="hl-string">'paymentTerms'),
            class="hl-string">'DueDate': invoice.get(class="hl-string">'dueDate'),
            class="hl-string">'PaymentStatus': invoice.get(class="hl-string">'paymentStatus'),
            class="hl-string">'CollectorName': invoice.get(class="hl-string">'collector', {}).get(class="hl-string">'name'),
            class="hl-string">'DisputeReason': None
        }

        class=class="hl-string">"hl-comment"># Invoice Generated
        events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Generated', class="hl-string">'EventTime': invoice.get(class="hl-string">'creationDate')})
        
        class=class="hl-string">"hl-comment"># Invoice Sent to Customer (example from correspondence log)
        if invoice.get(class="hl-string">'sentDate'):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Sent to Customer', class="hl-string">'EventTime': invoice.get(class="hl-string">'sentDate')})

        class=class="hl-string">"hl-comment"># Payment Due Date Passed (calculated)
        due_date_obj = datetime.strptime(invoice.get(class="hl-string">'dueDate'), class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ').date()
        if due_date_obj < datetime.today().date() and invoice.get(class="hl-string">'paymentStatus') not in [class="hl-string">'PAID', class="hl-string">'CLOSED']:
            event_time_at_due_date = datetime.combine(due_date_obj, time(23, 59, 59)).isoformat()
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Due Date Passed', class="hl-string">'EventTime': event_time_at_due_date})

        class=class="hl-string">"hl-comment"># Invoice Settled / Written Off
        if invoice.get(class="hl-string">'closeDate'):
            if invoice.get(class="hl-string">'paymentStatus') == class="hl-string">'PAID':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Settled', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})
            elif invoice.get(class="hl-string">'statusReason') == class="hl-string">'WRITTEN_OFF':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Written Off', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})

        class=class="hl-string">"hl-comment"># Process related notes for this invoice
        for note in notes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            activity_map = {
                class="hl-string">'REMINDER_SENT': class="hl-string">'Overdue Reminder Sent',
                class="hl-string">'DUNNING_STARTED': class="hl-string">'Dunning Procedure Initiated',
                class="hl-string">'COLLECTION_CALL': class="hl-string">'Collection Call Logged',
                class="hl-string">'PROMISE_TO_PAY': class="hl-string">'Promise to Pay Created'
            }
            activity_name = activity_map.get(note.get(class="hl-string">'noteType'))
            if activity_name:
                events.append({**common_attrs, class="hl-string">'ActivityName': activity_name, class="hl-string">'EventTime': note.get(class="hl-string">'creationDate'), class="hl-string">'CollectorName': note.get(class="hl-string">'createdBy')})

        class=class="hl-string">"hl-comment"># Process related disputes for this invoice
        for dispute in disputes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Registered', class="hl-string">'EventTime': dispute.get(class="hl-string">'creationDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
            if dispute.get(class="hl-string">'resolutionDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Resolved', class="hl-string">'EventTime': dispute.get(class="hl-string">'resolutionDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
        
        class=class="hl-string">"hl-comment"># Process related payments for this invoice
        for payment in payments_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            if payment.get(class="hl-string">'paymentReceivedDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Received', class="hl-string">'EventTime': payment.get(class="hl-string">'paymentReceivedDate')})
            if payment.get(class="hl-string">'applicationDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Posted', class="hl-string">'EventTime': payment.get(class="hl-string">'applicationDate')})

    class=class="hl-string">"hl-comment"># Process credit requests (linked by customer ID)
    for request in credit_requests:
        class=class="hl-string">"hl-comment"># Note: Linking to a specific invoice is often not possible. Here we create a case-level event.
        class=class="hl-string">"hl-comment"># A more advanced logic could try to link based on customer and time proximity to an invoice.
        credit_attrs = {**common_attrs, class="hl-string">'InvoiceNumber': fclass="hl-string">"CREDIT-{request.get('customerId')}", class="hl-string">'CustomerId': request.get(class="hl-string">'customerId')}
        events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Requested', class="hl-string">'EventTime': request.get(class="hl-string">'requestDate')})
        if request.get(class="hl-string">'status') == class="hl-string">'APPROVED' and request.get(class="hl-string">'approvalDate'):
            events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Approved', class="hl-string">'EventTime': request.get(class="hl-string">'approvalDate')})

    class=class="hl-string">"hl-comment"># Finalize DataFrame
    if not events:
        print(class="hl-string">"No events found for the specified criteria.")
        return

    df = pd.DataFrame(events)
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'], errors=class="hl-string">'coerce')
    df.dropna(subset=[class="hl-string">'InvoiceNumber', class="hl-string">'ActivityName', class="hl-string">'EventTime'], inplace=True)
    df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'highradius_event_log.csv'
    df.to_csv(output_file, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_file}")

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

Votre modèle de données pour la gestion du crédit et recouvrement

Votre modèle de données pour la gestion du crédit et recouvrement

Attributs de gestion du crédit et de recouvrement

Activités de gestion du crédit et de recouvrement

Guides d'extraction

Exportation du module de rapports et d'analyse HighRadius

Étapes

Configuration

a Exemple de requête config

Extraction par script Python via les API REST HighRadius

Étapes

Configuration

a Exemple de requête python

Prêt(e) à démarrer ?

Commencez à optimiser votre gestion du crédit et recouvrement

Votre modèle de données pour la gestion du crédit et recouvrement

Votre modèle de données pour la gestion du crédit et recouvrement

Attributs de gestion du crédit et de recouvrement

Activités de gestion du crédit et de recouvrement

Guides d'extraction

Exportation du module de rapports et d'analyse HighRadius

Étapes

Configuration

a Exemple de requête config

Extraction par script Python via les API REST HighRadius

Étapes

Configuration

a Exemple de requête python

Nous respectons votre vie privée

Prêt(e) à démarrer ?

Commencez à optimiser votre gestion du crédit et recouvrement