> ## Documentation Index > Fetch the complete documentation index at: https://developers.pontua.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Atualiza as configurações de horas extras de uma regra de ponto ## OpenAPI ````yaml https://api.pre.pontua.tech/api/public/doc-json patch /regras-de-ponto/{regraDePontoId}/configuracao/horas-extras openapi: 3.0.0 info: title: Pontua Public API description: >- API oficial da Pontua para integrações de clientes externos. Autentique com o token gerado no dashboard em **Configurações → API**. Envie o token no header `Authorization: Bearer `. version: '1.0' contact: {} servers: [] security: [] tags: [] paths: /regras-de-ponto/{regraDePontoId}/configuracao/horas-extras: patch: tags: - Regras de ponto summary: Atualiza as configurações de horas extras de uma regra de ponto operationId: RegrasDePontoController_AtualizarConfiguracaoHorasExtras parameters: - name: regraDePontoId required: true in: path description: ID da Regra schema: type: string requestBody: required: true description: Dados para atualização da configuração content: application/json: schema: $ref: '#/components/schemas/ConfigHorasExtrasDto' responses: '200': description: Regra atualizada content: application/json: schema: $ref: '#/components/schemas/RegraDePontoDto' examples: 'HE: Horas extras': value: regraDePontoId: 72a3e315-2987017ce62d nome: Regra de ponto HORA EXTRA codigo: 1 step: CONFIG_HORA_EXTRA tipoRegrasDePonto: HORAS_EXTRAS ativo: false colaboradores: 0 padraoSistema: false 'BH: Banco de horas': value: regraDePontoId: 72a3e315-2987017ce62d nome: Regra de ponto banco de horas codigo: 2 step: CONFIG_BANCO_HORAS tipoRegrasDePonto: BANCO_DE_HORAS ativo: false colaboradores: 0 padraoSistema: false 'Misto: Horas extras e banco de horas': value: regraDePontoId: 72a3e315-2987017ce62d nome: Regra de ponto Mista codigo: 3 step: CONFIG_MISTO tipoRegrasDePonto: MISTO ativo: false colaboradores: 0 padraoSistema: false HE como padrão do sistema: value: regraDePontoId: 72a3e315-2987017ce62d nome: Regra de ponto HE padrão codigo: 4 step: CONFIG_HORA_EXTRA tipoRegrasDePonto: HORAS_EXTRAS ativo: false colaboradores: 0 padraoSistema: true default: description: "\n\t\t\t400 - Bad Request: A solicitação não está no formato correto.\n\t\t\t401 - Unauthorized: A solicitação não foi autorizada. Verifique se o token de acesso é válido.\n\t\t\t403 - Forbidden: Acesso proibido! Requer um nível de permissão mais elevado.\n\t\t\t404 - Not Found: O recurso solicitado não foi encontrado.\n\t\t\t500 - Internal Server Error: Erro de execução no servidor!\n\t\t\t" content: application/json: schema: $ref: '#/components/schemas/ErrorDto' deprecated: false security: - bearer: [] components: schemas: ConfigHorasExtrasDto: type: object properties: diaFechamento: type: number description: Dia do fechamento do ponto example: 20 minimum: 1 maximum: 31 considerarFeriadoDiaTrabalho: type: boolean description: >- Ativando essa opção, hora extra realizada no intervalo irá ser calculado separadamente na apuração. example: false calcularSeparadoIntervalo: type: boolean description: Calcular separadamente horas extras no intervalo. example: true utilizarConfigPadrao: type: boolean description: Utilizar configurações Padrão de horas extras. example: false utilizarConfigPersonalizada: type: boolean description: >- Verifiquei minha convenção sindical e mesmo assim desejo alterar o padrão. example: false primeiraFase: type: number description: Valor da primeira fase de hora extra example: 0.5 segundaFase: type: number description: Valor da segunda fase de hora extra example: 1 minimum: 0 controlarMeiaFalta: type: boolean description: Irá controlar meia falta example: true percentualMeiaFalta: type: number description: Valor do percentual de meia falta example: 0.5 minimum: 0.01 maximum: 1 utilizarConfigAvancada: type: boolean description: Irá controlar as configurações avançadas example: true regraDePontoConfigAvancada: description: Array de configurações avançadas type: array items: $ref: '#/components/schemas/ConfiguracaoAvancadaDto' required: - diaFechamento - considerarFeriadoDiaTrabalho - calcularSeparadoIntervalo - utilizarConfigPadrao - utilizarConfigPersonalizada - controlarMeiaFalta - utilizarConfigAvancada - regraDePontoConfigAvancada RegraDePontoDto: type: object properties: regraDePontoId: type: string description: Id da Regra de ponto example: regraDePontoId-id nome: type: string description: Nome default da regra example: Regra de ponto 5 codigo: type: number description: Código de identificação da regra example: 5 tipoRegrasDePonto: type: string description: Tipo da regra de ponto enum: - HORAS_EXTRAS - BANCO_DE_HORAS - MISTO default: HORAS_EXTRAS step: type: string description: Proximo step de configuração enum: - CONFIG_HORA_EXTRA - CONFIG_BANCO_HORAS - CONFIG_MISTO - HORAS_NEGATIVAS - FLEXIBILIDADE_TOLERANCIA - ADICIONAL_NOTURNO - DSR - TOLERANCIA - IDENTIFICACAO - CONCLUIDO default: CONFIG_HORA_EXTRA ativo: type: boolean description: Retorna se regra está ativa example: false colaboradores: type: number description: Retorna quantidade de colaboradores example: 10 padraoSistema: type: boolean description: Retorna flag para registro criado por padrão no sistema example: false createdAt: format: date-time type: string description: Data de criação example: '2026-05-11T13:08:58.677Z' updatedAt: format: date-time type: string description: Data de update example: '2026-05-11T13:08:58.677Z' required: - regraDePontoId - nome - codigo - tipoRegrasDePonto - step - ativo - colaboradores - padraoSistema - createdAt - updatedAt ErrorDto: type: object properties: service: type: string description: Rota solicitada method: type: string description: Método http message: description: Mensagem do erro oneOf: - type: string example: message erro - type: array items: type: string example: - erro 1 - erro 2 required: - service - method - message ConfiguracaoAvancadaDto: type: object properties: periodoRegra: type: string description: Classificação do periodo da regra avançada enum: - TODOS_OS_DIAS - DIA_DE_TRABALHO - FERIADOS - SABADO_DOMINGO_E_FERIADOS - SEMANAL - SEGUNDA - TERCA - QUARTA - QUINTA - SEXTA - SABADO - DOMINGO - MENSAL - FOLGA - INTERVALO default: DIA_DE_TRABALHO percentualAvancado: description: Array de limites e percentuais example: - posicao: 0 percentual: 0.5 limite: '02:00' - posicao: 1 percentual: 0.75 type: array items: $ref: '#/components/schemas/PercentualAvancado' required: - periodoRegra - percentualAvancado PercentualAvancado: type: object properties: posicao: type: number description: Posição do percentual no array example: 0 percentual: type: number description: Valor do percentual de acréscimo de hora example: 0.5 limite: type: string description: Quantidade de horas do percentual no formato hh:mm example: '02:00' required: - posicao - percentual ````