> Mejora continua de procesos > Gestión del crédito y cobros > HighRadius > Template de datos

Su Template de datos para la gestión de crédito y cobros

HighRadius

Atributos de gestión de crédito y cobros(21) Actividades de gestión de crédito y cobros(15) Guías de extracción(2)

Su Template de datos para la gestión de crédito y cobros

Este Template ofrece una guía estructurada para recopilar los datos necesarios para analizar el proceso de gestión de crédito y cobros. Incluye los atributos esenciales que debe registrar, las actividades clave que debe seguir y recomendaciones prácticas para extraer esta información de su sistema HighRadius. Con este Template, podrá preparar los datos de forma eficiente para Process Mining.

Atributos recomendados para recopilar
Actividades clave para dar visibilidad al proceso
Instrucciones de extracción específicas para HighRadius

¿Es nuevo en los registros de eventos? Aprenda a crear un Registro de eventos para Process Mining.

Descargar Template

Atributos de gestión de crédito y cobros

Estos son los campos de datos recomendados para incluir en su Registro de eventos y analizar en profundidad el proceso de gestión de crédito y cobros.

3 Obligatorio 7 Recomendado 11 Opcional

	Nombre	Descripción
	Hora del evento EventTime	Marca de tiempo que indica cuándo se produjo la actividad, con la fecha y la hora.
Descripción La hora del evento proporciona la fecha y la hora exactas de cada actividad del proceso. Estos datos cronológicos son la base de Process Mining: permiten ordenar correctamente los eventos y calcular el tiempo transcurrido entre ellos. Este atributo se utiliza para calcular todos los KPI basados en el tiempo, como los tiempos de ciclo de la resolución de disputas, la aprobación del crédito y el registro de pagos. También permite analizar el rendimiento del proceso a lo largo del tiempo, identificar las actividades que causan demoras y medir el cumplimiento de los acuerdos de nivel de servicio. Por qué es importante Aporta el contexto cronológico de todas las actividades, esencial para calcular los tiempos de ciclo, detectar cuellos de botella y entender la dinámica del proceso. Dónde obtenerlo Cada registro de transacción o registro de eventos de HighRadius debe tener una marca de tiempo correspondiente, a menudo denominada «Fecha de creación» o «Marca de tiempo». Ejemplos 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Nombre de la actividad ActivityName	Nombre del evento de negocio específico que se produjo en un momento determinado para una factura.
Descripción El nombre de la actividad describe un paso del proceso de gestión de crédito y cobros, como «Factura generada», «Recordatorio de pago vencido enviado» o «Pago recibido». La secuencia de actividades forma el flujo del proceso de cada caso. Analizar este atributo permite descubrir y visualizar el mapa real del proceso. Ayuda a identificar cuellos de botella, desviaciones respecto al procedimiento estándar y ciclos de retrabajo. La frecuencia y el orden de actividades como «Llamada de cobro registrada» o «Disputa registrada» son clave para entender la eficiencia del proceso. Por qué es importante Este atributo define los pasos del proceso y permite reconstruir y analizar el flujo de cada factura. Dónde obtenerlo Suele obtenerse de los registros de eventos, los cambios de estado o los registros de acciones específicas en los distintos módulos de la plataforma HighRadius. Ejemplos Factura enviada al clienteInicio del procedimiento de gestión de impagosPago recibidoDisputa resuelta
	Número de factura InvoiceNumber	Identificador único de cada factura, que sirve como identificador principal del caso en el proceso de crédito a cobro.
Descripción El número de factura es la clave central que vincula todas las actividades relacionadas con una única transacción de cuentas por cobrar. Permite seguir todo el ciclo de vida, desde la generación de la factura, pasando por las distintas actividades de gestión de crédito y cobros, hasta la liquidación final o la baja. En el análisis de Process Mining, este atributo es esencial para agrupar todos los eventos relacionados en un único caso. Así se pueden visualizar los flujos completos del proceso, calcular la duración de los casos, como los días pendientes de cobro (DSO), y analizar las distintas rutas que puede seguir una factura, por ejemplo, la resolución de disputas o los procedimientos de gestión de impagos. Por qué es importante Es el identificador fundamental que conecta todos los pasos del proceso y permite analizar el recorrido completo de una factura, desde su creación hasta su cierre. Dónde obtenerlo Es un campo principal de HighRadius que suele encontrarse en los objetos de datos principales de facturas o cuentas por cobrar. Ejemplos INV-2023-001239876543210SI-55482
	Condiciones de pago PaymentTerms	Las condiciones acordadas que establecen cuándo debe pagar el cliente una factura.
Descripción Las condiciones de pago especifican los términos, como «30 días netos», «60 días netos» o «Pago a la recepción». Este atributo sirve de base para calcular la fecha de vencimiento de la factura. Es un atributo clave para el Dashboard y el KPI de cumplimiento de las condiciones de pago. Su análisis ayuda a determinar si se aplican las condiciones estándar de forma coherente y qué condiciones se asocian con más retrasos en los pagos. Esta información puede orientar la política de crédito y las negociaciones con los clientes. Por qué es importante Establece el plazo previsto para el pago, por lo que es fundamental para calcular las fechas de vencimiento y medir si los clientes cumplen los acuerdos de pago. Dónde obtenerlo Suele encontrarse en la cabecera de la factura o en los datos maestros del cliente de HighRadius o del sistema ERP de origen. Ejemplos 30 días netos60 días netosPago a la recepción
	Estado del pago PaymentStatus	El estado financiero actual de la factura, por ejemplo, abierta, pagada, vencida o en disputa.
