Usuários¶

O que é¶

Usuário é a identidade de acesso à plataforma Pontotel — é quem faz login, executa ações e/ou registra ponto conforme as permissões atribuídas.

Usuário ≠ Empregado

Usuário = quem acessa o sistema (login, permissões, ações)
Empregado = quem trabalha (cadastro de RH, jornadas, marcações)

Em muitos cenários, o usuário é vinculado a um empregado para que o colaborador possa acessar o sistema com os dados corretos.

Tipos de Usuário¶

Tipo	Descrição
Gestão	Perfil administrativo/operacional — RH, supervisão, administração
Funcionário	Perfil restrito do colaborador — registro de ponto + visão pessoal
Coletivo	Para dispositivos compartilhados (ponto em totem/tablet da empresa)

Por que isso importa numa integração¶

Integrações costumam: - Provisionar usuários automaticamente para gestores/RH e para os próprios colaboradores - Vincular usuário ↔ empregado para evitar duplicidade de cadastro e garantir dados consistentes (nome, e-mail) no registro de ponto

Regras de Negócio¶

Username e e-mail devem ser únicos na plataforma
Usuários inativos não conseguem autenticar na API
O vínculo com empregado garante consistência: ao editar o empregado, os dados do usuário se atualizam automaticamente
Defina claramente o padrão de e-mails antes de criar usuários em massa (e-mail real, alias por CPF, e-mail técnico etc.)

Operações Disponíveis¶

Método	Endpoint	Descrição
GET	`/usuarios/`	Listar usuários
POST	`/usuarios/`	Criar usuário
GET	`/usuarios/{id}/`	Obter usuário
PATCH	`/usuarios/{id}/`	Atualizar
DELETE	`/usuarios/{id}/`	Remover

Campos¶

Campo	Tipo	Obrigatório	Descrição
`id`	integer	—	ID interno
`username`	string	✅	Login do usuário
`email`	string	✅	E-mail
`first_name`	string	—	Nome
`last_name`	string	—	Sobrenome
`password`	string	✅ (criação)	Senha (apenas na criação)
`empregado_id`	integer	—	Vínculo com empregado (recomendado)
`permissoes`	array	—	Lista de permissões
`is_active`	boolean	—	Status (padrão: `true`)
`date_joined`	datetime	—	Data de criação

Exemplo: Criar Usuário Funcionário¶

HTTP
POST /pontotel/api/v4/usuarios/
Authorization: Bearer {token}
Content-Type: application/json

{
  "username": "maria.santos",
  "email": "maria.santos@empresa.com",
  "first_name": "Maria",
  "last_name": "Santos",
  "password": "senha_segura_123!",
  "empregado_id": 500
}

Erros Comuns¶

Erro	Causa	Solução
E-mail duplicado	Dois usuários com o mesmo e-mail	Padronize antes da criação em massa
Dados divergentes	Usuário não vinculado ao empregado	Sempre vincule `empregado_id` para colaboradores
Permissão errada	Misturar perfil de gestão com perfil pessoal	Defina tipos de perfil antes da integração

Fluxos Comuns¶

Criar usuário de gestão: via POST /usuarios/ sem empregado_id
Criar usuário funcionário: via POST /usuarios/ com empregado_id preenchido (preenche nome/e-mail automaticamente)