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

# Nível de análise do documento

> Escolha o quão exigente é a verificação do documento e quais parâmetros cada nível revisa.

O **nível de análise do documento** controla o quão rigorosa é a revisão do documento de identidade. Pense nos controles de um aeroporto: mais controles dão mais segurança, mas mais pessoas ficam esperando. Aqui é igual: quanto mais validações ativas, maior a exigência e menor a taxa de aprovação. Um nível mais baixo não elimina a segurança: muda a profundidade da análise.

Você o configura na aba **Verificação de documento** da [Configuração da Biometria Webview](/pt/guias/integracoes/identidade/configuracao-biometria).

<Tip>
  Se você precisa de ajuda para definir a melhor configuração para o seu documento, use o [Onboarding com a Jelou CLI](/pt/guias/integracoes/identidade/onboarding-biometria).
</Tip>

## Níveis disponíveis

| Nível | O que inclui | Caso de uso |
| - | - | - |
| **Padrão** | Tipo e origem do documento, data de vigência e elementos de segurança físicos. As três validações devem ser aprovadas. | Nível recomendado: equilibra proteção antifraude e conversão em cada país. |
| **Avançado** | Tudo do nível Padrão, mais o resultado global do documento. Opcionalmente, zona de leitura automática, coerência de dados e qualidade da foto. | Fluxos de alto risco ou setores regulados. Funciona melhor com documentos modernos de leitura fácil. |
| **Personalizado** | Tipo e vigência sempre ativos, mais a combinação de parâmetros que você escolher. | Empresas com regras de negócio específicas. É configurado apenas pela pessoa designada pelo cliente e requer coordenação prévia com a Jelou. |

<Tip>
  Recomendamos o nível **Padrão**. É o que alcança o melhor equilíbrio entre proteção antifraude e conversão em cada país.
</Tip>

<Info>
  As variáveis **tipo e origem do documento** e **data de vigência** não podem ser desativadas em nenhum nível selecionado.
</Info>

## O que é cada campo

Veja como cada elemento aparece em um documento. Os números da imagem coincidem com a tabela.

<Frame caption="Documento de exemplo. Não corresponde a nenhum país.">
  <img src="https://mintcdn.com/jelouai/sKeGHIMFW75ljq1I/assets/images/nivel-analisis-documento-campos.svg?fit=max&auto=format&n=sKeGHIMFW75ljq1I&q=85&s=c6ee472fc0bd5bb0ba8102a142462862" alt="Ilustração de um documento de identidade de exemplo com oito elementos numerados: cabeçalho, dados do titular, data de vencimento, holograma, zona de leitura automática, foto do titular, foto capturada e documento completo" width="640" height="380" data-path="assets/images/nivel-analisis-documento-campos.svg" />
</Frame>

| Nº | Elemento do documento | O que é | Campo que o usa |
| - | - | - | - |
| 1 | Cabeçalho | Indica o tipo de documento e o país. | Tipo e origem do documento |
| 2 | Dados do titular | Nomes, número e datas. São lidos com OCR, uma leitura automática de texto. | Coerência de dados |
| 3 | Data de vencimento | Define se está vigente. | Data de vigência |
| 4 | Holograma e padrões | Proteções físicas do documento. | Elementos de segurança físicos |
| 5 | Zona de leitura automática | Faixa com os dados codificados, como a MRZ. | Zona de leitura automática |
| 6 | Foto do titular | É comparada com a selfie. | Comparação facial |
| 7 | Foto capturada | Nitidez, luz, enquadramento e reflexos. | Qualidade da foto capturada |
| 8 | Documento completo | Reúne todas as revisões. | Resultado global do documento |

## O que cada nível revisa

| Campo na plataforma | O que verifica | Na imagem | Padrão | Avançado |
| - | - | - | - | - |
| Tipo e origem do documento | Se é um tipo reconhecido e do país emissor correto. | 1 | Sempre ativo | Sempre ativo |
| Data de vigência | Se está dentro do período de validade. | 3 | Sempre ativo | Sempre ativo |
| Elementos de segurança físicos | Hologramas, chips, códigos de segurança e padrões de fundo. | 4 | Ativo | Ativo |
| Resultado global do documento | Análise completa. Se algum controle falhar, o documento é rejeitado. | 8 | Não se aplica | Ativo |
| Zona de leitura automática | Se os dados codificados são lidos e coerentes. Somente se o documento tiver essa zona. | 5 | Não se aplica | Opcional |
| Coerência de dados do documento | Compara o que se vê (OCR) com o que está codificado na zona automática. | 2 e 5 | Não se aplica | Opcional |
| Qualidade da foto capturada | Nitidez, iluminação, enquadramento e ausência de reflexos. | 7 | Não se aplica | Opcional |

## Nível Personalizado

Com o nível **Personalizado** você escolhe quais parâmetros ativar. Tipo e origem do documento e data de vigência estão sempre ativos.

<Warning>
  **Antes de desativar o parâmetro Elementos de segurança físicos**

  Este parâmetro verifica hologramas, chips, códigos de segurança e padrões de fundo, e é uma barreira contra impressões ou fotocópias de alta resolução. Desativá-lo reduz o nível de segurança do documento. Se você precisar fazê-lo:

  1. Solicite à Jelou a atribuição do papel **external\_client\_biometry** para a sua company, enviando o e-mail da pessoa que precisa dele.
  2. Com o papel ativo, entre no Brain e desative a validação.
  3. O sistema exibe um modal de consentimento: digite "conheço e aceito os riscos" para confirmar. Essa aceitação fica registrada para auditoria.

  Se você precisa de ajuda para definir a melhor configuração para o seu documento, use o [Onboarding com a Jelou CLI](/pt/guias/integracoes/identidade/onboarding-biometria).
</Warning>

<Tip>
  Em populações com muitos documentos antigos ou desgastados, um nível mais exigente aumenta as rejeições ou o encaminhamento para revisão humana ([HIL](/pt/guias/integracoes/identidade/hil)). Avalie a qualidade documental típica da sua base de usuários antes de ativá-lo.
</Tip>

## Configuração recomendada por país

<AccordionGroup>
  <Accordion title="Todos os países" icon="earth-americas">
    * Desative o **Resultado global do documento**.
  </Accordion>

  <Accordion title="Equador e Colômbia" icon="flag">
    * Não deixe como obrigatórios a zona de leitura automática, a coerência de dados do documento nem o resultado global.
    * Aplique uma configuração **Personalizada** com estes parâmetros ativos:
      * Tipo e origem do documento.
      * Data de vigência.
      * Elementos de segurança físicos.
  </Accordion>

  <Accordion title="Peru" icon="flag">
    * Você pode manter ativa a zona de leitura automática.
    * Se os seus usuários usam muitos documentos antigos, como os de fundo azul, desative a qualidade da foto capturada.
  </Accordion>
</AccordionGroup>

<Warning>
  Ao deixar desativadas a **zona de leitura automática** e a **qualidade da foto capturada**, o sistema não exigirá que o documento tenha MRZ nem penalizará se a qualidade da imagem não for alta.
</Warning>


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