Descripción El estado del pago muestra en qué etapa del ciclo de vida se encuentra una factura. Indica si aún está pendiente de pago, si se ha pagado total o parcialmente, si ya venció o si está en revisión debido a una disputa. Este atributo es fundamental para el Dashboard de estado y antigüedad de los pagos de facturas. Permite segmentar rápidamente la cartera de cuentas por cobrar para conocer su situación financiera general y priorizar el cobro de las facturas vencidas o en disputa. Por qué es importante Agrupa las facturas en categorías que facilitan la acción, ofrece una visión inmediata del estado de las cuentas por cobrar y ayuda a priorizar las actividades de cobro. Dónde obtenerlo Es un campo de estado esencial del registro de facturas o de cuentas por cobrar en HighRadius. Ejemplos AbiertaPagadaVencidaEn disputaDada de baja
	Fecha de vencimiento DueDate	La fecha calculada en la que debe pagarse la factura.
Descripción La fecha de vencimiento es el día concreto en que debe pagarse una factura para que no se considere vencida. Suele calcularse a partir de la fecha de la factura y las condiciones de pago. Este atributo es fundamental para analizar las facturas vencidas. Es el dato principal para calcular los días de retraso, activar los procedimientos de reclamación de pagos y medir el KPI de tasa de cumplimiento de las condiciones de pago. También es clave para los Dashboards sobre antigüedad de facturas y eficacia de las reclamaciones. Por qué es importante Es la fecha clave para determinar si una factura se ha pagado a tiempo o está vencida, y activa las actividades de cobro y los KPI posteriores. Dónde obtenerlo Es un campo estándar del registro de facturas en HighRadius. Puede proceder del sistema ERP de origen o calcularse en HighRadius. Ejemplos 2023-04-142023-05-312023-06-20
	ID del cliente CustomerId	El identificador único del cliente asociado a la factura.
Descripción El ID del cliente vincula una factura con el cliente correspondiente. Esto permite agrupar y analizar los datos del proceso desde la perspectiva del cliente. Este atributo es esencial para analizar los hábitos de pago de distintos clientes o segmentos. Ayuda a responder preguntas como: ¿Qué clientes se retrasan con frecuencia? ¿Qué clientes presentan más disputas? También permite crear Dashboards como el de cumplimiento de las condiciones de pago y segmentar los KPI por cliente. Por qué es importante Permite analizar por cliente los hábitos de pago, la frecuencia de las disputas y la interacción general con el proceso, lo que ayuda a adaptar las estrategias de cobro. Dónde obtenerlo Es un campo estándar de la cabecera de la factura o de los datos de la cuenta del cliente en HighRadius. Ejemplos CUST-001ACME-CORPGLOBEX-US
	Importe de la factura InvoiceAmount	El importe monetario total de la factura.
Descripción Este atributo representa el importe total que debe pagarse por la factura. Es una métrica financiera clave para comprender el valor asociado a cada caso. En Process Mining, el importe de la factura se utiliza para priorizar las gestiones de cobro, por ejemplo, centrándose en las facturas vencidas de mayor importe. Es fundamental para calcular KPI financieros como los días pendientes de cobro (DSO) y se utiliza en el Dashboard de análisis de bajas de facturas para cuantificar el impacto financiero de las deudas incobrables. Por qué es importante Aporta el contexto financiero de cada caso y permite analizarlo según su valor, priorizar el trabajo y cuantificar impactos financieros como las bajas de facturas. Dónde obtenerlo Es un campo estándar de los datos de la cabecera de la factura en HighRadius. Ejemplos 5000.001250.7525000.50
	Motivo de la disputa DisputeReason	El código o la descripción del motivo que proporciona el cliente al disputar una factura.
Descripción Cuando un cliente presenta una disputa, suele indicar un motivo, como «Precio incorrecto», «Mercancía dañada» o «Factura duplicada». Este atributo registra ese motivo. Analizar los motivos de las disputas es clave para el Dashboard de tiempo de resolución de disputas de facturas. Ayuda a identificar las causas raíz y permite abordar problemas recurrentes en los precios, los envíos o la facturación. Reducir las disputas desde su origen puede acelerar considerablemente el flujo de caja. Por qué es importante Permite conocer las causas raíz de los retrasos en los pagos y realizar mejoras específicas en el proceso para prevenir futuras disputas. Dónde obtenerlo Esta información se registra en el módulo de gestión de disputas o deducciones de HighRadius cuando se notifica una disputa. Ejemplos Cantidad incorrectaDiscrepancia en el precioMercancía dañadaFacturación duplicada
	Nombre del gestor de cobros CollectorName	El nombre del usuario o agente responsable de realizar una actividad de cobro.
Descripción Este atributo identifica al agente de cobros, analista de crédito u otro usuario que realizó una actividad manual, como «Registrar llamada de cobro» o «Resolver disputa». El análisis permite comparar el desempeño de distintos gestores de cobros o equipos. Ayuda a comprender cómo se distribuye la carga de trabajo, evaluar la eficacia de las estrategias individuales, por ejemplo, la tasa de éxito de las llamadas de cobro por gestor, e identificar oportunidades de formación. También es clave para gestionar los recursos y planificar la capacidad. Por qué es importante Vincula las actividades del proceso con personas concretas y permite analizar el desempeño del equipo, la carga de trabajo y la eficacia de las intervenciones manuales. Dónde obtenerlo Esta información suele almacenarse en los registros de actividad o de acciones de usuario del módulo Collections de HighRadius. Ejemplos John SmithJane DoeEmily Jones
	Días de retraso DaysOverdue	El número de días que han transcurrido desde el vencimiento de una factura. Es cero si la factura aún no ha vencido o se pagó a tiempo.
