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

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

NetSuite

Attributs de gestion du crédit et de recouvrement (21) Activités de gestion du crédit et de recouvrement (13) 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 et activités essentiels, ainsi que des conseils pratiques pour l’extraction, afin de vous aider à démarrer rapidement. En suivant ces recommandations, vous pourrez préparer vos données pour analyser et améliorer vos processus.

Attributs recommandés à collecter
Activités clés à suivre
Conseils d’extraction pour NetSuite

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 5 Recommandé 13 Facultatif

	Nom	Description
	Heure de l’événement EventTime	Horodatage indiquant le moment où l’activité a eu lieu.
Description Cet attribut enregistre la date et l’heure précises de chaque activité du processus. Il est indispensable aux analyses temporelles, notamment au calcul des temps de cycle, des durées et des temps d’attente entre les étapes. Dans NetSuite, cet horodatage correspond généralement à la date de création ou de dernière modification de l’enregistrement concerné ou de la note système. Pourquoi est-ce important ? Il permet de calculer tous les indicateurs de performance liés au temps, comme les temps de cycle et les goulots d’étranglement, essentiels à l’analyse de l’efficacité. Où trouver ces données Ces données proviennent des champs de date de différents enregistrements. Par exemple, la valeur « Date Created » de la fiche Invoice pour l’événement « Facture créée », ou l’horodatage d’une System Note pour les changements de statut. Exemples 2023-01-15T10:00:00Z2023-02-01T14:30:00Z2023-02-15T09:05:00Z
	Nom de l’activité ActivityName	Nom de l’activité métier survenue à un moment précis.
Description Cet attribut décrit une étape ou un événement précis du processus de gestion du crédit et du recouvrement, par exemple « Facture créée », « Paiement reçu » ou « Litige enregistré ». L’analyse de la séquence et de la fréquence de ces activités est au cœur du Process Mining : elle révèle le déroulement réel du processus, ses écarts et ses goulots d’étranglement. Pourquoi est-ce important ? Cet attribut constitue la base de la carte du processus et permet de visualiser et d’analyser son déroulement. Où trouver ces données Ce champ est généralement déduit des changements de statut des transactions (par exemple Invoice ou Customer Payment) ou d’enregistrements associés, comme les notes système, les enregistrements personnalisés d’activités de recouvrement ou les tâches CRM. Exemples Facture crééeRappel de retard envoyéPaiement reçuFacture passée en perte
	Numéro de facture InvoiceNumber	Identifiant unique de chaque facture client.
Description Le numéro de facture sert d’identifiant principal du cas et relie de manière unique toutes les activités associées à une créance. Il permet d’analyser l’ensemble du cycle de vie, de la création de la facture aux actions de gestion du crédit, puis au paiement ou au règlement par le recouvrement. Dans NetSuite, il correspond généralement à l’ID de transaction lorsque le type de transaction est « Invoice ». Pourquoi est-ce important ? C’est la clé indispensable pour suivre le parcours d’une facture, de sa création à son règlement, et analyser le processus de bout en bout. Où trouver ces données Il s’agit généralement du champ « Transaction ID » (ID interne : tranid) de la fiche Invoice dans NetSuite. Exemples INV0012345INV0054321INV0098765
	Date d’échéance DueDate	Date à laquelle le paiement de la facture doit être effectué.
Description La date d’échéance est la date de paiement convenue par contrat. Elle sert de référence pour déterminer si un paiement est effectué à temps ou en retard. Cet attribut est indispensable au calcul d’indicateurs comme le taux de paiement à temps et au déclenchement des relances une fois l’échéance dépassée. Pourquoi est-ce important ? Elle sert de référence principale pour mesurer le respect des délais de paiement, calculer le nombre de jours de retard et suivre le respect des conditions de paiement. Où trouver ces données Il s’agit du champ « Due Date » (ID interne : duedate) de la transaction Invoice. Exemples 2023-02-142023-03-312023-04-15
	ID client CustomerId	Identifiant unique du client associé à la facture.
Description Cet attribut relie une facture à un client précis dans NetSuite. Il est essentiel pour segmenter les données et analyser la performance du processus selon les clients ou les groupes de clients. Il permet, par exemple, de comparer les comportements de paiement ou les taux de litige des comptes stratégiques à ceux des petites entreprises. Pourquoi est-ce important ? Il permet une analyse centrée sur les clients et aide à repérer ceux qui paient souvent en retard, contestent leurs factures ou suivent des processus non standard. Où trouver ces données Il s’agit du champ « Customer » (ID interne : entity) de la transaction Invoice. Exemples CUST001CUST002CUST003
	Montant de la facture InvoiceAmount	Montant total de la facture.
Description Indique le montant total dû au titre de la facture. Cet attribut financier est utilisé dans presque toutes les analyses, par exemple pour mesurer l’incidence financière des retards de paiement ou étudier les abandons de créances sur les factures de montant élevé. Il fournit le contexte nécessaire pour établir les priorités de recouvrement. Pourquoi est-ce important ? Il apporte une dimension financière à l’analyse du processus et permet de tenir compte des montants, par exemple pour prioriser le recouvrement des factures en retard de montant élevé. Où trouver ces données Il s’agit du champ « Amount (Total) » (ID interne : total) de la transaction Invoice. Exemples 1500.00250.5012500.75
	Segment de clientèle CustomerSegment	Catégorie du client, définie par exemple selon sa taille, son secteur d’activité ou sa région.
Description Le segment de clientèle répartit les clients en groupes pertinents (par exemple « Entreprise », « PME » ou « secteur public »). Cet attribut est essentiel au Dashboard « Performance de la stratégie de recouvrement par segment », qui compare l’efficacité des différentes approches de recouvrement. Il aide à adapter les stratégies aux comportements propres à chaque groupe. Pourquoi est-ce important ? Il permet de déterminer si certains problèmes de processus ou comportements de paiement se concentrent dans des groupes de clients particuliers. Où trouver ces données Il s’agit souvent d’un champ personnalisé de la fiche Customer dans NetSuite. Les données doivent être associées à la transaction Invoice à partir de la fiche Customer. Exemples EntrepriseEntreprise de taille intermédiaireSMB
	Statut de la facture InvoiceStatus	Statut actuel de la facture dans son cycle de vie.
