Skip to main content
PATCH
/
regras-de-ponto
/
{regraDePontoId}
/
configuracao
/
horas-extras
Atualiza as configurações de horas extras de uma regra de ponto
curl --request PATCH \
  --url https://api.example.com/regras-de-ponto/{regraDePontoId}/configuracao/horas-extras \
  --header 'Content-Type: application/json' \
  --data '
{
  "diaFechamento": 20,
  "considerarFeriadoDiaTrabalho": false,
  "calcularSeparadoIntervalo": true,
  "utilizarConfigPadrao": false,
  "utilizarConfigPersonalizada": false,
  "controlarMeiaFalta": true,
  "utilizarConfigAvancada": true,
  "regraDePontoConfigAvancada": [
    {
      "periodoRegra": "DIA_DE_TRABALHO",
      "percentualAvancado": [
        {
          "posicao": 0,
          "percentual": 0.5,
          "limite": "02:00"
        },
        {
          "posicao": 1,
          "percentual": 0.75
        }
      ]
    }
  ]
}
'
{
  "regraDePontoId": "72a3e315-2987017ce62d",
  "nome": "Regra de ponto HORA EXTRA",
  "codigo": 1,
  "step": "CONFIG_HORA_EXTRA",
  "tipoRegrasDePonto": "HORAS_EXTRAS",
  "ativo": false,
  "colaboradores": 0,
  "padraoSistema": false
}

Path Parameters

​
regraDePontoId
string
required

ID da Regra

Body

application/json

Dados para atualização da configuração

​
diaFechamento
number
required

Dia do fechamento do ponto

Required range: 1 <= x <= 31
Example:

20

​
considerarFeriadoDiaTrabalho
boolean
required

Ativando essa opção, hora extra realizada no intervalo irá ser calculado separadamente na apuração.

Example:

false

​
calcularSeparadoIntervalo
boolean
required

Calcular separadamente horas extras no intervalo.

Example:

true

​
utilizarConfigPadrao
boolean
required

Utilizar configurações Padrão de horas extras.

Example:

false

​
utilizarConfigPersonalizada
boolean
required

Verifiquei minha convenção sindical e mesmo assim desejo alterar o padrão.

Example:

false

​
controlarMeiaFalta
boolean
required

Irá controlar meia falta

Example:

true

​
utilizarConfigAvancada
boolean
required

Irá controlar as configurações avançadas

Example:

true

​
regraDePontoConfigAvancada
object[]
required

Array de configurações avançadas

​
primeiraFase
number

Valor da primeira fase de hora extra

Example:

0.5

​
segundaFase
number

Valor da segunda fase de hora extra

Required range: x >= 0
Example:

1

​
percentualMeiaFalta
number

Valor do percentual de meia falta

Required range: 0.01 <= x <= 1
Example:

0.5

Response

Regra atualizada

​
regraDePontoId
string
required

Id da Regra de ponto

Example:

"regraDePontoId-id"

​
nome
string
required

Nome default da regra

Example:

"Regra de ponto 5"

​
codigo
number
required

Código de identificação da regra

Example:

5

​
tipoRegrasDePonto
enum<string>
default:HORAS_EXTRAS
required

Tipo da regra de ponto

Available options:
HORAS_EXTRAS,
BANCO_DE_HORAS,
MISTO
​
step
enum<string>
default:CONFIG_HORA_EXTRA
required

Proximo step de configuração

Available options:
CONFIG_HORA_EXTRA,
CONFIG_BANCO_HORAS,
CONFIG_MISTO,
HORAS_NEGATIVAS,
FLEXIBILIDADE_TOLERANCIA,
ADICIONAL_NOTURNO,
DSR,
TOLERANCIA,
IDENTIFICACAO,
CONCLUIDO
​
ativo
boolean
required

Retorna se regra está ativa

Example:

false

​
colaboradores
number
required

Retorna quantidade de colaboradores

Example:

10

​
padraoSistema
boolean
required

Retorna flag para registro criado por padrão no sistema

Example:

false

​
createdAt
string<date-time>
required

Data de criação

Example:

"2026-04-26T19:36:24.884Z"

​
updatedAt
string<date-time>
required

Data de update

Example:

"2026-04-26T19:36:24.885Z"