---
title: "Criar uma nova requisição de férias"
method: POST
path: "/v1/pessoal/funcionarios/requisicoes-ferias"
tags: ["HCM Cadastros"]
---

# Criar uma nova requisição de férias

`POST /v1/pessoal/funcionarios/requisicoes-ferias`

## Request

- Base URL: `https://api.sankhya.com.br`
- URL: `https://api.sankhya.com.br/v1/pessoal/funcionarios/requisicoes-ferias`
- Auth: API key in header `Authorization`

Este endpoint permite o registro de uma nova requisição de férias de um funcionário. O processo é realizado em duas etapas internas: validação dos campos e período aquisitivo, seguida do lançamento da solicitação.

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

## Request body

- RequisicaoFeriasRequest
  - `codFunc` integer, required: Código do funcionário. Entidade: **Funcionário** (TFPFUN.CODFUNC).
  - `codEmp` integer, required: Código da empresa. Entidade: **EmpresaPessoal** (TFPFUN.CODEMP).
  - `periodoAquisitivo` object, required: Dados do período aquisitivo de férias do funcionário.
    - `dataInicioAquisitivo` string, required: Data de início do período aquisitivo. Formato: **dd/MM/yyyy**.
    - `dataFimAquisitivo` string: Data de fim do período aquisitivo. Formato: **dd/MM/yyyy**. Opcional — utilizado para desambiguação quando há múltiplos períodos com a mesma data de início.
  - `ferias` object, required: Dados do gozo de férias.
    - `dataInicioGozo` string, required: Data de início do gozo de férias. Formato: **dd/MM/yyyy**.
    - `numeroDias` integer, required: Quantidade de dias de férias solicitados.
    - `adianta13` boolean: Indica se o funcionário deseja adiantar o 13° salário junto às férias.
    - `abonoPecuniario` integer: Quantidade de dias de abono pecuniário (conversão de dias de férias em dinheiro). Quando não informado, assume **0**. A soma de `numeroDias + abonoPecuniario` não pode exceder 30.

## Response `200`

Requisição de Férias criada com sucesso.

- RequisicaoFeriasCreateResponse
  - `codigoSolicitacao` integer: Código da requisição de férias criada.

## 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.

## Changes

- **2026-11-03** `b3c833e7aab1`: 1 breaking, 1 warning, 3 info
  - the `error` response's property type changed from `string` to `object` for status `400`
  - removed the optional property `mensagem` from the response with the `400` status
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/details` to the response with the `400` status
  - …1 more

[Operation history](https://skmtc.dev/sankhya/apis/api-sankhya/changes/v1/pessoal/funcionarios/requisicoes-ferias/post.md)

---

[API](https://skmtc.dev/sankhya/apis/api-sankhya.md) - [All operations](https://skmtc.dev/sankhya/apis/api-sankhya/llms.txt) - [OpenAPI document](https://skmtc.dev/sankhya/apis/api-sankhya/revisions/b3c833e7aab1?raw)