O papel responde o que uma pessoa pode fazer. Ele é independente do escopo, que responde em quais empresas — as duas coisas são combinadas no cadastro de cada usuário.
A tela de papéis resume a proposta: use os papéis padrão da Kamino ou crie variações com regras específicas.
Onde fica a tela Papéis e permissões
Em Configurações › Cadastros › Papéis e permissões.
Quem administra um grupo de empresas consegue consultar os papéis, porque escolhe um deles ao convidar alguém. Criar, editar e excluir papéis próprios exige a permissão de papéis personalizados valendo para a organização inteira.
Os papéis padrão da Kamino
A tabela de papéis traz Papel, Descrição, Origem e a contagem de Usuários em cada um. Os papéis que a Kamino entrega vêm marcados como Padrão na coluna Origem. São os cinco que você escolhe ao convidar alguém:
Administrador — acesso total às empresas selecionadas, inclusive cadastros e integrações. É o papel de quem administra um grupo de empresas.
Gestor — envia pagamentos ao banco, faz transferências, fecha a conciliação e configura a cobrança.
Analista — lança contas a pagar e a receber, registra baixas, emite cobranças e concilia o extrato.
Colaborador — envia solicitações de reembolso e de pagamento e acompanha as próprias.
Visualizador — consulta todos os dados das empresas, sem criar nem alterar nada.
A coluna de contagem mostra, de relance, quantas pessoas têm cada papel. Em Mais ações, Ver usuários lista quem tem aquele papel.
Administrador da Organização e Desenvolvedor não aparecem na tabela de papéis
Dois acessos existem sem ser escolhidos na tabela de papéis, e por isso ficam fora dela:
Administrador da Organização — acesso ilimitado a toda a organização: assinatura, estrutura, papéis, segurança e todos os grupos de empresas. Ele é dado pelo interruptor Acesso administrativo à organização, no cadastro do usuário. Para saber quem é administrador da organização, confira esse interruptor no cadastro de cada usuário.
Desenvolvedor — dado pelo passe de documentação da API. Veja a seção seguinte.
O papel Desenvolvedor dá acesso só à documentação da API
O Desenvolvedor é um papel de plataforma para quem integra de fora: ele alcança apenas a documentação da API, e nenhum dado do cliente. Ele vem do convite de acesso à documentação e não é editável.
Ou seja: ele não é escolhido na hora de convidar alguém para operar a Kamino. Ele é atribuído automaticamente quando você emite um passe de documentação, e não pode ser alterado.
Como ver as permissões de um papel
Clique na linha do papel, ou use Mais ações › Ver permissões. O painel abre com as permissões agrupadas por módulo, em Permissões por módulo, e a contagem de funcionalidades ativas.
As funcionalidades são blocos, e cada bloco carrega a sua contagem de permissões — por exemplo, Usuários — Convite e gestão com 14 permissões, ou Empresas — Escrita com 3. Um papel é a seleção desses blocos.
Nos papéis padrão, o painel abre em modo de leitura, com o selo Padrão ao lado do título: as permissões aparecem desabilitadas e não se editam.
Criar um papel próprio a partir de um papel padrão
A criação de papéis próprios é liberada pela Kamino cliente a cliente. Se a sua organização não vê o botão Novo papel, ela usa só os papéis padrão.
Com a criação liberada, use Novo papel, no canto superior direito — o atalho é a tecla C —, ou Mais ações › Criar variação na linha de um papel padrão:
Escolha o Papel base. A variação nasce com as permissões dele.
Dê um Nome do papel e uma Descrição.
Desmarque, em Permissões por módulo, o que você não quer conceder.
Clique em Criar papel.
Vale criar um papel próprio quando um dos padrão chega perto do que você precisa, mas concede algo a mais que não deveria. O caso clássico é dar visão de relatórios a alguém sem permitir criar ou baixar lançamentos.
Quando o padrão já serve, use o padrão: um papel a menos é uma coisa a menos para revisar depois.
Regras e limites dos papéis próprios
Todas as regras abaixo são da Kamino:
A variação não pode conceder acessos além do papel base. O painel só mostra as permissões que o papel base concede.
A variação nasce de um papel padrão. Não dá para criar variação de outra variação.
Nome do papel até 120 caracteres, e descrição até 500.
Editar um papel próprio muda o acesso de todos os usuários atribuídos a ele.
Papel padrão não se edita nem se exclui.
Papel próprio com usuários não se exclui. A mensagem é Não é possível excluir um papel com usuários atribuídos. Remova os usuários deste papel antes de excluí-lo. Excluir não pode ser desfeito.
Perguntas frequentes sobre papéis e permissões
Qual papel dou para quem só precisa consultar?
O Visualizador: ele consulta todos os dados das empresas, sem criar nem alterar nada.
Qual a diferença entre Administrador e Administrador da Organização?
O Administrador tem acesso total às empresas selecionadas no cadastro do usuário. O Administrador da Organização alcança a organização inteira, inclusive assinatura, papéis, segurança e todos os grupos de empresas. Ele não é escolhido como papel: no cadastro do usuário, ligue Acesso administrativo à organização. Só outro administrador da organização pode ligar.
Posso mudar as permissões de um papel padrão?
Não. Papel padrão é somente leitura. Se a criação de papéis está liberada para a sua organização, crie uma variação dele e desmarque o que não quer conceder.
Como excluo um papel que não uso mais?
Só papel próprio se exclui, e só sem usuários. Tire as pessoas do papel, depois use Mais ações › Excluir papel.
Veja também
Convidar e gerenciar usuários
Passe de documentação da API
