Usuarios¶

Qué es¶

Usuario es la identidad de acceso a la plataforma Pontotel — es quien inicia sesión, ejecuta acciones y/o registra punto conforme a los permisos asignados.

≠ Empleado

Usuario = quién accede el sistema (login, permisos, acciones)
Empleado = quién trabaja (cadastro de RH, jornadas, marcas)

En muchos escenarios, el usuario es vinculado a un empleado Para que el colaborador pueda acceder al sistema con los datos correctos.

Tipos de usuario¶

Tipo	Descripción
Gestión	Perfil administrativo/operacional — RH, supervisión, administración
Funcion	Perfil restringido del colaborador — registro de punto + visión personal
Colectivo	Para dispositivos compartidos (punto en totem/tablet de la empresa)

Por qué esto importa en una integración¶

Integraciones suelen: - Provisionar usuarios automáticamente para gestores/RH y para los propios colaboradores - Vincular usuario ↔ empleado para evitar la duplicidad de registro y garantizar datos consistentes (nombre, correo electrónico) en el registro de punto

Reglas de negocio¶

Username y correo electrónico deben ser únicos en la plataforma
Los usuarios inactivos no pueden autenticar en la API
El vínculo con empleado garantiza consistencia: al editar el empleado, los datos del usuario se actualizan automáticamente
Establezca claramente el patrón de correo electrónico antes de crear usuarios en masa (e-mail real, alias por CPF, e-mail técnico etc.)

Operaciones disponibles¶

Método	Variable	Descripción
GET	`/usuarios/`	Listar usuarios
POST	`/usuarios/`	Crear usuario
GET	`/usuarios/{id}/`	Obtener usuario
PATCH	`/usuarios/{id}/`	Actualizar
DELETE	`/usuarios/{id}/`	Eliminar

Campos¶

Campo	Tipo	Obligatorio	Descripción
`id`	Integer	—	ID interno
`username`	string	Gálatas	Login del usuario
`email`	string	Gálatas	Correo electrónico
`first_name`	string	—	Nombre
`last_name`	string	—	Sobrenombre
`password`	string	Gálatas (creación)	Contraseña (solo en la creación)
`empregado_id`	Integer	—	Vínculo empleado (recomendado)
`permissoes`	array	—	Lista de permisos
`is_active`	boolean	—	Status (estándar: `true`)
`date_joined`	datetime	—	Fecha de creación

Ejemplo: Crear usuario Funcionario¶

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
}

Errores comunes¶

Error	Causa	Solución
Correo electrónico duplicado	Dos usuarios con el mismo correo	Padronize antes de la creación en masa
Datos divergentes	Usuario no vinculado al empleado	Siempre vincule `empregado_id` para colaboradores
Permiso incorrecto	Mezclar perfil de gestión con perfil personal	Establecer tipos de perfil antes de la integración

Flujos comunes¶

Crear usuario de gestión: POST /usuarios/ sin empregado_id
Crear usuario funcionario: POST /usuarios/ com empregado_id rellenado (preenche nombre/e-mail automáticamente)