# Pessoas, cargos e acessos

Cadastre pessoas, associe unidades e cargos e conceda ou revogue acesso sem confundir identidade com login.

Versão 1.2.1

**Gerenciador → Pessoas** reúne Acessos, Administradores, Colaboradores, Parceiros, Cargos e Fornecedores. As abas dependem dos tipos habilitados nas configurações. Clientes ficam em **Gerenciador → Atribuições → Clientes**. Uma pessoa pode participar da operação sem ter login; conceder acesso é uma decisão separada.

## Tipos e pré-requisitos

Pessoas permanece disponível. Colaboradores começam habilitados; Parceiros, Fornecedores, Cargos e Permissões por cargo dependem de ativação. Somente o Master altera essas configurações e as políticas globais. As associações de organizações/suborganizações seguem a configuração global de Organizações.

| Tipo | Particularidades |
| --- | --- |
| Administrador | Cadastro completo com acesso obrigatório; pode ser Master, Administrador ou Visualizador. Não tem cargo e não pode ser inativado. |
| Colaborador ou Parceiro | Pode existir sem acesso. Quando recebe acesso, utiliza Padrão ou a política do cargo habilitado. |
| Cliente | Não recebe login; pode ter um colaborador responsável. |
| Fornecedor | Não recebe login. |
| Cargo | É uma classificação para colaborador ou parceiro, com regras próprias; não é uma pessoa nem um acesso. |

O tipo da pessoa não pode ser trocado depois de salvar. Para evitar cadastros incorretos, selecione a aba apropriada antes de criar.

## Cadastrar vendedores

Cadastre seus vendedores no web em **Gerenciador → Pessoas → Colaboradores**. Abra o novo cadastro, preencha **Nome** e salve com **Status → Ativo**.

