Reportes disponibles
Cada reporte responde una pregunta diferente:
- Resumen de conciliación: Una vista general de alto nivel de las tasas de coincidencia, el volumen de excepciones y las varianzas totales.
- Reporte detallado de coincidencias: Una lista completa de coincidencias, incluyendo detalles de transacciones, puntajes de confianza y desgloses de varianza.
- Reporte de excepciones: Una vista enfocada de excepciones no resueltas con antigüedad, severidad y estado de resolución.
- Reporte de pista de auditoría: Un registro cronológico de la actividad de conciliación para investigación y cumplimiento.
Analíticas del dashboard
El dashboard de reportes proporciona métricas de conciliación en tiempo real para cualquier contexto y rango de fechas.
Agregados del dashboard
Usa el endpoint combinado de agregados del dashboard para una sola llamada que devuelve estadísticas de volumen, tasa de coincidencia y SLA para un contexto:cURL
GET /v1/reports/contexts/{contextId}/dashboard acepta date_from, date_to y un filtro opcional source_id, y devuelve un DashboardAggregatesResponse:
| Campo | Descripción |
|---|---|
volume | Estadísticas de volumen de transacciones para el rango |
matchRate | Estadísticas de tasa de coincidencia (coincidentes vs. total) |
sla | Estadísticas de SLA para el manejo de excepciones |
updatedAt | Cuándo se calcularon los agregados por última vez (RFC 3339) |
/v1/reports/contexts/{contextId}/dashboard/* (por ejemplo metrics, match-rate, sla, volume, source-breakdown y cash-impact).
No existe un endpoint escueto
GET /v1/reports/contexts/{contextId}. Los datos de reportes se sirven a través de las sub-rutas tipadas bajo /v1/reports/contexts/{contextId}/... — por ejemplo dashboard, summary, matched, unmatched y variance (cada una con una variante /export).Desglose por fuente
Visualiza el rendimiento de la conciliación por fuente — incluyendo tasas de coincidencia, recuentos de transacciones y montos no conciliados:cURL
Impacto de efectivo
Evalúa la exposición financiera total de las transacciones no conciliadas, desglosada por moneda y antigüedad:cURL
byCurrency y byAge para ayudar a priorizar los esfuerzos de resolución.
Paginación
Los endpoints de reportes de coincidencias, no coincidencias y varianza usan paginación basada en cursor. Pasa el valor
cursor de una respuesta anterior para recuperar la siguiente página de resultados.
Si se proporciona un valor de cursor inválido, la API devuelve un error 400 Bad Request con un mensaje que indica que los parámetros de paginación son inválidos. Las versiones anteriores devolvían un error 500 en este caso.
Conteos rápidos
Usa los endpoints de conteo para verificaciones de estado ligeras sin obtener conjuntos de resultados completos:
| Endpoint | Descripción |
|---|---|
| Contar coincidencias | Total de elementos coincidentes en un rango de fechas |
| Contar transacciones | Total de transacciones en un rango de fechas |
| Contar excepciones | Total de excepciones en un rango de fechas |
| Contar no coincidentes | Total de elementos no coincidentes en un rango de fechas |
cURL
count — ideal para dashboards ligeros o verificaciones de salud que no necesitan el conjunto de resultados completo.
Mejores prácticas
Programa resúmenes diarios
Programa resúmenes diarios
Automatiza un reporte de resumen diario entregado cada mañana para mantener alineadas a las partes interesadas.
Archiva exportaciones para cumplimiento
Archiva exportaciones para cumplimiento
Almacena reportes en almacenamiento seguro y duradero. Los artefactos financieros a menudo requieren retención de varios años.
Usa filtros para mantenerte accionable
Usa filtros para mantenerte accionable
Genera reportes específicos por fecha, estado, severidad o fuente—evita exportar todo por defecto.
Haz que las exportaciones sean autoexplicativas
Haz que las exportaciones sean autoexplicativas
Incluye nombres de fuentes, nombres de reglas e identificadores clave para que la salida pueda existir independientemente fuera de Matcher.
Monitorea los trabajos de reportes
Monitorea los trabajos de reportes
Los reportes grandes pueden fallar o estancarse. Rastrea el estado del trabajo y alerta sobre
FAILED o GENERATING prolongado.Próximos pasos
Contextos y fuentes
Configura contextos de conciliación y fuentes de datos.
Seguridad
Aprende cómo funcionan el control de acceso y la protección de datos en Matcher.