Skip to content

Days

What is it?

Shift defines hours within a working day: time of entry, time of departure, intervals and if there is work scheduled that day.

It is the fundamental unit used by the scales to assemble the employee's routine.

Journey Types

Type Description Behavior
With work Day with expected entry/output Absence without registration → missing
No job Rest or rest Absence does not generate foul

Why Does It Matter

If a "no work" journey is associated with a day off, the system does not wait for an appointment — correctly. But if a "with work" journey is used on a day that the collaborator should not work, it can lead to incorrect fault.

Why It Matters In Integration

  • Journey influences point records interpretation and sheet calculation
  • In integrations, journey is often referenced by your code
  • Must be registered before scale (compulsory deficit)

Available Operations

Method Endpoint Description
GET /jornadas/ List journeys
POST /jornadas/ Create journey
GET /jornadas/{id}/ Get Journey
PATCH /jornadas/{id}/ Update

Fields

Field Type Required Description
id integer — Internal ID
empregador_id integer Employer to whom you belong
codigo string Recommended Integration code
nome string Descriptive journey name
tipo string com_trabalho or sem_trabalho
dia_semana integer — Day (0=Mon, 6=Dom), when fixed
hora_entrada team — Input times
hora_saida team — Time of departure
intervalo_minutos integer — Duration of interval (minutes)

Example: Create Workday

Request

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
}

Response (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
}

Example: Create Happy Journey

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"
}

Common Errors

Error Cause Solution
Miss wrongly generated Journey with work on day off Use tipo: sem_trabalho for breaks
Scale without journey Try to create scale before journeys Register journeys first