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

# Verificações

> Encontre uma verificação, leia a jornada inteira, decida o que ficou em revisão e exporte o dossiê.

Cada linha em [Verificações](https://painel.legitimuz.com/verifications) é a jornada de uma pessoa.
É a tela onde o time de compliance passa o dia.

## Encontrar uma verificação

A lista tem duas visões, no topo.

| Visão            | O que reúne                                           |
| ---------------- | ----------------------------------------------------- |
| **Onboarding**   | a primeira verificação de uma pessoa, o cadastro      |
| **Transacional** | verificações recorrentes, feitas em momentos de risco |

### Buscar e filtrar

A busca aceita o nome ou o documento da pessoa. Os filtros recortam a lista.

| Filtro         | Para quê                                        |
| -------------- | ----------------------------------------------- |
| **Período**    | a janela de tempo, com padrão de 30 dias        |
| **Status**     | um dos cinco [status](/api/verification-status) |
| **Fluxos**     | qual fluxo a verificação percorreu              |
| **Documentos** | o tipo de documento apresentado                 |
| **Captura**    | como a jornada foi aberta                       |

### As colunas

| Coluna                 | O que mostra                                            |
| ---------------------- | ------------------------------------------------------- |
| **Cliente**            | nome e documento da pessoa, e quantas sessões ela abriu |
| **Fluxo e etapas**     | o fluxo usado e um ícone por etapa percorrida           |
| **Status**             | o desfecho, ou o estado atual                           |
| **Criado em**          | quando a verificação foi criada pela API                |
| **Última verificação** | a atividade mais recente                                |

<Tip>
  Várias sessões numa mesma verificação quase sempre significam dificuldade de captura: a pessoa
  tentou, não conseguiu, voltou. É o padrão que costuma preceder um chamado de suporte.
</Tip>

## Ler uma verificação

Clique em qualquer linha. A URL carrega o `public_id`, então o link é compartilhável. Colar num
chamado leva o colega exatamente para o mesmo lugar.

### O cabeçalho

Acima das abas fica o que não muda de aba para aba.

| Campo              | O que é                                           |
| ------------------ | ------------------------------------------------- |
| **Status**         | um dos cinco [status](/api/verification-status)   |
| **Criado em**      | quando a verificação foi criada                   |
| **Integração**     | o canal que a criou                               |
| **Fluxo**          | a versão de fluxo percorrida                      |
| **Jornada**        | onboarding ou transacional                        |
| **Decisão manual** | presente quando alguém do time alterou o desfecho |
| **Referência**     | o `ref_id` que o seu sistema mandou na criação    |

<Tip>
  A **Referência** é o que liga esta verificação ao seu banco. Se está vazia, o seu backend não
  mandou `ref_id`. Passe a mandar: todo chamado de suporte fica mais curto.
</Tip>

### Biometria

A aba de abertura. Mostra cada etapa biométrica com o desfecho dela.

| Etapa                | O que avalia                                            |
| -------------------- | ------------------------------------------------------- |
| **Liveness**         | se havia uma pessoa viva na frente da câmera            |
| **Facematch**        | se o rosto da selfie é o do documento                   |
| **Documentoscopia**  | se a peça apresentada é um documento legítimo           |
| **Biometria 1:N**    | se aquele rosto já aparece na base com outra identidade |
| **Sinais de device** | o que o aparelho e a rede informaram                    |

Os estados são **Aprovada**, **Falhou**, **Pendente** e **Não se aplica**.

<Info>
  **Não se aplica** significa que o fluxo não pediu a etapa. **Pendente** significa que a análise
  ainda está em andamento: a documentoscopia é assíncrona, e a verificação pode ter sido decidida
  antes de ela terminar.
</Info>

### Composição de Score

Os dois números e os sinais que os formaram. Detalhe em [score](/platform/score).

### Webhooks

O que o seu backend recebeu por causa desta verificação. É a primeira aba a abrir quando o seu
sistema não soube de uma decisão.

Cada entrega traz o evento, o código que o seu servidor devolveu e o número da tentativa. Dali você
reenvia o que falhou.

### Alertas

O que exigiu atenção nesta jornada. O contador aparece na própria aba, então você vê que há algo
antes de abrir.

## Decidir o que ficou em revisão

Uma verificação em revisão terminou sem decisão automática e aguarda uma pessoa.

<Steps>
  <Step title="Abra a verificação e leia as evidências">
    Biometria e Composição de Score respondem quase sempre. Alertas mostra o que pediu atenção.
  </Step>

  <Step title="Altere o status">
    A decisão fica registrada com autor, motivo e data. Ela não apaga o histórico; soma a ele.
  </Step>

  <Step title="Confirme que o seu sistema soube">
    [`verification.decided`](/webhooks/events#verificationdecided) dispara de novo, agora com o
    status final.
  </Step>
</Steps>

<Info>
  O seu handler de webhook precisa aceitar receber `verification.decided` duas vezes para a mesma
  verificação: uma quando ela entrou em revisão, outra quando alguém decidiu. O `decided_at`
  preserva o instante original.
</Info>

## Exportar

| O que        | Onde                        | Para quê                                          |
| ------------ | --------------------------- | ------------------------------------------------- |
| **Listagem** | botão **Exportar** na lista | análise em planilha, conciliação                  |
| **Dossiê**   | dentro de uma verificação   | auditoria, resposta a regulador, pedido da pessoa |

O dossiê traz identificação, dados cadastrais, scores, etapas, análise biométrica, composição de
score e as imagens enviadas. Etapa que o fluxo não pediu é escrita como tal, não omitida.

<Warning>
  O dossiê contém dado pessoal e biometria. Quando você o compartilha, ele sai da sua empresa.
  Trate o envio como tratamento de dado sensível. Veja [dados e privacidade](/help/data-and-privacy).
</Warning>

## Quem vê o quê

A tela respeita o papel de quem abriu.

| Permissão                            | Efeito                                                   |
| ------------------------------------ | -------------------------------------------------------- |
| `verificações: ler`                  | abre a lista e a verificação                             |
| `dados pessoais da verificação: ler` | mostra o documento em claro; sem ela, ele fica mascarado |
| `verificações: exportar`             | libera os dois tipos de exportação                       |

O documento em claro tem permissão própria de propósito. Conceda-a só a quem precisa dela para
trabalhar.

<Card title="Membros e permissões" icon="shield-check" href="/platform/organization/members" horizontal>
  Como montar um papel que vê a verificação sem ver o CPF.
</Card>

## Próximo passo

<Card title="8. Score" icon="gauge" href="/platform/score" horizontal>
  Como ler os dois números e os sinais por trás deles.
</Card>