> 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 le recouvrement

HighRadius

Attributs de gestion du crédit et de recouvrement (21) 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 le recouvrement

Ce modèle vous guide dans la collecte des données nécessaires à l’analyse de votre processus de gestion du crédit et de recouvrement. Il présente les attributs essentiels à recueillir, les activités clés à suivre et des conseils pratiques pour extraire ces informations de votre système HighRadius. Vous pourrez ainsi préparer efficacement vos données pour le Process Mining.

Attributs recommandés à recueillir
Activités clés à suivre pour comprendre le processus
Conseils d’extraction propres à HighRadius

Vous découvrez les journaux d’événements ? Découvrez comment créer un journal d’événements pour le 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 analyser en détail votre processus de gestion du crédit et de recouvrement.

3 Obligatoire 7 Recommandé 11 Facultatif

	Nom	Description
	Heure de l’événement EventTime	Horodatage indiquant la date et l’heure auxquelles l’activité a eu lieu.
Description L’heure de l’événement indique la date et l’heure précises de chaque activité du processus. Ces données chronologiques sont au cœur du Process Mining : elles permettent de remettre les événements dans le bon ordre et de calculer les durées qui les séparent. Cet attribut sert à calculer tous les KPI temporels, notamment les temps de cycle de résolution des litiges, d’approbation du crédit et d’enregistrement des paiements. Il permet également d’analyser les performances du processus au fil du temps, de repérer les activités à l’origine de retards et de mesurer le respect des accords de niveau de service. Pourquoi est-ce important ? Il situe toutes les activités dans le temps, ce qui est essentiel pour calculer les temps de cycle, repérer les goulots d’étranglement et comprendre le fonctionnement du processus. Où trouver ces données Chaque enregistrement de transaction ou journal d’événements dans HighRadius devrait comporter un champ d’horodatage, 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	Nom de l’événement métier précis survenu à un moment donné pour une facture.
Description Le nom de l’activité décrit une étape du processus de gestion du crédit et de recouvrement, comme « Facture générée », « Rappel de retard envoyé » ou « Paiement reçu ». La succession de ces activités constitue le flux du processus pour chaque cas. L’analyse de cet attribut permet de découvrir et de visualiser la carte réelle du processus. Elle aide à repérer les goulots d’étranglement, les écarts par rapport à la procédure habituelle et les boucles de reprise. La fréquence et l’ordre d’activités comme « Appel de recouvrement consigné » ou « Litige enregistré » sont essentiels pour comprendre l’efficacité du processus. Pourquoi est-ce important ? Cet attribut définit les étapes du processus et permet de reconstituer et d’analyser le flux de chaque facture. Où trouver ces données Il est généralement dérivé des journaux d’événements, des changements de statut ou des enregistrements d’actions spécifiques dans les différents modules de HighRadius. Exemples Facture envoyée au clientProcédure de relance lancéePaiement reçuLitige résolu
	Numéro de facture InvoiceNumber	Identifiant unique de chaque facture, utilisé comme identifiant de cas principal pour le processus crédit-encaissement.
Description Le numéro de facture est la clé centrale qui relie toutes les activités associées à une même transaction de créance. Il permet de suivre l’ensemble du cycle de vie, de la génération de la facture aux activités de gestion du crédit et de recouvrement, jusqu’au règlement final ou au passage en pertes. Dans une analyse par Process Mining, cet attribut est essentiel pour regrouper tous les événements associés dans un même cas. Vous pouvez ainsi visualiser les flux de processus de bout en bout, calculer la durée des cas, comme le délai moyen de paiement client (DSO), et analyser les différents parcours possibles d’une facture, notamment la résolution d’un litige ou les procédures de relance. Pourquoi est-ce important ? Cet identifiant fondamental relie toutes les étapes du processus et permet d’analyser le parcours complet d’une facture, de sa création à sa clôture. Où trouver ces données Il s’agit d’un champ principal dans HighRadius, généralement présent dans les objets de données centraux des factures ou des créances. Exemples INV-2023-001239876543210SI-55482
	Conditions de paiement PaymentTerms	Conditions convenues qui déterminent la date à laquelle le client doit régler une facture.
Description Les conditions de paiement précisent les modalités de règlement, par exemple « Net à 30 jours », « Net à 60 jours » ou « À réception ». Cet attribut sert de base au calcul de la date d’échéance de la facture. Il est essentiel au Dashboard et au KPI « Respect des conditions de paiement ». Son analyse permet de vérifier si les conditions standard sont appliquées de manière cohérente et de repérer celles qui sont associées à davantage de retards de paiement. Ces résultats peuvent éclairer la politique de crédit et les négociations avec les clients. Pourquoi est-ce important ? Il définit le délai de paiement attendu, indispensable au calcul des échéances et à la mesure du respect des accords de paiement par les clients. Où trouver ces données Ces informations figurent généralement dans l’en-tête de facture ou les données de référence du client dans HighRadius ou dans l’ERP source. Exemples Net à 30 joursNet à 60 joursÀ réception
	Date d’échéance DueDate	Date calculée à laquelle le paiement de la facture doit être effectué.
