---
title: "Consultar períodos aquisitivos de férias"
method: GET
path: "/v1/pessoal/periodos-aquisitivos-ferias"
tags: ["HCM Cadastros"]
---

# Consultar períodos aquisitivos de férias

`GET /v1/pessoal/periodos-aquisitivos-ferias`

Retorna os períodos aquisitivos de férias **não gozados** cadastrados no SankhyaOm. Um período não gozado pode ter saldo de dias igual a zero. Por padrão, esses períodos com saldo zerado também não são retornados; utilize o parâmetro `saldoZerado=true` para incluí-los.

**Regras de filtro:**
- `codigoFuncionario` só pode ser informado em conjunto com `codigoEmpresa`.

 Versão mínima do módulo pessoal: **5.102.0**

## Query parameters

- `codigoEmpresa` integer
- `codigoFuncionario` integer
- `updatedSince` string
- `saldoZerado` boolean
- `page` integer

## Response `200`

Lista de períodos aquisitivos retornada com sucesso.

- PeriodosAquisitivosFeriasResponse
  - `periodosAquisitivos` PeriodoAquisitivoFerias[]
    - `empresa` object
      - `codigo` integer — Código da empresa. Entidade: **EmpresaPessoal** (TFPFUN.CODEMP).
      - `nomeFantasia` string — Nome fantasia da empresa.
    - `funcionario` object
      - `codigo` integer — Código do funcionário. Entidade: **Funcionário** (TFPFUN.CODFUNC).
      - `nome` string — Nome completo do funcionário.
    - `periodoAquisitivo` object — Intervalo de datas do período aquisitivo de férias.
      - `dataInicio` string — Data de início do período aquisitivo. Formato: **dd/MM/yyyy HH:mm:ss**.
      - `dataFim` string — Data de fim do período aquisitivo. Formato: **dd/MM/yyyy HH:mm:ss**.
    - `abonoPecuniario` integer — Total de dias convertidos em abono pecuniário (venda de dias de férias). Entidade: **VFPPeriodoAquisitivoFerias** (ABONOPECUNIARIO).
    - `faltasNoPeriodo` integer — Quantidade de faltas registradas no período aquisitivo. Entidade: **VFPPeriodoAquisitivoFerias** (FALTPER).
    - `diasPerdidoFaltas` integer — Dias de férias perdidos em razão das faltas no período, conforme tabela progressiva da CLT. Entidade: **VFPPeriodoAquisitivoFerias** (DIASPERDIDOFALTAS).
    - `diasFeriasGozados` integer — Total de dias de férias já gozados ou com gozo agendado (sequências com data prevista informada). Entidade: **VFPPeriodoAquisitivoFerias** (NUMDIASFER).
    - `licencaRemunerada` integer — Dias de licença remunerada no período. Entidade: **VFPPeriodoAquisitivoFerias** (LICENCAREMUNERADA).
    - `adianta13` boolean — Indica se o adiantamento do 13° salário foi solicitado nas férias.
    - `saldoDias` integer — Saldo de dias de férias disponíveis para gozo. Calculado como: `MAIOR(30 - diasPerdidoFaltas - abonoPecuniario - diasFeriasGozados, 0)`. Entidade: **VFPPeriodoAquisitivoFerias** (SALDODIAS).
    - `dataAlteracao` string — Data e hora da última alteração no período aquisitivo. Formato: **dd/MM/yyyy HH:mm:ss**.

## Other responses

- `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/versions/0a3e81ca6195/schema)