Clientes - Documentos do Cliente

O que é

A página Documentos de Clientes é a fila central onde ficam todos os documentos enviados pelos passageiros e seus dependentes pelo Portal do Cliente: RG, CPF, CNH, Passaporte, Certidão de Nascimento e outros. Cada arquivo entra com status Pendente e aguarda revisão da agência antes de virar Aprovado ou Reprovado.

Você normalmente chega aqui pelo atalho Tarefas > Documentos Pendentes no sidebar (que só aparece quando há pelo menos um documento aguardando) ou quando um cliente avisa que enviou um documento e precisa de liberação para embarcar em uma excursão que exige o anexo. Os documentos pendentes ficam sempre no topo da lista, independentemente do filtro.

Como usar

1. Vá em Tarefas > Documentos Pendentes no menu lateral.
2. Use os cards de estatística no topo (Total, Pendentes, Aprovados, Reprovados) como atalho rápido para filtrar por status.
3. Use a barra de filtros logo abaixo para refinar:
   • Buscar por nome, email ou CPF do cliente - campo de texto livre.
   • Status - Pendentes, Aprovados ou Reprovados.
   • Tipo - RG, CPF, CNH, Passaporte, Certidão de Nascimento ou Outro.
   • Cliente - seleção direta de um cliente específico.
4. Em cada linha, clique em Visualizar para abrir o modal com o preview do arquivo (imagem ou PDF embutido), os dados do cliente, o dependente (se houver) e a Análise da IA quando o documento foi pré-analisado pelo Gemini (badge roxa IA).
5. Dentro do modal, ou direto pelos botões da linha, clique em Aprovar ou Reprovar. Documentos já decididos só exibem o botão Abrir Original.

Casos especiais

Aprovar um documento

1. Clique em Aprovar (botão verde no rodapé da linha ou dentro do modal de visualização).
2. No popup de confirmação, clique em Confirmar Aprovação.
3. O sistema registra quem aprovou e quando, troca o status para Aprovado e o cliente é notificado.

Reprovar um documento

1. Clique em Reprovar (botão vermelho - disponível apenas em documentos Pendentes).
2. Preencha o campo Motivo da Reprovação com pelo menos 10 caracteres (ex: "Foto embaçada, refazer com boa iluminação").
3. Clique em Confirmar Reprovação. O cliente recebe o motivo e pode reenviar o documento.

Documento de dependente

Quando o documento pertence a um dependente do cliente (filho, cônjuge), a linha mostra dois ícones: o do titular e o do dependente em roxo. A aprovação funciona igual - o vínculo é mantido automaticamente.

Documento pré-analisado pela IA

Documentos com a badge roxa IA já passaram pela análise automática do Gemini. Dentro do modal aparece a seção Análise da IA com a decisão sugerida e observações (ex: nome confere, validade ok). A decisão final continua sendo manual - use a sugestão como apoio, não como aprovação automática.

Excluir um documento aprovado por engano

1. Abra o menu de 3 pontinhos na linha do documento.
2. Clique em Excluir (item vermelho no fim do dropdown).
3. Confirme em Confirmar Exclusão. O arquivo é removido do storage e o cliente fica livre para enviar um novo no Portal.

Erros comuns e como resolver

• "O motivo da reprovação é obrigatório." - Você clicou em Confirmar Reprovação sem digitar nada. Escreva ao menos 10 caracteres explicando a causa.
• "O motivo deve ter pelo menos 10 caracteres." - Texto muito curto (ex: "ruim"). Detalhe o motivo para o cliente entender o que ajustar.
• Botões Aprovar/Reprovar não aparecem na linha - O documento já está Aprovado ou Reprovado. Para refazer a decisão, exclua e peça novo envio ao cliente.
• Item "Documentos Pendentes" sumiu do sidebar - Não há documentos pendentes no momento. O atalho só aparece quando há fila para revisar. Acesse direto por /admin/clientes/documentos.

Onde encontrar

• URL: /admin/clientes/documentos
• Caminho no menu: Tarefas > Documentos Pendentes
• Permissão necessária: editar os clientes
• Módulo necessário: nenhum

Veja também

• Clientes - Listagem
• Perfil do Cliente