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: conteos y montos conciliados y no conciliados en el rango de fechas.
  • Informe de detalle de coincidencias: una lista de transacciones conciliadas con su grupo de coincidencia, fuente, monto, moneda y fecha.
  • Informe de no conciliados: una lista de transacciones que siguen no conciliadas para dar seguimiento.
  • Informe de excepciones: una lista de excepciones creadas en el rango de fechas, con severidad, estado, motivo y fecha de vencimiento.
  • Informe de variaciones: totales de comisiones esperados y reales por fuente, tabla de comisiones y moneda, con la variación neta y su porcentaje.
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 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 (todas, excepto dashboard, tienen una variante /export, al igual que exceptions).
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.

​
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.
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.