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

# Generar informes

> Genera resúmenes de conciliación, detalles de coincidencias, vistas de excepciones e informes de variaciones para monitorear los resultados y dar soporte al cumplimiento.

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.

<Tip>
  Referencia de API:

  * [Agregados del dashboard](/es/reference/products/matcher/get-dashboard-aggregates)
  * [Exportar informe de conciliados](/es/reference/products/matcher/export-matched-report)
  * [Exportar informe de no conciliados](/es/reference/products/matcher/export-unmatched-report)
</Tip>

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

```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 `source_id` opcional, y devuelve un `DashboardAggregatesResponse`:

| Campo       | Descripción                                                          |
| ----------- | -------------------------------------------------------------------- |
| `volume`    | Estadísticas de volumen de transacciones para el rango               |
| `matchRate` | Estadísticas de tasa de coincidencia (coincidencias frente al total) |
| `sla`       | Estadísticas de SLA para el manejo de excepciones                    |
| `updatedAt` | Cuándo se calcularon por última vez los agregados (RFC 3339)         |

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

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

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

### Desglose por fuente

Consulta el rendimiento de la conciliación por fuente, con tasas de coincidencia, conteos 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/products/matcher/get-source-breakdown)
</Tip>

### Impacto en caja

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 los desgloses `byCurrency` y `byAge` para ayudar a priorizar los esfuerzos de resolución.

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

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

| Endpoint                                                                  | Descripción                                             |
| ------------------------------------------------------------------------- | ------------------------------------------------------- |
| [Contar coincidencias](/es/reference/products/matcher/count-matches)      | Total de elementos conciliados en un rango de fechas    |
| [Contar transacciones](/es/reference/products/matcher/count-transactions) | Total de transacciones en un rango de fechas            |
| [Contar excepciones](/es/reference/products/matcher/count-exceptions)     | Total de excepciones en un rango de fechas              |
| [Contar no conciliados](/es/reference/products/matcher/count-unmatched)   | Total de elementos no conciliados 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 health checks que no necesitan el conjunto de resultados completo.

## Mejores prácticas

***

<AccordionGroup>
  <Accordion title="Programa resúmenes diarios">
    Automatiza un informe resumen diario que se entregue cada mañana para mantener alineados a los interesados.
  </Accordion>

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

  <Accordion title="Usa filtros para mantener los informes accionables">
    Genera informes dirigidos por fecha y fuente. Evita exportar todo de forma predeterminada.
  </Accordion>

  <Accordion title="Haz que las exportaciones se expliquen solas">
    Incluye nombres de fuentes, nombres de reglas e identificadores clave para que la salida se sostenga sola fuera de Matcher.
  </Accordion>

  <Accordion title="Monitorea los jobs de informes">
    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.
  </Accordion>
</AccordionGroup>

## Próximos pasos

***

<Card title="Contextos y fuentes" icon="database" href="/es/products/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/products/matcher/reference/matcher-security" horizontal>
  Conoce cómo funcionan el control de acceso y la protección de datos en Matcher.
</Card>