Consultar el resumen financiero del mes

Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con type, id, attributes).

Tipo del recurso JSON:API. Siempre finance_summary.

Indicadores financieros de la cuenta para un mes calendario, con agregados, desgloses y comparación con el mes anterior.

Rango temporal del resumen (mes calendario completo).

Mes en formato YYYY-MM.

Inicio del mes en UTC, con formato YYYY-MM-DD HH:MM:SS.

Fin del mes en UTC (exclusivo), con formato YYYY-MM-DD HH:MM:SS.

Conteos de validaciones por veredicto, más retiros mediante borrado lógico del periodo (informativo).

Cantidad de validaciones del periodo, incluidas las que tienen estado pending.

Validaciones con veredicto valid en el periodo.

Validaciones con veredicto invalid en el periodo.

Validaciones con veredicto not_found en el periodo.

Validaciones con veredicto cep_unavailable en el periodo.

Validaciones cuya operación se liquidó y después se devolvió en el periodo.

Validaciones que terminaron en error técnico.

Validaciones aún en proceso que no han recibido estado terminal al cierre del periodo.

Validaciones retiradas mediante borrado lógico en el periodo.

Agregados monetarios del periodo. verified_volume suma únicamente validaciones con resultado valid.

Importe sumado en MXN de todas las validaciones del periodo.

Volumen en MXN de validaciones con resultado valid.

Diferencia entre volumen total y verificado.

Monto promedio por validación en MXN.

Monto mediano por validación en MXN.

Mayor monto individual del mes en MXN.

Menor monto individual del mes en MXN.

Porcentaje del volumen total correspondiente a validaciones verificadas, expresado de 0 a 100.

Tasa de éxito: porcentaje de validaciones con resultado valid sobre counts.total, expresado de 0 a 100.

Tiempo promedio de procesamiento en milisegundos del periodo.

Desglose diario con actividad. Los días sin validaciones se omiten.

Top 5 cuentas beneficiarias del usuario por volumen verificado en el mes.

Top 5 bancos receptores por volumen verificado.

Top 5 bancos emisores por volumen verificado.

Conteo de validaciones por valor de veredicto. Los valores ausentes implican cero.

Comparativa contra el mes anterior. Los deltas son null cuando el mes anterior tuvo base cero (crecimiento no definido).

Mes anterior en formato YYYY-MM.

Cantidad de validaciones del mes anterior.

Volumen verificado del mes anterior en MXN.

Cambio porcentual del conteo total respecto al mes anterior. null cuando el mes anterior tuvo cero validaciones.

Cambio porcentual del volumen verificado respecto al mes anterior. null cuando el mes anterior tuvo cero volumen verificado.

Folio determinístico del estado de cuenta del mes, idéntico al devuelto en la cabecera X-Finance-Folio del endpoint de exportación.

Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.

Versión de la API que procesó la petición.

Versión del prefijo de ruta de la API (ej. v1).

Identificador único de la petición (hex).

Descriptor compañero presente en el bloque meta de cada respuesta (y en el meta del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec.

Siempre UTC: La zona canónica para cada campo datetime del cuerpo.

Siempre ISO 8601: Sufijo Z explícito en cada datetime.

Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.