Primeiros Passos - Cadastrar Empresa de Transporte e Veículo

O que é

A empresa de transporte (informalmente "transportadora") é o cadastro da empresa responsável por levar os passageiros. Pode ser a própria operadora (frota própria) ou uma empresa terceirizada contratada por viagem. Cada empresa de transporte é dona de um ou mais veículos, e é o veículo que define a capacidade de assentos da excursão.

O fluxo é sempre nesta ordem: primeiro a empresa, depois o veículo vinculado a ela. Se você tentar criar o veículo sem ter nenhuma empresa cadastrada, a tela de criação mostra um aviso laranja com um atalho para cadastrar a empresa primeiro. Esses dois cadastros são pré-requisito para criar excursões com transporte associado.

Como usar

1. Cadastrar a Empresa de Transporte

1. Vá em Cadastros > Empresas de Transporte no menu lateral.
2. Clique em Novo Transporte (botão azul flutuante no canto superior direito).
3. Preencha os campos da seção Dados da Empresa:
   • Nome Fantasia - obrigatório, é o nome que aparece em listas e na ficha do veículo.
   • Razão Social, CNPJ, E-mail, Telefone, WhatsApp, Site - opcionais por padrão (podem virar obrigatórios via Configurações > Cadastros Personalizados). O CNPJ é único no sistema.
4. Preencha a seção Endereço: ao digitar o CEP o sistema busca automaticamente logradouro, bairro, cidade e estado.
5. Preencha a seção Contato Principal com nome, telefone e e-mail do responsável operacional (quem você liga para alinhar a viagem).
6. Mantenha o toggle Transporte ativo ligado (o padrão) para que a empresa apareça nos selects de criação de veículo e excursão.
7. Finalize em Cadastrar Transporte. Use Cadastrar e adicionar outro se for cadastrar várias empresas em sequência.

2. Cadastrar o Veículo

1. Vá em Cadastros > Veículos no menu lateral.
2. Clique em Novo Veículo (botão azul flutuante no canto superior direito).
3. Preencha a seção Dados do Veículo:
   • Empresa de Transporte - obrigatório, selecione a empresa cadastrada no passo anterior.
   • Tipo de Veículo - obrigatório, escolha entre Van, Micro-ônibus, Ônibus, Ônibus Leito, Ônibus Semi-leito, Ônibus Executivo, Ônibus Double Decker, Minivan ou Carro.
   • Capacidade Total - obrigatório, é o número de assentos vendáveis. Esse valor define as vagas da excursão. O texto de ajuda lembra que os assentos de guias são descontados automaticamente.
   • Modelo, Placa, Renavam, Ano de Fabricação - opcionais por padrão. A placa aceita tanto o formato antigo (ABC1234) quanto Mercosul (ABC1D23) e precisa ser única.
4. Na seção Foto do Veículo (no topo) você pode subir uma imagem 3:2 que aparecerá no site público e nos vouchers.
5. Marque as Comodidades disponíveis: Ar Condicionado, Wi-Fi, Banheiro, TV, Tomadas, Poltronas Reclináveis. Cada item marcado vira um ícone na ficha pública do veículo.
6. Finalize em Cadastrar Veículo. Para já editar o registro recém-criado (por exemplo, para configurar o mapa de assentos), use Cadastrar e continuar editando.

3. Configurar o mapa de assentos (opcional, mas recomendado)

1. Na listagem de Cadastros > Veículos, clique em Configurar Assentos na barra de ações do veículo (botão roxo).
2. Use um dos templates predefinidos (Van 15, Micro-ônibus 24, Ônibus 44, Ônibus Leito 28) ou monte o layout manualmente arrastando assentos no grid.
3. Salve o layout. O sistema avisa se a contagem de assentos vendáveis no mapa diverge da Capacidade Total cadastrada (a capacidade cadastrada continua sendo a fonte da verdade - o mapa é só visual para escolha de poltrona).

Casos especiais

Nenhuma empresa cadastrada ainda

Se você clicar em Novo Veículo sem ter nenhuma empresa de transporte ativa, no lugar do select da empresa aparece um aviso laranja "Nenhuma empresa de transporte cadastrada" com um botão direto Cadastrar Empresa de Transporte. Conclua a empresa primeiro e volte para o cadastro do veículo.

Atalho para cadastrar veículo já vinculado

Quando você acessa Cadastros > Veículos > Novo Veículo vindo de uma página de transporte específico, a URL pode trazer ?transporte_id={id}. A empresa já vem pré-selecionada no formulário.

Alterar a capacidade de um veículo já em uso

Ao salvar uma nova Capacidade Total em um veículo, todas as excursões futuras (com data de início igual ou posterior a hoje) que usam esse veículo têm o campo vagas_total atualizado automaticamente. Excursões passadas não são tocadas. Lembre-se de revisar o mapa de assentos para refletir a nova quantidade.

Empresa terceirizada que atualiza os próprios dados

Em cada empresa de transporte existe a ação Portal do Transporte (botão roxo na barra de ações da listagem). Gere o link e envie pela ferramenta de WhatsApp embutida - a transportadora terceirizada poderá atualizar os dados dela, os veículos e os layouts de assentos. As alterações ficam pendentes na sua área Tarefas > Atualizações de Transporte para aprovação.

Excluir uma empresa que possui veículos

Ao excluir uma empresa de transporte com veículos vinculados, o sistema abre o modal Excluir Transporte listando os veículos afetados, exige que você digite a palavra EXCLUIR para confirmar e remove em cascata todos os veículos junto. A exclusão é soft delete (pode ser recuperada via banco se necessário).

Erros comuns e como resolver

• "Empresa de Transporte" obrigatório - Causa: você tentou criar um veículo sem ter nenhuma empresa ativa. Solução: cadastre primeiro a empresa em Cadastros > Empresas de Transporte > Novo Transporte.
• "O campo placa já está sendo utilizado" - Causa: já existe outro veículo cadastrado com essa placa na sua empresa. Solução: verifique se o veículo não foi cadastrado antes; se foi excluído, use a listagem com filtro de inativos ou contate o suporte para restaurar.
• "O campo CNPJ já está sendo utilizado" - Causa: já existe outra empresa de transporte com esse CNPJ. Solução: busque na listagem pelo CNPJ antes de criar de novo - provavelmente está cadastrada como inativa, basta ativá-la pelo menu de ações.
• "O campo capacidade total deve ser pelo menos 1" - Causa: capacidade ficou em branco ou zero. Solução: informe o número total de assentos do veículo (sem descontar guias, o sistema desconta sozinho).
• Mapa de assentos com aviso de divergência - Causa: a contagem de assentos vendáveis no mapa não bate com a Capacidade Total cadastrada. Solução: ajuste o mapa ou edite a capacidade do veículo para que os dois valores coincidam.

Onde encontrar

• URL principal: /admin/transportes (empresas) e /admin/veiculos (veículos)
• Caminho no menu: Cadastros > Empresas de Transporte e Cadastros > Veículos
• Permissão necessária: ver os transportes (listar), criar os transportes (cadastrar), editar os transportes (editar e configurar assentos), excluir os transportes (excluir)
• Módulo necessário: nenhum (recurso nativo)

Veja também

• Bem-vindo ao Viagilize
• Criar sua Primeira Excursão
• Configurar Dados da Empresa