Skip to main content
Los reportes convierten una ejecución de conciliación en algo sobre lo que puedes actuar: cuánto coincidió, qué sigue abierto y cuánto dinero está expuesto. Los equipos de operaciones los usan para trabajar la cola del día; finanzas y cumplimiento los usan para cerrar los libros y documentar los resultados.

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 elementos no coincidentes: Una lista de transacciones que siguen sin coincidencia para darles seguimiento.
  • Reporte de excepciones: Una vista enfocada de excepciones no resueltas con antigüedad, severidad y estado de resolución.
  • Reporte de varianza: Un desglose de las diferencias de comisiones entre las transacciones coincidentes. Cada fila conserva la varianza neta sin procesar, muestra los ajustes registrados aplicados a esa fila e informa la varianza pendiente resultante. Un ajuste que no puede atribuirse a exactamente una fila de fuente, programa de comisiones y moneda se informa como no atribuido en lugar de dividirse.
Usa los endpoints del dashboard de reportes para acceder a métricas de conciliación y exportar datos.

Analíticas del dashboard


El dashboard de reportes proporciona métricas de conciliación en tiempo real para un contexto y un rango de fechas. Los endpoints de reportes usan por defecto la ventana de 30 días que termina mañana (UTC) y normalmente limitan la ventana a 90 días. Solo los endpoints de lista y conteo de elementos no coincidentes aceptan unbounded=true para consultar sin límites de fecha.

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: Hay slices del dashboard más granulares disponibles bajo /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
Referencia de API: Obtener desglose por fuente

Impacto de efectivo

Evalúa la exposición financiera total de las transacciones no conciliadas, desglosada por moneda y antigüedad:
cURL
La respuesta incluye desgloses byCurrency y byAge para ayudar a priorizar los esfuerzos de resolución.
Referencia de API: Obtener impacto de efectivo

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:
cURL
Cada endpoint de conteo devuelve un único valor count — ideal para dashboards ligeros o verificaciones de salud que no necesitan el conjunto de resultados completo.

Mejores prácticas


Automatiza un reporte de resumen diario entregado cada mañana para mantener alineadas a las partes interesadas.
Almacena reportes en almacenamiento seguro y duradero. Los artefactos financieros a menudo requieren retención de varios años.
Genera reportes específicos por fecha y fuente—evita exportar todo por defecto.
Incluye nombres de fuentes, nombres de reglas e identificadores clave para que la salida pueda existir independientemente fuera de Matcher.
Los reportes grandes pueden fallar o estancarse. Los trabajos de exportación usan QUEUED, RUNNING, SUCCEEDED, FAILED, EXPIRED y CANCELED; genera alertas por FAILED o un estado RUNNING 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.