> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Estados del expediente

> Estado general del expediente y estado por requerimiento en una verificación creada vía widget.

En una verificación creada vía widget hay **dos niveles de estado** que conviene distinguir:

* **Estado del expediente completo**: refleja el progreso global del onboarding del prospecto.
* **Estado por requerimiento**: cada requerimiento de documento definido en el `record_validation_schema` tiene su propio `status` con un código detallado.

***

## Estado del expediente

El expediente representa el conjunto de documentos e items que el prospecto debe completar en el flujo. Su estado global cambia conforme el prospecto avanza:

| Estado | Descripción |
| :- | :- |
| `pending_upload` | Aún no se ha subido ningún documento requerido. |
| `partial_upload` | Se han subido algunos documentos requeridos, pero faltan otros. |
| `pending_external` | Todos los documentos están subidos, pero faltan items que debe completar el prospecto directamente (`forms` o `ubos`). |
| `full_upload` | Se subieron todos los documentos requeridos y no quedan items externos pendientes: el expediente está completo. |

***

## Estado por requerimiento

Cada requerimiento del `record_validation_schema` (ver [Crear el flujo](/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo#2-requerimientos-de-documentos-record_validation_schema)) tiene su propio estado dentro de la llave `status` del expediente:

| Estado | Código de estado | Descripción |
| :- | :- | :- |
| `ok` | `ok` | El requerimiento fue validado. |
| `ok` | `classifying` | El documento fue subido y se está clasificando. |
| `ok` | `extracting` | El documento fue subido y se están extrayendo sus datos. |
| `error` | `invalid_type` | El documento no es del tipo esperado. |
| `error` | `invalid_subtype` | El documento no es del subtipo esperado. |
| `pending` | `pending_upload` | El documento aún no fue subido. |
| `pending` | `pending_classification` | El documento aún no fue clasificado. |

***

## Consultar el estado del expediente

Puedes consultar el estado del expediente de una verificación con:

```bash theme={"dark"}
curl -X GET "https://api.gotrebol.com/verifications/{verification_id}/record_validation" \
     -H "x-api-key: {api_key}"
```

Ver detalle del endpoint y estructura de respuesta en la [Referencia API](https://docs.gotrebol.com/api-reference/estado-de-validacion-de-documentos/obtener-estado-de-validacion-de-documentos-por-el-id-de-verificacion).

***

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Crear el flujo" href="/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo">
    Define los requerimientos del expediente y sus reglas de validación.
  </Card>

  <Card title="Webhooks" href="/docs/guia-devs/webhooks">
    Recibe notificaciones cuando el estado del expediente cambia.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.