ENDPOINTS

Colaboradores

Liste, crie e atualize colaboradores de forma programática. Ideal para sincronizar o cadastro com o seu sistema de RH.

GET/v1/employeesemployees:read

Lista todos os colaboradores do tenant com filtros e paginação.

Query parameters

Campo	Tipo	Obrig.	Descrição
`page`	integer	não	Página (padrão: 1).
`limit`	integer	não	Itens por página (padrão: 20, máximo: 100).
`search`	string	não	Busca por nome, e-mail ou matrícula.
`status`	string	não	Filtro de status: ACTIVE, INACTIVE, ON_LEAVE, TERMINATED.
`unitId`	string (UUID)	não	Filtrar por unidade.
`departmentId`	string (UUID)	não	Filtrar por departamento.

# Listar colaboradores ativos
curl "https://api.meuponto360.com/v1/employees?status=ACTIVE&limit=50" \
  -H "x-api-key: mp360_sk_sua_chave"

200 OK

{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "name": "João Silva",
      "email": "joao@empresa.com",
      "registrationNumber": "001",
      "role": "EMPLOYEE",
      "status": "ACTIVE",
      "department": "Tecnologia",
      "admissionDate": "2024-01-15T00:00:00.000Z"
    }
  ],
  "meta": { "total": 42, "page": 1, "lastPage": 1 }
}

POST/v1/employeesemployees:write

Cria um novo colaborador no tenant.

Parâmetros do body

Campo	Tipo	Obrig.	Descrição
`name`	string	sim	Nome completo do colaborador.
`registrationNumber`	string	sim	Matrícula única do colaborador no tenant.
`email`	string	não	E-mail (usado para login e notificações).
`role`	string	não	Papel: ADMIN, MANAGER, SUPERVISOR, EMPLOYEE, AUDITOR. Padrão: EMPLOYEE.
`admissionDate`	string (ISO 8601)	não	Data de admissão.
`unitId`	string (UUID)	não	ID da unidade/filial.
`departmentId`	string (UUID)	não	ID do departamento.
`jobRoleId`	string (UUID)	não	ID do cargo.

curl -X POST https://api.meuponto360.com/v1/employees \
  -H "x-api-key: mp360_sk_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Santos",
    "email": "maria@empresa.com",
    "registrationNumber": "042",
    "admissionDate": "2026-03-01"
  }'

PATCH/v1/employees/:idemployees:write

Atualiza os dados de um colaborador existente. Envie apenas os campos que deseja modificar.

curl -X PATCH https://api.meuponto360.com/v1/employees/a1b2c3d4-... \
  -H "x-api-key: mp360_sk_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"departmentId": "dept-uuid-aqui"}'