Gerenciando Veiculos
Veiculos sao o nucleo da sua operacao de frota. Este guia cobre tudo que voce precisa saber sobre adicionar, configurar e gerenciar veiculos no painel Levy Fleets.
Visao Geral
O sistema de gerenciamento de veiculos permite que voce:
- Adicione veiculos individuais ou importe em massa via CSV
- Rastreie localizacao e status de veiculos em tempo real
- Gerencie conectividade IoT e telemetria
- Controle disponibilidade e modo de manutencao de veiculos
- Gere e imprima codigos QR para veiculos
Acessando Veiculos
Via Painel
- Navegue ate Painel > Veiculos
- Veja a lista de todos os veiculos com status
- Clique em qualquer veiculo para ver detalhes
Via Mapa da Frota
- Navegue ate Painel > Mapa da Frota
- Veja veiculos em um mapa
- Clique em marcadores de veiculos para acoes rapidas
Adicionando Veiculos
Adicionar Veiculo Individual
Abrir Formulario de Adicionar Veiculo
Clique em + Adicionar Veiculo na pagina de Veiculos
Inserir Informacoes Basicas
Preencha os campos obrigatorios:
- Numero do Veiculo: Identificador unico (ex: VEH-001)
- Modelo: Selecione da lista de modelos de veiculos
Configurar Dispositivo IoT
Adicione detalhes do dispositivo IoT:
- IMEI IoT: Identificador unico do dispositivo
- Tipo IoT: Selecione o fabricante do dispositivo
Definir Localizacao Inicial
Opcionalmente defina a localizacao inicial do veiculo:
- Insira coordenadas manualmente, ou
- Clique no mapa para definir posicao
Salvar Veiculo
Clique em Salvar para criar o veiculo
Importar Varios Veiculos
Para adicionar muitos veiculos de uma vez, use a funcao de importacao CSV:
- Prepare seu arquivo CSV com colunas obrigatorias
- Navegue ate Veiculos > Importar
- Faca upload do arquivo CSV
- Revise e confirme a importacao
Veja Importacao em Massa de Veiculos para instrucoes detalhadas.
Campos do Veiculo
Campos Obrigatorios
| Campo | Descricao | Exemplo |
|---|---|---|
vehicle_number | Identificador unico | VEH-001 |
model_uuid | Referencia ao modelo do veiculo | UUID do modelo |
Campos Opcionais
| Campo | Descricao | Exemplo |
|---|---|---|
qr_code | Codigo QR para escaneamento pelo app | QR-ABC123 |
iot_imei | IMEI do dispositivo IoT | 123456789012345 |
iot_type | Tipo de dispositivo IoT | segway, okai, etc. |
latitude | Latitude atual | 52.5200 |
longitude | Longitude atual | 13.4050 |
battery_level | Porcentagem de bateria | 85 |
status | Status atual | available, in_use, etc. |
Status de Veiculos
Veiculos podem ter os seguintes status:
| Status | Descricao | Icone |
|---|---|---|
available | Pronto para aluguel | Verde |
in_use | Atualmente em viagem | Azul |
reserved | Reservado por cliente | Amarelo |
maintenance | Em modo de manutencao | Laranja |
offline | Sem conexao IoT | Cinza |
low_battery | Bateria abaixo do limite | Vermelho |
Transicoes de Status
available -> in_use (cliente inicia viagem)
in_use -> available (viagem termina)
available -> maintenance (operador ativa manutencao)
maintenance -> available (operador desativa manutencao)
* -> offline (conexao IoT perdida)
offline -> * (conexao IoT restaurada)
Localizacao do Veiculo
Atualizacoes de Localizacao em Tempo Real
A localizacao do veiculo e atualizada atraves de:
- Telemetria IoT - Dispositivos enviam atualizacoes periodicas de GPS
- Eventos de Viagem - Localizacao atualizada em inicio/fim de viagem
- Atualizacao Manual - Operadores podem definir localizacao manualmente
Visualizacao de Mapa
O Mapa da Frota mostra todos os veiculos com:
- Marcadores codificados por cor por status
- Nivel de bateria em tooltips
- Ultima atualizacao
- Acoes rapidas (desbloquear, bloquear, manutencao)
Historico de Localizacao
O historico de localizacao do veiculo e rastreado para:
- Analise de rotas de viagem
- Deteccao de comportamento incomum
- Fins de auditoria
Gerenciamento de IoT
Tipos de Dispositivo Suportados
Levy Fleets suporta multiplos fabricantes de IoT:
| Tipo | Fabricante | Recursos |
|---|---|---|
segway | Segway/Ninebot | GPS, bateria, bloqueio |
okai | OKAI | GPS, bateria, bloqueio, alarme |
omni | Omni | GPS, bateria, bloqueio |
teltonika | Teltonika | GPS, bateria |
custom | Personalizado | Configuravel |
Vinculando Dispositivo IoT
Obter IMEI do Dispositivo
Encontre o IMEI do dispositivo na etiqueta ou embalagem
Adicionar ao Veiculo
Insira o IMEI no campo iot_imei do veiculo
Selecionar Tipo IoT
Escolha o tipo de dispositivo correto
Verificar Conexao
Verifique o status do dispositivo em Telemetria
Status de Conexao IoT
| Status | Significado |
|---|---|
| Online | Dispositivo conectando normalmente |
| Offline | Sem comunicacao recente |
| Erro | Problema de conexao |
Modo de Manutencao
O modo de manutencao remove temporariamente um veiculo da frota disponivel.
Ativando Manutencao
- Abra a pagina de detalhes do veiculo
- Clique no botao Modo de Manutencao
- Opcionalmente adicione uma nota explicando o motivo
- Veiculo fica indisponivel para viagens
Desativando Manutencao
- Abra a pagina de detalhes do veiculo
- Clique em Sair do Modo de Manutencao
- Veiculo volta a estar disponivel
Veja Modo de Manutencao para mais detalhes.
Codigos QR
Cada veiculo pode ter um codigo QR unico para escaneamento pelo app movel.
Gerando Codigo QR
- Abra a pagina de detalhes do veiculo
- Clique em Gerar QR
- Sistema cria codigo QR unico
- Baixe ou imprima o codigo
Escaneando Codigo QR
Clientes usam o app movel para:
- Abrir o scanner de QR
- Escanear o codigo no veiculo
- Iniciar viagem diretamente
Veja Geracao de Codigo QR para mais detalhes.
Filtragem e Busca
Opcoes de Filtro
Filtre veiculos por:
- Status: available, in_use, maintenance, etc.
- Modelo: Tipo de veiculo
- Bateria: Acima/abaixo de nivel
- Localizacao: Dentro de zona especifica
Busca
Busque veiculos por:
- Numero do veiculo
- Codigo QR
- IMEI IoT
- UUID
Acoes em Massa
Selecao Multipla
- Marque a caixa de selecao ao lado dos veiculos
- Ou use "Selecionar Todos" para selecionar pagina inteira
- Escolha acao no menu de acoes em massa
Acoes Disponiveis
| Acao | Descricao |
|---|---|
| Ativar Manutencao | Colocar veiculos selecionados em manutencao |
| Desativar Manutencao | Remover veiculos selecionados de manutencao |
| Atualizar Modelo | Alterar modelo de veiculos selecionados |
| Exportar | Exportar dados de veiculos selecionados |
Exportacao de Dados
Exportar para CSV
- Filtre veiculos conforme necessario
- Clique em Exportar
- Escolha formato CSV
- Arquivo e baixado
Campos Exportados
- Numero do veiculo
- Modelo
- Status
- Bateria
- Ultima localizacao
- Ultimo update
- IMEI IoT
Integracao com Telemetria
Dados de Telemetria
Veiculos com dispositivos IoT enviam:
| Dado | Frequencia | Descricao |
|---|---|---|
| Localizacao | 30s - 5min | Coordenadas GPS |
| Bateria | 1min | Nivel de bateria |
| Status | Evento | Bloqueio, movimento, etc. |
| Velocidade | 10s | Velocidade atual |
Visualizando Telemetria
- Abra a pagina de detalhes do veiculo
- Navegue ate a aba Telemetria
- Veja historico de dados e graficos
Veja Telemetria de Veiculos para mais detalhes.
Solucao de Problemas
Veiculo Nao Aparece
Possiveis causas:
- Veiculo foi excluido
- Filtros ativos escondendo o veiculo
- Veiculo pertence a outra subconta
Solucoes:
- Limpe filtros
- Busque pelo numero exato
- Verifique subconta correta
Localizacao Nao Atualiza
Possiveis causas:
- Dispositivo IoT offline
- GPS sem sinal
- Problema de conectividade
Solucoes:
- Verifique status do dispositivo IoT
- Aguarde proxima atualizacao
- Verifique cobertura da area
Bateria Mostra 0%
Possiveis causas:
- Bateria realmente descarregada
- Sensor de bateria com defeito
- Ultima leitura desatualizada
Solucoes:
- Verifique fisicamente o veiculo
- Reinicie o dispositivo IoT
- Aguarde proxima atualizacao de telemetria
Melhores Praticas
Nomenclatura de Veiculos
- Use prefixos consistentes - Ex: VEH-001, VEH-002
- Inclua tipo no numero - Ex: SCOOT-001, BIKE-001
- Evite caracteres especiais - Use apenas letras, numeros e hifens
Organizacao da Frota
- Mantenha modelos atualizados - Facilita filtragem e relatorios
- Use manutencao proativamente - Remova veiculos antes de quebrar
- Monitore bateria regularmente - Recarregue antes de chegar a 0%
Seguranca
- Verifique IMEI ao cadastrar - Evite duplicatas
- Mantenha QR codes seguros - Substitua se danificados
- Monitore veiculos offline - Podem indicar roubo
Proximos Passos
- Pagina de Detalhes do Veiculo - Detalhes completos de cada veiculo
- Importacao em Massa - Importar muitos veiculos
- Modelos de Veiculos - Configurar tipos de veiculos
- Telemetria - Dados de dispositivos IoT
Frota Pronta
Com veiculos configurados corretamente, voce pode comecar a operar sua frota. Monitore regularmente status e bateria para manter alta disponibilidade.