Descripción Los días de retraso son una métrica calculada que mide la diferencia entre la fecha actual, en el caso de las facturas abiertas, o la fecha de pago, en el caso de las facturas pagadas, y la fecha de vencimiento de la factura. Es un indicador clave de morosidad. Este atributo es la base del Dashboard de estado y antigüedad de los pagos de facturas, donde se utiliza para agrupar las cuentas por cobrar en intervalos de antigüedad, por ejemplo, de 1 a 30 días o de 31 a 60 días. También forma parte del cálculo de los días pendientes de cobro (DSO) y ayuda a priorizar el cobro de las cuentas con más retraso. Por qué es importante Esta métrica cuantifica directamente los retrasos en los pagos, por lo que es esencial para analizar la antigüedad, priorizar los cobros y calcular los DSO. Dónde obtenerlo Este dato no se almacena en un campo. Se calcula durante la transformación de datos a partir de la fecha de vencimiento y la fecha de pago o la fecha actual. Ejemplos 1545092
	Es automatizada IsAutomated	Indicador booleano que señala si el sistema realizó una actividad automáticamente o si la realizó un usuario de forma manual.
Descripción Este atributo calculado distingue los eventos generados por el sistema, como el envío de un recordatorio de vencimiento mediante una ejecución automatizada de reclamación, de las acciones realizadas por una persona, como el registro de una llamada de cobro. Este indicador es fundamental para calcular el KPI de tasa de actividades de cobro automatizadas. Ayuda a medir el grado de automatización del proceso de cobro, detectar oportunidades para automatizarlo más y analizar la eficacia relativa de las acciones automatizadas y manuales. Por qué es importante Ayuda a medir el grado de automatización del proceso y permite analizar la eficiencia y la eficacia de los sistemas automatizados frente al trabajo manual. Dónde obtenerlo Se obtiene durante la transformación de datos. Para ello, se debe crear una asignación que, según el conocimiento del negocio, identifique como automatizados ciertos nombres de actividad. Ejemplos truefalse
	Fecha de promesa de pago PromiseToPayDate	La fecha en que el cliente se ha comprometido a pagar una factura vencida.
Descripción Cuando un gestor de cobros se pone en contacto con un cliente, puede obtener una promesa de pago, es decir, el compromiso del cliente de pagar antes de una fecha determinada. Este atributo registra la fecha prometida. Analizar estos datos es importante para evaluar la fiabilidad de las promesas de los clientes y la eficacia de los gestores de cobros al obtener compromisos firmes. Permite hacer un seguimiento de la tasa de promesas cumplidas, un indicador clave del desempeño del equipo de cobros. Por qué es importante Registra un resultado clave de las actividades de cobro y permite medir la eficacia del seguimiento y la fiabilidad de los compromisos de los clientes. Dónde obtenerlo Esta fecha se registra cuando se anota una actividad de promesa de pago en el módulo Collections de HighRadius. Ejemplos 2023-06-152023-07-012023-06-25
	Hora de finalización EndTime	La marca de tiempo que indica cuándo se completó una actividad.
Descripción La hora de finalización marca el cierre de una actividad. En el proceso de cobro, muchas actividades son eventos instantáneos en los que la hora de inicio coincide con la hora de finalización. Otras, como «Resolución de disputas», pueden tener una duración concreta. Cuando está disponible, este atributo se utiliza junto con la hora de inicio para calcular el tiempo de procesamiento de cada actividad. Así se identifican los pasos específicos que consumen más tiempo y recursos, no solo los intervalos entre ellos. Por qué es importante Permite medir con precisión la duración de cada actividad y ofrece una visión más detallada de cómo se distribuye el tiempo dentro del proceso. Dónde obtenerlo Consulte la documentación de HighRadius. Este dato puede estar disponible para ciertas actividades registradas que tienen un estado inicial y uno final. Ejemplos 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Moneda Currency	El código de moneda del importe de la factura.
Descripción Este atributo indica la moneda de la factura, por ejemplo, USD, EUR o JPY. Aporta el contexto necesario para interpretar importes como el de la factura. En una empresa multinacional, este campo es imprescindible para realizar análisis financieros precisos. Permite interpretar correctamente los importes y convertir las monedas de forma adecuada al agrupar datos para elaborar informes globales. Por qué es importante Es esencial para interpretar correctamente todos los importes y evitar cálculos e informes financieros inexactos en entornos con varias monedas. Dónde obtenerlo Es un campo estándar del registro de facturas, normalmente junto al importe de la factura. Ejemplos USDEURGBP
	Motivo de la baja WriteOffReason	El código o la explicación del motivo por el que una factura se dio de baja como deuda incobrable.
Descripción Cuando se determina que una factura no se puede cobrar, se da de baja. Este atributo registra el motivo, como «Quiebra del cliente», «Disputa sin resolver» o «Baja por importe reducido». Es un atributo clave para el Dashboard de análisis de bajas de facturas. Ayuda a analizar las causas raíz de las pérdidas financieras y aporta información que puede utilizarse para ajustar las políticas de crédito, mejorar la gestión de disputas o adaptar las estrategias de cobro y reducir futuras bajas. Por qué es importante Explica los motivos de la pérdida de ingresos y aporta retroalimentación clave para mejorar la evaluación del riesgo crediticio y las políticas de cobro. Dónde obtenerlo Esta información se registra al procesar una actividad de factura dada de baja, normalmente en el módulo financiero o de cobros de HighRadius. Ejemplos QuiebraVencimiento del plazo de prescripciónEl coste del cobro supera la deuda
	Nivel de reclamación DunningLevel	La etapa o el nivel alcanzado en el proceso automatizado de reclamación de pagos de una factura vencida.
