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

Su Template de datos de Credit Management & Collections

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 de Credit Management & Collections

Esta plantilla ofrece una guía estructurada para recopilar los datos necesarios para analizar su proceso de Credit Management & Collections. Describe los atributos esenciales que debe capturar y las actividades clave que debe supervisar, además de proporcionar orientación práctica sobre cómo extraer esta información de su sistema HighRadius. El uso de esta plantilla le ayudará a preparar sus datos de forma eficiente para Process Mining.

Atributos recomendados para recopilar
Actividades clave que debe supervisar para obtener visibilidad del proceso
Guía de extracción específica para HighRadius

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

Descargar Template

Atributos de gestión de crédito y cobros

Estos son los campos de datos recomendados que debe incluir en su registro de eventos para analizar exhaustivamente su 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, incluida 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 del process mining, ya que permiten ordenar correctamente los eventos y calcular la duración 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 de créditos y el registro de pagos. También se utiliza para analizar el rendimiento del proceso a lo largo del tiempo, identificar las actividades que provocan demoras y medir el cumplimiento de los acuerdos de nivel de servicio. Por qué es importante Proporciona el contexto cronológico de todas las actividades, algo esencial para calcular los tiempos de ciclo, descubrir cuellos de botella y comprender la dinámica del proceso. Dónde obtenerlo Cada registro transaccional o registro de eventos de HighRadius debería tener un campo de marca de tiempo correspondiente, a menudo denominado «Creation Date» o «Timestamp». Ejemplos 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Nombre de la actividad ActivityName	Nombre del evento empresarial 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 crédito y cobros, como «Factura generada», «Recordatorio de vencimiento enviado» o «Pago recibido». Esta 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 fundamentales para comprender la eficiencia del proceso. Por qué es importante Este atributo define los pasos del proceso y permite reconstruir y analizar el flujo del proceso para cada factura. Dónde obtenerlo Normalmente se deriva de registros de eventos, cambios de estado o registros de acciones específicas dentro de los distintos módulos de la plataforma HighRadius. Ejemplos Factura enviada al clienteProcedimiento de gestión de cobros iniciadoPago recibidoDisputa resuelta
	Número de factura InvoiceNumber	Identificador único de cada factura, que actúa como identificador principal del caso para el proceso de credit-to-cash.
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 hacer seguimiento de 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 contable. En el análisis de process mining, este atributo es esencial para agrupar todos los eventos relacionados en un único caso. Esto permite visualizar los flujos del proceso de principio a fin, calcular la duración de los casos, como los días de ventas pendientes de cobro (DSO), y analizar las distintas rutas que puede seguir una factura, como la resolución de disputas o los procedimientos de gestión de cobros. 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 normalmente se encuentra 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 se espera que el cliente pague una factura.
Descripción Las condiciones de pago especifican los términos, como «Neto 30», «Neto 60» o «Pago contra entrega». Este atributo sirve de base para calcular la fecha de vencimiento de la factura. Es un atributo clave para el panel y el KPI «Adherencia a las condiciones de pago». Su análisis ayuda a identificar si las condiciones estándar se aplican de forma coherente y qué condiciones se asocian con mayores tasas de retraso. Esta información puede orientar la política de crédito y las negociaciones con clientes. Por qué es importante Establece el plazo de pago esperado, por lo que es fundamental para calcular las fechas de vencimiento y medir el cumplimiento de los acuerdos de pago por parte de los clientes. Dónde obtenerlo Normalmente se encuentra en la cabecera de la factura o en los datos maestros del cliente en HighRadius o en el ERP de origen. Ejemplos Neto a 30 díasNeto a 60 díasVencimiento al recibir
	Estado del pago PaymentStatus	El estado financiero actual de la factura, como abierta, pagada, vencida o en disputa.
Descripción El estado del pago ofrece una visión del punto en el que se encuentra una factura dentro de su ciclo de vida. Indica si aún está pendiente de pago, si se ha pagado total o parcialmente, si ha superado la fecha de vencimiento o si está siendo investigada debido a una disputa. Este atributo es fundamental para el panel «Estado y antigüedad de los pagos de facturas». Permite segmentar rápidamente la cartera de cuentas por cobrar para comprender su salud financiera general y priorizar los esfuerzos de cobro sobre las partidas vencidas o en disputa. Por qué es importante Clasifica las facturas en grupos que permiten actuar, ofrece visibilidad inmediata sobre el estado de las cuentas por cobrar y ayuda a priorizar las actividades de cobro. Dónde obtenerlo Es un campo de estado principal del registro de la factura o de cuentas por cobrar en HighRadius. Ejemplos AbiertaPagadaVencidaDisputadaDada de baja
	Fecha de vencimiento DueDate	La fecha calculada en la que vence el pago de la factura.