Description La date d’échéance est la date limite à laquelle une facture doit être réglée pour ne pas être considérée comme échue. Elle est généralement calculée à partir de la date de facture et des conditions de paiement. Cet attribut est indispensable à toute analyse des retards de paiement. Il sert principalement à calculer le nombre de jours de retard, à déclencher les procédures de relance et à mesurer le KPI « Taux de respect des conditions de paiement ». Il alimente directement les Dashboards consacrés à l’ancienneté des factures et à l’efficacité des relances. Pourquoi est-ce important ? Cette date détermine si une facture est réglée à temps ou en retard. Elle déclenche les activités de recouvrement et le calcul des KPI qui en découlent. Où trouver ces données Il s’agit d’un champ standard de l’enregistrement de facture dans HighRadius. Il peut être renseigné par l’ERP source ou calculé dans HighRadius. Exemples 2023-04-142023-05-312023-06-20
	Identifiant client CustomerId	Identifiant unique du client associé à la facture.
Description L’identifiant client relie une facture au client concerné. Il permet de regrouper et d’analyser les données du processus du point de vue du client. Cet attribut est essentiel pour analyser les comportements de paiement des différents clients ou segments de clientèle. Il aide à répondre à des questions telles que : quels clients paient souvent en retard ? Quels clients contestent le plus de factures ? Il alimente des Dashboards comme « Respect des conditions de paiement » et permet de ventiler les KPI par client. Pourquoi est-ce important ? Il permet d’analyser, au niveau du client, les comportements de paiement, la fréquence des litiges et les interactions avec le processus, afin d’adapter les stratégies de recouvrement. Où trouver ces données Il s’agit d’un champ standard de l’en-tête de facture ou des données du compte client dans HighRadius. Exemples CUST-001ACME-CORPGLOBEX-US
	Montant de la facture InvoiceAmount	Montant total de la facture.
Description Cet attribut correspond au montant total dû au titre de la facture. Il s’agit d’une métrique financière importante pour évaluer la valeur associée à chaque dossier. En Process Mining, le montant de la facture sert à établir les priorités de recouvrement, par exemple en ciblant les factures échues de montant élevé. Il entre dans le calcul d’indicateurs financiers comme le délai moyen de paiement client (DSO) et permet de mesurer l’incidence financière des créances irrécouvrables dans le Dashboard « Analyse des abandons de créances ». Pourquoi est-ce important ? Il apporte un contexte financier à chaque dossier et permet d’analyser les montants, de hiérarchiser le travail et de mesurer les conséquences financières des abandons de créances. Où trouver ces données Il s’agit d’un champ standard des données d’en-tête de facture dans HighRadius. Exemples 5000.001250.7525000.50
	Motif du litige DisputeReason	Code ou description du motif fourni par le client lorsqu’il conteste une facture.
Description Lorsqu’un client conteste une facture, il en indique généralement le motif, par exemple « Prix incorrect », « Marchandise endommagée » ou « Facture en double ». Cet attribut enregistre ce motif. L’analyse des motifs de litige est essentielle au Dashboard « Délai de résolution des litiges liés aux factures ». Elle permet d’identifier les causes profondes des litiges et de corriger les problèmes récurrents liés aux prix, à l’expédition ou à la facturation. Réduire les litiges à la source peut accélérer sensiblement les encaissements. Pourquoi est-ce important ? Il met en évidence les causes des retards de paiement et permet de cibler les améliorations du processus pour éviter de nouveaux litiges. Où trouver ces données Ces informations sont enregistrées dans le module de gestion des litiges ou des déductions de HighRadius lorsqu’un litige est déclaré. Exemples Quantité incorrecteÉcart de prixMarchandise endommagéeFacturation en double
	Nom du chargé de recouvrement CollectorName	Nom de l’utilisateur ou de l’agent chargé d’effectuer une activité de recouvrement.
Description Cet attribut identifie le chargé de recouvrement, l’analyste crédit ou tout autre utilisateur ayant effectué une activité manuelle, comme « Appel de recouvrement enregistré » ou « Litige résolu ». L’analyse permet de comparer les résultats des différents chargés de recouvrement ou des équipes. Elle 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 chargé de recouvrement, et à repérer les besoins d’accompagnement. Elle est également utile pour gérer les ressources et planifier les capacités. Pourquoi est-ce important ? Il relie les activités du processus à des personnes précises, ce qui permet d’analyser les résultats des équipes, leur charge de travail et l’efficacité des interventions manuelles. Où trouver ces données Ces informations figurent généralement dans les journaux d’activité ou les enregistrements des actions des utilisateurs du module Collections de HighRadius. Exemples Jean MartinJeanne DupontÉmilie Jones
	Statut du paiement PaymentStatus	Situation financière actuelle de la facture : ouverte, payée, échue ou contestée, par exemple.
Description Le statut du paiement indique où en est la facture dans son cycle de vie. Il précise si le paiement est attendu, si la facture a été réglée en totalité ou en partie, si son échéance est dépassée ou si elle fait l’objet d’un litige. Cet attribut est au cœur du Dashboard « Statut et ancienneté des paiements de factures ». Il permet de segmenter rapidement les créances pour évaluer la situation financière globale et donner la priorité aux factures échues ou contestées. Pourquoi est-ce important ? Il répartit les factures en catégories et donne une vue immédiate de l’état des créances, ce qui aide à hiérarchiser les activités de recouvrement. Où trouver ces données Il s’agit d’un champ de statut essentiel de la facture ou de l’enregistrement des créances dans HighRadius. Exemples OuvertePayéeÉchueContestéePassée en perte
	Automatisée IsAutomated	Indicateur booléen précisant si une activité a été effectué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, comme « Rappel de retard envoyé » lors d’une campagne de relance automatisée, des actions effectuées par une personne, comme « Appel de recouvrement enregistré ». Cet indicateur est essentiel au calcul du KPI « Taux d’activités de recouvrement automatisées ». Il permet de mesurer le degré d’automatisation du processus de recouvrement, de repérer les possibilités d’automatisation supplémentaires et de comparer l’efficacité des interventions automatisées et manuelles. Pourquoi est-ce important ? Il permet de mesurer le degré d’automatisation du processus et d’analyser l’efficacité des systèmes automatisés par rapport aux interventions manuelles. Où trouver ces données Cet attribut est dérivé lors de la transformation des données. Il faut définir une association qui signale les noms d’activité automatisés en fonction des connaissances métier. Exemples truefalse
	Date de promesse de paiement PromiseToPayDate	Date à laquelle le client s’est engagé à régler une facture échue.