Description Indique le statut actuel de la facture, par exemple « Open », « Paid In Full » ou « Overdue ». Cet attribut permet de filtrer et d’analyser les factures encore en cours ou présentant un problème. Le Dashboard « Ancienneté et statut des factures en retard » s’appuie sur cet attribut pour présenter un état des créances en attente. Pourquoi est-ce important ? Il permet de filtrer l’analyse selon les étapes du cycle de vie de la facture, par exemple les factures ouvertes, en retard ou contestées. Où trouver ces données Il correspond au champ « Status » (ID interne : status) de la transaction Invoice. Exemples OuverteIntégralement régléeEn retard
	Automatisée IsAutomated	Indique si une activité a été exécutée automatiquement par un système.
Description Cet attribut booléen précise si une activité a été exécutée par un flux de travail automatisé ou par un utilisateur. Par exemple, l’activité « Envoi d’un rappel de retard » peut être automatisée, tandis qu’un « Appel de recouvrement effectué » est manuel. Cette distinction est essentielle au Dashboard « Fréquence et impact des activités manuelles », qui mesure le degré d’automatisation et repère les possibilités d’automatisation supplémentaires. Pourquoi est-ce important ? Aide à mesurer le degré d’automatisation du processus et à orienter les initiatives visant à réduire les tâches manuelles et à améliorer l’efficacité. Où trouver ces données Cet attribut est calculé à partir du type d’activité ou de l’utilisateur qui l’a exécutée. Par exemple, si l’utilisateur est un compte « SYSTEM » désigné, l’activité est considérée comme automatisée. Exemples truefalse
	Conditions de paiement PaymentTerms	Conditions de paiement convenues avec le client pour la facture.
Description Cet attribut précise les conditions auxquelles le client doit régler une facture, par exemple « Net 30 » ou « Net 60 ». Il sert de base au calcul de la date d’échéance et est essentiel au Dashboard « Respect des conditions de paiement et écarts », qui permet de vérifier si les clients respectent les conditions convenues. Pourquoi est-ce important ? Il définit le cadre contractuel des échéances de paiement et permet d’analyser le respect des conditions ainsi que les écarts susceptibles d’affecter la trésorerie. Où trouver ces données Il s’agit du champ « Terms » (ID interne : terms) de la transaction Invoice. Exemples Net 30Net 60À réception
	Délai d’enregistrement du paiement PaymentPostingLag	Durée entre la réception d’un paiement et son enregistrement dans le système.
Description Cette durée calculée mesure le délai entre l’activité « Paiement reçu » (réception des fonds) et l’activité « Paiement enregistré » (affectation du paiement à la facture dans NetSuite). Cette métrique clé du Dashboard « Analyse du délai d’enregistrement des paiements » met en évidence les inefficacités internes dans l’affectation des encaissements, qui peuvent fausser la visibilité sur la trésorerie. Pourquoi est-ce important ? Met en évidence les retards de traitement internes lors de l’affectation des encaissements, qui peuvent nuire à l’exactitude des rapports financiers et au statut des comptes clients. Où trouver ces données Ce calcul est effectué dans l’outil de Process Mining : Timestamp('Payment Posted') - Timestamp('Payment Received'). Exemples 1 jour4 heures3 jours
	Dernière mise à jour des données LastDataUpdate	Horodatage de la dernière actualisation des données depuis le système source.
Description Cet attribut indique la date de la dernière extraction et mise à jour des données du processus dans l’outil de Process Mining. Il permet de vérifier si les données analysées sont récentes et de prendre des décisions à partir d’informations à jour. Pourquoi est-ce important ? Il indique la fraîcheur des données et permet de savoir à quel point l’analyse du processus est à jour. Où trouver ces données Cette valeur est générée et ajoutée au jeu de données lors de l’extraction. Exemples 2023-10-27T02:00:00Z
	ID utilisateur UserId	Identifiant de l’utilisateur qui a effectué l’activité.
Description Identifie l’employé ou l’utilisateur système responsable d’une activité donnée, comme la comptabilisation d’un paiement ou un appel de recouvrement. Cet attribut permet d’analyser la répartition de la charge de travail et la performance de l’équipe, ainsi que de repérer les besoins de formation. Pour les activités automatisées, il peut s’agir de l’ID d’un utilisateur système. Pourquoi est-ce important ? Il permet d’analyser la performance par utilisateur ou par équipe, de comprendre la répartition de la charge de travail et de repérer les interventions manuelles. Où trouver ces données Ces données proviennent de champs tels que « Créé par », « Modified By » ou d’un champ « Owner » spécifique des transactions ou des enregistrements associés, par exemple l’enregistrement Phone Call pour les appels de recouvrement. Exemples j.doea.smithSYSTEM
	Jours de retard DaysOverdue	Nombre de jours écoulés depuis la date d’échéance de la facture.
Description Cette métrique calculée mesure le nombre de jours entre la date d’échéance de la facture et la date du jour, pour les factures ouvertes, ou la date de paiement. Indicateur clé du recouvrement, elle sert à classer les factures et à établir les priorités dans le Dashboard « Ancienneté et statut des factures en retard ». Une valeur inférieure ou égale à zéro signifie que la facture n’est pas en retard. Pourquoi est-ce important ? Mesure directement l’importance des retards de paiement et constitue une métrique essentielle pour les rapports d’ancienneté et la priorisation des activités de recouvrement. Où trouver ces données Cette valeur est calculée lors de la transformation des données : (date du jour ou date de paiement) - date d’échéance. Exemples 1532090
	Motif du litige DisputeReason	Motif indiqué par le client pour contester une facture.
