Threxio Release 2.6 - Módulo de Webhooks y Auditoría y Trazabilidad ampliada

Portal Recaudador

Módulo de Webhooks — notificaciones automáticas de eventos de transacciones

7subsecciones

💡 Se libera un módulo completo de Webhooks: las empresas pueden configurar notificaciones automáticas de eventos de transacciones hacia sistemas externos, con control granular por convenio, registro de envíos, reintentos automáticos y permisos por rol.

Se habilita la configuración de webhooks a nivel de empresa y de convenio, de forma independiente y flexible. Anteriormente, la notificación por webhook dependía de una única configuración a nivel de empresa, sin posibilidad de diferenciarla por convenio, lo que limitaba la flexibilidad para adaptarse a distintas necesidades operativas. Ahora, la empresa puede definir un webhook por defecto, activarlo o inactivarlo, y decidir explícitamente qué convenios quedan asociados a él, cada uno con su propio estado independiente.

Para gestionarlos, se incorpora una nueva pantalla de Webhooks dentro de Configuraciones del portal recaudador. Allí el usuario puede ver todos los webhooks existentes (ordenados alfabéticamente, en formato de acordeón, con nombre, URL, estado y cantidad de convenios asociados) y crear uno nuevo con estos datos:

Nombre: el usuario identifica el webhook para poder reconocerlo y reutilizarlo más adelante.
URL y token: se ingresan los datos del endpoint que recibirá las notificaciones.
Prueba de conexión: el sistema valida que el endpoint responde correctamente antes de habilitar el guardado.
Asociación de convenios: se debe asignar mínimo un convenio a cada webhook para su funcionamiento; un mismo convenio puede pertenecer a múltiples webhooks.

Si no se asocia ningún convenio al crearlo, el webhook queda guardado pero en estado inactivo.

Permite editar la configuración de un webhook ya creado, tanto a nivel de empresa como de convenio. Editar únicamente el nombre o los convenios asociados no requiere una nueva prueba de conexión, pero cambiar la URL o el token sí la exige. También se puede activar, inactivar o eliminar cada webhook: al inactivarlo, los convenios asociados quedan «congelados» en su estado actual y no se pueden modificar hasta reactivarlo, momento en el que recuperan exactamente la configuración previa.

Eliminar un webhook requiere confirmación explícita por ser una acción irreversible; el historial de envíos previos se conserva.

Detalle del webhook con acciones de edición, activación y eliminación

Dentro del detalle de cada webhook, el usuario puede administrar la lista de convenios asociados: activar o inactivar cada uno individualmente, o quitarlo del webhook (con confirmación previa). Las notificaciones solo se envían cuando el webhook y el convenio están simultáneamente activos.

Si se quita el último convenio activo, el webhook completo pasa automáticamente a estado inactivo. Estas acciones solo están disponibles mientras el webhook esté activo.

Detalle del webhook: convenios asociados y su estado

Cuando cambia el estado de una transacción, el sistema identifica automáticamente qué webhook aplica para ese convenio (según las reglas de activación de empresa y convenio) y envía el evento por HTTP, incluyendo autenticación con token cuando está configurado. Si la empresa o el convenio están inactivos, no se envía ninguna notificación. Esto desacopla por completo el envío de notificaciones del link de pago, permitiendo notificar cualquier transacción sin importar su origen.

El sistema detecta el cambio de estado de la transacción.
Evalúa si el webhook y el convenio están activos.
Envía la solicitud HTTP con el token de autenticación.
Si falla, reintenta automáticamente hasta un máximo configurable por cliente.

Cada intento queda con trazabilidad: número de reintento, descripción del error y respuesta del endpoint, visible en el Registro de Envíos.

Se incorpora la pantalla «Registro de Envíos», donde el usuario consulta el historial completo de notificaciones enviadas por webhook: transacción, documento, valores, estado, reintentos y mensajes de error, entre otros campos. Incluye filtros por estado (enviado/fallido), convenio, rango de fechas y búsqueda predictiva por ID de transacción, además de una tabla paginada.

La información se puede exportar a CSV respetando los filtros aplicados, lo que facilita al cliente el diagnóstico de fallas en su integración.

Registro de Envíos con filtros y tabla paginada

Permite descargar en formato CSV la información visualizada en el Registro de Envíos de webhooks, respetando los filtros aplicados y manteniendo el mismo orden de columnas que se ve en pantalla, para que el usuario pueda auditar o compartir la información fuera del portal.

Incorpora el módulo «Webhook» dentro de la Gestión de Roles y Permisos del portal recaudador, con permisos independientes de Ver/consultar, Crear, Editar, Activar/Inactivar y Eliminar. Si un usuario no cuenta con un permiso, la acción correspondiente se oculta por completo de su interfaz, no solo se deshabilita.

Activar cualquier permiso operativo activa automáticamente «Ver/consultar»; el rol Administrador conserva todos los permisos por jerarquía y no puede editarse.

Portal Administrador

Auditoría más completa y trazable, en Administrador y Recaudador

1mejora integral

💡 La auditoría se amplía y se vuelve más completa, tanto en el Portal Administrador como en el Portal Recaudador: cubre más funcionalidades, muestra el resultado de cada acción y sus valores antes/después cuando aplica, permite filtrar mejor la información y se puede descargar para su análisis.

La auditoría ahora es mucho más completa, tanto en el Portal Administrador como en el Portal Recaudador, y cubre un mayor número de funcionalidades en cada uno. Cada registro indica quién hizo la acción, cuándo, desde qué portal, el resultado (éxito o fallo) y, cuando aplica, los valores antes y después del cambio.

Además, ahora se puede filtrar la información por empresa (ya no es obligatorio seleccionarla), funcionalidad, acción, usuario y rango de fechas, para encontrar más rápido lo que se necesita.

Cubre más funcionalidades, tanto en el portal Administrador como en el Recaudador.
Nuevos filtros de búsqueda: empresa (ahora opcional), funcionalidad, acción, usuario y rango de fechas.
Cada registro muestra el resultado de la acción y, en las ediciones, los valores antes y después del cambio.
Toda la información consultada se puede descargar en un archivo para compartir o analizar fuera del portal.

Detalle de la actividad con el campo Resultado