Description Lorsqu’un chargé de recouvrement contacte un client, celui-ci peut s’engager à régler sa facture à une date précise. Cet attribut enregistre la date promise. L’analyse de ces données permet d’évaluer la fiabilité des engagements des clients et la capacité des chargés de recouvrement à obtenir des promesses fermes. Elle peut servir à suivre le taux de promesses tenues, un indicateur clé des résultats d’une équipe de recouvrement. Pourquoi est-ce important ? Il enregistre un résultat important des activités de recouvrement et permet de mesurer l’efficacité des relances ainsi que la fiabilité des engagements des clients. Où trouver ces données Cette date est enregistrée lorsqu’une activité « Promesse de paiement » est consignée dans le module Collections de HighRadius. Exemples 2023-06-152023-07-012023-06-25
	Dernière mise à jour des données LastDataUpdate	Horodatage de la dernière actualisation des données de cet enregistrement depuis le système source.
Description Cet attribut indique la date de mise à jour 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 permet de savoir si les résultats sont récents. Il est essentiel que les Dashboards et les rapports indiquent la date des informations présentées, afin que les décisions reposent sur des données à jour. Pourquoi est-ce important ? Il indique si les données sont à jour, un élément essentiel pour instaurer la confiance dans l’analyse et prendre des décisions éclairées. Où trouver ces données Cet horodatage est généré et ajouté à chaque enregistrement par le pipeline d’ingestion des données pendant leur extraction. Exemples 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Devise Currency	Code de devise du montant de la facture.
Description Cet attribut indique la devise de la facture, par exemple USD, EUR ou JPY. Il apporte un contexte essentiel aux montants, comme celui de la facture. Dans une entreprise internationale, ce champ est indispensable à l’exactitude de l’analyse financière. Il garantit que les montants sont interprétés correctement et permet de convertir les devises avant de regrouper les données pour les rapports internationaux. Pourquoi est-ce important ? Il est indispensable pour interpréter correctement les montants et éviter les erreurs de calcul et de reporting dans un environnement multidevise. Où trouver ces données Il s’agit d’un champ standard de l’enregistrement de facture, généralement situé à côté du montant de la facture. Exemples USDEURGBP
	Heure de fin EndTime	Horodatage indiquant le moment où une activité a été terminée.
Description L’heure de fin marque la conclusion d’une activité. Dans le processus de recouvrement, de nombreuses activités sont instantanées : l’heure de début et l’heure de fin sont alors identiques. D’autres, comme « Résolution d’un litige », peuvent avoir une durée distincte. Lorsque cet attribut est disponible, il est associé à l’heure de début pour calculer la durée de traitement de chaque activité. Vous pouvez ainsi repérer les étapes qui prennent le plus de temps et mobilisent le plus de ressources, et pas seulement les intervalles entre elles. Pourquoi est-ce important ? Il permet de mesurer précisément la durée de chaque activité et de mieux voir à quelles étapes du processus le temps est consacré. Où trouver ces données Consultez la documentation HighRadius. Cette information peut être disponible pour certaines activités enregistrées qui comportent un état de début et un état de fin. Exemples 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Motif de l’abandon de créance WriteOffReason	Code ou explication du motif pour lequel une facture a été passée en perte comme créance irrécouvrable.
Description Lorsqu’une facture est jugée irrécouvrable, elle est passée en perte. Cet attribut enregistre le motif, par exemple « Faillite du client », « Litige non résolu » ou « Abandon d’une créance de faible montant ». Cet attribut est essentiel au Dashboard « Analyse des abandons de créances ». Il aide à rechercher les causes des pertes financières et fournit des éléments pour ajuster la politique de crédit, améliorer le traitement des litiges ou adapter les stratégies de recouvrement afin de limiter les pertes à venir. Pourquoi est-ce important ? Il explique les causes des pertes de revenus et fournit des éléments utiles pour améliorer l’évaluation du risque de crédit et les politiques de recouvrement. Où trouver ces données Cette information est enregistrée lors du traitement d’une activité « Facture passée en perte », généralement dans le module financier ou de recouvrement de HighRadius. Exemples FaillitePrescription expiréeCoût du recouvrement supérieur à la créance
	Niveau de relance DunningLevel	Étape ou niveau atteint dans le processus automatisé de relance d’une facture échue.
