Cadastro de Fornecedor

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

Para que serve

Permite criar e editar o cadastro completo de um fornecedor, 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 fornecedores, clique em Novo Fornecedor.
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 Fornecedor.
8. O sistema redireciona para a tela de edição do registro recém-criado (/fornecedores/:id/editar).

Edição

1. Na lista de fornecedores, clique no ícone Editar (lápis) na linha do fornecedor.
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 Fornecedor.

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 do fornecedor	Botão de atalho para abrir o site em nova aba.

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.
Função	Não	Área de atuação (ex.: Compras, Financeiro)	Texto livre.
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.

Seção Observações

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

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

Gerenciamento de arquivos anexados ao fornecedor. 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 fornecedor"	Falha ao buscar os dados na edição.	Verifique a conexão; o sistema redireciona para a lista.
"Fornecedor criado com sucesso"	Criação bem-sucedida.	Nenhuma ação; o sistema redireciona para edição.
"Fornecedor atualizado com sucesso"	Atualização bem-sucedida.	Nenhuma ação; o formulário é recarregado.
"Erro ao salvar fornecedor"	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 /fornecedores/:id — carrega dados para edição.
• POST /fornecedores — cria novo fornecedor.
• PUT /fornecedores/:id — atualiza fornecedor existente.
• GET /cep/:cep — consulta endereço por CEP (via backend).
• GET /cnpj/:cnpj — consulta dados da Receita Federal (via backend).
• Componente FornecedorArquivos — gerencia arquivos no S3 (somente em edição).
• Tela relacionada: Lista de Fornecedores.

Dúvidas frequentes

Posso salvar um fornecedor 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.

O campo "Site" serve para alguma integração automática? Não. Ele armazena a URL e exibe um botão para abrir o site em nova aba. Não há integração automática.

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

Histórico de alterações

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