> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/produtos/editor-1/facephi-onboarding/mobile/ios/widgets/documento.md).

# Documento

**Widget de captura de documento**

### **Introdução**[​](#introducción) <a href="#introduccion" id="introduccion"></a>

SelphID é um widget que permite capturar e validar o Documento de identidade de um usuário.

Como resultado, a autenticidade do documento é verificada por meio de algoritmos e protocolos de segurança. Todos os dados extraídos podem ser consultados a qualquer momento na Facephi Platform.

### **Requisitos e instalação**[​](#requisitos-e-instalación) <a href="#requisitos-e-instalacion" id="requisitos-e-instalacion"></a>

O widget é compatível com dispositivos iOS 13 ou superior.

### **Capturar um documento**[​](#capturar-un-documento) <a href="#capturar-un-documento" id="capturar-un-documento"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/a91506ec1a52357fe4559e57d714ab2a2e7df503" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
A primeira tela é um tutorial que explica como fazer a captura de documento.

A animação mostra como interagir com o Widget. O texto traz detalhes de como realizar esta etapa corretamente.

Para continuar, toque no botão (2). Para voltar, toque no ícone (1).

1. Botão de voltar
2. Botão para continuar
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/454c54a8245180478af9698785f90babab84e998" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Se você ainda não concedeu ao aplicativo as permissões da câmera, aparecerá uma mensagem para que você possa aceitar essas permissões. O acesso à câmera é necessário para fazer as capturas de documento ou de rosto, entre outros.

1. Botão negar
2. Botão para permitir acesso
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/0a8859d3b19a3eb3c63c18eea6781097003e2aac" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Já no widget, aparece um texto que traz instruções sobre a etapa a ser realizada. Neste caso, sua câmera foi ativada e você deve enquadrar a parte da frente do seu documento. O documento deve caber dentro da moldura (3), sem que as bordas do documento ultrapassem a moldura. Se as condições de luz e nitidez forem adequadas, a foto será feita automaticamente.

Se você tiver dúvidas ou dificuldades com esta etapa, toque no botão de informação (2) e será aberto um tutorial que pode te ajudar.

Para sair do Widget sem fazer a captura, toque no ícone (1).

1. Botão de voltar
2. Botão de informação
3. Moldura para enquadrar o documento
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/4baeab5a705a024c75469c039f0a7c8eaeb65c96" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Este é o tutorial de captura de documento. Acesse-o tocando no ícone de informação (visto na tela anterior). Aqui são mostradas algumas dicas de como posicionar o documento e o que deve ser considerado para que a captura seja realizada. Você pode navegar deslizando para a direita ou para a esquerda (3) ou (4). Para pular esta tela, toque no botão (2).

Para voltar à captura de documento, toque no ícone (1).

1. Botão pular
2. Botão de voltar
3. Indicador de página
4. Botão seguinte
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/6daffc8a0112f8fbaab8a6e165b6615e5bc9e686" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/f664670d99ca419c1d1446db036e97af246579e1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
O widget mostrará em tempo real se a captura foi realizada ou se houve algum problema.

