¿Qué es y para qué sirve el módulo de Finanzas?

El módulo de Finanzas convierte tu historial de validaciones en agregados mensuales útiles para conciliación contable:

• Estadísticas: De todas tus operaciones realizadas en Veriko.
• Estados de cuenta: En diferentes formatos (pdf, xlsx, xml) de cada uno de tus beneficiarios.
• Reportes detallados: De transferencias válidas, no encontradas, tickets promedio, y mucho más.
• Comprobantes CEP descargables en ZIP: Descarga gran cantidad de comprobantes (CEP) y empaquetalos en formato .zip.

Qué cuenta como "verificado"

Una validación es "verificada" únicamente cuando status='valid' Y cep_xml fue accesible por medio de Banxico.
Cualquier otro veredicto terminal [not_found, cep_unavailable, invalid, failed, error] entra en el agregado de "no verificado" y suma al monto "no verificado" y no a lo "verificado". La definición es la misma que usa Comprobante Electrónico de Pago (CEP).

El Resumen de finanzas

GET /v1/finance/summary?month=YYYY-MM devuelve para el periodo solicitado, los datos que se muestran en el panel "Finanzas" de la consola de Veriko:

• counts — totales y desglose por veredicto (valid, not_found, cep_unavailable, invalid, failed, error).
• amounts — total_volume, verified_volume, unverified_volume, avg_ticket, median_ticket, max_ticket, min_ticket.
• success_rate — porcentaje de filas terminales con veredicto valid.
• avg_processing_ms — latencia media desde creación hasta cierre terminal.
• top_counterparties / top_banks_receptor / top_banks_emisor — top 5 cada uno, con count + valid + verified_volume.
• verdict_distribution — counts por veredicto en formato gráfico.
• comparison_prev_month — totales, volumen verificado del mes anterior y deltas porcentuales.

Estado de cuenta y reportes

GET /v1/finance/statement?month=YYYY-MM&format=... emite el estado de cuenta mensual en cuatro formatos:

• format=pdf (default)
• format=xlsx — workbook multi-hoja (Resumen / Detalle diario / Top contrapartes / Top bancos / KPIs / Transacciones).
• format=csv — secciones [HEADER] / [KPIS] / [TRANSACTIONS] / [TOTALS].
• format=html — el mismo template que el PDF, útil para imprimir desde el navegador.

Los cuatro reportes detallados (monthly / counterparties / by-bank / accounting) aceptan format=csv|preview y, en accounting, decimal=comma|dot para tooling SAT/contable. El PDF tiene un límite de 1000 filas.

Archivo de CEPs

GET /v1/finance/ceps?from=YYYY-MM-DD&to=YYYY-MM-DD devuelve un ZIP con todos los cep_xml (y cep_pdf_path si está) del rango, además dos manifiestos paralelos (manifest.csv y manifest.xlsx) con columnas validation_id, fecha, clave_rastreo, archivo.
Solo se incluyen filas con cep_xml, así que el archivo es exactamente el subconjunto verificado del periodo. Si el rango está vacío la respuesta es 404 no_ceps.