Transportes - Visão Geral

O que é

O módulo Transportes centraliza tudo o que envolve a movimentação dos passageiros nas suas excursões: as empresas de transporte (transportadoras próprias ou parceiras), os veículos dessas empresas (ônibus, vans, micro-ônibus, etc.) e o layout de assentos de cada veículo, que alimenta a venda nominal de poltronas.

A página inicial do módulo (/admin/transportes) lista as transportadoras cadastradas com nome fantasia, CNPJ, contato, cidade e a quantidade de excursões em que cada uma já foi usada. É o ponto de chegada quando você precisa revisar a frota disponível antes de montar uma excursão, ou quando vai cadastrar uma transportadora nova para começar a operar uma rota.

Como usar

1. Vá em Cadastros > Empresas de Transporte no sidebar para abrir a listagem.
2. Use a barra de filtros logo abaixo do cabeçalho para encontrar uma transportadora:
   • Busca - pesquisa por nome fantasia, razão social, CNPJ, e-mail, telefone ou cidade.
   • Status - alterna entre Todos, Ativos e Inativos.
3. Em cada linha da lista, abra o olho ao lado do nome para ver os dados rápidos da empresa em modal, sem sair da listagem.
4. Use a barra de ações rápidas do item para entrar em fluxos comuns:
   • Editar - abre o formulário completo da transportadora.
   • Visualizar - vai para a página de detalhes, com lista de excursões já vinculadas.
   • Motoristas - gestão dos motoristas dessa transportadora (requer permissão motoristas.view).
   • Portal do Transporte - gera/copia o link público que a transportadora usa para atualizar dados, veículos e layouts (as alterações ficam pendentes para sua aprovação).
5. Para cadastrar uma nova transportadora, clique em Novo Transporte (botão flutuante no canto superior direito).
6. Para gerenciar veículos, abra Cadastros > Veículos (/admin/veiculos). A listagem de veículos tem filtros por modelo/placa, transporte (empresa), tipo e status, além do botão Novo Veículo.

Casos especiais

Vincular transporte a uma excursão

A associação transportadora ↔ excursão não é feita aqui dentro do módulo de Transportes. Ela acontece na tela da excursão (aba de transportes), onde você escolhe a empresa, seleciona o(s) veículo(s) e define quantas vagas ficam reservadas para venda admin e quantas vão para venda online. O contador N excursões ao lado do nome da transportadora reflete justamente essas vinculações.

Exclusão de transporte com veículos cadastrados

Ao tentar excluir uma transportadora pelo dropdown Ações > Excluir, o sistema verifica se existem veículos vinculados e abre o modal listando placa, modelo e tipo de cada um. Para concluir, é obrigatório digitar EXCLUIR no campo de confirmação. Confirmando, a transportadora e todos os veículos vinculados são excluídos por soft delete em cascata. Não há undo direto pela interface.

Portal do Transporte (autoatendimento da transportadora)

Pela ação Portal do Transporte você gera um link único por transportadora que pode ser enviado por WhatsApp ou copiado. Quem recebe o link consegue atualizar cadastro, veículos e layouts de assentos - mas tudo entra como alteração pendente, dependendo de aprovação do admin antes de refletir na operação. Se o link aparecer marcado como desativado no modal, é preciso reativá-lo na página de detalhes da transportadora.

Lista vazia (primeiro acesso)

Sem nenhuma transportadora cadastrada, a listagem mostra o estado vazio com o atalho Cadastrar primeiro transporte, que leva direto ao formulário de criação. O mesmo padrão vale na listagem de veículos (Cadastrar primeiro veículo).

Erros comuns e como resolver

• "Para confirmar, digite EXCLUIR" - Causa: você clicou em Excluir, mas não digitou a palavra exata no campo de confirmação. Solução: digite EXCLUIR em maiúsculas (o sistema também aceita variações de caixa, mas precisa ser a palavra completa).
• "Erro ao gerar link" (toast vermelho no modal Portal do Transporte) - Causa: falha na requisição ao endpoint de compartilhamento. Solução: recarregue a página e tente novamente; se persistir, verifique se a transportadora ainda existe e se você tem permissão de editar os transportes.
• CNPJ recusado no cadastro - Causa: o CNPJ é único por empresa; já existe outra transportadora com o mesmo número. Solução: localize a existente pela busca por CNPJ antes de criar duplicado.
• Botão "Motoristas" não aparece - Causa: usuário sem a permissão motoristas.view. Solução: peça ao Proprietário para ajustar o perfil em Configurações > Perfis e Permissões.

Onde encontrar

• URL: /admin/transportes
• Caminho no menu: Cadastros > Empresas de Transporte
• Listagem de veículos: /admin/veiculos (Cadastros > Veículos)
• Permissão necessária: ver os transportes (e criar os transportes, editar os transportes, excluir os transportes para as ações correspondentes)
• Módulo necessário: nenhum

Veja também

• Cadastrar Empresa de Transporte
• Detalhes do Transporte
• Editar Transporte
• Atualizações pendentes do Portal do Transporte
• Cadastrar Veículo
• Detalhes do Veículo
• Editar Veículo
• Configurar Layout de Assentos
• Layout de Assentos (listagem)
• Vincular Transporte a uma Excursão