Descripción Due Date es la fecha concreta del calendario en la que debe pagarse una factura para evitar que se considere vencida. Normalmente se calcula a partir de la fecha de la factura y las condiciones de pago. Este atributo es fundamental para cualquier análisis de vencimientos. Es el dato principal para calcular 'Days Overdue', activar los procedimientos de reclamación y medir el KPI 'Payment Terms Adherence Rate'. También permite analizar Dashboards relacionados con la antigüedad de las facturas y la eficacia de las reclamaciones. Por qué es importante Es la fecha crítica que determina si una factura se ha pagado a tiempo o está vencida, y activa todas las actividades y KPI posteriores de cobro. Dónde obtenerlo Es un campo estándar del registro de facturas en HighRadius. Puede completarse desde el ERP de origen o calcularse en HighRadius. Ejemplos 2023-04-142023-05-312023-06-20
	ID de cliente CustomerId	El identificador único del cliente asociado a la factura.
Descripción Customer ID vincula una factura con la entidad de cliente correspondiente. Esto permite agregar y analizar los datos del proceso desde una perspectiva centrada en el cliente. Este atributo es esencial para analizar los comportamientos de pago de distintos clientes o segmentos de clientes. Ayuda a responder preguntas como: ¿Qué clientes se retrasan con frecuencia? ¿Qué clientes presentan más disputas? Es compatible con Dashboards como Payment Terms Adherence y permite segmentar los KPI por cliente. Por qué es importante Permite analizar a nivel de cliente el comportamiento 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 valor monetario total de la factura.
Descripción Este atributo representa el importe total adeudado en la factura. Es una métrica financiera fundamental para comprender el valor asociado a cada caso. En Process Mining, el importe de la factura se utiliza para priorizar los esfuerzos de cobro, por ejemplo, centrándose en las facturas vencidas de mayor valor. Es fundamental para KPI financieros como los días de ventas pendientes de cobro (DSO) y se utiliza en el panel Análisis de cancelaciones de facturas para cuantificar el impacto financiero de las deudas incobrables. Por qué es importante Proporciona el contexto financiero de cada caso, lo que permite analizar y priorizar el trabajo según el valor y cuantificar impactos financieros como las cancelaciones. 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 proporcionado cuando un cliente disputa una factura.
Descripción Cuando un cliente presenta una disputa, normalmente proporciona un motivo, como «Precio incorrecto», «Mercancía dañada» o «Factura duplicada». Este atributo registra dicho motivo. Analizar el motivo de la disputa es clave para el panel «Tiempo de resolución de disputas de facturas». Ayuda a identificar las causas raíz de las disputas, lo que permite abordar problemas sistémicos de precios, envíos o facturación. Reducir las disputas desde su origen puede acelerar considerablemente el flujo de caja. Por qué es importante Ofrece información sobre las causas raíz de los retrasos en los pagos y permite introducir mejoras específicas para evitar 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 registra una disputa. Ejemplos Cantidad incorrectaDiferencia de precioMercancía dañadaFacturación duplicada
	Nombre del cobrador 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 ejecutó una actividad manual, como «Llamada de cobro registrada» o «Disputa resuelta». En el análisis, permite comparar el rendimiento de distintos cobradores o equipos. Ayuda a comprender la distribución de la carga de trabajo, evaluar la eficacia de estrategias individuales, por ejemplo, la tasa de éxito de las llamadas de cobro por cobrador, e identificar oportunidades de capacitación. También es clave para gestionar los recursos y planificar la capacidad. Por qué es importante Relaciona las actividades del proceso con personas concretas, lo que permite analizar el rendimiento del equipo, la carga de trabajo y la eficacia de las intervenciones manuales. Dónde obtenerlo Esta información suele almacenarse en registros de actividades o registros de acciones de usuario dentro 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 la fecha de vencimiento de una factura. Es cero si la factura aún no ha vencido o se ha pagado a tiempo.
Descripción Los días de retraso son una métrica calculada que mide la diferencia entre la fecha actual, para las facturas abiertas, o la fecha de pago, para las facturas pagadas, y la fecha de vencimiento de la factura. Es un indicador clave de la morosidad. Este atributo es la base del panel «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 y de 31 a 60 días. También forma parte del cálculo de los días de ventas pendientes de cobro (DSO) y ayuda a priorizar los esfuerzos de cobro sobre las cuentas con mayor 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 el DSO. Dónde obtenerlo No es un campo almacenado. Se calcula durante la transformación de datos utilizando la fecha de vencimiento y la fecha de pago o la fecha actual. Ejemplos 1545092
	Está automatizado IsAutomated	Un indicador booleano que señala si el sistema realizó una actividad automáticamente o si la realizó manualmente un usuario.
