Lista de Perfis de Acesso

Módulo: Administração Caminho na aplicação: Menu > Administração > Perfis de Acesso (/perfis) Última atualização: 20/04/2026

Para que serve

Exibe todos os perfis de acesso cadastrados no tenant. Perfis agrupam permissões por módulo e são atribuídos aos usuários por filial. Permite pesquisar, visualizar quantos usuários utilizam cada perfil e remover perfis criados pelo tenant.

Quem pode usar

Usuários com permissão visualizar no módulo Perfis de Acesso. A remoção exige permissão excluir.

Como usar (passo a passo)

1. Acesse Menu > Administração > Perfis de Acesso.
2. A lista carrega automaticamente com até 50 registros por vez. Role a página para baixo para carregar mais.
3. Use o campo Buscar por nome ou descrição... para filtrar. O filtro é aplicado em tempo real.
4. Clique em Limpar para remover o filtro e recarregar a lista completa.
5. Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o perfil em modo de edição (ou somente leitura, se for perfil de sistema).
6. Clique em Novo Perfil (botão superior direito) para criar um novo perfil.
7. Para remover um perfil, clique no ícone de lixeira na linha correspondente e confirme. Perfis de sistema não exibem o botão de remoção.

Campos da tela

Campo	Obrigatório	O que preencher	Observações
Buscar por nome ou descrição...	Não	Texto livre	Filtra por nome ou descrição do perfil

Colunas da tabela

Coluna	Descrição
ID	Identificador interno sequencial do perfil no tenant
Nome	Nome do perfil. Perfis de sistema exibem ícone de cadeado
Descrição	Texto explicativo sobre o perfil
Permissões	Quantidade de módulos com pelo menos uma permissão concedida
Usuários	Número de vínculos usuário-filial que utilizam este perfil
Status	Ativo ou Inativo

Validações e regras

• A lista usa paginação por scroll infinito: carrega 50 registros por vez.
• Perfis de sistema são identificados pelo ícone de cadeado ao lado do nome. Não podem ser removidos e não exibem o botão de lixeira.
• O contador de registros é atualizado a cada busca.
• A remoção de um perfil desativa-o no backend (

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Erro ao carregar perfis"	Falha na comunicação com a API ao listar	Verifique a conexão e recarregue a página
"Perfil removido com sucesso"	Remoção realizada com sucesso	Informativo
Mensagem de erro da API ao remover	Perfil em uso ou outro impedimento	—

Integrações e dependências

• Consome perfisService.listar() com paginação e filtro de busca.
• A coluna Usuários utiliza o campo _count.usuarioFiliais retornado pela API.
• Navegação para edição: /perfis/:id/editar.
• Navegação para criação: /perfis/novo.

Dúvidas frequentes

O que é um perfil de sistema? É um perfil pré-configurado pelo Manto ERP, identificado pelo ícone de cadeado. Suas permissões não podem ser alteradas, mas ele pode ser atribuído a usuários normalmente.

Posso ter perfis com o mesmo nome?

Ao remover um perfil, os usuários vinculados a ele perdem o acesso?

Histórico de alterações

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