Descripción El nivel de reclamación indica la intensidad de las gestiones de cobro y suele corresponder a una secuencia de recordatorios o avisos automáticos enviados al cliente. Por ejemplo, el nivel 1 puede ser un recordatorio cordial y el nivel 3, un aviso final. Este atributo es esencial para el Dashboard de eficacia de la estrategia de reclamación. Al analizar qué niveles suelen dar lugar al pago, las empresas pueden optimizar sus flujos de trabajo de reclamación para que sean eficaces sin resultar demasiado insistentes ni perjudicar la relación con los clientes. Por qué es importante Registra cómo se intensifican las actividades de cobro y permite analizar qué estrategias de reclamación son más eficaces para conseguir el pago. Dónde obtenerlo Es un campo de estado que gestiona el motor automatizado de cobros o de reclamación de pagos de HighRadius. Ejemplos 123 - Aviso finalGestión de cobros legales
	País Country	El país del cliente asociado a la factura.
Descripción Este atributo indica el país donde se encuentra el cliente. Permite segmentar geográficamente el proceso de crédito y cobro. El análisis de los datos por país puede revelar diferencias regionales en los hábitos de pago, la eficacia de las estrategias de cobro y los motivos habituales de disputa. Esta información es esencial para adaptar las políticas regionales y elaborar informes de gestión de alto nivel en organizaciones globales. Por qué es importante Permite realizar análisis geográficos, detectar tendencias regionales en los hábitos de pago y adaptar las estrategias de cobro en consecuencia. Dónde obtenerlo Esta información forma parte de los datos maestros del cliente, que suelen estar disponibles en HighRadius o sincronizarse desde un sistema ERP de origen. Ejemplos USAAlemaniaBrasil
	Sistema de origen SourceSystem	Sistema del que proceden los datos.
Descripción Este atributo identifica el sistema de origen donde se generaron los datos del evento. En esta vista del proceso, el valor suele ser «HighRadius». En entornos con varios sistemas, este campo es clave para entender el linaje de los datos y rastrear la información hasta su origen. Ayuda a distinguir los procesos que abarcan distintas plataformas, como un ERP y una herramienta especializada de cobros. Por qué es importante Aclara el origen de los datos, algo importante para la gobernanza de datos, la validación y la comprensión del entorno tecnológico del proceso. Dónde obtenerlo Suele ser un valor estático que se añade durante la extracción y transformación de los datos para identificar el conjunto de datos. Ejemplos HighRadiusHighRadius-CobrosHighRadius-AplicaciónDeEfectivo
	Última actualización de datos LastDataUpdate	La marca de tiempo que indica cuándo se actualizaron por última vez los datos de este registro desde el sistema de origen.
Descripción Este atributo indica la antigüedad de los datos. Registra la fecha y hora de la última extracción o actualización de datos desde HighRadius. En el análisis, este campo aporta contexto sobre la actualidad de la información obtenida. Es fundamental que los Dashboards y los informes indiquen qué tan actualizada está la información, para que las decisiones empresariales se basen en datos recientes. Por qué es importante Aporta transparencia sobre la actualidad de los datos, algo fundamental para generar confianza en el análisis y tomar decisiones fundamentadas. Dónde obtenerlo La canalización de ingesta de datos genera esta marca de tiempo y la añade a cada registro durante el proceso de extracción. Ejemplos 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Unidad de negocio BusinessUnit	La unidad de negocio o división interna responsable de la venta o la factura.
Descripción El atributo Unidad de negocio asigna la factura a una parte concreta de la organización, como «Venta minorista», «Venta mayorista» o «Servicios». Esto permite desglosar el análisis del desempeño por segmento de negocio. La dirección puede comparar KPI como los días pendientes de cobro (DSO), las tasas de disputas y las bajas de facturas entre unidades de negocio para identificar las áreas con mejores resultados y las que necesitan mejorar. También ayuda a que cada parte de la organización asuma la responsabilidad de sus resultados en las cuentas por cobrar. Por qué es importante Permite comparar el desempeño de distintas partes de la organización e identificar qué divisiones tienen procesos de crédito a cobro más eficaces. Dónde obtenerlo Son datos de la organización que suelen encontrarse en la factura o derivarse del pedido de venta o de la cuenta del cliente asociada en HighRadius o en el sistema ERP. Ejemplos BU-North AmericaDivisión de serviciosFabricación

Obligatorio Recomendado Opcional

Actividades de gestión de crédito y cobros

Estos son los pasos y los hitos clave que debe registrar en su Registro de eventos para descubrir y analizar con precisión el proceso de gestión de crédito y cobros.

7 Recomendado 8 Opcional

	Actividad	Descripción
	Disputa registrada	Esta actividad marca el momento en que un cliente impugna una factura o solicita una deducción, que luego se registra formalmente en HighRadius. Esto detiene el proceso habitual de cobros por el importe impugnado.
Por qué es importante Este es el evento de inicio para medir el tiempo medio de resolución de disputas. Identificar cuándo y por qué se presentan disputas es clave para abordar causas raíz, como errores de facturación o problemas de envío. Dónde obtenerlo Este evento se registra cuando un usuario crea un caso de disputa vinculado a una factura en Deductions Cloud de HighRadius. La acción genera un registro de disputa con marca de tiempo. Capturar Se registra a partir de la marca de tiempo de creación del caso de disputa asociado a la factura. Tipo de evento explicit
	Disputa resuelta	Representa la conclusión del proceso de gestión de disputas, una vez investigado el problema y alcanzada una resolución. La factura puede continuar hacia el pago o darse de baja.