Descripción Este atributo calculado distingue entre eventos generados por el sistema, como «Recordatorio de vencimiento enviado» mediante una ejecución automatizada de reclamación, y acciones realizadas por personas, como «Llamada de cobro registrada». Este indicador es fundamental para calcular el KPI «Tasa de actividades de cobro automatizadas». Ayuda a medir el nivel de automatización del proceso de cobros, identificar oportunidades para automatizarlo aún más y analizar la eficacia relativa de las interacciones automatizadas y manuales. Por qué es importante Ayuda a medir el grado de automatización del proceso y permite analizar la eficiencia y eficacia de los sistemas automatizados frente a los esfuerzos manuales. Dónde obtenerlo Se obtiene durante la transformación de datos. Requiere crear una asignación que marque determinados nombres de actividad como automatizados según el conocimiento del negocio. Ejemplos truefalse
	Fecha de promesa de pago PromiseToPayDate	La fecha en la que el cliente se ha comprometido a pagar una factura vencida.
Descripción Cuando un cobrador contacta con un cliente, puede obtener una «promesa de pago», es decir, el compromiso del cliente de pagar en una fecha determinada. Este atributo registra la fecha prometida. El análisis de estos datos es importante para evaluar la fiabilidad de las promesas de los clientes y la eficacia de los cobradores al obtener compromisos firmes. Puede utilizarse para realizar un seguimiento de la tasa de promesas cumplidas, un indicador clave del rendimiento de un equipo de cobros. Por qué es importante Registra un resultado clave de las actividades de cobro y se utiliza para medir la eficacia de los seguimientos 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	Marca de tiempo que indica cuándo se completó una actividad.
Descripción La hora de finalización marca la conclusión de una actividad. Aunque muchas actividades de cobros son eventos instantáneos en los que la hora de inicio coincide con la hora de finalización, algunas, como «Resolución de disputa», pueden tener una duración definida. Este atributo, cuando está disponible, se utiliza junto con la hora de inicio para calcular el tiempo de procesamiento de cada actividad. Esto ayuda a identificar qué pasos concretos, y no solo los intervalos entre ellos, consumen más tiempo y recursos. Por qué es importante Permite medir con precisión la duración de cada actividad y ofrece una visión más detallada de dónde se emplea el tiempo dentro del proceso. Dónde obtenerlo Consulte la documentación de HighRadius. Esta información puede estar disponible para determinadas 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 especifica la moneda de la factura, como USD, EUR o JPY. Proporciona el contexto necesario para cualquier valor monetario, como el importe de la factura. En cualquier empresa multinacional, este campo es imprescindible para realizar análisis financieros precisos. Garantiza que los valores monetarios se interpreten correctamente y permite convertir divisas de forma adecuada al agregar datos para informes globales. Por qué es importante Es esencial para interpretar correctamente todos los valores monetarios y evitar cálculos e informes financieros inexactos en entornos multidivisa. Dónde obtenerlo Es un campo estándar del registro de la factura y normalmente se encuentra junto al importe de la factura. Ejemplos USDEURGBP
	Motivo de la cancelación WriteOffReason	El código o la explicación del motivo por el que una factura se canceló como deuda incobrable.
Descripción Cuando una factura se considera incobrable, se cancela. Este atributo registra el motivo de la cancelación, como «Quiebra del cliente», «Disputa sin resolver» o «Cancelación de saldo pequeño». Es un atributo fundamental para el panel «Análisis de cancelaciones de facturas». Ayuda a analizar las causas raíz de las pérdidas financieras y proporciona información para perfeccionar las políticas de crédito, mejorar la gestión de disputas o ajustar las estrategias de cobro con el fin de minimizar futuras cancelaciones. Por qué es importante Explica los motivos de la pérdida de ingresos y proporciona información esencial para mejorar la evaluación del riesgo crediticio y las políticas de cobro. Dónde obtenerlo Esta información se registra cuando se procesa una actividad de «Factura cancelada», normalmente en el módulo financiero o de cobros de HighRadius. Ejemplos QuiebraPlazo de prescripción vencidoEl costo del cobro supera la deuda
	Nivel de reclamación DunningLevel	La etapa o el nivel alcanzado en el proceso automatizado de reclamación de una factura vencida.