Description Lorsqu’un client conteste une facture, cet attribut enregistre le motif, par exemple « Prix incorrect », « Marchandise endommagée » ou « Facturation en double ». Il est essentiel aux Dashboards « Délai de résolution des litiges liés aux factures » et « Analyse des causes des abandons de créances » pour comprendre l’origine des litiges et repérer les tendances auxquelles il est possible de remédier. Pourquoi est-ce important ? Il aide à identifier les causes des litiges clients et fournit les éléments nécessaires pour améliorer les processus en amont, comme l’exécution des commandes ou l’exactitude de la facturation. Où trouver ces données Il s’agit probablement d’un champ personnalisé de la fiche Invoice ou d’un enregistrement personnalisé associé, utilisé pour suivre les litiges. Ce champ ne fait pas partie des champs standard de NetSuite. Exemples Quantité incorrecteÉcart de prixMarchandise endommagée
	Nom de l’agent de recouvrement CollectorName	Nom de l’agent de recouvrement chargé de la facture.
Description Identifie l’agent ou la ressource chargé de gérer une facture en retard. Cet attribut permet d’analyser la performance de l’équipe de recouvrement, de comprendre la répartition de la charge de travail et d’évaluer l’efficacité de chaque agent. Il contribue au calcul d’indicateurs comme le taux de réussite des contacts de recouvrement. Pourquoi est-ce important ? Il permet de mesurer la performance et d’équilibrer la charge de travail de l’équipe de recouvrement, en associant les activités à des personnes précises. Où trouver ces données Il s’agit souvent d’un champ personnalisé de la fiche Customer ou Invoice. Certaines extensions NetSuite dédiées au recouvrement ajoutent cette fonctionnalité. Exemples Alice JohnsonRobert WilliamsNon attribué
	Paiement dans les délais IsOnTimePayment	Indique si le paiement a été reçu au plus tard à la date d’échéance.
Description Cet attribut booléen calculé vérifie si l’activité « Paiement reçu » a eu lieu au plus tard à la « Date d’échéance » de la facture. Il simplifie le calcul du KPI « Taux de paiement dans les délais » et facilite le filtrage et l’analyse des paiements reçus à temps ou en retard. Il fournit un résultat binaire clair sur le respect des délais de paiement. Pourquoi est-ce important ? Fournit une métrique binaire simple pour évaluer le respect des conditions de paiement et calculer et comparer facilement le taux de paiement dans les délais. Où trouver ces données Cette valeur est calculée lors de la transformation des données : TRUE si (date de paiement <= date d’échéance), sinon FALSE. Exemples truefalse
	Pays Country	Le pays de l’adresse de facturation du client.
Description Cet attribut indique le pays associé à l’adresse de facturation du client sur la facture. Il sert à analyser les différences géographiques en matière de comportement de paiement, d’efficacité du recouvrement et de taux de litiges. Ces analyses peuvent aider à adapter les stratégies de recouvrement à chaque région et à comprendre l’incidence des conditions économiques locales. Pourquoi est-ce important ? Permet de segmenter le processus par zone géographique et de mettre en évidence les différences régionales en matière de comportement de paiement ou d’efficacité des processus. Où trouver ces données Ces informations proviennent des détails de « Billing Address » de la transaction Invoice, généralement hérités de la fiche client. Exemples USAAllemagneJapon
	Système source SourceSystem	Système d’où proviennent les données extraites.
Description Identifie le système d’origine des données d’événement. Pour cette vue du processus, la valeur sera toujours « NetSuite », mais cet attribut est obligatoire pour la gouvernance des données et pour distinguer les sources dans un environnement composé de plusieurs systèmes. Pourquoi est-ce important ? Garantit la traçabilité et la provenance des données, importantes pour leur validation et leur gouvernance, notamment dans les environnements où plusieurs systèmes sont intégrés. Où trouver ces données Il s’agit d’une valeur statique (« NetSuite ») ajoutée lors de la transformation des données. Exemples NetSuite
	Temps de cycle de la facturation à l’encaissement InvoiceToCashCycleTime	Durée totale entre la création de la facture et son règlement définitif.
Description Cette métrique calculée mesure la durée totale entre l’activité « Facture générée » et l’activité « Facture réglée ». Elle reflète la performance de bout en bout du processus de gestion du crédit et du recouvrement. Son analyse permet de repérer les retards systémiques et d’évaluer globalement la vitesse d’encaissement. Pourquoi est-ce important ? Ce KPI essentiel donne une mesure globale de l’efficacité du processus de facturation et d’encaissement. Où trouver ces données Ce calcul au niveau du dossier est effectué dans l’outil de Process Mining : Timestamp('Invoice Settled') - Timestamp('Invoice Generated'). Exemples 32 jours45 jours91 jours
	Unité opérationnelle BusinessUnit	L’unité opérationnelle ou la filiale associée à la transaction.
Description Indique l’unité opérationnelle, le service ou la filiale qui a émis la facture. Dans les comptes NetSuite OneWorld, ce champ correspond généralement à « Subsidiary ». Il permet d’analyser les processus par entité et de comparer leurs performances, ainsi que de repérer les problèmes propres à certaines divisions. Pourquoi est-ce important ? Permet de comparer les performances des processus entre les différentes entités de l’organisation et de repérer les écarts qui peuvent nécessiter des approches de gestion distinctes. Où trouver ces données Dans NetSuite OneWorld, ce champ correspond à « Subsidiary ». Dans les autres comptes, il peut correspondre à « Department » ou à « Class », selon la configuration. Exemples Ouest des États-UnisServices EMEAProduits APAC

Obligatoire Recommandé Facultatif

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

Voici les étapes et jalons essentiels à enregistrer dans votre journal d’événements pour découvrir et optimiser votre processus de recouvrement.