Por qué es importante Este es el evento de fin para medir el tiempo medio de resolución de disputas. Los ciclos prolongados pueden retrasar considerablemente el cobro y señalar ineficiencias en el proceso. Dónde obtenerlo Se registra cuando el estado del caso de disputa cambia a «Resuelto», «Cerrado» o un estado final similar. La marca de tiempo de este cambio se utiliza para la actividad. Capturar Se infiere a partir de la marca de tiempo en que el estado del caso de disputa se actualiza al estado final «Resuelto». Tipo de evento inferred
	Factura dada de baja	Representa un final alternativo del ciclo de vida de la factura: la deuda se considera incobrable y se da de baja como deuda incobrable. Es un resultado no deseado.
Por qué es importante Registrar las bajas es fundamental para calcular la tasa de facturas dadas de baja y analizar las causas raíz de las pérdidas financieras. Ayuda a identificar fallos en la evaluación del crédito o en las gestiones de cobro. Dónde obtenerlo Este evento se registra cuando se contabiliza una transacción específica para dar de baja el saldo de la factura o cuando su estado cambia a «Dada de baja». Capturar Se infiere a partir de un cambio de estado a «Dada de baja» o de la contabilización de un tipo de transacción específico de baja contra la factura. Tipo de evento inferred
	Factura generada	Este es el punto de partida del ciclo de vida de una factura en el proceso de cobros. Indica que la factura se ha creado en el sistema ERP y se ha importado a HighRadius para gestionar las cuentas por cobrar.
Por qué es importante Esta actividad es el evento de inicio principal para analizar el proceso de factura a cobro. Los tiempos de ciclo, como los días pendientes de cobro (DSO), suelen medirse a partir de este momento. Dónde obtenerlo Este evento explícito se registra a partir de la fecha de creación de la factura en HighRadius, que normalmente se sincroniza desde el sistema ERP de origen, como SAP u Oracle. Capturar Se registra a partir de la marca de tiempo de creación de la factura en los datos de cuentas por cobrar. Tipo de evento explicit
	Factura liquidada	Esta actividad indica que el ciclo de vida de la factura ha concluido correctamente: está pagada en su totalidad y cerrada. Es el estado final deseado del proceso.
Por qué es importante Este es el evento de fin principal de la ruta ideal del proceso. Analizar las rutas que conducen a este resultado ayuda a identificar buenas prácticas y estrategias de cobro eficaces. Dónde obtenerlo Por lo general, no es un evento explícito, sino que se infiere cuando el estado de la factura cambia a «Cerrado» o «Compensado» y el saldo llega a cero. La marca de tiempo del registro del pago final suele utilizarse como hora del evento. Capturar Se infiere cuando el estado de la factura cambia a «Cerrado» o cuando el campo del saldo de la factura llega a cero. Tipo de evento inferred
	Pago recibido	Esta actividad marca la recepción del pago de un cliente, que suele registrarse a partir de un extracto bancario o un archivo de lockbox. Indica que se han recibido los fondos, pero aún no se han aplicado a una factura concreta.
Por qué es importante Este es un hito clave que suele detener el cómputo del tiempo de cobro. Es el punto de partida para medir el KPI del retraso entre la recepción y el registro del pago, que permite detectar demoras en la aplicación del efectivo. Dónde obtenerlo Se registra a partir de los datos de pago de Cash Application Cloud de HighRadius. Cada lote de pagos o transacción procedente de un archivo bancario tiene una fecha de recepción. Capturar Se registra a partir de la marca de tiempo del registro de pago cuando se importa o se introduce en el módulo de aplicación de efectivo. Tipo de evento explicit
	Vencimiento de la fecha de pago	Evento calculado que se produce cuando la fecha actual supera la fecha de vencimiento de la factura. Esta actividad no representa una acción de un usuario o del sistema, sino un cambio de estado clave que activa el proceso de cobros.
Por qué es importante Esta actividad es el principal desencadenante de las actividades posteriores de gestión de impagos y cobros. Permite distinguir las facturas pagadas a tiempo de las vencidas y analizar la eficacia de las estrategias de cobro. Dónde obtenerlo Este evento no se almacena directamente. Se calcula comparando el campo de fecha de vencimiento de la factura con la marca de tiempo de otros eventos. Se obtiene durante la transformación de los datos para Process Mining. Capturar Se calcula comparando due_date de la factura con la fecha actual o la marca de tiempo del evento (Timestamp > Due Date). Tipo de evento calculated
	Compromiso de pago creado	Esta actividad se produce cuando un cliente se compromete a pagar una factura en una fecha futura y la persona responsable de los cobros registra el compromiso en el sistema. Es un resultado intermedio positivo.
Por qué es importante Registrar los compromisos de pago ayuda a prever el flujo de caja y evaluar la eficacia del equipo de cobros. También permite analizar los compromisos incumplidos, cuando el pago no se recibe en la fecha acordada. Dónde obtenerlo Este evento explícito se registra en HighRadius cuando una persona del equipo crea un registro de «Compromiso de pago» vinculado a una factura. El registro tiene su propia marca de tiempo de creación. Capturar Se registra a partir de la marca de tiempo de creación del objeto «Compromiso de pago» en HighRadius. Tipo de evento explicit
	Factura enviada al cliente	Esta actividad marca el momento en que se entrega la factura al cliente, normalmente por correo electrónico o a través de un portal. HighRadius puede automatizar y registrar esta comunicación.
