Index de Fornecedores
Gestão do cadastro de fornecedores com a Lista (foreheads) como visão principal, filtros por categoria e localização, visibilidade no marketplace e ações dependentes de perfil.
O ponto de partida: a tela real de Fornecedores no modo padrão (Lista, foreheads) — Header, Subheader (Novo Fornecedor), Sidebar com switcher Meus fornecedores ↔ Fornecedores ME, criteria bar e a tabela. As seções abaixo detalham cada parte.
Boas Práticas
O índice de Fornecedores segue o chassi de Estrutura de Index — zonas, subheader, filtros e ecossistema são transversais. Esta página cobre só o que é próprio da entidade.
Especificação
Lista (padrão) — a view principal de Fornecedores: empilha o Forehead de fornecedor (logo, razão social, badges Meu fornecedor / status / anos, CNPJ, endereço com «+N», contatos e o selo «Visível para o marketplace»), com seleção e ações por linha. É o modo que melhor identifica a entidade numa varredura. Tabela — colunas densas para comparação de status e responsável. Preview — painel dividido com lista à esquerda e detalhes do fornecedor à direita, com tabs para dados gerais, transações e documentos. Toggle de view persistido por usuário.
Colunas
O comprador molda as colunas à decisão: o conjunto padrão cobre quem é, em que situação está e quem responde; dezenas de outras ficam ocultas em "Editar colunas" — sinais de confiança (nota, tempo de resposta), vínculo comercial (contratos ME/ERP) e localização.
| Coluna | Tipo | Observação | Visibilidade |
|---|---|---|---|
| Nome / Razão social | Link | Abre o perfil. CNPJ como linha secundária abaixo do nome. | Padrão |
| CNPJ | Texto formatado | Máscara XX.XXX.XXX/XXXX-XX. «—» para Internacional. | Padrão |
| Categorias | Chips | Máx. 2 visíveis + «+N»; tooltip lista todas. | Padrão |
| Status | Badge semântico | Nunca truncado. Ver status abaixo. | Padrão |
| Responsável interno | Avatar + nome | Usuário ME responsável pelo cadastro. | Padrão |
| Última atualização | Data relativa | Relativa ≤30d, absoluta >30d. | Padrão |
| Nota média | Número | Escolher com quem cotar (sinal de confiança). | Opcional |
| Tempo médio de resposta | Número | Priorizar quem responde mais rápido. | Opcional |
| Contratos ME / ERP | Badge | Conferir o vínculo comercial vigente. | Opcional |
| Localização (UF / cidade) | Texto | Recortar por região de atendimento. | Opcional |
| Nome fantasia | Texto | Quando difere da razão social. | Opcional |
| Telefone | Texto | Contato direto com o fornecedor. | Opcional |
| Último contato | Data relativa | Reativar quem está parado. | Opcional |
Status semânticos
Status é sempre um badge com cor semântica — nunca texto solto. A paleta é fixa; Fornecedores mapeia seu ciclo nestes tons.
| Status | Significado |
|---|---|
| Ativo | Habilitado para transações e busca. |
| Em análise | Aguardando homologação interna. |
| Inativo | Não aparece em buscas de documentos. |
| Bloqueado | Impede novas transações; requer admin para desbloquear. |
Filtros
Filtrar fornecedores acontece em camadas que se somam — da busca livre ao recorte estruturado — e todas refletem na listagem na hora. A mecânica dos critérios (chips, operadores, salvar) vive no padrão Filtrar; aqui está o que cada superfície da tela resolve.
Busca
Campo no subheader. Casa nome fantasia, razão social ou CNPJ; é o gatilho do Command Palette.
Command Palette (Filter Search)
Overlay que a busca abre: busca direta por fornecedor, aplicar um filtro salvo ou montar um critério (Critério → Operador → Valor). Mecânica em Filtrar.
Critérios (Filter Bar)
Filtros estruturados acima da tabela: Status, Categoria, Responsável… Os três primeiros visíveis; o resto em “Mais filtros”.
Recortes da sidebar
O switcher Meus ↔ ME, Por status, Grupos, Índices e Localização aplicam um recorte pronto num clique.
Filtros salvos
Combinações de critérios salvas e reaplicáveis; ficam em Favoritos, na sidebar.
Critérios da Filter Bar
Os critérios estruturados que recortam a base. Status já entra pré-aplicado em "Ativo" — o recorte mais comum.
| Filtro | Controle | Quando ajuda |
|---|---|---|
| Status | Multi-select | Recorta por situação; já vem pré-aplicado em “Ativo”. |
| Categoria | Select hierárquico | Segmento de fornecimento — o pai inclui os filhos. |
| Responsável | Typeahead | O comprador dono da carteira do fornecedor. |
| Tipo | Multi-select | Natureza do fornecedor: PF, PJ ou Internacional. |
| UF | Multi-select | Recorta por localização (estado). |
| Data de cadastro | Intervalo de datas | Janela de entrada do fornecedor na base. |
As ações da index estão detalhadas na aba Ações.
Contextos
'Bloquear' é exclusivo do Administrador. Modal exige motivo obrigatório para registro de auditoria.
Ativar/desativar executa na hora e mostra um toast com 'Desfazer' (5s) — ação reversível, sem modal. Só 'Bloquear' (destrutiva) exige confirmação.
Anatomia do Forehead: me_highlight de 4px (linha selecionada) · DocumentBadge (logo do fornecedor) · LeadingSlot (título, badges e dados) · TraillingSlot (status, nota, completude e a ActionBar favorite/chat/genius/mais + Ver mais). O drawer de indicadores fica recolhido e abre no Ver mais.
Clicar em um item abre o painel de detalhes à direita sem sair da tela. Tabs organizam dados gerais, transações e documentos. Painel esquerdo permanece fixo.
Ações
Como os padrões de Ações do usuário se aplicam ao índice de Fornecedores. O universal está na Geral; aqui, o que é próprio da entidade.
Ações por linha (menu de mais ações)
Menu ⋮ no fim da linha: Ver, Editar e Ativar/Desativar. A destrutiva Bloquear (exclusiva do Administrador, com modal de motivo) fica isolada após um divisor.
Desfazer (ações reversíveis)
Ativar/desativar e alterar responsável executam na hora, com toast "Desfazer" (5s). Só Bloquear exige modal.
Feedback
O retorno é proporcional ao impacto. O catálogo completo está na Geral; abaixo, as particularidades de Fornecedores.
| Cenário | Mecanismo de feedback |
|---|---|
Filtro de categoria | Reflete na Filter Bar na hora; a contagem do cabeçalho atualiza. |
Ativar / Desativar | Toast com Desfazer (5s) — ação reversível, sem modal. |
Bloquear (admin) | Modal de confirmação com motivo obrigatório (auditoria) — irreversível. |
Exportar | Indicador de progresso durante a geração do arquivo. |