Descripción El nivel de reclamación indica la intensidad del esfuerzo 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, mientras que el nivel 3 puede ser un aviso final. Este atributo es esencial para el panel «Eficacia de la estrategia de reclamación». Al analizar qué niveles de reclamación conducen con mayor frecuencia al pago, las empresas pueden optimizar sus Workflows de reclamación para garantizar su eficacia sin adoptar un tono excesivamente agresivo que perjudique la relación con el cliente. Por qué es importante Registra la escalada de las actividades de cobro y permite analizar qué estrategias de reclamación son más eficaces para impulsar el pago. Dónde obtenerlo Es un campo de estado gestionado por el motor automatizado de cobros o de Workflows de reclamación de HighRadius. Ejemplos 123 - Aviso finalCobro por vía legal
	País Country	El país del cliente asociado a la factura.
Descripción Este atributo especifica el país en el que se encuentra el cliente. Permite segmentar geográficamente el proceso de crédito y cobros. El análisis por país puede revelar diferencias regionales en el comportamiento de pago, la eficacia de las estrategias de cobro y los motivos habituales de las disputas. 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, descubrir tendencias regionales en el comportamiento 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 normalmente están disponibles en HighRadius o se sincronizan desde un ERP de origen. Ejemplos USAAlemaniaBrasil
	Sistema de origen SourceSystem	Sistema del que proceden los datos.
Descripción Este atributo identifica el sistema de origen en el que se generaron los datos del evento. En esta vista del proceso, el valor normalmente será «HighRadius». En entornos con varios sistemas, este campo es fundamental para comprender el linaje de los datos y rastrear la información hasta su origen. Ayuda a diferenciar procesos que pueden abarcar 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 y validación de datos y para comprender el entorno tecnológico del proceso. Dónde obtenerlo Normalmente es un valor estático que se añade durante el proceso de extracción y transformación de datos para etiquetar el conjunto de datos. Ejemplos HighRadiusHighRadius-CollectionsHighRadius-CashApp
	Última actualización de datos LastDataUpdate	Marca de tiempo en la que los datos de este registro se actualizaron por última vez 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. Para el análisis, este campo aporta contexto sobre la actualidad de la información. Es fundamental que los Dashboards y los informes muestren hasta qué momento están actualizados los datos, para garantizar que las decisiones empresariales se basen en información reciente. Por qué es importante Aporta transparencia sobre la actualidad de los datos, algo fundamental para generar confianza en el análisis y tomar decisiones informadas. Dónde obtenerlo Esta marca de tiempo se genera y añade a cada registro mediante la canalización de ingesta de datos 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 «Retail», «Mayorista» o «Servicios». Esto permite desglosar el análisis del rendimiento por distintos segmentos de negocio. La dirección puede comparar KPI como DSO, tasas de disputa y cancelaciones entre unidades de negocio para identificar áreas destacadas o que necesitan mejoras. También ayuda a exigir responsabilidades a las distintas partes de la organización por el rendimiento de sus cuentas por cobrar. Por qué es importante Permite comparar el rendimiento de distintas partes de la organización e identificar qué divisiones tienen los procesos de crédito a cobro más eficaces. Dónde obtenerlo Son datos organizativos que normalmente se encuentran en la factura o se derivan del pedido de venta o de la cuenta del cliente asociada en HighRadius o en el ERP. Ejemplos BU-North AmericaDivisión de serviciosManufactura

Obligatorio Recomendado Opcional

Actividades de gestión de crédito y cobros

Estos son los pasos clave y los hitos del proceso que debe capturar en su registro de eventos para descubrir y analizar con precisión su 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 presenta una disputa o deducción contra una factura y esta se registra formalmente en HighRadius. Esto pausa el proceso estándar de cobros por el importe disputado.
Por qué es importante Este es el evento inicial para medir el tiempo medio de resolución de disputas. Identificar cuándo y por qué se presentan las disputas es clave para abordar causas raíz, como errores de facturación o problemas de envío. Dónde obtenerlo Este evento se captura cuando un usuario crea un caso de disputa vinculado a una factura en HighRadius Deductions Cloud. Esta acción crea un registro de disputa con marca de tiempo. Recopilar Se captura a partir de la marca de tiempo de creación del registro 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, cuando el problema se ha investigado y se ha alcanzado una resolución. La factura puede continuar ahora hacia el pago o la baja contable.
Por qué es importante Este es el evento final para medir el tiempo medio de resolución de disputas. Los ciclos prolongados en esta etapa pueden retrasar significativamente el cobro y señalar ineficiencias del proceso. Dónde obtenerlo Se captura cuando el estado del caso de disputa cambia a «Resuelto», «Cerrado» o un estado final similar. La marca de tiempo de este cambio de estado se utiliza para la actividad. Recopilar Se infiere de la marca de tiempo en la que el estado del caso de disputa se actualiza a un estado final de «Resuelto». Tipo de evento inferred
	Factura dada de baja	Representa un final alternativo del ciclo de vida de la factura, en el que la deuda se considera incobrable y se da de baja como deuda incobrable. Es un resultado no deseado.
