> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Generando reportes

> Genera resúmenes de conciliación, detalles de coincidencias, vistas de excepciones y registros de auditoría para monitorear resultados y cumplir con los requisitos normativos.

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

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

Usa los endpoints del dashboard de reportes para acceder a métricas de conciliación y exportar datos.

<Tip>Referencia de API: [Agregados del dashboard](/es/reference/matcher/get-dashboard-aggregates) | [Exportar reporte de coincidencias](/es/reference/matcher/export-matched-report) | [Exportar reporte de no coincidencias](/es/reference/matcher/export-unmatched-report)</Tip>

## 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:

```bash cURL theme={null}
curl -X GET "https://api.matcher.example.com/v1/reports/contexts/{contextId}/dashboard?date_from=2025-01-01&date_to=2025-01-31" \
 -H "Authorization: Bearer $TOKEN"
```

`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)  |

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`).

<Note>
  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`).
</Note>

<Tip>Referencia de API: [Obtener agregados del dashboard](/es/reference/matcher/get-dashboard-aggregates)</Tip>

### Desglose por fuente

Visualiza el rendimiento de la conciliación por fuente — incluyendo tasas de coincidencia, recuentos de transacciones y montos no conciliados:

```bash cURL theme={null}
curl -X GET "https://api.matcher.example.com/v1/reports/contexts/{contextId}/dashboard/source-breakdown?date_from=2025-01-01&date_to=2025-01-31" \
 -H "Authorization: Bearer $TOKEN"
```

<Tip>Referencia de API: [Obtener desglose por fuente](/es/reference/matcher/get-source-breakdown)</Tip>

### Impacto de efectivo

Evalúa la exposición financiera total de las transacciones no conciliadas, desglosada por moneda y antigüedad:

```bash cURL theme={null}
curl -X GET "https://api.matcher.example.com/v1/reports/contexts/{contextId}/dashboard/cash-impact?date_from=2025-01-01&date_to=2025-01-31" \
 -H "Authorization: Bearer $TOKEN"
```

La respuesta incluye desgloses `byCurrency` y `byAge` para ayudar a priorizar los esfuerzos de resolución.

<Tip>Referencia de API: [Obtener impacto de efectivo](/es/reference/matcher/get-cash-impact)</Tip>

## 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](/es/reference/matcher/count-matches)      | Total de elementos coincidentes en un rango de fechas    |
| [Contar transacciones](/es/reference/matcher/count-transactions) | Total de transacciones en un rango de fechas             |
| [Contar excepciones](/es/reference/matcher/count-exceptions)     | Total de excepciones en un rango de fechas               |
| [Contar no coincidentes](/es/reference/matcher/count-unmatched)  | Total de elementos no coincidentes en un rango de fechas |

```bash cURL theme={null}
curl -X GET "https://api.matcher.example.com/v1/reports/contexts/{contextId}/matches/count?date_from=2025-01-01&date_to=2025-01-31" \
 -H "Authorization: Bearer $TOKEN"
```

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

***

<AccordionGroup>
  <Accordion title="Programa resúmenes diarios">
    Automatiza un reporte de resumen diario entregado cada mañana para mantener alineadas a las partes interesadas.
  </Accordion>

  <Accordion title="Archiva exportaciones para cumplimiento">
    Almacena reportes en almacenamiento seguro y duradero. Los artefactos financieros a menudo requieren retención de varios años.
  </Accordion>

  <Accordion title="Usa filtros para mantenerte accionable">
    Genera reportes específicos por fecha, estado, severidad o fuente—evita exportar todo por defecto.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Monitorea los trabajos de reportes">
    Los reportes grandes pueden fallar o estancarse. Rastrea el estado del trabajo y alerta sobre `FAILED` o `GENERATING` prolongado.
  </Accordion>
</AccordionGroup>

## Próximos pasos

***

<Card title="Contextos y fuentes" icon="database" href="/es/matcher/configuration/matcher-contexts-and-sources" horizontal>
  Configura contextos de conciliación y fuentes de datos.
</Card>

<Card title="Seguridad" icon="shield-halved" href="/es/matcher/reference/matcher-security" horizontal>
  Aprende cómo funcionan el control de acceso y la protección de datos en Matcher.
</Card>