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

# Validación gubernamental

> Cruza datos biométricos contra fuentes oficiales según disponibilidad por país.

La validación gubernamental consulta en tiempo real fuentes oficiales de registro civil para reforzar la confianza en el resultado de la biometría. Tiene un valor adicional al proceso de biometría.

## Tipos de validación

Existen dos tipos de validación gubernamental, con cobertura de país distinta para cada uno:

| Tipo             | Qué hace                                                                                                                                               | Cobertura                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| **Solo datos**   | Contrasta los datos extraídos por OCR del documento contra la fuente gubernamental. Retorna una respuesta booleana (verdadero/falso).                  | Disponible en **Ecuador, Colombia y Perú**. En integración: **Chile y México**. |
| **Datos y foto** | Además de contrastar los datos, compara la foto extraída del documento contra la foto almacenada en la fuente gubernamental (selfie vs. foto oficial). | Disponible únicamente en **Ecuador y Perú**.                                    |

## Cobertura por país

Actualmente la validación gubernamental está disponible en **Ecuador, Perú y Colombia**. Los campos que devuelve cada fuente oficial varían según el país.

<AccordionGroup>
  <Accordion title="Ecuador" icon="🇪🇨">
    Conexión directa con Registro Civil.

    | Variable                   | Descripción                                                                       | Tipo de respuesta                |
    | -------------------------- | --------------------------------------------------------------------------------- | -------------------------------- |
    | `nombres` / `primerNombre` | Primer nombre del usuario registrado oficialmente.                                | Dato (texto)                     |
    | `primerApellido`           | Primer apellido del usuario.                                                      | Dato (texto)                     |
    | `segundoApellido`          | Segundo apellido del usuario.                                                     | Dato (texto)                     |
    | `fechaNacimiento`          | Fecha de nacimiento registrada oficialmente.                                      | Dato (fecha)                     |
    | `sexo`                     | Sexo registrado en el documento oficial.                                          | Dato (texto)                     |
    | `estadoCivil`              | Estado civil registrado (campo adicional).                                        | Dato (texto)                     |
    | `profesion`                | Profesión registrada (campo adicional).                                           | Dato (texto)                     |
    | `lugarNacimiento`          | Lugar de nacimiento registrado (campo adicional).                                 | Dato (texto)                     |
    | `domicilio`                | Dirección de domicilio registrada (campo adicional).                              | Dato (texto)                     |
    | `provincia`                | Provincia de residencia registrada (campo adicional).                             | Dato (texto)                     |
    | `ciudad`                   | Ciudad de residencia registrada (campo adicional).                                | Dato (texto)                     |
    | `codigoError`              | Código de estado de la consulta. El valor `000` indica que los datos son válidos. | Dato / código (control de éxito) |
    | `fotografia`               | Fotografía oficial del usuario, usada para la comparación facial.                 | Dato (URL)                       |
  </Accordion>

  <Accordion title="Perú" icon="🇵🇪">
    Validación de datos y foto contra RENIEC.

    | Variable            | Descripción                                                       | Tipo de respuesta   |
    | ------------------- | ----------------------------------------------------------------- | ------------------- |
    | `firstName`         | Primer nombre del usuario.                                        | Dato (texto)        |
    | `paternalLastName`  | Apellido paterno del usuario.                                     | Dato (texto)        |
    | `maternalLastName`  | Apellido materno del usuario.                                     | Dato (texto)        |
    | `lastName`          | Apellidos combinados del usuario.                                 | Dato (texto)        |
    | `fullName`          | Nombre completo del usuario.                                      | Dato (texto)        |
    | `dateOfBirth`       | Fecha de nacimiento registrada oficialmente.                      | Dato (fecha)        |
    | `civilStatus`       | Estado civil registrado.                                          | Dato (texto)        |
    | `address`           | Dirección de domicilio registrada.                                | Dato (texto)        |
    | `documentType`      | Tipo de documento validado (por defecto, DNI).                    | Dato (texto)        |
    | `expeditionDate`    | Fecha de expedición del documento.                                | Dato (fecha)        |
    | `expirationDate`    | Fecha de vencimiento del documento.                               | Dato (fecha)        |
    | `ubigeoReniec`      | Código de ubicación geográfica oficial.                           | Dato (código)       |
    | `verificationDigit` | Dígito verificador del documento.                                 | Dato (texto)        |
    | `photo`             | Fotografía oficial del usuario, usada para la comparación facial. | Porcentaje de match |
  </Accordion>

  <Accordion title="Colombia" icon="🇨🇴">
    Validación de datos con ANI.

    | Variable         | Descripción                                    | Tipo de respuesta                                                      |
    | ---------------- | ---------------------------------------------- | ---------------------------------------------------------------------- |
    | `firstName`      | Primer nombre del usuario.                     | Dato (texto) o booleano (`false` si no coincide con la fuente oficial) |
    | `secondName`     | Segundo nombre del usuario.                    | Dato (texto) o booleano (`false` si no coincide)                       |
    | `firstLastName`  | Primer apellido del usuario.                   | Dato (texto) o booleano (`false` si no coincide)                       |
    | `secondLastName` | Segundo apellido del usuario.                  | Dato (texto) o booleano (`false` si no coincide)                       |
    | `fullName`       | Nombre completo del usuario.                   | Dato (texto)                                                           |
    | `fullLastName`   | Apellidos completos del usuario.               | Dato (texto)                                                           |
    | `issueDate`      | Fecha de expedición del documento.             | Dato (fecha)                                                           |
    | `documentStatus` | Estado del documento (vigente, vencido, etc.). | Dato (texto)                                                           |

    <Warning>
      Colombia es el único país donde un campo de nombre puede devolver un valor booleano (`false`) en vez de un dato: si cualquiera de estos campos no coincide con la fuente oficial, todo el resultado gubernamental se invalida.
    </Warning>
  </Accordion>
</AccordionGroup>

## Consideraciones clave

* La disponibilidad depende del país.
* Los campos devueltos pueden variar entre jurisdicciones.
* Un fallo en la consulta gubernamental produce un **rechazo definitivo**, sin derivación a revisión manual.
* Un error técnico de la fuente gubernamental (`serviceError`) es un caso distinto al rechazo de identidad: requiere un flujo propio de reintento en vez de bloquear al usuario.
