Fluxos de integração

Os cenários suportados pela API de integração, com endpoints e exemplos de payload. Schemas completos e teste interativo na Referência da API.

Funcionários e usuários

Sincronize o quadro de colaboradores a partir do seu RH/ERP.

Ação	Endpoint
Listar / detalhar funcionários	`GET /employees/` · `GET /employees/{employee_id}/`
Criar usuário de acesso	`POST /accounts/create/` · `POST /v2/users/mobile/create/` · `POST /v2/users/manager/create/`
Atualizar usuário	`PUT /accounts/USER_ID/update/`
Criar funcionário	`POST /employees/create/`
Atualizar funcionário	`PUT /employees/{id}/update/`
Readmitir funcionário	`PUT /employees/readmission/{id}/`

Ordem recomendada: cadastros base → funcionário → usuário de acesso. Exemplos de payload no guia Primeiros passos.

Movimentações e abonos

Registre afastamentos, férias, abonos e justificativas vindos do RH.

Criar movimentação — POST /movimentation/

{
  "employee": 315,
  "justification": 4,
  "begin_date": "2026-09-10",
  "end_date": "2026-09-12",
  "observation": "Atestado médico de 3 dias"
}

Criar justificativa (tipo de movimentação) — POST /justifications/

{
  "name": "Atestado médico",
  "amount": 1,
  "blocked": false,
  "require_in_app": true,
  "require_in_web": true,
  "when_to_use": "Afastamentos por recomendação médica"
}

Ação	Endpoint
Listar / detalhar movimentações	`GET /v2/movimentations/` · `GET /v2/movimentations/{movimentation_id}`
Criar / atualizar / remover movimentação	`POST /movimentation/` · `PUT /movimentation/{id}/` · `DELETE /movimentation/{id}/`
Listar / detalhar justificativas	`GET /justifications/` · `GET /justifications/{id}/`
Criar / atualizar / remover justificativa	`POST /justifications/` · `PUT /justifications/{id}/` · `DELETE /justifications/{id}/`

Lançamentos manuais

Insira marcações que não passaram pelo registro eletrônico (decisão administrativa, ordem judicial etc.).

Lançar marcações — POST /v2/timeRecords/manual/ (V2, preferencial; V1: POST /manualEntry/)

{
  "employee_id": 315,
  "period_id": 87,
  "respect_limit": true,
  "records": [
    { "day": "2026-09-08", "hour": "08:00", "justification_id": 4 },
    { "day": "2026-09-08", "hour": "12:00", "justification_id": 4 },
    { "day": "2026-09-08", "hour": "13:00", "justification_id": 4 },
    { "day": "2026-09-08", "hour": "18:00", "justification_id": 4 }
  ]
}

Cadastros base

Mantenha a estrutura organizacional sincronizada. Disponíveis em V1 e V2 — prefira a V2.

Recurso	Consultar	Criar	Atualizar
Departamento	`GET /v2/departaments/` · `GET .../{departament_id}/`	`POST /v2/departaments/`	`PUT /v2/departaments/{departament_id}/`
Cargo	`GET /v2/departaments/positions/` · `GET .../{position_id}/`	`POST /v2/departaments/positions/`	`PUT /v2/departaments/positions/{position_id}/`
Horário/escala	`GET /v2/schedules/` · `GET .../{schedule_id}/`	`POST /v2/schedules/`	`PUT /v2/schedules/{schedule_id}/`
Calendário	`GET /v2/calendars/` · `GET .../{calendar_date_id}/`	`POST /v2/calendars/`	`PUT /v2/calendars/{calendar_date_id}/`
Feriado	`GET /v2/calendars/holidays/` · `GET .../{holiday_id}/`	`POST /v2/calendars/holidays/`	`PUT /v2/calendars/holidays/{holiday_id}/`

Exemplos de payload no guia Primeiros passos.

Acompanhamento em tempo real

O status de ponto da equipe, na mesma fonte usada pelo aplicativo do gestor.

Status da equipe — GET /v2/dashboard/team-status/

Filtros por query string: departament_id, status, search, limit, offset, pagination.

curl "https://<tenant>.api.3pontoapp.com.br/v2/dashboard/team-status/?departament_id=7&status=working" \
  --header "Authorization: JWT <token>"

Resposta (item):

{
  "employee_id": 315,
  "name": "Maria da Silva",
  "departament": "Operações",
  "position": "Analista de Operações",
  "status": "working",
  "tipo": "CLT",
  "last_entry": "2026-09-08T08:02:00",
  "late_minutes": 2,
  "image": "https://..."
}

Resumo agregado — GET /v2/dashboard/team-status/summary/

{
  "total": 128,
  "working": 97,
  "on_break": 12,
  "late": 5,
  "absent": 8,
  "day_off": 4,
  "out_of_shift": 2,
  "generated_at": "2026-09-08T10:15:00"
}