5 Recommandé 8 Facultatif

	Activité	Description
	Date d’échéance dépassée	Cet événement calculé survient lorsque la date du jour dépasse la date d’échéance de la facture et que celle-ci n’a pas été intégralement réglée. Il marque le passage de la facture du statut « en cours » au statut « en retard ».
Pourquoi est-ce important ? Cet événement déclenche les activités de recouvrement. L’analyse de la période qui suit est essentielle pour comprendre l’efficacité du recouvrement et des relances. Où trouver ces données Il s’agit d’un événement calculé, obtenu en comparant la date du jour au champ « Due Date » de la transaction Invoice. L’horodatage de l’événement correspond à la date d’échéance. Données à recueillir L’horodatage correspond à la valeur du champ « Due Date » de la facture. Type d’événement calculated
	Facture créée	Indique la création officielle de la facture dans le système. Cet événement est enregistré à partir de la date de création de la transaction Invoice dans NetSuite et marque le début du cycle de vie de la facture.
Pourquoi est-ce important ? Il s’agit de l’événement de début principal du processus de la facturation à l’encaissement. Il est essentiel pour calculer des indicateurs clés comme le délai moyen de paiement client (DSO) et le temps de cycle global de la facturation à l’encaissement. Où trouver ces données Cet événement explicite est enregistré à partir de la date de création de la transaction Invoice dans NetSuite (table Transaction, où Type vaut « Invoice »). Données à recueillir Utilisez l’horodatage de création de la transaction de facture. Type d’événement explicit
	Facture passée en perte	Marque la fin infructueuse du cycle de vie de la facture : la créance est considérée comme irrécouvrable et retirée des comptes clients. L’événement est enregistré lorsqu’une écriture comptable pour créance irrécouvrable est imputée sur la facture.
Pourquoi est-ce important ? Cet événement marque l’échec du processus. L’analyse des parcours qui aboutissent à un abandon de créance aide à repérer les faiblesses de la politique de crédit et de la stratégie de recouvrement, et à réduire les créances irrécouvrables. Où trouver ces données Déduit de l’imputation d’une « Journal Entry » sur la facture, lorsque cette écriture correspond précisément à un abandon de créance irrécouvrable. Un statut personnalisé peut également être utilisé. Données à recueillir Utilisez la date de l’écriture Journal Entry d’abandon de créance imputée sur la facture. Type d’événement inferred
	Facture réglée	Marque la fin du cycle de vie de la facture : le solde dû est ramené à zéro grâce aux paiements et aux avoirs imputés. L’événement est déduit du passage du statut de la facture à « Paid In Full ».
Pourquoi est-ce important ? Il s’agit de l’événement de fin qui marque la réussite du processus. C’est le dernier point de données utilisé pour calculer le temps de cycle de bout en bout de la facturation à l’encaissement. Où trouver ces données Déduit du passage du champ « Status » de la transaction Invoice à « Paid In Full ». L’horodatage peut correspondre à la date du dernier paiement ou du dernier avoir ayant soldé la facture. Données à recueillir Horodatage de la dernière imputation de paiement qui fait passer le statut à « Paid In Full ». Type d’événement inferred
	Paiement reçu	Cet événement marque la création d’un paiement client et son imputation sur une facture. Il s’agit d’une étape clé, enregistrée directement à partir de la transaction Customer Payment dans NetSuite.
Pourquoi est-ce important ? Cette activité est essentielle au calcul du DSO et du taux de paiement à temps. Elle marque la réception des fonds et constitue un indicateur clé de la réussite du recouvrement. Où trouver ces données Enregistré à partir de la date de création de la transaction « Customer Payment ». La sous-liste « Apply » de cet enregistrement associe le paiement à une ou plusieurs factures. Données à recueillir Utilisez la date de transaction de l’enregistrement Customer Payment. Type d’événement explicit
	Appel de recouvrement effectué	Activité de recouvrement manuelle au cours de laquelle un agent appelle le client. Cet événement est enregistré à partir des activités Phone Call créées par les utilisateurs dans le module CRM de NetSuite.
Pourquoi est-ce important ? Cette activité permet de quantifier le travail manuel consacré au recouvrement. L’analyse de sa fréquence et de son taux de réussite est importante pour mieux répartir les ressources et déterminer les possibilités d’automatisation. Où trouver ces données Enregistré à partir de la date de création d’une activité « Phone Call » dont le client est l’enregistrement associé et dont le message mentionne le numéro de facture. Données à recueillir Utilisez l’horodatage de l’activité Phone Call du CRM. Type d’événement explicit
	Avoir émis	Indique la création d’un avoir imputé sur la facture, souvent pour corriger une erreur ou régler un litige. Il s’agit d’une transaction explicite dans NetSuite.
Pourquoi est-ce important ? Des avoirs fréquents peuvent révéler des problèmes récurrents, comme des erreurs de prix ou des problèmes de livraison. Leur analyse aide à identifier les causes des pertes de revenus. Où trouver ces données Cet événement explicite est enregistré à partir de la date de création de la transaction Credit Memo associée à la facture d’origine. Données à recueillir Utilisez l’horodatage de création de la transaction Credit Memo. Type d’événement explicit
	Facture envoyée au client	Indique que la facture a été communiquée au client, généralement par e-mail. Cet événement est souvent déduit des journaux système qui recensent les communications sortantes liées à la transaction de facture.
Pourquoi est-ce important ? Le suivi de cette activité permet de repérer les délais entre la création de la facture et l’information du client, qui peuvent retarder le paiement. Il renseigne sur l’efficacité du processus de communication lié à la facturation. Où trouver ces données Déduit de la date d’un e-mail envoyé depuis la fiche de facture, dans l’onglet secondaire Communication > Messages de la transaction Invoice. Données à recueillir Utilisez l’horodatage de l’enregistrement « Message » associé à la facture. Type d’événement inferred
	Litige enregistré	Indique que le client a officiellement contesté la facture, ce qui suspend le processus de recouvrement habituel. L’événement est généralement déduit du changement du champ de statut de la facture vers la valeur « Disputed ».
