← 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/validations
  • GET /v1/admin/validations
  • GET /v1/admin/validations/recent