Description Le niveau de relance indique l’intensité des démarches de recouvrement. Il correspond souvent à une série de rappels ou d’avis automatiques envoyés au client. Par exemple, le niveau 1 peut être un simple rappel, tandis que le niveau 3 correspond à un dernier avis. Cet attribut est essentiel au Dashboard « Efficacité de la stratégie de relance ». En analysant les niveaux de relance qui aboutissent le plus souvent à un paiement, les entreprises peuvent ajuster leurs flux de travail de relance pour obtenir des résultats sans insister excessivement au risque de détériorer la relation client. Pourquoi est-ce important ? Il suit la progression des démarches de recouvrement et permet d’analyser les stratégies de relance qui incitent le plus efficacement les clients à payer. Où trouver ces données Il s’agit d’un champ de statut géré par le moteur automatisé de recouvrement ou de relance de HighRadius. Exemples 123 - Dernier avisRecouvrement judiciaire
	Nombre de jours de retard DaysOverdue	Nombre de jours écoulés depuis la date d’échéance de la facture. Cette valeur est égale à zéro si la facture n’est pas encore échue ou a été réglée à temps.
Description Le nombre de jours de retard est une métrique calculée qui mesure l’écart entre la date du jour, pour les factures ouvertes, ou la date de paiement, pour les factures réglées, et la date d’échéance de la facture. C’est un indicateur clé des retards de paiement. Cet attribut est à la base du Dashboard « Statut et ancienneté des paiements de factures », où il sert à répartir les créances par ancienneté, par exemple entre 1 et 30 jours ou entre 31 et 60 jours. Il entre également dans le calcul du délai moyen de paiement client (DSO) et aide à donner la priorité aux comptes les plus en retard. Pourquoi est-ce important ? Cette métrique quantifie directement les retards de paiement. Elle est essentielle à l’analyse de l’ancienneté, à la hiérarchisation des recouvrements et au calcul du DSO. Où trouver ces données Il ne s’agit pas d’un champ stocké. La valeur est calculée pendant la transformation des données à partir de la date d’échéance et de la date de paiement ou de la date du jour. Exemples 1545092
	Pays Country	Pays du client associé à la facture.
Description Cet attribut indique le pays où se trouve le client. Il permet de segmenter géographiquement le processus de crédit et de 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 motifs de litige les plus fréquents. Ces informations sont essentielles pour adapter les politiques aux différentes régions et produire des rapports de gestion à l’échelle d’une organisation internationale. Pourquoi est-ce important ? Il permet une analyse géographique qui peut révéler des tendances régionales en matière de paiement et aider à adapter les stratégies de recouvrement. Où trouver ces données Cette information fait partie des données de référence du client. Elle est généralement disponible dans HighRadius ou synchronisée depuis un ERP source. Exemples USAAllemagneBrésil
	Système source SourceSystem	Système d’origine des données.
Description Cet attribut indique le système source dans lequel les données de l’événement ont été générées. Pour cette vue du processus, sa valeur sera généralement « HighRadius ». Dans un environnement comprenant plusieurs systèmes, ce champ est essentiel pour comprendre la provenance des données et remonter à leur origine. Il permet de distinguer les processus qui couvrent plusieurs plateformes, par exemple un ERP et un outil spécialisé dans le recouvrement. Pourquoi est-ce important ? Il précise l’origine des données, ce qui est important pour leur gouvernance et leur validation, ainsi que pour comprendre l’environnement technologique du processus. Où trouver ces données Il s’agit généralement d’une valeur statique ajoutée lors de l’extraction et de la transformation des données pour identifier le jeu de données. Exemples HighRadiusHighRadius-CollectionsHighRadius-CashApp
	Unité opérationnelle BusinessUnit	Unité ou division interne responsable de la vente ou de la facture.
Description L’attribut Unité opérationnelle rattache la facture à une partie précise de l’organisation, comme « Vente au détail », « Vente en gros » ou « Services ». Il permet d’analyser les résultats par segment d’activité. La direction peut comparer des KPI comme le DSO, le taux de litiges et les abandons de créances entre les unités opérationnelles afin de repérer les points forts et les domaines à améliorer. Les différentes entités de l’organisation peuvent ainsi être tenues responsables des résultats obtenus en matière de créances. Pourquoi est-ce important ? Il permet de comparer les résultats des différentes entités de l’organisation et de repérer celles dont le processus de crédit à l’encaissement est le plus efficace. Où trouver ces données Il s’agit de données organisationnelles, généralement présentes sur la facture ou déduites de la commande client ou du compte client associé dans HighRadius ou dans l’ERP. Exemples BU-North AmericaDivision des servicesFabrication

Obligatoire Recommandé Facultatif

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

Voici les principales étapes et les jalons à enregistrer dans votre journal d’événements pour découvrir et analyser précisément votre processus de gestion du crédit et de recouvrement.

7 Recommandé 8 Facultatif

	Activité	Description
	Échéance de paiement dépassée	Cet événement calculé survient lorsque la date du jour dépasse l’échéance de paiement de la facture. Il ne correspond pas à une action de l’utilisateur ou du système, mais à un changement d’état important qui déclenche le processus de recouvrement.