* **Se a captura não foi realizada (1)**, tente novamente esta etapa até que o widget tire a foto. O botão de informação ou os diagnósticos de erro podem ser de grande ajuda nesta etapa.
* **Se a captura foi realizada corretamente (2)**, aparecerá uma mensagem de confirmação. Repita a mesma etapa, desta vez com a parte traseira do seu documento.
  {% endcolumn %}
  {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/33488fcecd63df6a526d4514c169e24cf39579cb" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
*Tela opcional. Pode ser ativada em Configurações.*

O widget capturou o documento e esta tela de pré-visualização é exibida. Aqui você deve verificar se o documento aparece por completo e se os dados estão legíveis.

Se a foto estiver borrada, ou houver dados cobertos ou cortados, recomendamos que você toque no botão (2) para tentar a foto novamente. Uma captura ruim pode levar a uma interpretação incorreta dos dados e à necessidade de repetir o processo novamente.

Se a foto estiver nítida e os dados forem lidos corretamente, toque no botão (3) para continuar para a próxima etapa.

Para sair e não continuar, toque no ícone (1). Pular esta etapa levará você à etapa anterior.

1. Botão de voltar
2. Botão para tentar novamente
3. Botão para continuar
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/f476bd176851795dc5678b47c91ffe1bd10d6f88" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Agora capture o verso do documento. As etapas e as instruções são as mesmas da captura da frente do documento.

Assim que a foto for tirada, você terá que verificar a pré-visualização da captura para validar a foto ou refazê-la. Se for validada, você terá concluído o processo de captura de documento.
{% endcolumn %}
{% endcolumns %}

### **Erros**[​](#errores) <a href="#errores" id="errores"></a>

#### **Tentativas permitidas**[​](#intentos-permitidos) <a href="#intentos-permitidos" id="intentos-permitidos"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/8d99dc5c0b82aae5ed491a1bd3b429be47fdae6c" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Por segurança, há um limite de tentativas permitidas para realizar certas ações. Se este erro apareceu para você, é porque você realizou X tentativas seguidas sem sucesso. Você deve esperar o tempo terminar para tentar esta etapa novamente.

Ao tocar no botão (2), você volta ao Widget para tentar esta etapa novamente. Se quiser voltar, toque no ícone (1).

1. Botão de voltar
2. Botão para tentar novamente
   {% endcolumn %}
   {% endcolumns %}

#### **Permissões da câmera**[​](#permisos-de-cámara) <a href="#permisos-de-camara" id="permisos-de-camara"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/fb1eac6002b8958af5c11eec3a09305f19141ad3" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Anteriormente, a permissão da câmera foi negada, mas o Widget está tentando acessar.

Ao tocar no botão (2), você será direcionado para as permissões do app para que possa ativá-las. Caso contrário, para fechar esta tela de erro, toque no ícone (1).

1. Botão de voltar
2. Botão para ir às permissões do celular
   {% endcolumn %}
   {% endcolumns %}

#### **Atualizar o aplicativo**[​](#actualizar-la-aplicación) <a href="#actualizar-la-aplicacion" id="actualizar-la-aplicacion"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/a8643cb478f23cfc2b1a3daea5a52e8795317a1e" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Existe uma nova Versão do aplicativo e é necessário atualizá-lo. Normalmente, para correção de erros ou implementação de melhorias.

Ao tocar no botão (2), você será direcionado para a página de download para atualizar o app. Por outro lado, para fechar esta tela de erro, toque no ícone (1).

1. Botão de voltar
2. Botão para atualizar
   {% endcolumn %}
   {% endcolumns %}

#### **Problema técnico**[​](#problema-técnico) <a href="#problema-tecnico" id="problema-tecnico"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/011f169fd898941b5c751aa4d8108faa0f60f4ff" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Ocorreu um erro interno no aplicativo e é necessário reiniciar a última etapa para um registro correto.

Ao tocar no botão (2), você tentará esta etapa novamente. Caso contrário, para fechar esta tela de erro, toque no ícone (1).

1. Botão de voltar
2. Botão para tentar novamente
   {% endcolumn %}
   {% endcolumns %}

#### **Tempo excedido**[​](#tiempo-superado) <a href="#tiempo-superado" id="tiempo-superado"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/70c8d9989a42730137c07dd247c2da403616bf8c" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Foi excedido o tempo máximo para que o Widget realize a captura.

O caso mais provável é que as condições necessárias para que o Widget realize uma foto adequada não foram atendidas.

Tente novamente esta etapa seguindo as instruções que aparecem na tela, ou tocando no ícone de informação (se houver) para receber dicas.

1. Botão de voltar
2. Botão para tentar novamente
   {% endcolumn %}
   {% endcolumns %}

#### **Inatividade**[​](#inactividad) <a href="#inactividad" id="inactividad"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/4abcfab88e29d591506055584a3974c5bdc35775" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
O aplicativo não detecta movimento. Isso pode ocorrer porque o widget foi iniciado, mas ficou inativo por um tempo.

Tente novamente esta etapa seguindo as instruções que aparecem na tela, ou tocando no ícone de informação (se houver) para receber dicas.

1. Botão de voltar
2. Botão para tentar novamente
   {% endcolumn %}
   {% endcolumns %}

#### **O documento está com brilho**[​](#el-documento-tiene-brillo) <a href="#el-documento-tiene-brillo" id="el-documento-tiene-brillo"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="/files/a912d55e8c223fc9ec4ca36ba4f843a95f51bf46" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
O documento está com brilho e o widget não pode tirar a foto porque não consegue ler os dados corretamente.

Tente novamente esta etapa seguindo as instruções na tela ou tocando no ícone de informação (se estiver disponível) para receber ajuda.

1. Botão para voltar
2. Botão para tentar novamente
   {% endcolumn %}
   {% endcolumns %}