Por qué es importante El seguimiento de esta actividad ayuda a garantizar que los clientes reciban las facturas a tiempo. Las demoras entre la generación y el envío de una factura pueden afectar directamente al tiempo de pago y a los días pendientes de cobro (DSO). Dónde obtenerlo A menudo, este evento se registra explícitamente en el historial de comunicaciones o actividades asociado a la factura en el módulo Collections Cloud. También puede inferirse a partir del estado de un proceso automatizado de envío de comunicaciones. Capturar Se registra en el historial de comunicaciones de la factura cuando se envía un correo electrónico o se entrega a través del portal. Tipo de evento explicit
	Inicio del procedimiento de gestión de impagos	Esta actividad indica el inicio de un procedimiento formal de gestión de impagos o de un nivel específico de dicho procedimiento para una factura vencida. Es un paso más sistemático que el envío de un único recordatorio.
Por qué es importante Registrar el inicio de los procedimientos de gestión de impagos ayuda a analizar la eficacia de las distintas estrategias y niveles de cobro para conseguir que se realice el pago. Dónde obtenerlo Este evento suele inferirse a partir de un cambio en el campo «Nivel de gestión de impagos» o «Estrategia de cobro» asociado al registro de la factura en HighRadius. Capturar Se infiere a partir de un cambio en el atributo del nivel de gestión de impagos de la factura, registrado en los registros de cambios o en el historial con marcas de tiempo. Tipo de evento inferred
	Límite de crédito aprobado	Representa la finalización satisfactoria de la revisión del crédito, cuando se concede oficialmente un límite de crédito al cliente. Este evento queda registrado cuando una persona responsable de la gestión de crédito aprueba la solicitud en la plataforma HighRadius.
Por qué es importante Este hito clave permite continuar con el proceso de ventas. Registrar esta actividad es esencial para calcular el KPI del tiempo total del ciclo de aprobación del crédito. Dónde obtenerlo Este evento suele registrarse cuando cambia el estado de la solicitud de límite de crédito a «Aprobado». También puede aparecer como evento explícito en el registro de auditoría del sistema. Capturar Se infiere a partir de un cambio de estado de la solicitud de crédito a «Aprobado» o del campo de marca de tiempo de aprobación. Tipo de evento inferred
	Límite de crédito solicitado	Esta actividad marca el inicio de la evaluación del crédito de un cliente. Suele activarse antes de finalizar un pedido de venta y queda registrada cuando se introduce en el sistema una solicitud de límite de crédito nuevo o actualizado.
Por qué es importante Analizar el tiempo transcurrido entre la solicitud y la aprobación ayuda a identificar cuellos de botella en la incorporación de clientes y en el ciclo de ventas. Es un punto de partida clave para medir la eficiencia del equipo de gestión de crédito. Dónde obtenerlo Es probable que este evento se infiera a partir de un cambio de estado en el perfil de crédito del cliente o de la fecha de creación de un registro de solicitud de límite de crédito en el módulo de gestión de crédito de HighRadius. Capturar Se infiere a partir de la marca de tiempo de creación de una solicitud de límite de crédito o de un cambio de estado a «Pendiente de aprobación». Tipo de evento inferred
	Llamada de cobro registrada	Representa una llamada manual de cobro que una persona del equipo de cobros realiza al cliente por una factura vencida. El equipo registra los detalles y el resultado de la llamada directamente en HighRadius.
Por qué es importante Esta actividad es clave para evaluar la tasa de éxito de las llamadas de cobro y la eficiencia de las actividades de cobro. Ayuda a distinguir las gestiones de cobro automatizadas de las manuales. Dónde obtenerlo Este evento explícito se crea cuando una persona del equipo de cobros utiliza la función «Registrar llamada» o «Añadir actividad» en la factura o la cuenta del cliente en la interfaz de HighRadius. La entrada incluye una marca de tiempo. Capturar Se registra a partir de la tabla del historial de actividades, donde se anotan las acciones manuales del equipo de cobros. Tipo de evento explicit
	Pago registrado	Representa la finalización del proceso de aplicación de efectivo: el pago recibido se ha conciliado correctamente y aplicado a una factura concreta, cuyo saldo pendiente queda así liquidado.
Por qué es importante Esta actividad concluye el ciclo de procesamiento del pago. El tiempo transcurrido entre «Pago recibido» y «Pago registrado» muestra la eficiencia del proceso de aplicación de efectivo. Dónde obtenerlo Este evento se registra a partir del campo de fecha de contabilización o fecha de compensación de la factura. La marca de tiempo se registra cuando finaliza la aplicación de efectivo. Capturar Se registra a partir de la marca de tiempo de «fecha de contabilización» o «fecha de compensación» de la partida contable de la factura. Tipo de evento explicit
	Recordatorio de pago vencido enviado	Representa un recordatorio, manual o automatizado, enviado al cliente por una factura vencida. HighRadius automatiza esta actividad como parte de sus estrategias de gestión de impagos y registra la comunicación.
Por qué es importante Esta actividad es fundamental para medir la tasa de eficacia de la gestión de impagos. Permite analizar cuántos recordatorios se necesitan antes de recibir un pago. Dónde obtenerlo Este evento explícito se registra en el historial de actividades o comunicaciones de la factura en Collections Cloud de HighRadius. Cada recordatorio enviado tiene su correspondiente entrada y marca de tiempo. Capturar Se registra a partir de la marca de tiempo del historial de comunicaciones asociado a la factura. Tipo de evento explicit

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de HighRadius