Pourquoi est-ce important ? Cette activité déclenche principalement les étapes suivantes de relance et de recouvrement. Elle distingue les factures payées à temps des factures en retard et permet d’évaluer l’efficacité de la stratégie de recouvrement. Où trouver ces données Cet événement n’est pas enregistré directement. Il est calculé en comparant la date d’échéance de la facture à l’horodatage d’autres événements, lors de la transformation des données pour le Process Mining. Données à recueillir Calculé en comparant due_date de la facture à la date du jour 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. La facture est créée dans le système ERP, puis importée dans HighRadius pour la gestion des créances.
Pourquoi est-ce important ? Cette activité constitue l’événement de début de référence pour l’analyse du processus facture-encaissement. Les temps de cycle, comme le délai moyen de paiement client (DSO), sont généralement calculés à partir de ce point. Où trouver ces données Il s’agit d’un événement explicite, enregistré à partir de la date de création de la facture dans HighRadius. Celle-ci est généralement synchronisée depuis le système ERP source, comme SAP ou Oracle. Données à recueillir Enregistré à partir de l’horodatage de création de la facture dans les données des créances. Type d’événement explicit
	Facture passée en pertes	Cet événement marque une autre issue possible du cycle de vie de la facture : la créance est jugée irrécouvrable et passée en pertes. Il s’agit d’un résultat indésirable.
Pourquoi est-ce important ? Le suivi des factures passées en pertes est essentiel pour calculer leur taux et analyser les causes des pertes financières. Il aide à repérer les défaillances dans l’évaluation du crédit ou les efforts de recouvrement. Où trouver ces données Cet événement est enregistré lorsqu’une transaction de passage en pertes du solde de la facture est comptabilisée ou lorsque le statut de la facture passe à « Passée en pertes ». Données à recueillir Déduit du passage du statut à « Passée en pertes » ou de la comptabilisation d’une transaction spécifique de passage en pertes sur la facture. Type d’événement inferred
	Facture soldée	Cette activité marque la fin du cycle de vie de la facture : celle-ci est entièrement payée et clôturée. C’est l’état final attendu du processus.
Pourquoi est-ce important ? Il s’agit de l’événement de fin du parcours nominal du processus. L’analyse des parcours qui aboutissent à ce résultat permet de repérer les bonnes pratiques et les stratégies de recouvrement efficaces. Où trouver ces données Cet événement n’est généralement pas explicite. Il est déduit du passage du statut de la facture à « Clos » ou « Soldé » et du solde qui devient nul. L’horodatage du dernier paiement enregistré sert souvent d’heure d’événement. Données à recueillir Déduit du passage du statut de la facture à « Clos » ou du moment où son solde devient nul. Type d’événement inferred
	Litige enregistré	Cette activité marque le moment où un client conteste une facture ou y applique une déduction, puis consigne officiellement le litige dans HighRadius. Le recouvrement du montant contesté est alors suspendu.
Pourquoi est-ce important ? Cet événement marque le début de la mesure du délai moyen de résolution des litiges. Repérer quand et pourquoi les litiges sont soulevés est essentiel pour traiter leurs causes, comme les erreurs de facturation ou les problèmes d’expédition. Où trouver ces données Cet événement est enregistré lorsqu’un utilisateur crée un dossier de litige associé à une facture dans HighRadius Deductions Cloud. Cette action crée un enregistrement horodaté du litige. Données à recueillir Enregistré à partir de l’horodatage de création du dossier de litige associé à la facture. Type d’événement explicit
	Litige résolu	Cet événement marque la fin du traitement du litige : le problème a été examiné et une solution a été trouvée. La facture peut alors être payée ou passée en pertes.
Pourquoi est-ce important ? Cet événement marque la fin de la période mesurée pour calculer le délai moyen de résolution des litiges. Des cycles longs à cette étape peuvent retarder considérablement les encaissements et révéler des inefficacités du processus. Où trouver ces données Cet événement est enregistré lorsque le statut du dossier de litige passe à « Résolu », « Clos » ou à un autre statut final. L’horodatage de ce changement de statut est utilisé pour l’activité. Données à recueillir Déduit de l’horodatage auquel le statut du dossier de litige passe à l’é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 de boîte postale. Les fonds ont été reçus, mais ne sont pas encore affectés à la facture concernée.
Pourquoi est-ce important ? Cette étape clé arrête souvent le décompte du délai de recouvrement. Elle marque le début de la mesure du KPI de délai entre la réception et l’enregistrement du paiement, qui met en évidence les retards d’affectation des encaissements. Où trouver ces données Cet événement est enregistré à partir des données de paiement dans HighRadius Cash Application Cloud. Chaque lot de paiements ou transaction provenant d’un fichier bancaire comporte une date de réception. Données à recueillir Enregistré à partir de l’horodatage de la transaction de paiement, lors de son importation ou de sa saisie dans le module d’affectation des encaissements. Type d’événement explicit
	Appel de recouvrement consigné	Cet événement correspond à un appel manuel passé au client par un agent de recouvrement au sujet d’une facture en retard. L’agent consigne directement dans HighRadius les détails et le résultat de l’appel.
Pourquoi est-ce important ? Cette activité est essentielle pour évaluer le taux de réussite des appels de recouvrement et l’efficacité des activités de recouvrement. Elle permet de distinguer les démarches automatisées des démarches manuelles. Où trouver ces données Cet événement explicite est créé lorsqu’un agent utilise la fonction « Consigner un appel » ou « Ajouter une activité » sur la facture ou le compte client dans l’interface HighRadius. L’entrée comporte un horodatage. Données à recueillir Enregistré à partir de la table du journal des activités, où les agents consignent leurs actions manuelles. Type d’événement explicit
	Facture envoyée au client	Cette activité marque l’envoi de la facture au client, généralement par courriel ou via un portail client. HighRadius peut automatiser et consigner cet échange.
