O módulo de Fornecedor centraliza o cadastro e a gestão de todos os parceiros que fornecem materiais, serviços ou insumos à operação. É a base usada em Compras, Almoxarifado e fluxos financeiros: pedidos de compra, cotações e importação de NF referenciam fornecedores cadastrados aqui.
Para quem é esta documentação: compras, almoxarifado, financeiro e administrativo.
O que você aprende aqui:
- Como acompanhar indicadores na Visão Geral de Fornecedores
- Como cadastrar, editar, visualizar e filtrar fornecedores
- Como gerenciar contatos, categorias e segmentos
- Como usar Premium, inativação com motivo e exportação Excel
- Como o cadastro se conecta ao módulo de Compras
Pré-requisito principal: ter empresa e filiais cadastradas no Painel de Controle — todo fornecedor deve ser vinculado a uma filial (ou empresa matriz).
Menu no sistema:
- Visão Geral →
/fornecedor - Cadastro de Fornecedor →
/fornecedor/cadastro
4.1 Visão Geral de Fornecedores
Foco: Painel analítico — status, crescimento e qualidade da base cadastral.
Para que serve
A Visão Geral consolida métricas da base de fornecedores via API dedicada (/suppliers/dashboard). Ela não cadastra fornecedores — orienta o acompanhamento antes de entrar em Cadastro de Fornecedor.
Regra em uma linha: Visão Geral mostra como está a base; Cadastro de Fornecedor é onde você cria e mantém os registros.
Cabeçalho
- Título: Gestão de Fornecedores — Gerencie seus fornecedores e relacionamentos
- Filtro de empresa/filial: recorta todos os gráficos para a unidade selecionada
- Botão Atualizar: recarrega os dados do dashboard
Painéis analíticos (4 cards)
| Painel | Conteúdo |
| Status dos Fornecedores | Ativos vs. Inativos — quantidade e % com barra de progresso |
| Crescimento Mensal | Novos fornecedores cadastrados; comparativo Este Mês vs. Mês Anterior |
| Distribuição por Tipo de Pessoa | Pessoa Jurídica vs. Pessoa Física |
| Resumo Executivo | Total, % ativos, Eficiência de Cadastro, Qualidade dos Fornecedores e Cadastros Completos |
4.2 Cadastro de Fornecedor
Foco: Tela operacional — listagem, cadastro, edição, Premium e relatório.
Cabeçalho
- Botão Voltar → retorna à Visão Geral (
/fornecedor) - Título: Cadastro de Fornecedores — Gerencie o cadastro e relatórios de fornecedores
- Atualizar — recarrega a listagem
- Novo Fornecedor — abre modal de cadastro
Indicadores no topo (4 cards)
| Card | Informação |
| Total | Todos os fornecedores |
| Ativos | Com status ativo |
| Inativos | Desativados |
| Premium | Fornecedores com categoria Premium ⭐ |
Filtros
| Filtro | Opções | Padrão |
| Buscar | Razão social, nome fantasia, CNPJ/CPF, e-mail, categoria, segmento ou contatos | — |
| Status | Todos, Ativo, Inativo, ⭐ Premium | Todos |
| Tipo | Todos, Premium, Padrão | Todos |
| Filial | Todas + empresa matriz e filiais | Todas |
Listagem com contador de resultados e paginação de 50 fornecedores por página.
Tabela — Relatório de Fornecedores
Colunas: Filial · Fornecedor (nome + tipo PF/PJ) · CNPJ/CPF · Status (com motivo se inativo) · Tipo (categoria — Premium com ⭐) · Data Cadastro · Ações
Botão Exportar Excel — gera planilha do filtro atual (dados completos: endereço, contatos, observações, datas etc.).
Menu de ações (⋮) por linha:
| Ação | Descrição |
| Visualizar | Modal somente leitura com dados e contatos |
| Editar | Abre modal de cadastro preenchido |
| Marcar como Premium / Remover Premium | Altera categoria para Premium ou Fornecedor |
| Inativar | Exige motivo obrigatório |
| Ativar | Reativa fornecedor inativo (limpa motivo) |
| Excluir | Remove permanentemente (bloqueado se houver histórico em outros módulos) |
4.2.1 Novo / Editar Fornecedor (modal)
Dados Básicos
| Campo | Obrigatório | Observação |
| Filial | Sim | Empresa matriz ou filial |
| Tipo de Pessoa | Sim | Pessoa Física ou Pessoa Jurídica |
| CNPJ (PJ) | Sim | Busca automática na Receita ao completar 14 dígitos |
| Razão Social / Nome Fantasia (PJ) | Razão Social sim | Preenchimento automático via CNPJ |
| Inscrição Estadual (PJ) | Não | |
| Nome Completo / CPF / RG (PF) | Nome e CPF sim | CPF validado; sem duplicidade |
| Telefone | Sim | Formatado automaticamente |
| Sim | ||
| Categoria | Sim | Selecionar ou criar nova (+ no campo) |
| Segmento | Não | Selecionar ou criar novo (+ no campo) |
4.2.2 Visualizar Fornecedor
Modal Dados do Fornecedor em modo leitura: informações básicas, endereço, categoria, segmento, status, observações e lista de contatos.
Se inativo, exibe o motivo da inativação registrado.
4.2.3 Inativar Fornecedor
- Menu ⋮ → Inativar
- Informar motivo (obrigatório)
- Confirmar
O fornecedor permanece no histórico com status Inativo e motivo visível na tabela e na visualização.
Ativar: menu ⋮ → Ativar → confirmação → status volta a Ativo.
4.2.4 Classificação Premium
Fornecedores Premium são identificados pela categoria Premium (badge amarela com ⭐ na tabela).
- Marcar como Premium: altera categoria para
Premium - Remover Premium: volta para categoria
Fornecedor
Use para priorizar parceiros estratégicos em compras e negociações.
4.2.5 Categorias e Segmentos
Dentro do modal de cadastro, os botões + ao lado de Categoria e Segmento abrem modais para:
- Criar nova categoria ou segmento
- Editar existente
- Excluir (quando sem vínculos)
Categorias e segmentos inativos no banco não aparecem nos seletores.
4.2.6 Exportação Excel
Gera arquivo fornecedores_AAAA-MM-DD.xlsx com o filtro aplicado, incluindo:
Filial, ID, tipo pessoa, razão social, CNPJ/CPF, contatos, endereço completo, categoria, segmento, status, motivo de inativação e datas de cadastro/atualização.
(Diferente do módulo Cliente, não há importação por planilha nesta tela — cadastro em massa deve ser feito via integração ou cadastro individual.)
4.3 Considerações
- Fornecedor é pré-requisito do módulo Compras — solicitações, cotações e pedidos de compra selecionam fornecedores desta base.
- Exclusão pode ser bloqueada se o fornecedor tiver histórico em Compras, Financeiro ou outros módulos — nesse caso, use Inativar.
- CNPJ/CPF duplicados são rejeitados no cadastro.
- Diferente de Clientes, inativar e excluir não exigem perfil Master — qualquer usuário autenticado com acesso ao módulo pode executar (sujeito às permissões de menu).
- A categoria Premium é independente do status Ativo/Inativo — um fornecedor pode ser Premium e inativo.
- Rotas legadas (
/fornecedor/fornecedores,/fornecedor/cadastro-fornecedor) existem no sistema, mas o menu oficial aponta para/fornecedor/cadastro.