← 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

CampoTipoDescripción
idstring (uuid)Identificador único de la validación (UUID v4).
typestringTipo de recurso JSON:API. Siempre `validation`.
validation_typestringTipo de validación: `direct` para parámetros textuales, `ocr` para imagen de comprobante.
statusstringEstado del resultado. Ver `Validation.attributes.status` para la descripción completa de cada valor. `queued` — en cola; `processing` — en curso; `valid` — el comprobante existe y cuadra; `not_found` — Banxico no lo encuentra; `cep_unavailable` — el servicio no pudo entregarlo; `invalid` — los datos no cuadran; `failed` — el intento no pudo completarse; `error` — falló el sistema al procesarla.
fechastring (date)Fecha de la transferencia (YYYY-MM-DD).
montonumber (double)Importe de la transferencia en pesos mexicanos (MXN).
clave_rastreostringClave con la que el banco identifica la transferencia ante el sistema de pagos.
emisorstringBanco emisor de la transferencia.
receptorstringBanco receptor de la transferencia.
playgroundbooleanIndica si la validación fue ejecutada en modo sandbox.
created_atstring (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_atTimestampUTC | nullMarca temporal de finalización de la validación. `null` mientras el estado es `queued` o `processing`.
deleted_atTimestampUTC | nullTimestamp de eliminación (soft-delete). `null` si la validación no fue eliminada.
is_deletedboolean`true` si y solo si `deleted_at` tiene valor; campo de conveniencia para filtrado en la UI.
retry_stateobjectEstado 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.
enabledbooleanIndica si el ciclo de reintentos está activo para esta validación.
max_retriesinteger | nullSiempre `null` en el shape compacto. Ver `RetryStateFull` para el valor.
interval_secondsinteger | nullSiempre `null` en el shape compacto. Ver `RetryStateFull` para el valor.
outcomesarray | nullSiempre `null` en el shape compacto. Ver `RetryStateFull` para el valor.
attempts_completedintegerNúmero de reintentos completados hasta el momento.
next_attempt_atTimestampUTC | nullTimestamp del próximo reintento programado. `null` si el ciclo está en estado terminal o si no hay reintentos activos.
resolved_atTimestampUTC | nullTimestamp cuando un reintento resolvió la validación a `valid`. `null` si el ciclo no ha terminado por resolución.
exhausted_atTimestampUTC | nullTimestamp cuando se agotaron los reintentos sin resolución. `null` si el ciclo no ha terminado por agotamiento.
cancelled_atTimestampUTC | nullTimestamp cuando el ciclo fue cancelado explícitamente. `null` si no fue cancelado.
terminal_statestring | nullEstado 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. `null` si la validación no tiene ciclo de reintentos.

Usado en operaciones

  • GET /v1/validations
  • GET /v1/admin/validations
  • GET /v1/admin/validations/recent