Pourquoi est-ce important ? Ce suivi permet de vérifier que les clients reçoivent leurs factures rapidement. Tout retard entre la génération et l’envoi d’une facture peut allonger le délai de paiement et augmenter le DSO. Où trouver ces données Cet événement est souvent consigné explicitement dans l’historique des échanges ou des activités associé à la facture dans le module Collections Cloud. Il peut aussi être déduit du statut d’une tâche d’envoi automatisé. Données à recueillir Consigné dans l’historique des communications de la facture lors de l’envoi par courriel ou de la mise à disposition sur le portail. Type d’événement explicit
	Limite de crédit approuvée	Cet événement marque la fin de l’examen du crédit et l’attribution officielle d’une limite au client. Il est enregistré lorsqu’un responsable du crédit approuve la demande dans HighRadius.
Pourquoi est-ce important ? Cette étape clé permet de poursuivre le processus de vente. Son suivi est essentiel pour calculer le KPI du temps de cycle total d’approbation du crédit. Où trouver ces données Cet événement est généralement enregistré lorsque le statut de la demande de limite de crédit passe à « Approuvé ». Il peut également figurer explicitement dans le journal d’audit du système. Données à recueillir Déduit du passage de la demande de crédit au statut « Approuvé » ou du champ d’horodatage de l’approbation. Type d’événement inferred
	Limite de crédit demandée	Cette activité marque le début de l’évaluation du crédit d’un client. Elle intervient généralement avant la validation d’une commande et est enregistrée lorsqu’une demande de nouvelle limite de crédit ou de modification est saisie dans le système.
Pourquoi est-ce important ? L’analyse du délai entre la demande et l’approbation permet de repérer les goulots d’étranglement dans l’intégration des clients et le cycle de vente. C’est un point de départ essentiel pour mesurer l’efficacité de l’équipe de gestion du crédit. Où trouver ces données Cet événement est probablement déduit d’un changement de statut du profil de crédit du client ou de la date de création d’une demande de limite de crédit dans le module de gestion du crédit de HighRadius. Données à recueillir Déduit de l’horodatage de création d’une demande de limite de crédit ou du passage de son statut à « En attente d’approbation ». Type d’événement inferred
	Paiement enregistré	Cet événement marque la fin du processus d’affectation des encaissements : le paiement reçu a été rapproché avec succès et affecté à une facture précise, ce qui solde le montant dû.
Pourquoi est-ce important ? Cette activité clôt le cycle de traitement du paiement. Le délai entre « Paiement reçu » et « Paiement enregistré » indique l’efficacité du processus d’affectation des encaissements. Où trouver ces données Cet événement est enregistré à partir du champ de date d’enregistrement ou de date de lettrage de la facture. L’horodatage est consigné lorsque l’affectation de l’encaissement est finalisée. Données à recueillir Enregistré à partir de l’horodatage du champ « date d’enregistrement » ou « date de lettrage » de la ligne comptable de la facture. Type d’événement explicit
	Procédure de relance lancée	Cette activité marque le début d’une procédure formelle de relance ou le passage à un niveau précis de cette procédure pour une facture en retard. Elle correspond à une démarche plus structurée qu’un simple rappel.
Pourquoi est-ce important ? Le suivi du lancement des procédures de relance permet d’évaluer l’efficacité des différentes stratégies et des différents niveaux de relance pour obtenir un paiement. Où trouver ces données Cet événement est généralement déduit d’une modification du champ « Niveau de relance » ou « Stratégie de recouvrement » associé à la facture dans HighRadius. Données à recueillir Déduit d’une modification de l’attribut de niveau de relance de la facture, enregistrée dans les journaux de modifications ou l’historique horodaté. Type d’événement inferred
	Promesse de paiement créée	Cette activité survient lorsqu’un client s’engage à payer une facture à une date ultérieure et que l’agent de recouvrement consigne cet engagement dans le système. Il s’agit d’un résultat intermédiaire positif.
Pourquoi est-ce important ? Le suivi des promesses de paiement aide à prévoir la 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 convenue. Où trouver ces données Cet événement explicite est consigné dans HighRadius lorsqu’un agent crée un enregistrement « Promesse de paiement » associé à une facture. Cet enregistrement possède son propre horodatage de création. Données à recueillir Enregistré à partir de l’horodatage de création de l’objet « Promesse de paiement » dans HighRadius. Type d’événement explicit
	Rappel de retard envoyé	Cet événement correspond à un rappel, manuel ou automatisé, envoyé au client au sujet d’une facture en retard. HighRadius automatise cette étape dans le cadre de ses stratégies de relance et consigne les communications.
