← Volver al índice de esquemas

ValidationStats

Contadores agregados de las validaciones del usuario autenticado. Devuelto por `GET /v1/validations/stats`. Honra los mismos filtros que `GET /v1/validations` (`date_from`, `date_to`, `type`, `search`, `with_deleted`, `playground`, `batch_id`).

Propiedades

Campo Tipo Descripción
type string Tipo del recurso JSON:API (siempre `validation_stats`).
attributes object Conteos agregados de validaciones del usuario (cumpliendo los filtros). Los cubos de primer nivel cuentan por `banxico_status` (veredicto); `by_status` desglosa por la columna `status` (ciclo de vida).
total integer Cantidad total de validaciones del usuario que cumplen los filtros. Incluye todas, sin importar el estado Banxico.
valid integer Subconjunto del total con `banxico_status='valid'` (transferencia confirmada).
not_found integer Subconjunto del total con `banxico_status='not_found'`.
cep_unavailable integer Subconjunto del total con `banxico_status='cep_unavailable'` (el servicio CEP de Banxico no estaba disponible al momento de validar).
error integer Subconjunto del total con `banxico_status='error'` (error Banxico, p.ej. HTTP 5xx o fallo de red).
pending integer Subconjunto del total con `banxico_status='pending'`: validaciones asíncronas aún en cola o en proceso, sin resultado CEP todavía.
deleted integer Cantidad de validaciones soft-deleted del usuario (cumpliendo los mismos filtros).
other integer Resto del total tras restar `valid`, `not_found`, `cep_unavailable`, `error` y `pending`. En la práctica corresponde a filas `invalid`. Se calcula como `max(0, total - valid - not_found - cep_unavailable - error - pending)`.
by_type object Desglose por tipo de validación. `direct + ocr` siempre suma `total`.
direct * integer Validaciones directas (por campos CLABE/tarjeta/teléfono).
ocr * integer Validaciones por OCR de comprobante.
by_status object Desglose por estado de ciclo de vida (columna `status`: `queued` / `processing` / `valid` / `not_found` / `cep_unavailable` / `invalid` / `failed` / `error`). Es el MISMO eje sobre el que filtra la tabla de validaciones (a diferencia de `valid` / `not_found` / `cep_unavailable` / `error` / `pending` arriba, que cuentan por `banxico_status`): una fila en curso aparece como `processing`/`queued` aquí, pero como `pending` en aquellos cubos. Las ocho llaves siempre están presentes (0 si no hay filas) y siempre suman `total`.
queued * integer Validaciones en cola, aún sin procesar (asíncronas).
processing * integer Validaciones en proceso contra Banxico ahora mismo.
valid * integer Validaciones con estado de ciclo de vida `valid` (confirmadas).
not_found * integer Validaciones con estado `not_found`.
cep_unavailable * integer Validaciones con estado `cep_unavailable`.
invalid * integer Validaciones con estado `invalid` (entrada inválida).
failed * integer Validaciones con estado `failed` (fallo del pipeline).
error * integer Validaciones con estado `error`.

Usado en operaciones

  • GET /v1/validations/stats