Transportes - Cadastrar Empresa de Transporte

O que é

Esta página cria uma nova empresa de transporte (transportadora) dentro do modulo Transportes. Ela representa a pessoa juridica parceira que fornece onibus, vans, micro-onibus ou qualquer veiculo usado nas excursões - não o veiculo em si.

O fluxo natural do modulo e: primeiro você cadastra a empresa aqui, depois cria os veiculos dela na area de Veiculos e, com tudo registrado, vincula o transporte as excursões. O usuário costuma chegar nesta tela vindo de "Cadastros > Empresas de Transporte > Novo Transporte" quando esta organizando os parceiros antes de montar uma excursão ou ao adicionar uma nova viacao que comecou a operar.

Como usar

1. Va em Cadastros > Empresas de Transporte no menu lateral.
2. Clique em Novo Transporte (botao no topo direito da listagem). Você cai em "/admin/transportes/create".
3. Preencha 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, mas o administrador pode torna-los obrigatorios em Configurações > Campos Personalizados (entidade transporte). Os campos de CNPJ, Telefone e WhatsApp aplicam mascara automática enquanto você digita.
4. Preencha o bloco Endereço:
   • Digite o CEP - assim que você completar os 8 digitos, o sistema busca automaticamente o endereço e preenche Logradouro, Bairro, Cidade e Estado, e foca o campo Número. Um ticador verde aparece a direita do CEP quando a busca funciona.
   • Ajuste Complemento e Estado se necessário.
5. Preencha o bloco Contato Principal: Nome do Contato, Telefone do Contato e E-mail do Contato. Use esses campos para registrar a pessoa direta da transportadora (gerente comercial, dono, despachante).
6. Use o bloco Observações para qualquer texto livre sobre a empresa.
7. Decida a forma de salvar no bloco final:
   • Cadastrar Transporte - salva e volta para a listagem.
   • Cadastrar e continuar editando - salva e abre a tela de edição do registro criado (util para ja cadastrar veiculos ou motoristas em seguida).
   • Cadastrar e adicionar outro - salva e abre um formulario em branco para cadastrar a próxima empresa.
8. Confirme se o toggle Transporte ativo esta marcado (ele vem marcado por padrão). Empresas inativas continuam na base, mas não aparecem como opção em telas de vinculo.

Casos especiais

Campos obrigatorios alem do Nome Fantasia

Por padrão, so Nome Fantasia e obrigatório. Se a sua empresa configurou campos personalizados ou tornou padroes (CNPJ, telefone etc.) obrigatorios em Configurações > Campos Personalizados para a entidade transporte, eles aparecem com asterisco vermelho e bloqueiam o salvamento se ficarem em branco. A regra de validação acompanha essa configuração automaticamente.

CNPJ duplicado

O sistema impede cadastrar duas empresas com o mesmo CNPJ na sua empresa. Se você tentar salvar com um CNPJ ja usado, recebe erro de validação no proprio campo. Antes de criar, busque na listagem se a empresa ja existe (a busca cobre nome fantasia, razao social, CNPJ, e-mail, telefone e cidade).

Campos personalizados extras

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 mais abaixo, antes do rodape de salvar. Eles seguem as regras de obrigatoriedade definidas em Configurações.

CEP não encontrado

Se o CEP digitado não for encontrado na base, aparece a mensagem CEP não encontrado abaixo do campo. Você ainda pode preencher o endereço manualmente - o CEP não bloqueia o salvamento (a não ser que tenha sido configurado como obrigatório).

Erros comuns e como resolver

• "O campo Nome Fantasia e obrigatório." - Causa: você tentou salvar sem preencher o Nome Fantasia. Solucao: preencha o campo no topo do bloco Dados da Empresa.
• "O CNPJ ja foi utilizado." - Causa: ja existe outra empresa de transporte com esse CNPJ na sua empresa. Solucao: busque na listagem ("/admin/transportes") pelo CNPJ ou nome - provavelmente você vai querer editar a empresa existente em vez de criar de novo.
• "O campo Site deve ser uma URL valida." - Causa: o site foi digitado sem https:// ou com formato invalido. Solucao: use https://exemplo.com.br (com protocolo).
• "O campo E-mail deve ser um endereço de e-mail valido." - Causa: formato invalido (faltou @, domínio errado). Solucao: corrija o e-mail, vale tanto para o e-mail principal quanto para o do contato.
• "Erro ao buscar CEP. Tente novamente." - Causa: falha de rede na chamada interna para "/admin/api/cep". Solucao: aguarde alguns segundos e digite o CEP de novo, ou preencha os campos de endereço manualmente.

Onde encontrar

• URL: /admin/transportes/create
• Caminho no menu: Cadastros > Empresas de Transporte > Novo Transporte
• Permissão necessária: criar os transportes
• Módulo necessário: nenhum

Veja também

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