Pasos

Acceda al módulo de informes y análisis: Inicie sesión en su instancia de HighRadius con una cuenta que tenga los permisos necesarios para crear y ejecutar informes personalizados. Vaya a la sección de informes y análisis desde el Dashboard principal o el menú de la aplicación.
Cree un informe personalizado: Inicie el proceso para crear un informe. Seleccione un objeto base que sirva como referencia principal para los datos, como el objeto Facturas o Open A/R. Asigne al informe un nombre descriptivo, por ejemplo, ProcessMind_Credit_Collections_Log.
Defina los atributos principales de las facturas: Añada al diseño del informe los campos principales de las facturas. Incluya InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate y PaymentStatus. Estos serán las columnas base de cada evento.
Añada datos de objetos relacionados (eventos): Este es el paso más importante. Deberá combinar datos de distintos objetos de HighRadius para registrar las 15 actividades requeridas. Use las funciones del generador de informes para añadir fuentes de datos relacionadas. Para cada actividad, cree un conjunto de columnas que represente los detalles del evento.
Estructure el informe en formato de Registro de eventos: Configure el informe para que genere una fila por evento. Por lo general, esto requiere unir distintos bloques de datos en lugar de combinarlos como columnas. En cada bloque unido, asigne el campo de fecha correspondiente a una columna común EventTime e indique el valor correspondiente de ActivityName.
Configure el evento «Payment Due Date Passed»: Este evento es condicional. Cree un bloque de datos específico para las facturas cuya DueDate ya haya pasado y cuyo PaymentStatus siga siendo 'Open' o 'Overdue'. Para estos registros, establezca ActivityName en 'Payment Due Date Passed' y use la propia DueDate como EventTime.
Añada información sobre cobros y disputas: Asegúrese de incluir datos de los módulos de cobros y disputas. Combine objetos como CollectorNotes o ActivityHistory para obtener CollectorName. Cuando corresponda, combine el objeto Disputas para recuperar DisputeReason.
Establezca filtros para el informe: Aplique filtros para definir el alcance de la extracción. Establezca un intervalo de fechas específico para EventTime, por ejemplo, los últimos 6 meses, para mantener un volumen de datos manejable. Según la estructura de su organización, también puede necesitar filtrar por códigos de empresa o unidades de negocio.
Ejecute y revise el informe: Ejecute el informe para obtener una vista previa de los datos. Compruebe que la estructura coincida con el formato requerido del Registro de eventos, con una fila por actividad y columnas para InvoiceNumber, ActivityName, EventTime y otros atributos.
Exporte los datos del informe: Cuando la vista previa sea correcta, exporte el informe completo. Seleccione CSV como formato de exportación, ya que las herramientas de Process Mining pueden incorporar este formato fácilmente. Asegúrese de que la exportación use la codificación UTF-8 para evitar problemas con los caracteres.
Revise los datos por última vez: Abra el archivo CSV exportado en una aplicación de hojas de cálculo. Antes de cargarlo en ProcessMind, compruebe que estén presentes las 15 actividades, que las marcas de tiempo tengan el formato correcto y que los atributos clave estén completos.

Configuración

Tipo de informe: Informe personalizado que combina datos de varios módulos. Según la versión de HighRadius, puede denominarse 'Joined Report' o requerir varios bloques de datos unidos entre sí.
Objeto de datos principal: Use el objeto Facturas o Accounts Receivable como base del informe.
Objetos de datos secundarios: Deberá vincular objetos adicionales, como CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase y CashApplication.
Filtro de intervalo de fechas: Aplique un filtro al campo principal de marca de tiempo del evento. Se recomienda extraer datos de un periodo de 3 a 6 meses para equilibrar el nivel de detalle y el rendimiento. Por ejemplo, EventTime dentro de los últimos 180 días.
Filtros de estado: Considere excluir estados de factura que no sean pertinentes, como 'Cancelled' o 'Draft', salvo que formen parte del proceso que desea analizar.
Permisos: La cuenta que ejecute el informe debe tener acceso de lectura a todos los módulos pertinentes, incluidos Crédito, Cobros, Disputas y Aplicación de pagos, para garantizar que se extraiga el conjunto completo de datos.

Consulta de ejemplo 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
  }
}

Pasos

