Saltar al contenido principal

Eventos

La pantalla de eventos (/dashboard/events) expone el stream interno de eventos de dominio que genera el sistema cada vez que cambia un estado relevante — invoice.created, payment.succeeded, subscription.canceled, nfe.issued y decenas de otros. Es la misma cola que alimenta los Webhooks y el historial del cliente en el portal.

Por qué es importante​

A diferencia de la Auditoría, que registra las modificaciones hechas por personas, los eventos representan lo que ocurrió desde el punto de vista del dominio del negocio — sin importar el origen (UI, API, worker, webhook recibido de un gateway).

Los eventos son útiles para:

  • Depuración: descubrir por qué un webhook no llegó a su destino o por qué una suscripción se canceló inesperadamente.
  • Replays: reenviar eventos a un endpoint que estaba fuera de servicio.
  • Integraciones: confirmar que un evento esperado realmente se generó.

Estructura del evento​

Cada evento contiene:

  • type — nombre con el patrón recurso.accion (ej.: invoice.paid)
  • resource_type y resource_id — la entidad afectada
  • payload — JSON con el estado relevante en el momento del evento
  • created_at — cuándo se emitió el evento
  • delivery_status — agregado de los intentos de entrega a los endpoints suscritos

Filtros y búsqueda​

La lista ofrece filtros por tipo de evento, recurso, rango de fechas y status de entrega. Cada fila puede expandirse para mostrar el payload completo y el historial de intentos en cada endpoint suscrito.

Catálogo de eventos​

La referencia completa de los tipos de evento (y cuándo se dispara cada uno) está en Webhooks > Eventos.

Captura de pantalla​

Lista de eventos con tipo, recurso, payload y status de entrega