Por qué es importante Hacer seguimiento de las bajas es fundamental para calcular la tasa de bajas de facturas y analizar las causas raíz de las pérdidas financieras. Ayuda a identificar fallas en la evaluación crediticia o en los esfuerzos de cobro. Dónde obtenerlo Este evento se captura cuando se registra una transacción específica para dar de baja el saldo de la factura o cuando el estado de la factura cambia a «Dada de baja». Recopilar Se infiere de un cambio de estado a «Dada de baja» o del registro de un tipo específico de transacción 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 se ha creado una factura en el sistema ERP y se ha importado a HighRadius para gestionar las cuentas por cobrar.
Por qué es importante Esta actividad actúa como evento inicial principal del análisis del proceso invoice-to-cash. Todos los tiempos de ciclo, como los días de ventas pendientes de cobro (DSO), suelen medirse a partir de este punto. Dónde obtenerlo Este es un evento explícito capturado a partir de la fecha de creación del registro de factura en HighRadius, que normalmente se sincroniza desde el sistema ERP de origen, como SAP u Oracle. Recopilar Se captura a partir de la marca de tiempo de creación del registro de factura en los datos de cuentas por cobrar. Tipo de evento explicit
	Factura saldada	Esta actividad indica el final satisfactorio del ciclo de vida de la factura, cuando se ha pagado y cerrado por completo. Es el estado final deseado del proceso.
Por qué es importante Actúa como el evento final principal del «camino feliz» del proceso. Analizar las rutas que conducen a este resultado ayuda a identificar buenas prácticas y estrategias de cobro eficaces. Dónde obtenerlo Normalmente no es un evento explícito, sino que se infiere cuando el estado de la factura cambia a «Cerrada» o «Compensada» y el saldo llega a cero. La marca de tiempo del registro del pago final suele utilizarse como hora del evento. Recopilar Se infiere cuando el estado de la factura cambia a «Cerrada» o cuando el campo de saldo de la factura llega a cero. Tipo de evento inferred
	Ha pasado la fecha de vencimiento del pago	Evento calculado que se produce cuando la fecha actual supera la fecha de vencimiento del pago de la factura. Esta actividad no representa una acción de un usuario o sistema, sino un cambio de estado crítico que activa el proceso de cobros.
Por qué es importante Esta actividad es el principal desencadenante de todas las actividades posteriores de gestión de cobros. Separa las facturas pagadas a tiempo de las vencidas y permite analizar la eficacia de la estrategia de cobro. Dónde obtenerlo Este evento no se almacena directamente, sino que se calcula comparando el campo de fecha de vencimiento de la factura con la marca de tiempo de otros eventos. Se deriva durante la transformación de datos para process mining. Recopilar 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
	Pago recibido	Esta actividad marca la recepción del pago de un cliente, que a menudo se registra 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 específica.
Por qué es importante Este es un hito crítico que suele detener el cómputo del ciclo de cobros. Es el punto de partida para medir el KPI del retraso entre la recepción y el registro del pago, y permite detectar demoras en la aplicación del efectivo. Dónde obtenerlo Se captura a partir de los registros de pagos de HighRadius Cash Application Cloud. Cada lote o transacción de pago procedente de un archivo bancario tendrá una fecha de recepción. Recopilar Se captura a partir de la marca de tiempo del registro de pago cuando se importa o introduce en el módulo de aplicación de efectivo. Tipo de evento explicit
	Factura enviada al cliente	Esta actividad marca el momento en que la factura se entrega al cliente, normalmente por correo electrónico o mediante un portal de clientes. HighRadius puede automatizar y registrar este evento de comunicación.
Por qué es importante Hacer seguimiento de este punto ayuda a garantizar que los clientes reciban las facturas a tiempo. Las demoras entre la generación y el envío de la factura pueden afectar directamente los plazos de pago y el DSO. Dónde obtenerlo A menudo se registra explícitamente en el historial de correspondencia o actividades asociado a la factura en el módulo Collections Cloud. También puede inferirse a partir del estado de un trabajo automatizado de correspondencia. Recopilar Se registra en el historial de comunicaciones de la factura cuando se ejecuta la entrega por correo electrónico o portal. Tipo de evento explicit
	Límite de crédito aprobado	Representa la finalización satisfactoria del proceso de revisión crediticia, en la que se concede oficialmente un límite de crédito al cliente. Este evento se registra cuando un responsable de crédito aprueba la solicitud en la plataforma HighRadius.