Requisitos previos: Asegúrese de tener instalada la versión 3.6 o posterior de Python, junto con las bibliotecas pandas y requests. Puede instalarlas con pip: pip install pandas requests. También debe solicitar a su administrador de HighRadius las credenciales de API (Client ID y Client Secret) con acceso de lectura a los objetos de datos necesarios, como facturas, cobros, disputas y pagos.
Inicialice el script: Cree un archivo de script de Python, por ejemplo, extract_hr_data.py. Empiece importando las bibliotecas necesarias (requests, pandas, datetime) y definiendo constantes de marcador de posición para la URL base de la API de HighRadius, las credenciales de cliente y el intervalo de fechas de extracción.
Implemente la autenticación: Escriba una función para gestionar la autenticación. Esta función recibirá su Client ID y Client Secret, enviará una solicitud POST al endpoint de autenticación de HighRadius (por ejemplo, /auth/v1/token) y obtendrá un token de portador. Este token se incluirá en el encabezado de todas las solicitudes de datos posteriores.
Obtenga los datos principales de las facturas: Desarrolle una función para consultar el endpoint principal de facturas (por ejemplo, /invoices/v1/search). La función debe gestionar la paginación para recuperar todos los registros del intervalo de fechas especificado. Debe llamar a la API de forma iterativa y recopilar los datos de las facturas hasta que no queden más páginas. Guarde estos datos principales en una lista de diccionarios.
Obtenga datos de objetos relacionados: Cree funciones de recuperación de datos independientes para cada entidad principal, como disputas, notas de cobro y pagos. Estas funciones consultarán sus respectivos endpoints (por ejemplo, /disputes/v1/search, /collections/v1/notes, /cashapp/v1/payments) y deberán recuperar de forma eficiente todos los datos pertinentes al periodo especificado. Por lo general, es mejor obtener estos conjuntos de datos en bloque que consultar una factura cada vez.
Estructure el Registro de eventos: Inicialice una lista vacía para almacenar todas las filas del Registro de eventos. El script recorrerá los datos obtenidos y transformará cada acción pertinente o cambio de estado en un diccionario estandarizado que represente una fila de evento. Cada diccionario debe incluir las claves InvoiceNumber, ActivityName, EventTime y todos los demás atributos requeridos.
Genere eventos del ciclo de vida de las facturas: Recorra la lista principal de facturas. Para cada una, cree eventos de 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' y 'Invoice Written Off' a partir de la fecha de creación, los registros de correspondencia, la fecha de cierre y los campos de estado. Guárdelos como diccionarios de eventos.
Calcule «Payment Due Date Passed»: En el mismo recorrido de facturas, añada la lógica para crear un evento 'Payment Due Date Passed'. Se trata de un evento calculado. La lógica debe comprobar si ya pasó la fecha de vencimiento de la factura, si aún no se ha pagado y si todavía no se ha generado este evento para ella. La fecha de vencimiento debe usarse como EventTime de esta actividad.
Genere eventos de cobros y disputas: Procese los datos obtenidos de los endpoints de cobros y disputas. Para cada nota, promesa de pago, acción de cobro o registro de disputa, cree las filas correspondientes en el Registro de eventos ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Asigne al registro del evento los detalles pertinentes, como CollectorName y DisputeReason.
Genere eventos de pago: Procese los datos de pago del módulo de aplicación de pagos. Cree eventos 'Payment Received' a partir de la fecha de creación del pago o de la fecha del extracto bancario, y eventos 'Payment Posted' a partir de la fecha en que el pago se aplicó correctamente a la factura.
Consolide y dé formato a los datos: Después de procesar todas las fuentes de datos y generar los eventos, convierta la lista de diccionarios de eventos en un DataFrame de pandas. Así podrá ordenar los datos y convertir sus tipos con facilidad. Asegúrese de que la columna EventTime use un formato de marca de tiempo uniforme (YYYY-MM-DD HH:MI:SS).
Exporte a CSV: Use la función to_csv de pandas para exportar el DataFrame final a un archivo CSV. Asígnele un nombre claro, por ejemplo, highradius_event_log.csv. Establezca el parámetro index=False para evitar que el índice del DataFrame se escriba como columna. El archivo estará listo para cargarse en ProcessMind.

Configuración

Credenciales de API: Se requiere un usuario de API dedicado con Client ID y Client Secret. Debe tener permisos de lectura para todos los endpoints pertinentes, incluidos los de facturas, clientes, actividades de cobro, disputas y aplicación de pagos.
Intervalo de fechas: El script de Python incluye las variables START_DATE y END_DATE. Es fundamental establecer un intervalo de fechas concreto y razonable, por ejemplo, de 3 a 6 meses, para limitar el volumen de datos y evitar que el script tarde demasiado en ejecutarse. Aplique el filtro a un campo de fecha indexado, como la fecha de creación o modificación de la factura.
URL de los endpoints: Las rutas específicas de los endpoints de API (por ejemplo, /invoices/v1/search) son marcadores de posición. Debe confirmar las URL correctas en la documentación de API de HighRadius de su organización.
Parámetros de paginación: El script debe gestionar correctamente el mecanismo de paginación de la API. Por lo general, esto implica usar los parámetros limit y offset o un enfoque basado en cursores. Un tamaño de página de entre 100 y 500 suele ser un buen punto de partida.
Entorno: Ejecute el script en un entorno estable con memoria suficiente para gestionar los DataFrames, sobre todo si las extracciones son grandes. Para extracciones a escala de producción, es preferible ejecutarlo en un servidor en lugar de un equipo local.
Campos personalizados: Si su proceso depende de campos personalizados de HighRadius, deberá modificar el script para consultarlos e incluirlos en los resultados.

Consulta de ejemplo 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()

¿Todo listo para comenzar?

Este Template le proporciona la base de datos estructurada que necesita para obtener información detallada sobre el proceso de gestión de crédito y cobros. Empiece hoy a optimizar las operaciones de HighRadius para acelerar el flujo de caja.

Volver a la guía de mejora

Descargar Template

Empiece a optimizar la gestión de crédito y cobros

Elimine cuellos de botella, reduzca el tiempo de ciclo un 30 % y aumente la eficiencia.

Comience su prueba gratuita

No se requiere tarjeta de crédito. Comience en unos minutos.

Su Template de datos para la gestión de crédito y cobros

Su Template de datos para la gestión de crédito y cobros

Atributos de gestión de crédito y cobros

Actividades de gestión de crédito y cobros

Guías de extracción

Exportación desde el módulo de informes y análisis de HighRadius

Pasos

Configuración

Consulta de ejemplo sql

Extracción mediante scripts de Python y las API REST de HighRadius

Pasos

Configuración

Consulta de ejemplo python

¿Todo listo para comenzar?

Empiece a optimizar la gestión de crédito y cobros