Pourquoi est-ce important ? Cette activité est essentielle pour mesurer le taux d’efficacité des relances. Elle permet d’analyser le nombre de rappels nécessaires avant la réception d’un paiement. Où trouver ces données Il s’agit d’un événement explicite, consigné dans le journal des activités ou des échanges associé à la facture dans HighRadius Collections Cloud. Chaque rappel envoyé donne lieu à une entrée horodatée. Données à recueillir Enregistré à partir de l’horodatage du journal des communications 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 Rapports et analyses : Connectez-vous à votre instance HighRadius avec un compte disposant des autorisations nécessaires pour créer et exécuter des rapports personnalisés. Ouvrez la section Rapports et analyses depuis le Dashboard principal ou le menu de l’application.
Créez un rapport personnalisé : Lancez la création d’un rapport. Sélectionnez un objet de base qui servira de point de départ pour vos données, par exemple l’objet Factures ou Open A/R. Donnez au rapport un nom explicite, comme ProcessMind_Credit_Collections_Log.
Définissez les principaux attributs des factures : Ajoutez les champs principaux des factures à la structure du rapport : InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate et PaymentStatus. Ils constitueront les colonnes de base de chaque événement.
Ajoutez les données des objets associés (événements) : Cette étape est essentielle. Vous devez joindre ou réunir les données de différents objets HighRadius pour enregistrer les 15 activités requises. Utilisez les fonctions du générateur de rapports pour ajouter des sources de données associées. Pour chaque activité, créez un ensemble de colonnes décrivant les détails de l’événement.
Structurez le rapport au format du journal d’événements : Configurez le rapport pour obtenir une ligne par événement. En général, il faut réunir différents blocs de données plutôt que de les joindre sous forme de colonnes. Pour chaque bloc réuni, associez le champ de date pertinent à une colonne commune EventTime et définissez la valeur correspondante de ActivityName.
Configurez l’événement « Payment Due Date Passed » : Cet événement est conditionnel. Créez un bloc de données spécifique pour les factures dont la DueDate est passée et dont le PaymentStatus est toujours « Open » ou « Overdue ». Pour ces enregistrements, définissez ActivityName sur « Payment Due Date Passed » et utilisez la DueDate comme valeur de EventTime.
Ajoutez les informations sur les responsables du recouvrement et les litiges : Veillez à inclure les données des modules Collections et Litiges. Joignez des objets comme CollectorNotes ou ActivityHistory pour obtenir CollectorName. Joignez l’objet Disputes pour récupérer DisputeReason, le cas échéant.
Définissez les filtres du rapport : Appliquez des filtres pour délimiter l’extraction. Définissez une période pour EventTime, par exemple les six derniers mois, afin de conserver un jeu de données de taille raisonnable. Selon la structure de votre organisation, vous devrez peut-être aussi filtrer par code société ou unité opérationnelle.
Exécutez le rapport et vérifiez l’aperçu : Lancez le rapport pour afficher un aperçu des données. Vérifiez que la structure correspond au format requis pour le journal d’événements : une ligne par activité et des colonnes pour InvoiceNumber, ActivityName, EventTime et les autres attributs.
Exportez les données du rapport : Lorsque l’aperçu vous convient, exportez le rapport complet. Choisissez le format CSV, facilement importable dans les outils de Process Mining. Vérifiez que l’encodage UTF-8 est sélectionné pour éviter les problèmes de caractères.
Effectuez une dernière vérification des données : Ouvrez le fichier CSV exporté dans un tableur. Avant de l’importer dans ProcessMind, vérifiez que les 15 activités sont présentes, que les horodatages sont correctement formatés et que les principaux attributs sont renseignés comme prévu.

Configuration

Type de rapport : rapport personnalisé réunissant des données de plusieurs modules. Selon la version de HighRadius, il peut s’agir d’un « Joined Report » ou de plusieurs « Blocks » réunis.
Objet de données principal : commencez par l’objet Factures ou Accounts Receivable comme base du rapport.
Objets de données secondaires : vous devrez établir des liens avec d’autres objets, tels que CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase et CashApplication.
Filtre de période : appliquez un filtre au champ d’horodatage de l’événement principal. Il est recommandé d’extraire les données sur une période de 3 à 6 mois afin de trouver un équilibre entre le niveau de détail et les performances. Par exemple, EventTime au cours des 180 derniers jours.
Filtres d’état : envisagez d’exclure les états de facture non pertinents, comme « Cancelled » ou « Draft », sauf s’ils font partie du processus que vous souhaitez analyser.
Autorisations : le compte utilisateur qui exécute le rapport doit disposer d’un accès en lecture à tous les modules concernés, notamment Credit, Collections, Litiges et Cash Application, afin d’extraire un jeu de données complet.

a Exemple de requête sql