Se a dúvida for sobre vendedores que não aparecem na comissão, depois de cadastrar volte à **Performance → Dados Gerais** e selecione essas pessoas na aba **Colaboradores** do ciclo. Cadastrar a pessoa não a seleciona automaticamente numa Performance já existente. Não é necessário conceder login para ela participar. Veja a [seleção de participantes](/spm/manual/performance-participantes/#selecao-individual-e-paginacao).

## Cadastrar uma pessoa

1. Abra a aba do tipo desejado e a ação de novo cadastro no cabeçalho.
2. Preencha **Nome**, obrigatório, com até 150 caracteres. **Documento** é opcional e aceita até 50 caracteres.
3. Se disponíveis, escolha organizações, suborganizações e cargo. Cada suborganização deve ter sua organização selecionada; o cargo precisa corresponder ao tipo da pessoa.
4. Preencha as demais opções aplicáveis, revise o acesso e salve.

| Campo condicional | Quando aparece e como preencher |
| --- | --- |
| Organizações e Suborganizações | Quando habilitadas globalmente; permitem múltiplos vínculos. Uma suborganização exige sua organização selecionada. As escolhas e alterações respeitam o alcance do editor. |
| Cargo | Colaborador ou Parceiro, com Cargos habilitados; pode ficar Sem cargo. Escolha cargo ativo do mesmo tipo de pessoa. |
| Colaborador responsável | Cliente, com Responsável pelo cliente e Colaboradores habilitados. Opcional, inicialmente Sem responsável. Não concede login ao cliente. |
| Remuneração fixa e Remuneração variável | Colaboradores e Parceiros, com Valores de remuneração habilitado. Opcionais, não negativas, até 9.999.999.999.999,99, com precisão monetária. Não significam pagamento executado nem atualização geral de ciclos. |
| Status | Ativo ou Inativo, inicialmente Ativo, exceto Administradores, que permanecem ativos. Inativar preserva identidade e histórico, sujeito às proteções do acesso. |

Novos registros usam situação Ativo. Colaboradores e parceiros podem apresentar remuneração fixa e variável quando esse recurso está habilitado; os valores informados precisam ser não negativos. Alterações na pessoa podem atualizar pagamentos fixos conforme a configuração de Pagamentos e estão sujeitas aos limites contratados de participantes. Isso não significa executar uma transferência bancária.

Exemplo fictício: cadastre Ana como colaboradora, vincule-a à organização Comercial e deixe **Não conceder** se ela participará das apurações sem entrar no sistema. Conceda o acesso posteriormente, se necessário.

## Conceder e revogar acesso

Para colaboradores e parceiros, use a seção **Acesso** e escolha **Conceder**. Um acesso novo exige **Login (E-mail)** válido, até 190 caracteres, normalizado para minúsculas, e a escolha entre **Atribuir senha** (de 8 a 128 caracteres) ou **Primeiro acesso por e-mail**. Colaborador e Parceiro começam com Não conceder. Para Administrador, conceder acesso é obrigatório: selecione **Nível de acesso → Master, Administrador ou Visualizador**, inicialmente Administrador; somente um Master pode atribuir Master. A senha segue os requisitos descritos em [Entrar e gerenciar suas contas](/spm/manual/acesso-e-sessoes/#recuperar-a-senha). Ao editar um acesso já configurado, deixar Senha vazia preserva a senha existente.

Escolher **Não conceder** revoga o acesso e as sessões sem apagar a pessoa nem seus vínculos. Alterar login ou senha também invalida sessões anteriores. O último Master com acesso não pode perder esse papel/acesso.

A aba **Acessos** lista as credenciais existentes. Editar nela abre somente os dados de acesso; não altera a identidade e as associações da pessoa. Excluir acesso preserva a pessoa e encerra suas sessões. Essa exclusão não é oferecida para Master. Para editar o cadastro completo, use a aba do tipo de pessoa.

## Cadastrar cargos

Somente o Master mantém Cargos. No cadastro completo, preencha:

| Campo | Regra |
| --- | --- |
| Nome | Obrigatório, até 100 caracteres. |
| Cargo de | Colaborador (inicial) ou Parceiro; não muda depois de salvar. |
| Remuneração fixa e Remuneração variável | Opcionais quando Valores de remuneração está habilitado; valores não negativos com precisão monetária. |
| Status | Ativo (inicial) ou Inativo. |
| Permissões | Editor disponível com Permissões por cargo habilitado; parte da política Padrão em novo cargo e permite definir capacidades por página. |

O cargo tem tipo Colaborador ou Parceiro, que não muda depois de criado. O nome é único dentro da empresa para aquele tipo. Com Cargos e Permissões por cargo ativados, a política do cargo substitui a política geral Padrão da pessoa associada. Sem essa combinação, continua valendo a política geral.

Cargo inativo não concede permissões. Administradores não usam cargo. A política do cargo não amplia o alcance para registros de outros participantes; consulte [Perfis, permissões e alcance dos dados](/spm/manual/permissoes-e-escopos/).

## Remuneração fixa e variável

Com **Valores de remuneração** habilitado, Colaboradores, Parceiros e seus Cargos oferecem os dois campos opcionais. Aceitam valores monetários não negativos até **9.999.999.999.999,99**, com duas casas decimais. Preencher esses campos não cria uma transferência nem garante remuneração no ciclo.

| Campo | Finalidade e utilização |
| --- | --- |
| Remuneração fixa | Referência para a parcela fixa, independente do atingimento das metas. Sua geração como obrigação deve ser configurada em Pagamentos, no vínculo de Pagamento fixo. Não é somada automaticamente a toda comissão ou bônus. |
| Remuneração variável | Referência de remuneração vinculada a resultados. Pode compor a base de uma regra de Performance, especialmente OTE ou Score; o valor efetivo depende do atingimento e da faixa/fator configurados. Não é um bônus garantido nem o valor realizado de vendas. |

Ao selecionar um colaborador na Performance, o sistema usa o valor informado na pessoa; se estiver ausente, usa o cargo; se ambos estiverem ausentes, usa zero. **Zero informado é um valor explícito** e não é substituído pelo cargo. Fixa e variável seguem essa prioridade de forma independente.

A Performance guarda uma **cópia dos valores e vínculos do colaborador no ciclo**. Alterar Pessoas ou Cargos não reescreve automaticamente todos os ciclos: **Atualizar** busca os valores atuais, **Editar** ajusta apenas aquele ciclo e **Limpar** zera os valores do ciclo. Duplicar preserva a referência da origem para os participantes que continuam ativos; não atualiza silenciosamente para o cadastro atual. Veja [remuneração fixa e variável no ciclo](/spm/manual/performance-participantes/#remuneracao-fixa-e-variavel-no-ciclo).

Exemplo: uma colaboradora tem fixa de R$ 2.000 e variável de R$ 1.000. Uma regra OTE baseada na variável com fator 1 paga R$ 1.000 de variável quando sua faixa é atingida; com fator 1,2, paga R$ 1.200. A fixa continua sujeita à configuração própria de Pagamentos. O cálculo não soma automaticamente R$ 2.000 à regra OTE.

Parceiros também podem ter esses campos em Pessoas/Cargos, mas a Performance atual não oferece a mesma tabela de valores do ciclo nem pagamento pela referência **Remuneração variável** para parceiros. Use apenas as opções disponibilizadas para esse público.

## Dados de recebimento

O cadastro completo de Colaboradores e Parceiros oferece **Forma de recebimento → Não informado, Pix ou TED**, com Titular e CPF/CNPJ do titular. Pix exige Tipo de chave e Chave Pix; TED exige Código do banco, Agência, Conta e Tipo de conta, com dígitos opcionais. O documento do titular deve corresponder ao da pessoa. Alterar exige aprovação em Pessoas; configurar recebimento não movimenta dinheiro nem ativa CNAB/Split. Veja todos os [campos e validações de recebimento](/spm/manual/pessoas-dados-de-recebimento/).

## Tabela, importação e cuidados

Use filtros e seleção antes de editar, duplicar ou exportar. A exportação da tabela gera JSON com os registros filtrados ou selecionados. A importação aceita uma lista JSON; duplicações e importações não copiam credenciais e começam sem acesso. Revise os dados antes de conceder logins.

A aba Acessos não permite novo cadastro, importação ou edição em lote. Administradores exigem o cadastro completo; cadastro rápido, duplicação e importação ficam indisponíveis para esse tipo. Nas demais abas, as ações visíveis continuam dependendo da permissão.

Se uma opção estiver ausente, confira o tipo habilitado, o cargo compatível, os vínculos, os filtros e seu alcance. Um Administrador não pode alterar o próprio acesso/associações nem contas Master pelo Gerenciador.

## Disponibilidade

O cadastro de Pessoas e a configuração de Cargos/Acessos estão no web. No aplicativo, a pessoa pode gerenciar o próprio perfil e usar os dados e seletores autorizados das operações; não há a tela de Gerenciador → Pessoas.

### Primeiro acesso por e-mail

Em Pessoas → Acessos, edite o acesso e escolha **Primeiro acesso por e-mail** em **Definição de senha**, entre o e-mail e a senha. Essa opção também está disponível ao cadastrar uma pessoa com acesso. Ao tentar entrar com o e-mail cadastrado, o usuário recebe um link para criar sua senha, válido por 30 minutos e de uso único. Depois de definir a senha, entra normalmente com ela. O cadastro não envia o e-mail antecipadamente.

Para definir uma senha diretamente, escolha **Atribuir senha**. Na edição de um acesso com senha cadastrada, deixar o campo vazio mantém a senha atual. Selecionar **Primeiro acesso por e-mail** remove a senha anterior e invalida as sessões existentes; pode ser usado novamente quando o usuário precisar definir outra senha. Acessos inativos continuam bloqueados. O suporte autorizado pelo Admin pode acessar a conta antes da definição de senha.