Férias¶

O que é¶

Férias é o registro dos períodos de descanso remunerado do colaborador conforme a legislação trabalhista vigente (CLT). Sincronizar férias na Pontotel evita inconsistências em folha e relatórios quando o colaborador estiver ausente.

Por que isso importa numa integração¶

Evita inconsistências na folha: sem o registro, o sistema pode interpretar a ausência como falta
Sincronização com ERP/RH: sistemas de folha normalmente controlam períodos de férias — a integração deve refletir esses dados na Pontotel para evitar lançamentos manuais
Conformidade: manter histórico correto de férias é exigência legal

Regras de Negócio¶

Férias podem ser fracionadas em até 3 períodos (conforme CLT)
Nenhum período pode ser inferior a 14 dias corridos
Períodos de férias não podem sobrepor uns aos outros
O colaborador precisa ter o período aquisitivo completo para ter direito (12 meses)
Férias de colaborador inativo ainda podem ser consultadas

Operações Disponíveis¶

Método	Endpoint	Descrição
GET	`/ferias/`	Listar férias
POST	`/ferias/`	Registrar período
GET	`/ferias/{id}/`	Obter período
PATCH	`/ferias/{id}/`	Atualizar
DELETE	`/ferias/{id}/`	Cancelar

Campos¶

Campo	Tipo	Obrigatório	Descrição
`id`	integer	—	ID interno
`empregado_id`	integer	✅	ID do empregado
`data_inicio`	date	✅	Início do período de férias
`data_fim`	date	✅	Fim do período de férias
`status`	string	—	`pendente` \| `aprovado` \| `cancelado`
`observacao`	string	—	Observação

Exemplo: Registrar Férias¶

Requisição¶

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

Resposta (201 Created)¶

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

Erros Comuns¶

Erro	Causa	Solução
Faltas indevidas na folha	Férias não registradas durante o período	Registre férias antes ou junto com o período
Sobreposição de períodos	Dois registros de férias com datas conflitantes	Verifique períodos existentes antes de criar
Período inferior a 14 dias	Fracionamento abaixo do mínimo legal	Garanta mínimo de 14 dias corridos por parcela