Cadastro de Transportadora

Módulo: Pessoas Caminho na aplicação: Menu > Pessoas > Transportadoras > "Nova Transportadora" ou ícone Editar na linha Última atualização: 20/04/2026

Para que serve

Permite criar e editar o cadastro completo de uma transportadora, incluindo dados principais, endereço, contatos, site e arquivos anexos.

Quem pode usar

Todos os usuários autenticados.

Como usar (passo a passo)

Criação

1. Na lista de transportadoras, clique em Nova Transportadora.
2. Selecione o Tipo (Pessoa Física ou Pessoa Jurídica). O padrão é Pessoa Jurídica.
3. Informe o CNPJ ou CPF. Para PJ, clique no ícone de lupa ao lado do campo para consultar dados automaticamente na Receita Federal.
4. Preencha os demais campos obrigatórios (nome/razão social).
5. Informe o CEP — o sistema preenche logradouro, bairro, cidade, UF e IBGE automaticamente.
6. Adicione contatos na seção Contatos se necessário.
7. Clique em Cadastrar Transportadora.
8. O sistema redireciona para a tela de edição do registro recém-criado (/transportadoras/:id/editar).

Edição

1. Na lista de transportadoras, clique no ícone Editar (lápis) na linha da transportadora.
2. Altere os campos desejados.
3. Clique em Salvar Alterações.
4. O sistema recarrega os dados do registro e mantém o usuário na mesma tela.

Consulta de CNPJ

1. Com o tipo definido como Pessoa Jurídica, informe o CNPJ.
2. Clique no ícone de lupa ao lado do campo CNPJ.
3. Se já houver dados preenchidos, uma caixa de confirmação pergunta se deseja substituir.
4. Ao confirmar, razão social, fantasia, endereço, inscrição estadual e situação cadastral são preenchidos automaticamente.

Consulta de CEP

Digite o CEP (ou clique na lupa). O sistema preenche logradouro, bairro, cidade, UF e IBGE. Se já houver endereço em modo edição, uma confirmação é exibida antes de substituir.

Gerenciamento de contatos

1. No card Contatos, preencha o formulário (nome obrigatório) e clique em Adicionar Contato.
2. Para editar um contato, clique em Editar na linha. O formulário é preenchido; clique em Atualizar Contato para confirmar.
3. Para remover, clique na lixeira e confirme.
4. Os contatos são salvos junto com o cadastro principal ao clicar em Salvar Alterações / Cadastrar Transportadora.

Campos da tela

Seção Dados Principais

Campo	Obrigatório	O que preencher	Observações
Status	Não	Ativo / Inativo	Padrão: Ativo.
Tipo	Sim	Pessoa Física ou Pessoa Jurídica	Padrão: Pessoa Jurídica. Altera o label e a validação do documento.
CPF / CNPJ	Sim	CPF (PF) ou CNPJ (PJ) formatado	Formatado automaticamente. Validação de dígitos verificadores. Para PJ: ícone de lupa consulta a Receita Federal.
Nome / Razão Social	Sim	Nome completo (PF) ou razão social (PJ)	Mínimo 2 caracteres.
Fantasia	Não	Nome fantasia	Texto livre.
Inscrição Estadual	Não	IE da empresa	Texto livre.
Inscrição Municipal	Não	IM da empresa	Texto livre.
Simples Nacional	Não	Sim / Não	Padrão: Não.
Situação Cadastral	Não	Preenchida pela consulta CNPJ	Campo desabilitado. Somente PJ.
Data Abertura	Não	Data de abertura (DD/MM/AAAA)	Somente PJ.
Site	Não	URL do site da transportadora	Texto livre.

Seção Endereço

Campo	Obrigatório	O que preencher	Observações
CEP	Não	CEP no formato 00000-000	Consulta automática ao completar 8 dígitos.
Logradouro	Não	Nome da rua, avenida etc.	Preenchido automaticamente pelo CEP.
Número	Não	Número do imóvel	Texto livre.
Complemento	Não	Apto, sala, bloco etc.	Texto livre.
Bairro	Não	Bairro	Preenchido automaticamente pelo CEP.
Cidade	Não	Nome da cidade	Preenchido automaticamente pelo CEP.
UF	Não	Sigla do estado (2 letras)	Select com todas as UFs brasileiras.
País	Não	Nome do país	Padrão: Brasil.
IBGE	Não	Código IBGE do município	Preenchido automaticamente pelo CEP.