Pourquoi est-ce important ? Cet événement marque le début de la mesure du délai de résolution des litiges. Des litiges fréquents peuvent révéler des problèmes sous-jacents dans la facturation ou le processus de vente. Où trouver ces données Déduit d’un journal système ou d’un changement horodaté du champ personnalisé « Invoice Status » vers une valeur telle que « Disputed » ou « In Dispute ». Données à recueillir Horodatage de la mise à jour du champ de statut signalant un litige. Type d’événement inferred
	Litige résolu	Marque la résolution du litige du client, qui permet de reprendre le processus de recouvrement ou de régler la facture. L’événement est déduit du passage du statut de la facture de « Disputed » à un statut actif.
Pourquoi est-ce important ? Cet événement marque la fin de la mesure du temps de cycle de résolution des litiges. Une résolution efficace est importante pour préserver la satisfaction client et accélérer les encaissements. Où trouver ces données Déduit d’un journal système ou d’un changement horodaté du champ personnalisé « Invoice Status », de « Disputed » à une valeur telle que « Open » ou « Resolved ». Données à recueillir Horodatage de la mise à jour du champ de statut indiquant la résolution. Type d’événement inferred
	Paiement comptabilisé	Indique la date à laquelle l’incidence financière du paiement est officiellement enregistrée dans le grand livre. Cette date est extraite de la date de comptabilisation de la transaction Customer Payment.
Pourquoi est-ce important ? Le délai entre « Paiement reçu » et « Paiement comptabilisé » révèle les retards administratifs. Son analyse est importante pour garantir l’exactitude et la ponctualité des rapports financiers. Où trouver ces données Enregistré à partir de la « Posting Period » ou de la date de transaction figurant dans l’impact sur le grand livre de la transaction « Customer Payment ». Données à recueillir Utilisez la date de comptabilisation dans le grand livre de la transaction Customer Payment. Type d’événement explicit
	Procédure de relance lancée	Marque le début d’une procédure formelle de relance ou de recouvrement pour une facture en retard, qui peut comporter plusieurs étapes. L’événement est enregistré lorsqu’un niveau de relance précis est attribué à la facture.
Pourquoi est-ce important ? Le suivi du lancement d’une procédure formelle de relance permet d’en mesurer le respect et l’efficacité. Il s’agit d’une étape clé pour analyser l’influence des différentes stratégies de relance sur les comportements de paiement. Où trouver ces données Déduit de la date à laquelle le champ « Dunning Level » de la facture ou de la fiche client prend pour la première fois une valeur non nulle ou un niveau de relance initial. Données à recueillir Repérez l’horodatage auquel le champ Dunning Level change. Type d’événement inferred
	Rappel de retard envoyé	Un premier rappel, souvent automatisé, est envoyé au client au sujet d’une facture en retard. Cette activité est généralement enregistrée lors de la création d’une lettre de relance ou d’un événement de communication consigné dans le module de relance de NetSuite.
Pourquoi est-ce important ? Cette activité constitue la première étape du processus de relance. L’analyse de sa fréquence et de son effet sur les paiements permet d’évaluer l’efficacité des premières démarches de recouvrement. Où trouver ces données Enregistré à partir de la date de création d’un enregistrement « Dunning Letter » associé à la facture et généré par NetSuite Dunning SuiteApp. Données à recueillir Utilisez l’horodatage de création de l’enregistrement Dunning Letter. Type d’événement explicit

Recommandé Facultatif

Guides d’extraction

Comment extraire vos données de NetSuite

Étapes

Connectez-vous à NetSuite : accédez à votre compte NetSuite avec un rôle autorisé à créer et à exécuter des recherches enregistrées, ainsi qu’à consulter les enregistrements de transactions et d’activités requis (par exemple, Facture, paiement client, appel téléphonique).
Accédez aux recherches enregistrées : sélectionnez Reports > Saved Searches > All Saved Searches > New. Vous répéterez cette procédure pour créer plusieurs recherches distinctes, une par type d’événement.
Créez la recherche de base sur les factures : commencez par créer une recherche pour l’événement « Facture générée ». Sélectionnez « Transaction » comme type de recherche. Cette recherche enregistrera la création des factures.
Définissez les critères de recherche : dans le sous-onglet « Criteria », ajoutez les filtres suivants :
- Type est Invoice.
- Main Line est true. Vous obtiendrez ainsi un enregistrement par facture, et non un enregistrement par ligne.
- Date Created se situe dans la période d’analyse souhaitée, par exemple les six derniers mois.
Définissez les résultats de recherche : dans le sous-onglet « Results », ajoutez les colonnes nécessaires au journal d’événements. Utilisez des libellés personnalisés correspondant aux noms d’attributs requis (par exemple, InvoiceNumber). Utilisez des formules pour renseigner le champ ActivityName. La section de la requête présente les correspondances détaillées entre les champs.
Créez des recherches pour les autres événements : en suivant les configurations de la section de la requête, créez des recherches enregistrées distinctes pour les autres activités, comme les paiements, les avoirs, les appels de recouvrement et les changements de statut. Certaines peuvent nécessiter d’autres types d’enregistrements, comme « Phone Call », ou une recherche dans « System Notes ».
Exécutez et exportez les recherches : lancez chaque recherche enregistrée séparément. Dans la page des résultats, cliquez sur l’icône « Export - CSV » pour télécharger les données. Donnez à chaque fichier un nom explicite (par exemple, invoice_generated.csv, payment_received.csv).
Générez les événements « Date d’échéance du paiement dépassée » : cet événement ne peut pas être exporté directement. Vous devez le calculer après l’exportation. Dans l’outil de traitement des données de votre choix, comme Python, Power Query ou un outil ETL, créez une ligne pour chaque facture qui n’est pas encore entièrement payée, avec ActivityName défini sur « Date d’échéance du paiement dépassée » et EventTime correspondant à DueDate plus un jour.
Regroupez les fichiers exportés : utilisez un outil externe pour réunir tous les fichiers CSV exportés dans un seul fichier principal. Vérifiez que les en-têtes de colonnes sont identiques dans tous les fichiers avant de les regrouper.
Mettez en forme les données finales : vérifiez le fichier CSV regroupé. Assurez-vous que EventTime respecte un format d’horodatage uniforme (par exemple, YYYY-MM-DD HH:MI:SS) et que chaque ligne contient toutes les colonnes requises (InvoiceNumber, ActivityName, EventTime).
Importez les données dans ProcessMind : le fichier CSV final regroupé est prêt à être importé comme journal d’événements.