/*
 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 : vérifiez que Python 3.6 ou une version ultérieure est installé, ainsi que les bibliothèques pandas et requests. Vous pouvez les installer avec pip : pip install pandas requests. Demandez également à votre administrateur HighRadius des identifiants d’API (Client ID et Client Secret) disposant d’un accès en lecture aux objets de données nécessaires, comme les factures, le recouvrement, les litiges et les paiements.
Initialisez le script : créez un fichier de script Python, par exemple extract_hr_data.py. Commencez par importer les bibliothèques nécessaires (requests, pandas, datetime), puis définissez des constantes de remplacement pour l’URL de base de l’API HighRadius, les identifiants client et la période d’extraction souhaitée.
Mettez en place l’authentification : écrivez une fonction dédiée. Elle utilisera votre Client ID et votre Client Secret pour envoyer une requête POST au point de terminaison d’authentification HighRadius (par exemple /auth/v1/token) et récupérer un jeton Bearer. Ce jeton figurera dans l’en-tête de toutes les requêtes de données suivantes.
Récupérez les données principales des factures : créez une fonction qui interroge le point de terminaison principal des factures (par exemple /invoices/v1/search). Elle doit gérer la pagination pour récupérer tous les enregistrements de la période choisie. La fonction appelle l’API de manière répétée et collecte les données jusqu’à ce qu’il n’y ait plus de pages. Stockez ces données principales dans une liste de dictionnaires.
Récupérez les données des objets associés : créez une fonction distincte pour chaque entité de données principale, comme les litiges, les notes de recouvrement et les paiements. Ces fonctions interrogent les points de terminaison correspondants (par exemple /disputes/v1/search, /collections/v1/notes, /cashapp/v1/payments) et récupèrent efficacement toutes les données pertinentes pour la période choisie. Il est généralement préférable de récupérer ces jeux de données en bloc plutôt que d’interroger l’API pour chaque facture.
Structurez le journal d’événements : initialisez une liste vide qui contiendra toutes les lignes du journal d’événements. Le script parcourra les données récupérées et convertira chaque action ou changement d’état pertinent en un dictionnaire normalisé correspondant à une ligne d’événement. Chaque dictionnaire doit contenir les clés InvoiceNumber, ActivityName, EventTime et tous les autres attributs requis.
Générez les événements du cycle de vie des factures : parcourez la liste principale des factures. Pour chacune, créez les événements « Invoice Generated », « Invoice Sent to Customer », « Invoice Settled » et « Invoice Written Off », à partir de sa date de création, des journaux de correspondance, de la date de clôture et des champs d’état. Enregistrez-les sous forme de dictionnaires d’événement.
Calculez l’événement « Payment Due Date Passed » : dans la même boucle sur les factures, ajoutez la logique nécessaire pour créer cet événement calculé. Vérifiez si la date d’échéance est passée, si la facture n’a pas encore été payée et si l’événement « Payment Due Date Passed » n’a pas déjà été généré pour cette facture. La valeur de EventTime doit correspondre à la date d’échéance.
Générez les événements de recouvrement et de litige : traitez les données récupérées depuis les points de terminaison du recouvrement et des litiges. Pour chaque note, promesse de paiement, action de relance ou dossier de litige, créez les lignes correspondantes dans le journal d’événements (« Overdue Reminder Sent », « Collection Call Logged », « Promise to Pay Created », « Dispute Registered », « Dispute Resolved »). Associez les informations pertinentes, comme CollectorName et DisputeReason, à chaque événement.
Générez les événements de paiement : traitez les données de paiement du module d’affectation des paiements. Créez des événements « Payment Received » à partir de la date de création du paiement ou de la date du relevé bancaire, et des événements « Payment Posted » à partir de la date à laquelle le paiement a été affecté à la facture.
Consolidez et formatez les données : après avoir traité toutes les sources et généré les événements, convertissez la liste de dictionnaires d’événement en DataFrame pandas. Vous pourrez ainsi trier les données et convertir les types de données au besoin. Veillez à utiliser un format d’horodatage uniforme pour la colonne EventTime (YYYY-MM-DD HH:MI:SS).
Exportez au format CSV : utilisez la fonction to_csv de pandas pour exporter le DataFrame final dans un fichier CSV. Choisissez un nom explicite, par exemple highradius_event_log.csv. Définissez le paramètre index=False pour éviter d’ajouter l’index du DataFrame comme colonne. Le fichier est alors prêt à être importé dans ProcessMind.

Configuration

Identifiants d’API : un utilisateur d’API dédié, avec un Client ID et un Client Secret, est nécessaire. Il doit disposer d’autorisations de lecture sur tous les points de terminaison concernés, notamment ceux des factures, des clients, des activités de recouvrement, des litiges et de l’affectation des paiements.
Période : le script Python comprend les variables START_DATE et END_DATE. Il est essentiel de définir une période précise et raisonnable, par exemple de 3 à 6 mois, afin de limiter le volume de données et d’éviter une exécution trop longue du script. Filtrez les données à partir 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 d’API indiqués, par exemple /invoices/v1/search, sont des valeurs de remplacement. Vérifiez les URL exactes dans la documentation des API HighRadius de votre organisation.
Paramètres de pagination : le script doit gérer correctement le mécanisme de pagination de l’API. Celui-ci fait généralement appel aux paramètres limit et offset, ou à une approche fondée sur un curseur. Une taille de page de 100 à 500 constitue un bon point de départ.
Environnement : exécutez le script dans un environnement stable disposant de suffisamment de mémoire pour traiter les DataFrames, en particulier pour les extractions volumineuses. Pour les extractions en production, privilégiez un serveur plutôt qu’un ordinateur local.
Champs personnalisés : si votre processus utilise des champs personnalisés dans HighRadius, modifiez le script pour interroger ces champs et les inclure dans le résultat.

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()

Prêt à commencer ?

Ce modèle vous fournit une base de données structurée pour réaliser des analyses détaillées de votre processus de gestion du crédit et de recouvrement. Commencez dès aujourd’hui à optimiser vos opérations HighRadius pour accélérer les encaissements !

Retour au guide d’amélioration Télécharger le modèle

Commencez à optimiser la gestion du crédit et le recouvrement

Éliminez les goulots d’étranglement, réduisez le temps de cycle de 30 % et gagnez en efficacité.

Démarrez l’essai gratuit

Aucune carte bancaire requise. Commencez en quelques minutes.

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

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

Attributs de gestion du crédit et de recouvrement

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

Guides d’extraction

Export depuis le module Rapports et analyses de HighRadius

Étapes

Configuration

a Exemple de requête sql

Extraction par script Python via les API REST HighRadius

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Commencez à optimiser la gestion du crédit et le recouvrement

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

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

Attributs de gestion du crédit et de recouvrement

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

Guides d’extraction

Export depuis le module Rapports et analyses de HighRadius

Étapes

Configuration

a Exemple de requête sql

Extraction par script Python via les API REST HighRadius

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Commencez à optimiser la gestion du crédit et le recouvrement

Nous respectons votre vie privée

Prêt à commencer ?