Seção Contatos

Campo	Obrigatório	O que preencher	Observações
Nome do Contato	Sim (por contato)	Nome da pessoa de contato	Obrigatório ao adicionar.
Email	Não	E-mail do contato	Validação de formato.
Telefone	Não	Telefone no formato (00) 0000-0000	Formatado automaticamente.
Celular	Não	Celular no formato (00) 00000-0000	Formatado automaticamente.
Notas	Não	Recebe notas fiscais por e-mail?	Toggle Sim/Não.
Boletos	Não	Recebe boletos por e-mail?	Toggle Sim/Não.
Cobrança	Não	Recebe cobranças por e-mail?	Toggle Sim/Não.

Seção Observações

Campo	Obrigatório	O que preencher	Observações
Observações	Não	Informações adicionais sobre a transportadora	Campo texto livre (3 linhas).

Seção Arquivos (somente em edição)

Gerenciamento de arquivos anexados à transportadora. Disponível somente após o cadastro ser salvo.

Validações e regras

• Tipo: obrigatório → exibe "Selecione o tipo" → bloqueia o envio.
• CPF/CNPJ: obrigatório → exibe "Informe o documento" → bloqueia o envio. Dígitos verificadores validados no frontend → exibe "CPF invalido" ou "CNPJ invalido".
• Nome/Razão Social: obrigatório, mínimo 2 caracteres → exibe "Informe o nome" → bloqueia o envio.
• Email do contato: formato de e-mail → exibe "Email invalido" → bloqueia a adição do contato.
• Alterações não salvas: ao tentar sair com campos modificados, um alerta de confirmação é exibido.
• Situação cadastral PJ diferente de "Ativa": ao consultar CNPJ → exibe alerta Atencao: situacao cadastral "{valor}" mas não bloqueia o cadastro.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Erro ao carregar transportadora"	Falha ao buscar os dados na edição.	Verifique a conexão; o sistema redireciona para a lista.
"Transportadora criada com sucesso"	Criação bem-sucedida.	Nenhuma ação; o sistema redireciona para edição.
"Transportadora atualizada com sucesso"	Atualização bem-sucedida.	Nenhuma ação; o formulário é recarregado.
"Erro ao salvar transportadora"	Falha na requisição de criação ou atualização.	—
"Erro ao consultar CEP"	CEP não encontrado ou erro na API.	—
"Dados do CNPJ carregados com sucesso"	Consulta CNPJ bem-sucedida.	Nenhuma ação.
"Erro ao consultar CNPJ"	CNPJ não encontrado ou erro na API.	—

Integrações e dependências

• GET /transportadoras/:id — carrega dados para edição.
• POST /transportadoras — cria nova transportadora.
• PUT /transportadoras/:id — atualiza transportadora existente.
• GET /cep/:cep — consulta endereço por CEP (via backend).
• GET /cnpj/:cnpj — consulta dados da Receita Federal (via backend).
• Componente TransportadoraArquivos — gerencia arquivos no S3 (somente em edição).
• Tela relacionada: Lista de Transportadoras.

Dúvidas frequentes

Posso salvar uma transportadora sem informar o CPF/CNPJ? Não. O documento é obrigatório e validado antes do envio.

A consulta CNPJ sobrescreve dados que já preenchi? Ao criar: sobrescreve diretamente. Ao editar: uma caixa de confirmação pergunta se deseja substituir.

A seção "Arquivos" aparece ao criar uma nova transportadora? Não. Ela só fica visível após o cadastro ser salvo pela primeira vez.

Qual a diferença entre os campos "Notas", "Boletos" e "Cobrança" nos contatos? Indicam quais tipos de documento o contato recebe por e-mail. São informações de referência e não disparam envios automáticos por si só.

Histórico de alterações

Data	Alteração
20/04/2026	Documento inicial criado.