Skip to main content
Los informes 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.

​
Informes disponibles

Cada informe responde a una pregunta distinta:
  • Resumen de conciliación: una vista general de las tasas de coincidencia, el volumen de excepciones y las variaciones totales.
  • Informe de detalle de coincidencias: una lista completa de coincidencias, con detalles de la transacción, puntuaciones de confianza y desgloses de variaciones.
  • Informe de no conciliados: una lista de transacciones que siguen no conciliadas para dar seguimiento.
  • Informe de excepciones: una vista enfocada de las excepciones sin resolver con antigüedad, severidad y estado de resolución.
  • Informe de variaciones: un desglose de las diferencias de comisiones entre transacciones conciliadas. Cada fila conserva la variación neta bruta, muestra los ajustes registrados aplicados a esa fila e informa la variación pendiente resultante. El informe muestra un ajuste como no atribuido cuando no corresponde a exactamente una fila de fuente, tabla de comisiones y moneda. El informe nunca divide un ajuste así.
Usa los endpoints del dashboard de informes para acceder a las métricas de conciliación y exportar datos.
Referencia de API:

​
Analítica del dashboard

El dashboard de informes ofrece métricas de conciliación en tiempo real para un contexto y un rango de fechas. Los endpoints de informes usan de forma predeterminada 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 de conteo de no conciliados 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 source_id opcional, y devuelve un DashboardAggregatesResponse: Hay cortes del dashboard más granulares bajo /v1/reports/contexts/{contextId}/dashboard/* (por ejemplo metrics, match-rate, sla, volume, source-breakdown y cash-impact).
No existe un endpoint GET /v1/reports/contexts/{contextId} a secas. Las sub-rutas tipadas bajo /v1/reports/contexts/{contextId}/... llevan los datos de los informes, por ejemplo dashboard, summary, matched, unmatched y variance (cada una con una variante /export).
Referencia de API: Obtener agregados del dashboard

​
Desglose por fuente

Consulta el rendimiento de la conciliación por fuente, con tasas de coincidencia, conteos de transacciones y montos no conciliados:
cURL
Referencia de API: Obtener desglose por fuente

​
Impacto en caja

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

​
Paginación

Los endpoints de informes de conciliados, no conciliados y variaciones usan paginación basada en cursor. Pasa el valor cursor de una respuesta anterior para obtener la siguiente página de resultados. Si proporcionas 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 no son vá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 traer los conjuntos de resultados completos:
cURL
Cada endpoint de conteo devuelve un único valor count, ideal para dashboards ligeros o health checks que no necesitan el conjunto de resultados completo.

​
Mejores prácticas

Automatiza un informe resumen diario que se entregue cada mañana para mantener alineados a los interesados.
Guarda los informes en un almacenamiento seguro y duradero. Los artefactos financieros a menudo requieren retención de varios años.
Genera informes dirigidos por fecha y fuente. Evita exportar todo de forma predeterminada.
Incluye nombres de fuentes, nombres de reglas e identificadores clave para que la salida se sostenga sola fuera de Matcher.
Los informes grandes pueden fallar o estancarse. Los jobs de exportación usan QUEUED, RUNNING, SUCCEEDED, FAILED, EXPIRED y CANCELED. Alerta sobre FAILED o RUNNING prolongado.

​
Próximos pasos

Contextos y fuentes

Configura contextos de conciliación y fuentes de datos.

Seguridad

Conoce cómo funcionan el control de acceso y la protección de datos en Matcher.