Configuration

Prérequis : vous devez disposer d’un rôle utilisateur autorisé à créer, modifier et exporter des recherches enregistrées. Vous devez également pouvoir accéder aux types d’enregistrements suivants : Transaction (factures, paiements, avoirs), Phone Call (ou autres enregistrements d’activité CRM) et System Notes.
Types d’enregistrements : les principaux types utilisés dans ces recherches sont Transaction et Phone Call. L’enregistrement System Note sert également à suivre les changements de statut et les événements de communication lorsqu’aucun enregistrement de transaction direct n’est disponible.
Filtrage par période : pour préserver les performances et maîtriser le volume de données, appliquez systématiquement un filtre de date (par exemple, Date Created ou Last Modified Date) à toutes les recherches enregistrées. Pour une première analyse, il est recommandé d’utiliser une période de 3 à 6 mois.
Filtre Main Line : lors de la recherche d’enregistrements de transaction, utilisez le critère Main Line is true pour isoler les informations d’en-tête. Vous éviterez ainsi de dupliquer les événements pour chaque ligne d’une facture ou d’un paiement.
Utilisation de formules : les formules NetSuite sont indispensables pour créer la colonne normalisée ActivityName. Les champs Formula (Text) permettent de définir en dur le nom de l’activité pour chaque recherche. Si nécessaire, vous pouvez utiliser Formula (Date/Time) pour uniformiser les champs d’horodatage.
Limites d’exportation : l’exportation CSV depuis l’interface NetSuite est généralement limitée à 100 000 lignes par recherche. Pour les jeux de données plus volumineux, vous devrez peut-être lancer les recherches sur des périodes plus courtes ou utiliser des recherches planifiées qui envoient les résultats dans le File Cabinet.

a Exemple de requête sql

/*
This configuration outlines the setup for multiple NetSuite Saved Searches. 
Each search is designed to extract a specific activity for the event log.
Create one Saved Search in the NetSuite UI for each block defined below.
*/

