Como importar veículos em massa via CSV
Se você está migrando de outro sistema ou precisa cadastrar muitos veículos de uma vez, a importação por CSV é o caminho mais rápido. O processo tem três etapas: carregar o arquivo, revisar cada veículo individualmente e salvar tudo de uma vez.
A importação exige a permissão Gerenciar veículos (can_manage_vehicles).
Passo 1: Acesse a página de importação
Na lista de veículos, clique em Importar CSV dentro do menu de ações (botão com ícone de seta para baixo, ao lado de Novo veículo). Você será levado à tela de importação de veículos.
Passo 2: Baixe o modelo CSV
Na tela de upload, clique em Baixar CSV de exemplo para obter o arquivo modelo-importacao-veiculos.csv. Abra-o em Excel, Google Sheets ou qualquer editor de planilhas.
Colunas do modelo
| Coluna | Obrigatório | Formato | Exemplo |
|---|---|---|---|
| placa | Não | Alfanumérico | ABC1D23 |
| chassi | Não | 17 dígitos | 9C2KC1670JR500123 |
| renavam | Não | Apenas números | 12345678901 |
| cor | Sim | Texto livre | Prata |
| km | Sim | Número inteiro ≥ 0 | 15000 |
| preco_compra | Sim | Decimal (ponto como separador) | 18500.00 |
| data_compra | Sim | YYYY-MM-DD ou DD/MM/YYYY | 2025-03-15 |
| status | Não | preparando, disponivel, reservado, vendido | disponivel |
Cada placa deve aparecer uma única vez no arquivo. Linhas com placa duplicada geram erro de validação e não são importadas.
Passo 3: Envie o arquivo
De volta ao painel, arraste o CSV para a área de upload ou clique para selecionar o arquivo. O sistema valida os cabeçalhos e já sinaliza erros estruturais antes de avançar (ex.: coluna cor ausente).
Passo 4: Revise cada veículo
Após o upload, você entra na fase de revisão. A barra de progresso no topo mostra:
- Verde: veículo verificado e pronto para salvar
- Amarelo: veículo pendente de revisão
- Vermelho: veículo com erro que impede o salvamento
Para cada veículo, o formulário permite completar os dados que o CSV não contém: marca, modelo, versão, ano (via tabela FIPE), unidade, fornecedor, preço de anúncio, chassi, RENAVAM, nome do proprietário e outras informações opcionais.
Depois de preencher, clique em Verificar para marcar o veículo como pronto. Use as setas para navegar entre os itens ou clique diretamente em um indicador na barra de progresso.
Veículos marcados como verificados ficam prontos para salvar mesmo que outros ainda estejam pendentes: você pode salvar só os verificados e continuar revisando o restante depois.
Passo 5: Salve no estoque
Quando todos os veículos desejados estiverem verificados, clique em Salvar veículo(s) (o botão exibe o número de veículos verificados). O sistema envia cada veículo individualmente e exibe o resultado em tempo real:
- Sucesso: veículo adicionado ao estoque
- Erro: mensagem descrevendo o problema (ex.: placa já cadastrada no sistema)
Ao final, clique em Ver estoque para conferir os novos registros.
Exportar o estoque em CSV
Para baixar seu estoque como planilha, abra o menu de ações (botão com ícone de seta para baixo, ao lado de Novo veículo) e clique em Exportar CSV. O download começa na hora, com o nome veiculos-AAAA-MM-DD.csv.
A exportação respeita o filtro de status ativo na lista. Se você filtrou por Disponível, por exemplo, só os veículos disponíveis entram no arquivo. Sem filtro, todo o estoque é exportado.
O arquivo traz uma coluna por informação principal do veículo: Marca, Modelo, Versão, Ano, KM, Cor, Tipo, Combustível, Câmbio, Placa, Status, Preço de Venda e Data de Entrada. É compatível com Excel e Google Sheets (codificação UTF-8).
Exportar exige a permissão Gerenciar veículos (can_manage_vehicles): o botão só aparece para quem pode gerenciar o estoque.