Transportes - Cadastrar Veículo

O que é

A página Novo Veículo é o formulário usado para registrar um veículo da frota - próprio ou de uma empresa parceira - dentro do Viagilize. O cadastro guarda dados de identificação (modelo, placa, Renavam, ano), classifica o tipo (van, micro-ônibus, ônibus, ônibus leito, semileito, executivo, double decker, minivan ou carro), define a capacidade total de assentos e marca quais comodidades estão disponíveis a bordo.

O usuário geralmente chega aqui logo após cadastrar uma Empresa de Transporte, ou quando precisa adicionar mais um veículo à frota para alocar em uma nova excursão. O vínculo com a empresa de transporte é obrigatório: sem nenhuma empresa cadastrada, o formulário bloqueia o botão de gravação e mostra um atalho para criar a primeira empresa antes de continuar.

Como usar

1. Vá em Cadastros > Veículos no sidebar e clique em Novo Veículo no canto superior direito da listagem.
2. (Opcional) No card Foto do Veículo, envie uma imagem (proporção 3:2, recortada via Cropper) que será usada para identificação visual nas listas e mapas de assentos.
3. No card Dados do Veículo, preencha:
   • Empresa de Transporte - selecione a transportadora dona ou responsável pelo veículo. Só aparecem empresas ativas. Se a URL vier com ?transporte_id={id}, esse campo já vem pré-selecionado.
   • Tipo de Veículo - escolha entre Van, Micro-ônibus, Ônibus, Ônibus Leito, Ônibus Semileito, Ônibus Executivo, Double Decker, Minivan ou Carro. Define os templates de layout sugeridos depois.
   • Capacidade Total - número inteiro de 1 a 100. Representa o total de assentos vendáveis; os lugares de motorista e guia não entram nessa contagem.
   • Modelo - texto livre (ex.: "Mercedes-Benz Sprinter"). Obrigatoriedade depende de campos personalizados da sua empresa.
   • Placa - convertida automaticamente para maiúsculas e limpa de caracteres não alfanuméricos, limitada a 7 dígitos. Aceita formato Mercosul (ABC1D23) ou antigo (ABC1234). Precisa ser única no sistema.
   • Renavam - até 15 caracteres. Obrigatoriedade depende de campos personalizados.
   • Ano de Fabricação - entre 1900 e o próximo ano.
4. No card Comodidades, marque os checkboxes correspondentes ao que o veículo oferece: Ar Condicionado, Wi-Fi, Banheiro, TV, Tomadas e Reclináveis. Os ícones servem só de referência visual.
5. (Opcional) Em Observações, registre informações internas livres sobre o veículo (uso restrito, particularidades operacionais).
6. No rodapé, decida o status com o toggle Veículo ativo (já vem ligado por padrão - desligar deixa o veículo fora das listas de alocação).
7. Clique em Cadastrar Veículo para salvar e ir direto para a tela de detalhes do veículo.

Casos especiais

Sem empresa de transporte cadastrada

Quando você ainda não tem nenhuma empresa de transporte ativa, o seletor Empresa de Transporte é substituído por um aviso âmbar com o texto "Nenhuma empresa de transporte cadastrada" e um botão Cadastrar Empresa de Transporte. Nesse estado o botão Cadastrar Veículo fica desabilitado - é obrigatório criar a empresa primeiro e voltar.

Pré-selecionar a empresa via link

Abrir a URL /admin/veiculos/create?transporte_id={id} já deixa o campo Empresa de Transporte preenchido. Útil para fluxos que partem da tela de detalhes da empresa.

Cadastrar vários veículos seguidos

Em vez de Cadastrar Veículo, abra o dropdown ao lado e escolha Cadastrar e adicionar outro. O sistema grava o veículo atual e abre um novo formulário em branco, com a mensagem "Veículo cadastrado com sucesso! Cadastre um novo veículo." Use Cadastrar e continuar editando quando quiser ajustar fotos ou layouts logo após salvar.

Campos personalizados (Custom Fields)

Se você configurou campos personalizados para a entidade veiculo, eles aparecem em duas posições: inline dentro do card Dados do Veículo (seção dados_gerais) e em cards próprios abaixo (demais seções). Campos marcados como obrigatórios no catálogo passam a exigir preenchimento, inclusive os campos padrão Modelo, Placa, Renavam, Ano de Fabricação, Foto e Observações.

Erros comuns e como resolver

• "The placa has already been taken." - Causa: já existe outro veículo cadastrado com a mesma placa. Solução: confirme se o veículo não foi cadastrado antes; se for outro veículo, verifique a placa digitada.
• "The capacidade total field must be at least 1." - Causa: campo Capacidade Total ficou vazio ou recebeu zero/negativo. Solução: informe um inteiro de 1 a 100.
• "The transporte id field is required." - Causa: nenhuma Empresa de Transporte selecionada (ou nenhuma foi cadastrada ainda). Solução: cadastre uma empresa de transporte primeiro pelo botão âmbar do próprio formulário.
• "The tipo field is required." - Causa: o seletor Tipo de Veículo ficou vazio. Solução: escolha um dos tipos da lista.
• "The ano fabricacao must be a number between 1900 and {ano+1}." - Causa: ano fora do intervalo válido. Solução: corrija para um ano entre 1900 e o próximo ano.
• Botão "Cadastrar Veículo" desabilitado - Causa: não há nenhuma empresa de transporte ativa na sua empresa. Solução: clique em Cadastrar Empresa de Transporte no aviso âmbar e crie a primeira empresa.

Onde encontrar

• URL: /admin/veiculos/create
• Caminho no menu: Cadastros > Veículos > Novo Veículo
• Permissão necessária: criar os veículos
• Módulo necessário: nenhum

Veja também

• Cadastrar Empresa de Transporte
• Detalhes do Veículo
• Editar Veículo
• Layout de Assentos
• Configurar Assentos
• Vincular Transporte a Excursão