Transportes - Detalhes da Empresa de Transporte

O que é

A página de Detalhes da Empresa de Transporte reúne, em uma única tela, todas as informações cadastrais de uma transportadora parceira: dados da empresa, endereço, contato principal, observações internas, veículos vinculados e o histórico de excursões em que ela foi utilizada. É o ponto central para conferir, compartilhar e operar sobre uma transportadora específica.

O usuário normalmente chega aqui clicando no nome de uma transportadora na listagem em Cadastros > Empresas de Transporte, ou logo após cadastrar uma nova empresa. A partir desta página é possível abrir a edição, adicionar veículos, ativar/desativar a transportadora e gerar um link de portal para que a própria transportadora mantenha os dados atualizados.

Como usar

1. Vá em Cadastros > Empresas de Transporte no sidebar.
2. Clique no nome da transportadora desejada na listagem para abrir os detalhes em "/admin/transportes/{transporte}".
3. Confira as seções na coluna principal:
   • Dados da Empresa - Nome Fantasia, Razão Social, CNPJ, E-mail, Telefone, Telefone Secundário, WhatsApp e Site.
   • Endereço - Logradouro, número, complemento, bairro, CEP, cidade e estado. Mostra "Endereço não cadastrado" quando vazio.
   • Contato Principal - Nome, telefone e e-mail da pessoa de contato. Mostra "Contato não cadastrado" quando vazio.
   • Observações - Texto livre interno, exibido apenas se houver conteúdo.
   • Veículos - Lista cada veículo com modelo, tipo, placa, capacidade, ícones de comodidades (Ar Condicionado, Wi-Fi, Banheiro, TV, Tomadas, Reclinável) e badge de status.
4. Use a sidebar à direita para:
   • Conferir o cartão de identificação da transportadora com iniciais, nome e status.
   • Ver Informações do Cadastro (data de cadastro e última atualização).
   • Operar o Portal do Transporte (link compartilhável).
   • Disparar Ações Rápidas (editar, adicionar veículo, alternar status, WhatsApp, ligar).
5. No final da página, quando houver, consulte o Histórico de Excursões - clicando em qualquer item você é levado direto à edição da excursão.

Gerar e compartilhar o Portal do Transporte

1. Na sidebar, localize o card Portal do Transporte.
2. Clique em Gerar Link do Portal. O sistema cria o link e o exibe em um campo somente leitura.
3. Clique no botão com ícone de prancheta ao lado do campo para copiar o link. O botão fica verde com um check por 2 segundos confirmando a cópia.
4. Use Desativar Link para invalidar o acesso sem perder o link, ou Reativar Link para liberá-lo novamente.
5. Quando a transportadora envia alterações pelo portal, aparece um aviso amarelo no topo do card com a contagem de atualização(ões) pendente(s). Clique no aviso para abrir a tela de aprovação.

Acionar o WhatsApp ou ligar

• O botão Enviar WhatsApp só aparece se o campo WhatsApp da transportadora estiver preenchido. Ele abre wa.me/55<numero> em nova aba, já com o código do país.
• O botão Ligar só aparece se o campo Telefone estiver preenchido e usa o protocolo tel:.

Casos especiais

Transportadora sem veículos

Quando ainda não há veículos vinculados, o card Veículos mostra um ícone de caminhão centralizado, a mensagem "Nenhum veículo cadastrado" e o atalho Cadastrar primeiro veículo, que abre o formulário de novo veículo já com transporte_id pré-preenchido.

Transportadora inativa

O badge no cabeçalho fica vermelho com o rótulo "Inativo" e, no card Ações Rápidas, o botão muda para Ativar Transporte (verde). Transportadoras inativas continuam sendo exibidas no histórico, mas o status visual sinaliza que ela não deve ser oferecida em novas excursões.

Atualizações pendentes do portal

Quando a transportadora envia alterações pelo Portal do Transporte, aparece um banner amarelo dentro do card Portal do Transporte com a contagem de atualizações pendentes. O clique leva para "/admin/transportes/{transporte}/atualizacoes", onde é possível aprovar ou rejeitar cada alteração antes que ela substitua os dados oficiais.

E-mails longos

Quando o e-mail da empresa ou do contato principal tem mais de 25 caracteres, ele é quebrado visualmente em duas linhas (parte local em cima, "@domínio" embaixo em tom mais discreto) para evitar estouro do card. Não é truncamento - o valor completo continua salvo.

Campos personalizados

Se houver campos personalizados configurados para a entidade "transporte", eles aparecem dentro das seções correspondentes (Dados da Empresa ou Endereço) ou em um bloco próprio mais abaixo, conforme a seção definida no cadastro do campo personalizado.

Erros comuns e como resolver

• Botão "Enviar WhatsApp" não aparece - Causa: campo WhatsApp vazio no cadastro. Solução: clicar em Editar e preencher o número.
• Botão "Ligar" não aparece - Causa: campo Telefone vazio. Solução: preencher pelo botão Editar.
• "Endereço não cadastrado" - Causa: nenhum campo de endereço foi preenchido (logradouro e cidade ambos vazios). Solução: editar a transportadora e preencher pelo menos o endereço e a cidade.
• Link do Portal não copia - Causa: o navegador bloqueou o acesso à área de transferência (geralmente em conexões sem HTTPS). Solução: acessar pelo subdomínio oficial em HTTPS ou copiar manualmente do campo exibido.
• Veículos não somem ao excluir a transportadora - Causa: ao excluir uma transportadora com veículos, o sistema pede confirmação de exclusão em cascata. Solução: confirmar o aviso para que os veículos sejam desativados junto.

Onde encontrar

• URL: /admin/transportes/{transporte}
• Caminho no menu: Cadastros > Empresas de Transporte (e depois clicar no item desejado na listagem)
• Permissão necessária: ver os transportes
• Módulo necessário: nenhum

Veja também

• Transportes - Listagem
• Transportes - Editar
• Cadastrar Veículo
• Detalhes do Veículo