Cadastro de Perfil de Acesso
Módulo: Administração Caminho na aplicação: Menu > Administração > Perfis de Acesso > "Novo Perfil" ou ícone Editar em um registro Última atualização: 20/04/2026
Para que serve
Cria e edita perfis de acesso. Um perfil reúne as permissões (por módulo e ação) que serão concedidas a todos os usuários associados a ele. Os perfis são atribuídos a usuários por filial no Cadastro de Usuário.
Quem pode usar
Usuários com permissão criar ou editar no módulo Perfis de Acesso. Perfis de sistema podem ser visualizados, mas não editados por nenhum usuário.
Como usar (passo a passo)
Criando um novo perfil
- Na Lista de Perfis de Acesso, clique em Novo Perfil.
- Preencha Nome e, opcionalmente, Descrição.
- Na matriz de Permissões, marque as ações que este perfil poderá executar em cada módulo.
- Use Selecionar Todos para marcar todas as permissões de todos os módulos de uma vez, ou Desmarcar Todos para limpar a seleção completa.
- Para conceder ou remover todas as ações de um módulo específico, clique no checkbox ao lado do nome do módulo.
- Clique em Cadastrar Perfil.
- O sistema exibe a mensagem de sucesso e redireciona para a tela de edição do perfil recém-criado.
Editando um perfil existente
- Na Lista de Perfis de Acesso, clique no ícone Editar (lápis) na linha do perfil.
- Se o perfil for de sistema, a tela abre em modo somente leitura com um aviso informativo. Nenhum campo pode ser alterado.
- Para perfis do tenant, ajuste Nome, Descrição, Situação e a matriz de permissões conforme necessário.
- Clique em Salvar Alterações.
- O sistema recarrega os dados do perfil na mesma tela — a tela não fecha.
Marcando permissões
A tabela de permissões possui uma linha por módulo do sistema e uma coluna por ação disponível (Visualizar, Criar, Editar, Excluir). Para módulos que não suportam determinada ação, a célula exibe "—".
- Checkbox da ação: marca ou desmarca aquela ação específica para o módulo.
- Checkbox do módulo (coluna "Módulo"): marca todas as ações disponíveis daquele módulo de uma vez. Quando apenas algumas ações estão marcadas, aparece em estado intermediário.
- Selecionar Todos: marca todas as ações de todos os módulos.
- Desmarcar Todos: remove todas as seleções.
Módulos disponíveis para configuração de permissões
| Módulo | Label na tela |
|---|---|
| clientes | Clientes |
| fornecedores | Fornecedores |
| funcionarios | Funcionários |
| transportadoras | Transportadoras |
| produtos | Produtos |
| produtos.grupos | Grupos |
| produtos.categorias | Categorias |
| produtos.marcas | Marcas |
| produtos.fabricantes | Fabricantes |
| fiscal.perfis | Perfis Fiscais |
| fiscal.regras | Regras Fiscais |
| fiscal.impostos | Impostos |
| comercial.tabelas_preco | Tabelas de Preço |
| empresas | Empresas |
| filiais | Filiais |
| usuarios | Usuários |
| perfis | Perfis de Acesso |
Cada módulo suporta as ações: Visualizar, Criar, Editar, Excluir.
Campos da tela
Cartão: Dados do Perfil
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| ID | — | Apenas leitura | Exibido somente na edição; identificador sequencial interno |
| Situação | Sim | Ativo / Inativo | Padrão: Ativo. Perfis inativos não podem ser atribuídos a novos usuários (⚠️ CONFIRMAR comportamento exato) |
| Nome | Sim | Nome identificador do perfil | Ex.: Administrador, Vendedor, Financeiro. Mínimo 2 caracteres |
| Descrição | Não | Texto explicativo | Auxilia na identificação do perfil na listagem |
Cartão: Permissões
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Matriz de permissões | Não | Checkboxes por módulo e ação | Um perfil sem nenhuma permissão pode ser salvo, mas o usuário vinculado não verá nenhum módulo |
Validações e regras
- Nome é obrigatório e deve ter no mínimo 2 caracteres.
- Perfis de sistema (
sistema = true) são somente leitura: todos os campos e checkboxes ficam desabilitados e o botão Salvar Alterações não é exibido. Um alerta amarelo informa esta condição no topo da tela. - Um perfil pode ser salvo sem nenhuma permissão marcada.
- O formulário detecta alterações não salvas e exibe um aviso ao tentar sair sem salvar.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Informe o nome" | Campo Nome vazio ao submeter | Preencha o nome do perfil |
| "Erro ao carregar perfil" | Falha ao buscar os dados do perfil na edição | Verifique a conexão; o sistema redireciona para a lista |
| "Perfil criado com sucesso" | Sucesso na criação | Informativo |
| "Perfil atualizado com sucesso" | Sucesso na edição | Informativo |
| Mensagem de erro genérica do backend | Erro retornado pela API | — |
Integrações e dependências
- Consome
perfisService.criar()eperfisService.atualizar(). - A lista de módulos e ações disponíveis vem do endpoint
GET /rbac/catalogo(fonte:apps/api-core/src/lib/rbac-catalogo.ts) — qualquer novo módulo deve ser adicionado lá. - Após a criação, redireciona para
/perfis/:id/editar(replace no histórico). - Após a edição, recarrega os dados do perfil sem sair da tela.
- Perfis criados aqui são selecionáveis no Cadastro de Usuário (apenas perfis com situação Ativo).
Dúvidas frequentes
Posso duplicar um perfil existente para criar um similar?
O que acontece com os usuários de um perfil que eu tornar Inativo?
Por que não consigo editar este perfil? Se o perfil exibir o ícone de cadeado na listagem e a mensagem "Perfil de sistema" no formulário, ele foi criado pelo Manto ERP e não pode ser alterado. Crie um novo perfil com as permissões desejadas.
Um usuário com o perfil "Visualizar" em Usuários consegue ver dados de outros tenants? Não. O sistema isola completamente os dados por tenant — um usuário só acessa registros da sua empresa.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |