Pular para conteúdo

Escalas¶

O que é¶

Escala é a estrutura que organiza a sequência de dias trabalhados e de folga ao longo de um ciclo de trabalho (ex.: 6×1, 12×36, 5×2). Para cada dia do ciclo, a escala aponta qual jornada o colaborador deverá seguir.

Dependência crítica: Jornadas antes de Escalas

A escala referencia jornadas por dia. Antes de criar uma escala, as jornadas que ela usará já devem estar cadastradas.

Diferença: Jornada vs. Escala¶

	Jornada	Escala
Define	Horários do dia (entrada/saída/intervalos)	Sequência de dias (ciclo trabalho/folga)
Granularidade	1 dia	Ciclo repetível (ex.: 6×1)
Depende de	Nada	Jornadas previamente cadastradas
Exemplo	"Segunda: 08h–17h, 1h intervalo"	"6 dias com Jornada A, 1 dia folga"

Tipos de Escala Comuns¶

Tipo	Descrição
`5x2`	5 dias trabalhados, 2 de folga (semana convencional)
`6x1`	6 dias seguidos, 1 de folga
`12x36`	12 horas trabalhadas, 36 horas de folga (plantões)
`4x3`	Semana de 4 dias

Por que isso importa numa integração¶

O colaborador deve estar associado a uma escala para que a rotina seja automatizada
Mudanças de escala impactam folha e compliance — deve-se registrar data de vigência
Em integrações, escala é frequentemente referenciada pelo seu código de integração

Operações Disponíveis¶

Método	Endpoint	Descrição
GET	`/escalas/`	Listar escalas
POST	`/escalas/`	Criar escala
GET	`/escalas/{id}/`	Obter escala
PATCH	`/escalas/{id}/`	Atualizar

Campos¶

Campo	Tipo	Obrigatório	Descrição
`id`	integer	—	ID interno
`empregado_id`	integer	✅	ID do empregado
`tipo`	string	✅	Tipo de escala (ex.: `5x2`, `12x36`)
`data_inicio`	date	✅	Início da vigência
`data_fim`	date	—	Fim da vigência (null = em vigor)
`jornadas`	array	—	Jornadas por dia do ciclo

Exemplo: Criar Escala¶

Requisição¶

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

{
  "empregado_id": 500,
  "tipo": "5x2",
  "data_inicio": "2025-01-15"
}

Resposta (201 Created)¶

JSON
{
  "id": 200,
  "empregado_id": 500,
  "tipo": "5x2",
  "data_inicio": "2025-01-15",
  "data_fim": null,
  "jornadas": []
}

Erros Comuns¶

Erro	Causa	Solução
Escala sem jornadas	Jornadas não cadastradas antes da escala	Cadastre jornadas primeiro
Datas sobrepostas	Período de vigência conflitante com escala existente	Encerre a escala anterior antes de criar nova

Links Relacionados¶