> ## 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.           |
| `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>