Transportes - Editar Empresa de Transporte

O que é

Esta página atualiza os dados de uma empresa de transporte (transportadora) ja cadastrada no modulo Transportes. E o lugar para corrigir um CNPJ digitado errado, trocar o telefone do contato comercial, mudar o endereço, atualizar observações internas e, principalmente, alternar o status ativo/inativo da transportadora - o que controla se ela aparece (ou não) como opção na hora de vincular transporte a uma nova excursão.

O usuário costuma chegar aqui de tres jeitos: clicando em Editar na tela de detalhes da transportadora, clicando no icone de edição na listagem em Cadastros > Empresas de Transporte, ou logo após cadastrar uma empresa nova usando a opção Cadastrar e continuar editando (que cai direto neste formulario). A estrutura do formulario e identica ao cadastro, so que com os campos ja preenchidos com os valores atuais.

Como usar

1. Va em Cadastros > Empresas de Transporte no sidebar.
2. Localize a transportadora na listagem (use a busca por nome fantasia, razao social, CNPJ, e-mail, telefone ou cidade).
3. Abra o formulario de edição em "/admin/transportes/{transporte}/edit" - pelo icone de edição da linha na listagem ou pelo botao Editar dentro da tela de detalhes.
4. Atualize o bloco Dados da Empresa:
   • Nome Fantasia - único campo obrigatório fixo. E o nome usado nas telas operacionais.
   • Razao Social, CNPJ, E-mail, Telefone, Telefone Secundario, WhatsApp e Site - opcionais por padrão. CNPJ, Telefone e WhatsApp tem mascara automática enquanto você digita.
5. Atualize o bloco Endereço:
   • Ao alterar o CEP e digitar os 8 numeros, o sistema busca o endereço automaticamente e preenche Logradouro, Bairro, Cidade e Estado, mostrando um icone verde de confirmação a direita do campo CEP. Depois o foco vai direto para Número.
   • Ajuste Complemento e demais campos se precisar.
6. Atualize o bloco Contato Principal: Nome do Contato, Telefone do Contato e E-mail do Contato.
7. Edite o bloco Observações para registrar qualquer informação interna adicional sobre a empresa.
8. Ajuste o toggle Transporte ativo no bloco final caso queira desativar a transportadora sem excluir.
9. Acompanhe o indicador amarelo Alteracoes não salvas (N) que aparece a esquerda dos botoes de salvar - ele conta quantos campos foram alterados desde o último salvamento.
10. Confirme em Salvar Alteracoes (volta para a listagem) ou abra o dropdown ao lado para escolher Salvar e continuar editando (salva e mantem você na mesma tela).

Casos especiais

Desativar em vez de excluir

Para tirar uma transportadora das opções oferecidas nas excursões futuras sem perder o histórico, desligue o toggle Transporte ativo no rodape do formulario e clique em Salvar Alteracoes. A empresa continua nos registros antigos, mas some das selecoes de novos vinculos. Essa e a operação recomendada quando você simplesmente parou de trabalhar com a transportadora.

Excluir o cadastro (com ou sem veiculos)

A exclusão em si não e feita neste formulario - ela parte do botao de excluir na listagem ou na tela de detalhes, mas vale conhecer o comportamento:

• Se a transportadora não tem veiculos vinculados, ela e excluida diretamente (soft delete).
• Se a transportadora tem veiculos vinculados, o sistema bloqueia a primeira tentativa e mostra um modal de confirmação com a quantidade e a lista (placa, modelo, tipo) de veiculos que serão excluidos junto. So após você confirmar a exclusão em cascata e que a transportadora e os veiculos são removidos.

Em ambos os casos, o registro fica em soft delete (não perdido de vez no banco), preservando o vinculo histórico com excursões ja realizadas.

Campos obrigatorios alem do Nome Fantasia

Por padrão, so Nome Fantasia e obrigatório. Se a sua empresa configurou em Configurações > Campos Personalizados que outros campos padrão (CNPJ, telefone, e-mail etc.) são obrigatorios para a entidade transporte, eles aparecem com asterisco vermelho no formulario e bloqueiam o salvamento se ficarem em branco. A mesma regra vale para campos personalizados criados por você.

CNPJ duplicado

O sistema impede salvar com um CNPJ que ja pertenca a outra transportadora na sua empresa. Se você esta tentando "transferir" o CNPJ de uma empresa para outra, primeiro limpe o CNPJ do cadastro antigo (ou desative-o) e so depois aplique o valor na empresa nova.

CEP não encontrado

Se o CEP digitado não for encontrado na base, aparece a mensagem CEP não encontrado abaixo do campo. O salvamento não e bloqueado por isso (a menos que o CEP tenha sido configurado como obrigatório) - você pode preencher endereço, bairro, cidade e estado manualmente.

Campos personalizados

Se a sua empresa criou campos personalizados para a entidade transporte, eles aparecem misturados nos blocos Dados da Empresa e Endereço (quando associados a essas secoes) ou em um bloco proprio abaixo de Observações, antes do rodape de salvar.

Erros comuns e como resolver

• "O campo Nome Fantasia e obrigatório." - Causa: o campo foi apagado e tentou-se salvar. Solucao: preencher novamente o nome fantasia no bloco Dados da Empresa.
• "O CNPJ ja foi utilizado." - Causa: o CNPJ informado pertence a outra transportadora do mesmo empresa. Solucao: confirmar na listagem ("/admin/transportes") qual e a empresa que ja usa esse CNPJ e decidir se vale juntar/desativar antes de salvar.
• "O campo Site deve ser uma URL valida." - Causa: o site foi digitado sem https:// ou com formato invalido. Solucao: usar https://exemplo.com.br (com protocolo).
• "O campo E-mail deve ser um endereço de e-mail valido." - Causa: formato invalido. Solucao: corrigir o e-mail principal ou o e-mail do contato - a validação vale para os dois.
• "Erro ao buscar CEP. Tente novamente." - Causa: falha de rede na chamada interna para "/admin/api/cep". Solucao: aguardar alguns segundos e digitar o CEP de novo, ou preencher endereço, bairro, cidade e estado manualmente.
• Toggle "Transporte ativo" volta sozinho para desligado depois de salvar - Causa: o toggle não foi marcado antes de submeter o formulario; o sistema entende ausencia como false. Solucao: marcar o toggle explicitamente antes de clicar em Salvar Alteracoes.

Onde encontrar

• URL: /admin/transportes/{transporte}/edit
• Caminho no menu: Cadastros > Empresas de Transporte (e depois icone de editar na linha ou botao Editar dentro da tela de detalhes)
• Permissão necessária: editar os transportes
• Módulo necessário: nenhum

Veja também

• Visao geral dos Transportes
• Cadastrar Empresa de Transporte
• Detalhes do Transporte
• Cadastrar Veiculo
• Vincular Transporte a uma Excursão