Gestão de Frota: Veículos, Documentos e Alertas

Visão Geral

O módulo de Gestão de Frotas permite controlar veículos, motoristas e documentos da sua frota com extração automática de dados e alertas de vencimento. Você pode cadastrar veículos importando dados do CRLV-e, registrar motoristas pela CNH e enviar documentos que são processados automaticamente por IA.

Painel Principal da Frota

Ao acessar o módulo, você verá:

• Cartões de resumo: total de veículos, motoristas, documentos vencidos, vencendo em 30 dias, regulares e em revisão pendente
• Tabela de documentos: todos os documentos da frota com placa, tipo, número do certificado, vencimento, dias restantes, status e confiança da extração
• Filtros: por placa, tipo de documento e status
• Ações rápidas: Upload de Documento, Alertas, Motoristas

Cadastro de Veículos

Importação Automática pelo CRLV-e

Ao criar um novo veículo, você pode importar os dados automaticamente:

1. Na seção “Importar dados do CRLV-e”, envie o PDF do CRLV-e ou cole o texto do documento
2. Clique em “Extrair Dados”
3. O sistema preenche automaticamente os campos do formulário com os dados extraídos

Campos do Formulário

Identificação do Veículo:

Características:

Proprietário:

Clique em “Cadastrar Veículo” para salvar.

Detalhes do Veículo

Na página de detalhes, você vê todos os dados do veículo, alertas ativos e a tabela de documentos vinculados com vencimentos e status.

Cadastro de Motoristas

Importação Automática pela CNH

Ao criar um novo motorista:

1. Na seção “Importar dados da CNH”, envie o arquivo (PDF, JPG ou PNG) ou cole o texto da CNH
2. Clique em “Extrair Dados”
3. Os campos de CNH são preenchidos automaticamente

Campos do Formulário

Dados Pessoais:

CNH:

Veículos Vinculados:

• Busque por placa ou modelo e selecione os veículos que o motorista opera

Observações:

• Campo de texto livre para anotações sobre o motorista

Lista de Motoristas

A lista exibe nome, CPF, CNH, categoria, validade (com indicador de vencimento), status (Ativo/Inativo), quantidade de veículos e documentos vinculados. Você pode filtrar por nome, CPF, status e situação da CNH.

Upload de Documentos

Como Enviar

1. Clique em “Upload Documento” no painel da frota ou na página de um veículo
2. Preencha o formulário:

Alternativamente, você pode colar o texto do certificado/laudo no campo de texto.

3. Clique em “Enviar para Processamento”

Tipos de Documento Suportados

O Que Acontece Após o Envio

O documento passa pelas seguintes etapas:

1. Processando — a IA está extraindo os dados
2. Revisão Necessária — extração concluída, mas com baixa confiança (revise os dados)
3. Concluído — dados extraídos com sucesso

O sistema extrai automaticamente campos como número do certificado, data de inspeção, data de vencimento, emissor e responsável técnico.

Detalhes do Documento

Na página de detalhes você encontra:

• Status e vencimento: badge colorido com dias restantes
• Confiança da extração: percentual (verde se ≥ 80%, amarelo se menor)
• Dados Extraídos: todos os campos identificados pela IA. Clique em qualquer valor para editar manualmente
• Alertas: avisos de vencimento ou baixa confiança
• Versões Anteriores: se houver múltiplos uploads do mesmo tipo para o veículo
• Histórico: log de ações (upload, revisão, edições)
• Notas: área para adicionar observações sobre o documento

Ações disponíveis:

• Ver Arquivo — abre o PDF/imagem original
• Download — baixa o arquivo original
• Marcar como Revisado — confirma que os dados extraídos foram verificados

Alertas

O sistema gera alertas automaticamente para manter sua frota em conformidade.

Tipos de Alerta

Vencimento:

• Vencimento em 30 dias
• Vencimento em 7 dias
• Vence hoje
• Documento vencido

Qualidade dos Dados:

• Baixa confiança de extração
• Sem data de vencimento detectada
• Inconsistência de dados

Prioridades

Gerenciando Alertas

Na página de Alertas, você pode:

• Filtrar por status (Pendente, Enviado, Reconhecido) e prioridade
• Reconhecer alertas individualmente clicando em “Reconhecer”, indicando que você está ciente
• Ver o documento relacionado diretamente pelo botão “Ver doc”

Os alertas também aparecem na página de detalhes do veículo e do documento.

Integração via API

Listar Veículos

curl -X GET https://textualiza.com.br/api/fleet/vehicles \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Cadastrar Veículo

curl -X POST https://textualiza.com.br/api/fleet/vehicles \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "license_plate": "ABC1D23",
    "renavam": "12345678901",
    "make_model": "VW/24.280 CRM 6X2",
    "fuel_type": "diesel",
    "body_type": "tanque_pp"
  }'

Enviar Documento

curl -X POST https://textualiza.com.br/api/fleet/documents \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -F "file=@crlv.pdf" \
  -F "vehicle=1"

Listar Alertas

curl -X GET https://textualiza.com.br/api/fleet/alerts \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Dicas

• Importe pelo CRLV-e: ao cadastrar um veículo, use a importação automática para evitar erros de digitação na placa, RENAVAM e chassi.
• Detecção automática: se não souber o tipo exato do documento, deixe o campo em branco — o sistema identifica automaticamente.
• Revise extrações com baixa confiança: documentos com confiança abaixo de 80% merecem uma verificação manual dos dados extraídos.
• Monitore os alertas: configure uma rotina de verificação dos alertas para evitar que documentos vençam sem renovação.