Por qué es importante Este hito clave desbloquea el proceso de ventas. Hacer seguimiento de esta actividad es esencial para calcular el KPI del tiempo total del ciclo de aprobación de crédito. Dónde obtenerlo Este evento suele capturarse a partir de un cambio de estado de la solicitud de límite de crédito a «Aprobado». También puede ser un evento explícito del registro de auditoría del sistema. Recopilar Se infiere 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 crediticia de un cliente. Normalmente se activa antes de finalizar un pedido de venta y se registra 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 los ciclos de ventas. Es un punto de partida fundamental para medir la eficiencia del equipo de gestión de crédito. Dónde obtenerlo Este evento probablemente se infiere de un cambio de estado en el perfil crediticio del cliente o de la fecha de creación de un registro de solicitud de límite de crédito en el módulo Credit Management de HighRadius. Recopilar Se infiere 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 realizada por un agente al cliente en relación con una factura vencida. Los agentes registran los detalles y el resultado de la llamada directamente en HighRadius.
Por qué es importante Esta actividad es fundamental para evaluar la tasa de éxito de las llamadas de cobro y la eficiencia de las actividades de cobro. Ayuda a distinguir entre los esfuerzos de cobro automáticos y manuales. Dónde obtenerlo Es un evento explícito que se crea cuando un agente utiliza la función «Log Call» o «Add Activity» en la factura o la cuenta del cliente dentro de la interfaz de HighRadius. La entrada incluye una marca de tiempo. Recopilar Se captura de la tabla del registro de actividades donde los agentes registran las acciones manuales. Tipo de evento explicit
	Pago registrado	Representa la finalización del proceso de aplicación del efectivo, cuando un pago recibido se concilia y aplica correctamente a una factura específica, lo que elimina el saldo pendiente.
Por qué es importante Esta actividad concluye el ciclo de procesamiento del pago. El tiempo entre «Pago recibido» y «Pago registrado» revela la eficiencia del proceso de aplicación del efectivo. Dónde obtenerlo Este evento se captura a partir del campo de fecha de registro o fecha de compensación de la factura. Esta marca de tiempo se registra cuando finaliza la aplicación del efectivo. Recopilar Se captura a partir de la marca de tiempo de «posting date» o «clearing date» en la partida contable de la factura. Tipo de evento explicit
	Procedimiento de gestión de cobros iniciado	Esta actividad indica el inicio de un proceso formal de gestión de cobros o de un nivel específico dentro de dicho proceso para una factura vencida. Representa un paso más sistemático que un simple recordatorio.
Por qué es importante Hacer seguimiento del inicio de los procedimientos de gestión de cobros ayuda a analizar la eficacia de las distintas estrategias y niveles de cobro para impulsar el pago. Dónde obtenerlo Este evento suele inferirse de un cambio en el campo «Nivel de gestión de cobros» o «Estrategia de cobro» asociado al registro de la factura en HighRadius. Recopilar Se infiere de un cambio en el atributo del nivel de gestión de cobros de la factura, capturado mediante registros de cambios o un historial con marcas de tiempo. Tipo de evento inferred
	Promesa de pago creada	Esta actividad se produce cuando un cliente se compromete a pagar una factura en una fecha futura y el agente de cobros registra la promesa en el sistema. Es un resultado intermedio positivo.
Por qué es importante Hacer seguimiento de las promesas de pago ayuda a prever el flujo de caja y evaluar la eficacia de los agentes de cobro. También permite analizar las promesas incumplidas, cuando el pago no se recibe en la fecha prometida. Dónde obtenerlo Es un evento explícito que se registra en HighRadius cuando un agente crea un registro de «Promise to Pay» vinculado a una factura. Este registro tiene su propia marca de tiempo de creación. Recopilar Se captura a partir de la marca de tiempo de creación del objeto «Promise to Pay» en HighRadius. Tipo de evento explicit
	Recordatorio de vencimiento enviado	Representa un recordatorio automático o manual enviado a un cliente sobre una factura vencida. HighRadius automatiza esta acción como parte de sus estrategias de gestión de cobros y crea un registro de la comunicación.
Por qué es importante Esta actividad es fundamental para medir la tasa de eficacia de la gestión de cobros. Permite analizar cuántos recordatorios se necesitan antes de recibir un pago. Dónde obtenerlo Es un evento explícito registrado en el registro de actividades o correspondencia de la factura dentro de HighRadius Collections Cloud. Cada recordatorio enviado tendrá una entrada y una marca de tiempo correspondientes. Recopilar Se captura a partir del registro de comunicaciones con marca de tiempo asociado a la factura. Tipo de evento explicit

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de HighRadius

Pasos

