Pular para conteúdo

Jornadas

O que é

Jornada define os horários dentro de um dia de trabalho: hora de entrada, hora de saída, intervalos e se há trabalho previsto naquele dia.

É a unidade fundamental usada pelas escalas para montar a rotina do colaborador.

Tipos de Jornada

Tipo Descrição Comportamento
Com trabalho Dia com entrada/saída previstas Ausência sem registro → falta
Sem trabalho Folga ou descanso Ausência não gera falta

Por que isso importa

Se uma jornada "sem trabalho" for associada a um dia de folga, o sistema não aguarda marcação — correctamente. Mas se uma jornada "com trabalho" for usada em um dia que o colaborador não deveria trabalhar, pode gerar falta incorretamente.

Por que isso importa numa integração

  • Jornada influencia a interpretação dos registros de ponto e o cálculo da folha
  • Em integrações, jornada é frequentemente referenciada pelo seu código
  • Deve ser cadastrada antes das escalas (depência obrigatória)

Operações Disponíveis

Método Endpoint Descrição
GET /jornadas/ Listar jornadas
POST /jornadas/ Criar jornada
GET /jornadas/{id}/ Obter jornada
PATCH /jornadas/{id}/ Atualizar

Campos

Campo Tipo Obrigatório Descrição
id integer — ID interno
empregador_id integer ✅ Empregador ao qual pertence
codigo string Recomendado Código de integração
nome string ✅ Nome descritivo da jornada
tipo string ✅ com_trabalho ou sem_trabalho
dia_semana integer — Dia (0=Seg, 6=Dom), quando fixo
hora_entrada time — Horário de entrada
hora_saida time — Horário de saída
intervalo_minutos integer — Duração do intervalo (minutos)

Exemplo: Criar Jornada com Trabalho

Requisição

HTTP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
POST /pontotel/api/v4/jornadas/
Authorization: Bearer {token}
Content-Type: application/json

{
  "empregador_id": 42,
  "codigo": "JOR-PADRAO",
  "nome": "Jornada Padrão 8h",
  "tipo": "com_trabalho",
  "hora_entrada": "08:00:00",
  "hora_saida": "17:00:00",
  "intervalo_minutos": 60
}

Resposta (201 Created)

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "id": 301,
  "empregador_id": 42,
  "codigo": "JOR-PADRAO",
  "nome": "Jornada Padrão 8h",
  "tipo": "com_trabalho",
  "hora_entrada": "08:00:00",
  "hora_saida": "17:00:00",
  "intervalo_minutos": 60
}

Exemplo: Criar Jornada de Folga

HTTP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
POST /pontotel/api/v4/jornadas/
Authorization: Bearer {token}
Content-Type: application/json

{
  "empregador_id": 42,
  "codigo": "JOR-FOLGA",
  "nome": "Folga",
  "tipo": "sem_trabalho"
}

Erros Comuns

Erro Causa Solução
Falta gerada erroneamente Jornada com trabalho em dia de folga Use tipo: sem_trabalho para folgas
Escala sem jornada Tentar criar escala antes das jornadas Cadastre jornadas primeiro