Skip to content

Vacation

What is it?

Vacation it is the registration of paid rest periods of the employee according to the current labor law (CLT). Synchronizing holidays at Pontotel prevents leaf inconsistencies and reports when the employee is absent.

Why It Matters In Integration

  • Avoids inconsistencies on the sheet: without registration, the system can interpret absence as lack
  • Sync with ERP/RH: sheet systems normally control holiday periods — integration should reflect this data in Pontotel to avoid manual releases
  • Compliance: maintaining correct holiday history is legal requirement

Business Rules

  • Vacations can be fractionated in up to 3 periods (as CLT)
  • No period may be less than 14 days running
  • Vacation periods may not overwrite One another
  • The collaborator needs to have the purchase period complete to be entitled (12 months)
  • Inactive employee vacation can still be consulted

Available Operations

Method Endpoint Description
GET /ferias/ List holidays
POST /ferias/ Registration period
GET /ferias/{id}/ Get Period
PATCH /ferias/{id}/ Update
DELETE /ferias/{id}/ Cancel

Fields

Field Type Required Description
id integer — Internal ID
empregado_id integer Employee ID
data_inicio date Start of holiday period
data_fim date End of holiday period
status string — pendente \
observacao string — Observation

Example: Registration Holidays

Request

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

{
  "empregado_id": 500,
  "data_inicio": "2025-07-01",
  "data_fim": "2025-07-30",
  "observacao": "Férias anuais 2025 — 1ª parcela"
}

Response (201 Created)

JSON
1
2
3
4
5
6
7
8
{
  "id": 77,
  "empregado_id": 500,
  "data_inicio": "2025-07-01",
  "data_fim": "2025-07-30",
  "status": "pendente",
  "observacao": "Férias anuais 2025 — 1ª parcela"
}

Common Errors

Error Cause Solution
Mistakes in the sheet Unregistered holidays during the period Register holidays before or together with the period
Overlay of periods Two holiday records with conflicting dates Check existing periods before creating
Period less than 14 days Fractioning below legal minimum Ensure minimum of 14 days run per plot