Acceder al módulo de informes y análisis: Inicie sesión en su instancia de HighRadius con un usuario que tenga los permisos necesarios para crear y ejecutar informes personalizados. Acceda a la sección de informes y análisis desde el Dashboard principal o el menú de la aplicación.
Crear un informe personalizado nuevo: Inicie el proceso para crear un informe nuevo. Seleccione un objeto base que sirva como referencia principal de los datos, como el objeto Facturas o Open A/R. Asigne al informe un nombre descriptivo, por ejemplo, ProcessMind_Credit_Collections_Log.
Definir los atributos principales de la factura: Añada al diseño del informe los campos principales de la factura. Estos incluyen InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate y PaymentStatus. Estos campos formarán las columnas base de cada evento.
Añadir datos de objetos relacionados (eventos): Este es el paso más importante. Deberá unir o combinar datos de varios objetos de HighRadius para capturar las 15 actividades requeridas. Utilice la funcionalidad del generador de informes para añadir fuentes de datos relacionadas. Para cada actividad, creará un conjunto de columnas que represente los detalles del evento.
Estructurar el informe con el formato de registro de eventos: Configure el informe para que genere una fila por evento. Normalmente, esto implica combinar distintos bloques de datos en lugar de unirlos como columnas. En cada bloque combinado, asigne el campo de fecha pertinente a una columna común EventTime y establezca de forma fija el ActivityName correspondiente.
Configurar el evento 'Payment Due Date Passed': Este evento es condicional. Cree un bloque de datos específico para las facturas cuya DueDate haya quedado atrás y cuyo PaymentStatus siga siendo 'Open' u 'Overdue'. Para estos registros, establezca ActivityName como 'Payment Due Date Passed' y utilice la propia DueDate como EventTime.
Añadir información de cobros y disputas: Asegúrese de incluir datos de los módulos Collections y Disputas. Una los objetos CollectorNotes o ActivityHistory para obtener CollectorName. Una el objeto Disputas para recuperar DisputeReason cuando corresponda.
Establecer filtros del informe: Aplique filtros para definir el alcance de la extracción. Establezca un intervalo de fechas específico para EventTime, como los últimos 6 meses, con el fin de mantener el conjunto de datos en un tamaño manejable. También puede ser necesario filtrar por códigos de empresa o unidades de negocio específicos, según la estructura de su organización.
Ejecutar y previsualizar el informe: Ejecute el informe para previsualizar 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.
Exportar los datos del informe: Cuando esté conforme con la vista previa, exporte el informe completo. Seleccione CSV como formato de exportación, ya que las herramientas de Process Mining pueden ingerirlo fácilmente. Asegúrese de que la configuración de exportación utilice codificación UTF-8 para evitar problemas con los caracteres.
Revisión final de los datos: Abra el archivo CSV exportado en una aplicación de hojas de cálculo. Realice una comprobación final para asegurarse de que las 15 actividades estén presentes, que las marcas de tiempo tengan el formato correcto y que los atributos clave estén cumplimentados como se espera antes de cargar el archivo en ProcessMind.

Configuración

Tipo de informe: Un informe personalizado que combina datos de varios módulos. Según la versión concreta de HighRadius, puede denominarse 'Joined Report' o requerir varios bloques de datos 'Blocks' que se combinan.
Objeto de datos principal: Comience con 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 de marca de tiempo del evento principal. 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 irrelevantes, como 'Cancelled' o 'Draft', salvo que formen parte del proceso que desea analizar.
Permisos: La cuenta de usuario que ejecute el informe debe tener acceso de lectura a todos los módulos relevantes, incluidos Credit, Collections, Disputas y Cash Application, para garantizar la extracción de un conjunto de datos completo.

