Importacao em Massa de Veiculos

A funcao de importacao em massa permite adicionar varios veiculos ao seu sistema de uma vez usando um arquivo CSV. Isso e ideal para configuracao inicial da frota ou adicao de lotes de veiculos novos.

Visao Geral

Quando Usar

• Configuracao inicial - Ao iniciar operacoes com muitos veiculos
• Adicao de lote - Quando receber novos veiculos em grande quantidade
• Migracao - Ao transferir dados de outro sistema
• Atualizacao em massa - Para modificar varios veiculos de uma vez

Beneficios

Preparando o Arquivo CSV

Formato do Arquivo

O arquivo deve ser:

• Formato CSV (valores separados por virgula)
• Codificacao UTF-8
• Primeira linha com cabecalhos

Colunas Obrigatorias

Colunas Opcionais

Arquivo de Exemplo

vehicle_number,model_name,qr_code,iot_imei,iot_type,latitude,longitude
VEH-001,E-Scooter Pro,QR-001,123456789012345,segway,52.5200,13.4050
VEH-002,E-Scooter Pro,QR-002,123456789012346,segway,52.5201,13.4051
VEH-003,E-Bike Standard,QR-003,123456789012347,okai,52.5202,13.4052

Processo de Importacao

Acessando a Funcao

Validacao

Apos fazer upload, o sistema valida:

1. Formato do arquivo - CSV valido com cabecalhos
2. Colunas obrigatorias - Presenca de campos necessarios
3. Valores unicos - Sem duplicatas de vehicle_number
4. Modelo valido - Modelo existe no sistema
5. IMEI valido - Formato correto do IMEI

Tela de Revisao

A tela de revisao mostra:

Confirmando Importacao

Tratamento de Erros

Tipos de Erro

Importacao Parcial

Se algumas linhas tiverem erro:

1. Voce pode importar apenas as linhas validas
2. Ou cancelar e corrigir todo o arquivo
3. Linhas com erro sao listadas para correcao

Log de Importacao

Apos a importacao, um log e gerado com:

• Quantidade de veiculos importados
• Quantidade de erros
• Detalhes de cada erro
• Data e hora da importacao
• Usuario que realizou

Atualizando Veiculos Existentes

Modo de Atualizacao

A importacao pode atualizar veiculos existentes:

1. Marque a opcao Atualizar existentes
2. Veiculos com mesmo vehicle_number serao atualizados
3. Novos veiculos serao criados

Campos Atualizaveis

Ao atualizar, os seguintes campos podem ser modificados:

• qr_code
• iot_imei
• iot_type
• latitude
• longitude
• battery_level

Modelos de Arquivo

Baixando Template

1. Na pagina de importacao, clique em Baixar Template
2. O arquivo CSV de exemplo sera baixado
3. Use como base para seus dados

Templates Disponiveis

Validacao de Dados

Regras de Validacao

vehicle_number

• Obrigatorio
• Maximo 50 caracteres
• Unico no sistema
• Permitido: letras, numeros, hifens

model_name

• Obrigatorio
• Deve corresponder a modelo existente
• Case-sensitive

qr_code

• Opcional
• Maximo 100 caracteres
• Unico se fornecido

iot_imei

• Opcional
• Exatamente 15 digitos
• Unico se fornecido

iot_type

• Opcional
• Deve ser tipo valido: segway, okai, omni, teltonika, custom

latitude/longitude

• Opcionais
• Latitude: -90 a 90
• Longitude: -180 a 180

Boas Praticas

Preparacao

1. Verifique modelos - Confirme que modelos existem no sistema
2. Limpe dados - Remova espacos extras e caracteres especiais
3. Valide IMEI - Confirme que IMEIs estao corretos
4. Teste pequeno - Importe alguns veiculos primeiro

Durante Importacao

1. Revise cuidadosamente - Verifique preview antes de confirmar
2. Corrija erros - Nao ignore linhas com problema
3. Documente - Anote o que foi importado

Apos Importacao

1. Verifique veiculos - Confira se todos aparecem corretamente
2. Teste IoT - Verifique conexao dos dispositivos
3. Configure QR - Imprima e aplique codigos QR

Limites e Restricoes

Limites de Importacao

Tempo de Processamento

Solucao de Problemas

Arquivo Nao Carrega

Possiveis causas:

• Arquivo muito grande
• Formato incorreto
• Codificacao errada

Solucoes:

1. Verifique tamanho do arquivo
2. Salve como CSV UTF-8
3. Tente com menos linhas

Modelo Nao Encontrado

Possiveis causas:

• Nome incorreto
• Modelo nao cadastrado
• Erro de digitacao

Solucoes:

1. Verifique lista de modelos no sistema
2. Copie nome exato do modelo
3. Crie o modelo antes de importar

IMEI Duplicado

Possiveis causas:

• Mesmo IMEI em varias linhas
• IMEI ja usado por outro veiculo

Solucoes:

1. Verifique duplicatas no CSV
2. Busque por IMEI no sistema
3. Corrija ou remova duplicatas

Integracao com API

Importacao via API

Para automacao, use o endpoint de importacao:

POST /api/vehicles/import
Content-Type: multipart/form-data

file: [arquivo CSV]
update_existing: true/false

Resposta

{
  "success": true,
  "imported": 45,
  "updated": 5,
  "errors": 2,
  "error_details": [
    {
      "line": 12,
      "error": "Modelo nao encontrado"
    }
  ]
}

Proximos Passos

• Gerenciando Veiculos - Gerenciar veiculos importados
• Modelos de Veiculos - Configurar modelos
• Telemetria - Verificar conexao IoT