← Volver al índice de esquemas
FinanceSummaryAttributes
Indicadores financieros de la cuenta para un mes calendario, con agregados, desgloses y comparación con el mes anterior.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
period | object | Rango temporal del resumen (mes calendario completo). |
month | string | Mes en formato `YYYY-MM`. |
from_utc | string | Inicio del mes en UTC, con formato `YYYY-MM-DD HH:MM:SS`. |
to_utc | string | Fin del mes en UTC (exclusivo), con formato `YYYY-MM-DD HH:MM:SS`. |
counts | object | Conteos de validaciones por veredicto, más retiros mediante borrado lógico del periodo (informativo). |
total | integer | Cantidad de validaciones del periodo, incluidas las que tienen estado `pending`. |
valid | integer | Validaciones con veredicto `valid` en el periodo. |
invalid | integer | Validaciones con veredicto `invalid` en el periodo. |
not_found | integer | Validaciones con veredicto `not_found` en el periodo. |
cep_unavailable | integer | Validaciones con veredicto `cep_unavailable` en el periodo. |
returned | integer | Validaciones cuya operación se liquidó y después se devolvió en el periodo. |
error | integer | Validaciones que terminaron en error técnico. |
pending | integer | Validaciones aún en proceso que no han recibido estado terminal al cierre del periodo. |
deleted | integer | Validaciones retiradas mediante borrado lógico en el periodo. |
amounts | object | Agregados monetarios del periodo. `verified_volume` suma únicamente validaciones con resultado `valid`. |
total_volume | number | Importe sumado en MXN de todas las validaciones del periodo. |
verified_volume | number | Volumen en MXN de validaciones con resultado `valid`. |
unverified_volume | number | Diferencia entre volumen total y verificado. |
avg_ticket | number | Monto promedio por validación en MXN. |
median_ticket | number | Monto mediano por validación en MXN. |
max_ticket | number | Mayor monto individual del mes en MXN. |
min_ticket | number | Menor monto individual del mes en MXN. |
verified_share_pct | number | Porcentaje del volumen total correspondiente a validaciones verificadas, expresado de 0 a 100. |
success_rate | number | Tasa de éxito: porcentaje de validaciones con resultado `valid` sobre `counts.total`, expresado de 0 a 100. |
avg_processing_ms | integer | Tiempo promedio de procesamiento en milisegundos del periodo. |
daily_breakdown | array | Desglose diario con actividad. Los días sin validaciones se omiten. |
top_counterparties | array | Top 5 cuentas beneficiarias del usuario por volumen verificado en el mes. |
top_banks_receptor | array | Top 5 bancos receptores por volumen verificado. |
top_banks_emisor | array | Top 5 bancos emisores por volumen verificado. |
verdict_distribution | object | Conteo de validaciones por valor de veredicto. Los valores ausentes implican cero. |
comparison_prev_month | object | Comparativa contra el mes anterior. Los deltas son `null` cuando el mes anterior tuvo base cero (crecimiento no definido). |
prev_month | string | Mes anterior en formato `YYYY-MM`. |
total | integer | Cantidad de validaciones del mes anterior. |
verified_volume | number | Volumen verificado del mes anterior en MXN. |
total_delta_pct | number | null | Cambio porcentual del conteo total respecto al mes anterior. `null` cuando el mes anterior tuvo cero validaciones. |
volume_delta_pct | number | null | Cambio porcentual del volumen verificado respecto al mes anterior. `null` cuando el mes anterior tuvo cero volumen verificado. |
folio | string | Folio determinístico del estado de cuenta del mes, idéntico al devuelto en la cabecera `X-Finance-Folio` del endpoint de exportación. |
Usado en operaciones
GET /v1/finance/summary