← Volver al índice de esquemas
ValidationListItem
Validación abreviada para vistas de lista. Envuelta bajo `{ type, id, attributes }` siguiendo el formato JSON:API; los campos a continuación describen el bloque `attributes`. Las filas eliminadas (soft-delete) también aparecen — `is_deleted` y `deleted_at` permiten a la UI distinguirlas sin una petición adicional.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
id | string (uuid) | Identificador único de la validación (UUID v4). |
type | string | Tipo de recurso JSON:API. Siempre `validation`. |
validation_type | string | Tipo de validación: `direct` para parámetros textuales, `ocr` para imagen de comprobante. |
status | string | Estado del resultado. Ver `Validation.attributes.status` para la descripción completa de cada valor. |
fecha | string (date) | Fecha de la transferencia (YYYY-MM-DD). |
monto | number (double) | Importe de la transferencia en pesos mexicanos (MXN). |
clave_rastreo | string | Clave de rastreo SPEI. |
emisor | string | Banco emisor de la transferencia. |
receptor | string | Banco receptor de la transferencia. |
playground | boolean | Indica si la validación fue ejecutada en modo sandbox. |
created_at | string (date-time) | Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `*_at`, `*_end`, `*_start`, `*_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente. |
completed_at | union | Marca temporal de finalización de la validación. `null` mientras el estado es `queued` o `processing`. |
deleted_at | union | Timestamp de eliminación (soft-delete). `null` si la validación no fue eliminada. |
is_deleted | boolean | `true` si y solo si `deleted_at` tiene valor; campo de conveniencia para filtrado en la UI. |
retry_state | object | Estado compacto del ciclo de reintentos. Los campos de política (`max_retries`, `interval_seconds`, `outcomes`) son siempre `null` en esta vista; consultar `GET /v1/validations/{id}` para el estado completo. |
enabled | boolean | Indica si el ciclo de reintentos está activo para esta validación. |
max_retries | integer | null | Siempre `null` en el shape compacto. Ver `RetryStateFull` para el valor. |
interval_seconds | integer | null | Siempre `null` en el shape compacto. Ver `RetryStateFull` para el valor. |
outcomes | array | null | Siempre `null` en el shape compacto. Ver `RetryStateFull` para el valor. |
attempts_completed | integer | Número de reintentos completados hasta el momento. |
next_attempt_at | union | Timestamp del próximo reintento programado. `null` si el ciclo está en estado terminal o si no hay reintentos activos. |
resolved_at | union | Timestamp cuando un reintento resolvió la validación a `valid`. `null` si el ciclo no ha terminado por resolución. |
exhausted_at | union | Timestamp cuando se agotaron los reintentos sin resolución. `null` si el ciclo no ha terminado por agotamiento. |
cancelled_at | union | Timestamp cuando el ciclo fue cancelado explícitamente. `null` si no fue cancelado. |
terminal_state | string | null | Estado terminal del ciclo: `pending` — activo, sin resultado final aún; `resolved` — un reintento obtuvo `valid`; `exhausted` — se agotaron los intentos; `cancelled` — cancelado por el usuario. |
Usado en operaciones
GET /v1/validationsGET /v1/admin/validationsGET /v1/admin/validations/recent