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

# Apresentação

> Verifique a autenticidade de documentos de identificação e extraia seus dados.

Confirme se um documento de identificação é autêntico e se ele pertence a quem o apresenta, com a Documentoscopia.

## O produto

É um serviço de **análise de autenticidade documental** que examina a frente e o verso de um documento de identificação, compara a face do documento com a selfie do titular e devolve um parecer sobre a legitimidade do que foi enviado.

A análise pode ser **automática**, com resposta em minutos, ou conduzida por uma **mesa de análise** com especialistas, quando o caso exige avaliação humana. Você escolhe o modo e o prazo por meio de um preset de workflow.

A Documentoscopia também oferece **extração de dados (OCR)**, que lê os campos de um conjunto de documentos e devolve os valores encontrados. Nesse modo, você envia os documentos sem precisar identificar o que é cada um.

## Como funciona

<Steps>
  <Step title="Envio dos documentos" icon="file-arrow-up" iconType="regular">
    Você envia o CPF do titular e as imagens em base64. A frente do documento é
    obrigatória; verso e selfie são opcionais.
  </Step>

  <Step title="Processamento" icon="gears" iconType="regular">
    O documento entra em análise automática ou na mesa de análise, conforme o
    preset escolhido.
  </Step>

  <Step title="Acompanhamento" icon="magnifying-glass" iconType="regular">
    Consulte o documento pelo identificador para saber em que etapa ele está.
  </Step>

  <Step title="Resultado" icon="badge-check" iconType="regular">
    Ao final, o documento recebe um parecer: aprovado, rejeitado ou encaminhado
    para revisão manual.
  </Step>
</Steps>

Cada documento enviado passa pelos seguintes estados:

| Status       | Descrição                              |
| :----------- | :------------------------------------- |
| `PROCESSING` | Análise em andamento                   |
| `COMPLETED`  | Análise concluída                      |
| `ERROR`      | Erro registrado durante o envio        |
| `FAILED`     | Falha no processamento                 |
| `TIMEOUT`    | Tempo limite de processamento excedido |

Quando a análise termina, o documento passa a `COMPLETED` e o campo `result` traz o parecer:

| Resultado       | Descrição                                 |
| :-------------- | :---------------------------------------- |
| `APPROVED`      | Documento aprovado                        |
| `REJECTED`      | Documento rejeitado                       |
| `MANUAL_REVIEW` | Documento encaminhado para revisão manual |
| `ERROR`         | Não foi possível concluir a análise       |

### Recomendações

Para garantir a performance e evitar rejeições no envio, siga as especificações abaixo:

* Imagens e documentos enviados em **data URI base64**, no formato `data:image/jpeg;base64,...`
* **Até 10 MB por arquivo**, com no máximo **50 MB** no corpo da requisição
* Documentos em **JPG, JPEG, PNG ou PDF**; selfie apenas em **JPG, JPEG ou PNG**
* O conteúdo do arquivo precisa corresponder ao tipo declarado no data URI
* CPF com **11 dígitos** e dígitos verificadores válidos, com ou sem máscara

## FAQ

Dúvidas mais comuns sobre nosso produto:

<AccordionGroup>
  <Accordion title="Existe um tamanho máximo para os arquivos enviados?">
    Cada arquivo pode ter até **10 MB** e o corpo da requisição, no total, até **50 MB**.
  </Accordion>

  <Accordion title="Posso enviar a selfie em PDF?">
    Não. A selfie aceita apenas **JPG, JPEG e PNG**. O PDF é aceito somente na
    frente e no verso do documento.
  </Accordion>

  <Accordion title="Como escolho entre análise automática e mesa de análise?">
    Pelo campo `workflowPresetAlias` no envio. Os presets `auto` são processados
    automaticamente e os presets `mesa` passam por especialistas, com prazos que
    vão de **15 minutos a 24 horas**. Consulte os presets disponíveis no endpoint
    de presets de workflow.
  </Accordion>

  <Accordion title="Quando os arquivos processados ficam disponíveis para download?">
    Somente depois que o documento é enviado para análise e recebe um
    identificador de lote. Antes disso, a consulta de arquivos retorna **422**.
  </Accordion>

  <Accordion title="Qual a diferença entre a análise de documentos e o OCR?">
    A análise de documentos avalia a **autenticidade** de um documento de identificação, com frente, verso e selfie identificados no envio. O OCR **extrai os campos** de até 20 documentos, enviados sem identificação, e devolve os valores lidos.
  </Accordion>
</AccordionGroup>

## Próximos passos

Escolha entre entender como instalar o produto ou explorar outras soluções:

<Columns cols={2}>
  <Column>
    <Card title="Comece a usar agora" icon="sparkles" href="/plataforma/documentoscopia/api/post-documents-import">
      Entenda como enviar documentos para análise
    </Card>
  </Column>

  <Column>
    <Card title="Conheça o ID Check" icon="circle-check" href="/plataforma/id-check/apresentacao">
      Verifique identidade em tempo real por biometria facial
    </Card>
  </Column>
</Columns>