// Saved Search 1: Invoice Generated
{
  "SavedSearchName": "ProcessMind - Invoice Generated",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Generated'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 2: Invoice Sent to Customer
{
  "SavedSearchName": "ProcessMind - Invoice Sent",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "E-mailed"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Sent to Customer'"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Note: 'Payment Due Date Passed' is a calculated event, generated post-export.

// Saved Search 3: Overdue Reminder Sent & Dunning Procedure Initiated
{
  "SavedSearchName": "ProcessMind - Dunning Events",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "[Your Dunning Status Field]"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} = '[Your First Dunning Level]' THEN 'Dunning Procedure Initiated' ELSE 'Overdue Reminder Sent' END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 4: Collection Call Made
{
  "SavedSearchName": "ProcessMind - Collection Calls",
  "RecordType": "Phone Call",
  "Criteria": [
    {"Field": "Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Collection Call Made'"},
    {"Column": "EventTime", "Field": "Completed Date"},
    {"Column": "InvoiceNumber", "Field": "Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Company : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Company : Category"},
    {"Column": "InvoiceAmount", "Field": "Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Transaction : Status"}
  ]
}

// Saved Search 5: Dispute Registered & Resolved
{
  "SavedSearchName": "ProcessMind - Dispute Status",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "Status"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} LIKE '%Disputed%' THEN 'Dispute Registered' WHEN {systemnotes.oldvalue} LIKE '%Disputed%' THEN 'Dispute Resolved' ELSE NULL END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 6: Credit Memo Issued
{
  "SavedSearchName": "ProcessMind - Credit Memos",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Credit Memo"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Applied To Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Credit Memo Issued'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 7: Payment Received & Posted
{
  "SavedSearchName": "ProcessMind - Payments",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Customer Payment"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    // For 'Payment Received'
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Received'"},
    {"Column": "EventTime", "Field": "Date Created"},
    // For 'Payment Posted'
    // {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Posted'"},
    // {"Column": "EventTime", "Field": "[Your GL Posting Date Field]"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 8: Invoice Settled
{
  "SavedSearchName": "ProcessMind - Invoice Settled",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Status", "Operator": "anyof", "Value": "Paid In Full"},
    {"Field": "Date Closed", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Settled'"},
    {"Column": "EventTime", "Field": "Date Closed"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 9: Invoice Written Off
{
  "SavedSearchName": "ProcessMind - Invoice Written Off",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Journal Entry"},
    {"Field": "Main Line", "Operator": "is", "Value": "false"},
    {"Field": "Account", "Operator": "is", "Value": "[Your Bad Debt Expense Account]"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Written Off'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Created From : Document Number"},
    {"Column": "CustomerId", "Field": "Created From : Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Created From : Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Created From : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Created From : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Created From : Status"}
  ]
}

Étapes

Prérequis : vérifiez que Python 3.6 ou une version ultérieure est installé sur votre système. Vous aurez également besoin des identifiants NetSuite SuiteTalk pour l’authentification par jeton (TBA) : Account ID, Consumer Key, Consumer Secret, Token ID et Token Secret. Le rôle NetSuite associé doit permettre d’accéder à tous les enregistrements requis, notamment les transactions (factures, paiements, avoirs), les activités CRM (appels téléphoniques) et les fiches client.
Installez les bibliothèques Python : ouvrez votre ligne de commande ou votre terminal et installez les bibliothèques Python nécessaires. Les principales sont pandas pour le traitement des données, requests et requests_oauthlib pour les appels d’API, ou une bibliothèque NetSuite dédiée. pip install pandas requests requests_oauthlib
Configurez l’authentification : dans le script Python fourni, repérez la section consacrée aux identifiants. Saisissez de manière sécurisée votre Account ID, votre Consumer Key, votre Consumer Secret, votre Token ID et votre Token Secret NetSuite dans les variables prévues à cet effet. Il est fortement recommandé d’utiliser des variables d’environnement ou un coffre-fort sécurisé plutôt que d’inscrire directement ces identifiants dans le script.
Configurez les paramètres d’extraction : dans le script, définissez les variables start_date et end_date pour préciser la période d’extraction des données. Vous pouvez également modifier le filtre subsidiary_id pour limiter l’extraction à une filiale NetSuite précise.
Comprenez le fonctionnement du script : le script interroge séparément chacune des 13 activités requises. Chaque requête est une instruction SuiteQL distincte envoyée au point de terminaison de l’API REST NetSuite. Le script gère automatiquement la pagination de l’API afin de récupérer tous les enregistrements de chaque requête.
Exécutez le script Python : lancez le script depuis votre terminal à l’aide de la commande python your_netsuite_extraction_script.py. Le script se connecte à NetSuite, exécute les requêtes successives et affiche dans la console l’état d’avancement de la récupération des données pour chaque activité.
Regroupez et transformez les données : après avoir récupéré les données brutes de chaque activité, le script utilise la bibliothèque pandas pour réunir tous les résultats dans un DataFrame unique. Ce DataFrame constitue le journal d’événements.
Vérifiez et enregistrez le journal d’événements : le script enregistre le DataFrame final dans un fichier CSV nommé netsuite_collections_event_log.csv. Ouvrez ce fichier pour vérifier que les données sont complètes et exactes.
Préparez l’importation : vérifiez que le fichier CSV final contient les en-têtes requis, InvoiceNumber, ActivityName et EventTime, ainsi que les attributs recommandés. Le fichier est alors prêt à être importé dans ProcessMind.

Configuration

Authentification : le script utilise l’authentification par jeton NetSuite (TBA). Vous devez fournir l’Account ID, le Consumer Key, le Consumer Secret, le Token ID et le Token Secret. Le rôle associé au jeton doit disposer d’un accès en lecture aux enregistrements Transaction, Customer, Phone Call et Message.
Période : les variables start_date et end_date du script définissent la période d’extraction. Pour une première analyse, une période de 3 à 6 mois est recommandée afin de trouver un équilibre entre volume de données et performances.
Filtre sur la filiale : la variable subsidiary_id permet de filtrer les données pour une unité opérationnelle précise. Si votre environnement ne comporte qu’une seule filiale, vous pouvez omettre ce filtre.
Point de terminaison de l’API : le script utilise le point de terminaison de l’API REST SuiteQL de NetSuite. Vérifiez que cette API est activée pour votre compte (/services/rest/query/v1/suiteql).
Gestion de la pagination : le script comprend une fonction qui gère automatiquement les réponses paginées de l’API. La taille de page page_size est fixée à 1 000, le maximum autorisé par l’API, afin de réduire le nombre d’appels nécessaires.
Champs personnalisés : l’extraction des événements « Litige enregistré » et « Litige résolu » suppose l’utilisation des champs personnalisés custbody_dispute_date et custbody_dispute_resolved_date. Vous devez mettre à jour le script avec les identifiants de champs réellement utilisés dans votre instance NetSuite.

a Exemple de requête python

import pandas as pd
import requests
from requests_oauthlib import OAuth1
import json
import os
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Best practice: Use environment variables instead of hardcoding credentials.
NS_ACCOUNT = os.getenv(class="hl-string">'NS_ACCOUNT', class="hl-string">'[Your NetSuite Account ID]')
NS_CONSUMER_KEY = os.getenv(class="hl-string">'NS_CONSUMER_KEY', class="hl-string">'[Your Consumer Key]')
NS_CONSUMER_SECRET = os.getenv(class="hl-string">'NS_CONSUMER_SECRET', class="hl-string">'[Your Consumer Secret]')
NS_TOKEN_ID = os.getenv(class="hl-string">'NS_TOKEN_ID', class="hl-string">'[Your Token ID]')
NS_TOKEN_SECRET = os.getenv(class="hl-string">'NS_TOKEN_SECRET', class="hl-string">'[Your Token Secret]')

class=class="hl-string">"hl-comment"># The base URL for the SuiteQL API endpoint
BASE_URL = fclass="hl-string">"https://{NS_ACCOUNT.replace('_', '-')}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'
SUBSIDIARY_ID = class="hl-string">'[Your Subsidiary ID]' class=class="hl-string">"hl-comment"># Optional: filter by subsidiary

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query and handles pagination."""
    all_results = []
    offset = 0
    limit = 1000

    oauth = OAuth1(
        client_key=NS_CONSUMER_KEY,
        client_secret=NS_CONSUMER_SECRET,
        resource_owner_key=NS_TOKEN_ID,
        resource_owner_secret=NS_TOKEN_SECRET,
        realm=NS_ACCOUNT,
        signature_method=class="hl-string">'HMAC-SHA256'
    )

    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(BASE_URL, headers=headers, data=payload, auth=oauth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            data = response.json()
            
            if not data.get(class="hl-string">'items'):
                break

            all_results.extend(data[class="hl-string">'items'])
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            print(fclass="hl-string">"Response body: {response.text if 'response' in locals() else 'No response'}")
            return None

    return all_results

def main():
    class="hl-string">"""Main function to orchestrate the data extraction."""
    all_events = []
    
    class=class="hl-string">"hl-comment"># Common WHERE clause for filtering by date and subsidiary
    common_filter = fclass="hl-string">"WHERE T.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD') AND T.subsidiary = {SUBSIDIARY_ID}"

    class=class="hl-string">"hl-comment"># --- Define SuiteQL Queries for Each Activity ---
    queries = {
        class="hl-string">'Invoice Generated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Generated' AS ActivityName,
                TO_CHAR(T.createdDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.createdDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Sent to Customer': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Sent to Customer' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND M.emailed = 'T' AND M.messageDate IS NOT NULL
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Payment Due Date Passed': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Payment Due Date Passed' AS ActivityName,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD"T"23:59:59"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status NOT IN ('CustInvc:B', 'CustInvc:A') -- Not Paid In Full or Pending Approval
                AND T.dueDate < CURRENT_DATE
                AND T.dueDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Overdue Reminder Sent': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Overdue Reminder Sent' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND (M.subject LIKE '%Overdue%' OR M.subject LIKE '%Reminder%')
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dunning Procedure Initiated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dunning Procedure Initiated' AS ActivityName,
                TO_CHAR(SL.systemNoteDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
                INNER JOIN SystemNote AS SL ON T.id = SL.recordId
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND SL.field = 'custbody_dunning_level' AND SL.oldValue IS NULL -- Assumes a custom dunning level field
                AND SL.systemNoteDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Collection Call Made': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Collection Call Made' AS ActivityName,
                TO_CHAR(PC.completedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                PhoneCall AS PC
                INNER JOIN Transaction AS T ON PC.transaction = T.id
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND PC.title LIKE '%Collection%'
                AND PC.completedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dispute Registered': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Registered' AS ActivityName,
                TO_CHAR(T.custbody_dispute_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_date IS NOT NULL -- Assumes a custom dispute date field
                AND T.custbody_dispute_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Dispute Resolved': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Resolved' AS ActivityName,
                TO_CHAR(T.custbody_dispute_resolved_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_resolved_date IS NOT NULL -- Assumes a custom dispute resolved date field
                AND T.custbody_dispute_resolved_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Credit Memo Issued': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Credit Memo Issued' AS ActivityName,
                TO_CHAR(CM.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                CM.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS CM
                INNER JOIN TransactionLine AS CML ON CM.id = CML.transaction
                INNER JOIN Transaction AS AppliedTo ON CML.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON CM.entity = C.id
            WHERE
                CM.type = 'CustCred' AND CM.voided = 'F' AND CM.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND CM.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Received': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Received' AS ActivityName,
                TO_CHAR(P.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND P.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Posted': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Posted' AS ActivityName,
                TO_CHAR(P.postingdate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc' AND P.posting = 'T'
                AND P.postingdate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Invoice Settled': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Settled' AS ActivityName,
                TO_CHAR(T.lastModifiedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status = 'CustInvc:B' -- Paid In Full
                AND T.lastModifiedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Written Off': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Invoice Written Off' AS ActivityName,
                TO_CHAR(JE.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                JE.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS JE
                INNER JOIN TransactionLine AS JEL ON JE.id = JEL.transaction
                INNER JOIN Transaction AS AppliedTo ON JEL.entity = AppliedTo.entity -- A best-effort link via customer
                INNER JOIN Customer AS C ON JE.entity = C.id
            WHERE
                JE.type = 'Journal' AND JE.voided = 'F' AND JE.subsidiary = {SUBSIDIARY_ID}
                AND JEL.account = [Your Bad Debt Expense Account ID] -- Must configure your specific bad debt account
                AND AppliedTo.type = 'CustInvc'
                AND JE.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
                AND (JEL.memo LIKE '%' || AppliedTo.tranid || '%' OR JE.memo LIKE '%' || AppliedTo.tranid || '%') -- Best-effort link by checking memo field for invoice number
        """
    }

    for activity, query in queries.items():
        print(fclass="hl-string">"Fetching data for: {activity}...")
        results = execute_suiteql(query)
        if results:
            all_events.extend(results)
            print(fclass="hl-string">"  ...found {len(results)} events.")
        else:
            print(fclass="hl-string">"  ...no events found or an error occurred.")

    if not all_events:
        print(class="hl-string">"No data extracted. Exiting.")
        return

    class=class="hl-string">"hl-comment"># Convert to pandas DataFrame
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Data Cleaning and Formatting
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'])
    df.rename(columns=lambda c: class="hl-string">''.join(c.split()).capitalize(), inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'netsuite_collections_event_log.csv'
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"\nEvent log successfully saved to {output_file}")

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

Prêt à commencer ?

Utilisez ce modèle pour préparer vos données et mieux comprendre votre processus de gestion du crédit et de recouvrement. Commencez dès aujourd’hui à améliorer votre trésorerie.

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

Commencez dès aujourd’hui à optimiser la gestion du crédit et le recouvrement !

Repérez les inefficacités, réduisez le temps de cycle de 30 % et améliorez rapidement votre trésorerie.

Démarrez l’essai gratuit

Aucune carte bancaire requise. Configuration 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 des données des recherches enregistrées et des rapports NetSuite

Étapes

Configuration

a Exemple de requête sql

Extraction Python via les services Web NetSuite SuiteTalk

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Commencez dès aujourd’hui à 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 des données des recherches enregistrées et des rapports NetSuite

Étapes

Configuration

a Exemple de requête sql

Extraction Python via les services Web NetSuite SuiteTalk

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Commencez dès aujourd’hui à optimiser la gestion du crédit et le recouvrement !

Nous respectons votre vie privée

Prêt à commencer ?

Commencez dès aujourd’hui à optimiser la gestion du crédit et le recouvrement !