`ValidationQueued`

Respuesta asíncrona de `POST /v1/validate?async=1` y `POST /v1/validate-ocr?async=1`. Contiene la validación encolada y los datos necesarios para consultar su resultado en `GET /v1/validations/{id}`.

Propiedades

Campo	Tipo	Descripción
`data`	`object`	Envoltorio JSON:API del recurso encolado.
`type`	`string`	Tipo de recurso JSON:API. Siempre `validation`.
`id`	`string (uuid)`	Identificador único de la validación creada (UUID v4), utilizable en `GET /v1/validations/{id}`.
`attributes`	`object`	Datos de la validación encolada.
`validation_id`	`string (uuid)`	UUID de la validación (idéntico a `data.id`).
`status`	`string`	Estado inmediato tras el encolamiento. Siempre `queued`.
`etag_version`	`integer`	Versión inicial del recurso para polling condicional con `If-None-Match`. Enviarla como ETag evita respuestas innecesarias cuando el estado no ha cambiado.
`enqueued_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `_at`, `_end`, `_start` y `_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta.
`expires_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `_at`, `_end`, `_start` y `_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta.
`retry_state`	`object`	Estado del ciclo de reintentos automáticos al momento del encolamiento. Siempre presente; si no se configuró `retry_policy` en el body ni en la política del usuario, `enabled=false` y los campos de política son `null`.
`enabled`	`boolean`	`true` cuando la validación tiene reintentos configurados, aunque su ciclo ya haya terminado (`terminal_state`).
`max_retries`	`integer \| null`	Número máximo de reintentos configurado; `null` cuando `enabled` es `false`.
`interval_seconds`	`integer \| null`	Intervalo en segundos entre reintentos, de `300` a `86400`; `null` cuando `enabled` es `false`.
`outcomes`	`array \| null`	Resultados que originan un reintento: `not_found`, `cep_unavailable` y `error`; `null` cuando `enabled` es `false`.
`attempts_completed`	`integer`	Cantidad de reintentos completados hasta el momento.
`next_attempt_at`	`TimestampUTC \| null`	Fecha del próximo reintento; `null` cuando no hay uno programado.
`resolved_at`	`TimestampUTC \| null`	Fecha en que un reintento obtuvo `valid`; `null` mientras no ocurra.
`exhausted_at`	`TimestampUTC \| null`	Fecha en que se agotaron los intentos; `null` mientras no ocurra.
`cancelled_at`	`TimestampUTC \| null`	Fecha de cancelación del ciclo; `null` mientras no ocurra.
`terminal_state`	`string \| null`	Situación del ciclo: `pending`, `resolved`, `exhausted` o `cancelled`. Es `null` cuando la validación no tiene un ciclo de reintentos.
`client_ref`	`string`	Referencia propia enviada en la petición (`client_ref`), devuelta tal cual. Solo aparece cuando la petición la incluyó.
`meta`	`object`	Metadatos de control del flujo de polling.
`next_poll_after_seconds`	`integer`	Segundos recomendados de espera antes del primer poll a `GET /v1/validations/{id}`. Sondear antes de este intervalo puede activar el límite de solicitudes.
`playground`	`boolean`	`true` cuando la validación pertenece al banco de pruebas (Playground). Campo reservado para compatibilidad: las respuestas asíncronas actuales lo omiten, porque el banco de pruebas no encola validaciones.