a 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 instalado Python 3.6 o una versión posterior, junto con las bibliotecas pandas y requests. Puede instalarlas mediante pip: pip install pandas requests. También debe obtener las credenciales de API, el Client ID y el Client Secret, de su administrador de HighRadius, con acceso de lectura a los objetos de datos necesarios, como facturas, cobranzas, disputas y pagos.
Inicialice el script: Cree un archivo de script de Python nuevo, por ejemplo, extract_hr_data.py. Comience 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 del cliente y el intervalo de fechas deseado para la extracción.
Implemente la autenticación: Escriba una función para gestionar la autenticación. Esta función recibirá su Client ID y Secret, realizará una solicitud POST al endpoint de autenticación de HighRadius, por ejemplo, /auth/v1/token, y recuperará un token bearer. Este token se utilizará en el encabezado de todas las solicitudes de datos posteriores.
Obtenga los datos principales de facturas: Desarrolle una función para consultar el endpoint principal de facturas, por ejemplo, /invoices/v1/search. Esta función debe gestionar la paginación para garantizar la recuperación de 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 haya más páginas disponibles. Almacene estos datos principales en una lista de diccionarios.
Obtenga los datos de objetos relacionados: Para cada entidad de datos principal, como Disputes, Collection Notes y Payments, cree funciones independientes de recuperación de datos. Estas funciones consultarán sus respectivos endpoints, por ejemplo, /disputes/v1/search, /collections/v1/notes y /cashapp/v1/payments, y deben estar diseñadas para obtener de forma eficiente todos los datos relevantes del periodo especificado. Normalmente, es preferible obtener estos conjuntos de datos en bloque en lugar de consultar una factura cada vez.
Estructure el Registro de eventos: Inicialice una lista vacía que contendrá todas las filas del Registro de eventos. El script recorrerá los datos obtenidos y transformará cada acción o cambio de estado relevante en un diccionario estandarizado que represente una única fila de evento. Cada diccionario debe contener las claves InvoiceNumber, ActivityName, EventTime y todos los demás atributos requeridos.
Genere los eventos del ciclo de vida de la factura: Recorra la lista principal de facturas. Para cada factura, cree eventos para 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' e 'Invoice Written Off' según su fecha de creación, los registros de correspondencia, la fecha de cierre y los campos de estado. Almacénelos como diccionarios de eventos.
Calcule «Payment Due Date Passed»: Dentro del mismo bucle 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 la fecha de vencimiento de la factura ya pasó, si la factura aún no se ha pagado y si todavía no se ha generado para ella un evento 'Payment Due Date Passed'. El EventTime de esta actividad debe ser la propia fecha de vencimiento.
Genere eventos de cobranzas y disputas: Procese los datos obtenidos de los endpoints de cobranzas y disputas. Para cada nota, promesa de pago, acción de gestión de cobro o registro de disputa, cree las filas de evento correspondientes ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Asigne los detalles relevantes, como CollectorName y DisputeReason, al registro del evento.
Genere eventos de pago: Procese los datos de pago del módulo de aplicación de efectivo. Cree eventos 'Payment Received' según la fecha de creación del pago o la fecha del extracto bancario, y eventos 'Payment Posted' según 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. Esto facilita la ordenación y las conversiones finales de tipos de datos. Asegúrese de que la columna EventTime utilice un formato de marca de tiempo coherente (YYYY-MM-DD HH:MI:SS).
Exporte a CSV: Utilice la función to_csv de pandas para exportar el DataFrame final a un archivo CSV. Asigne al archivo 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 una columna. El archivo estará listo para cargarlo en ProcessMind.

Configuración

Credenciales de API: Se requiere un usuario de API específico con un Client ID y un Client Secret. El usuario debe tener permisos de lectura para todos los endpoints de API relevantes, incluidos los de facturas, clientes, actividades de cobranzas, disputas y aplicación de efectivo.
Intervalo de fechas: El script de Python incluye las variables START_DATE y END_DATE. Es fundamental establecer un intervalo de fechas específico y razonable, como 3-6 meses, para limitar el volumen de datos y evitar tiempos de ejecución excesivamente largos. Filtre según 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 de los endpoints 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. Normalmente, esto implica utilizar los parámetros limit y offset o un enfoque basado en cursores. Un tamaño de página de 100-500 suele ser un buen punto de partida.
Entorno: El script debe ejecutarse en un entorno estable con memoria suficiente para gestionar los DataFrames, especialmente en extracciones 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 consultar estos campos e incluirlos en la salida.

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

¿Listo para comenzar?

Esta plantilla le proporciona la base de datos estructurada que necesita para obtener información detallada sobre su proceso de Credit Management & Collections. Comience hoy mismo a optimizar sus operaciones de HighRadius para acelerar el flujo de efectivo.

Volver a la guía de mejora Descargar Template

Comience a optimizar su Credit Management & Collections

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

Iniciar la prueba gratuita

No necesita tarjeta de crédito. Comience en cuestión de minutos.

Su Template de datos de Credit Management & Collections

Su Template de datos de Credit Management & Collections

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 del módulo de informes y análisis de HighRadius

Pasos

Configuración

a Consulta de ejemplo sql

Extracción mediante script de Python a través de las API REST de HighRadius

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Comience a optimizar su Credit Management & Collections

Su Template de datos de Credit Management & Collections

Su Template de datos de Credit Management & Collections

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 del módulo de informes y análisis de HighRadius

Pasos

Configuración

a Consulta de ejemplo sql

Extracción mediante script de Python a través de las API REST de HighRadius

Pasos

Configuración

a Consulta de ejemplo python

¿Listo para comenzar?

Comience a optimizar su Credit Management & Collections

Valoramos su privacidad