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

# Coleta todas as informações de uma regra de ponto etapa de configuração de horas extras



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json get /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 <SEU_TOKEN>`.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /regras-de-ponto/{regraDePontoId}/configuracao/horas-extras:
    get:
      tags:
        - Regras de ponto
      summary: >-
        Coleta todas as informações de uma regra de ponto etapa de configuração
        de horas extras
      operationId: RegrasDePontoController_ColetaConfiguracaoHorasExtras
      parameters:
        - name: regraDePontoId
          required: true
          in: path
          description: ID da Regra
          schema:
            type: string
      responses:
        '200':
          description: Configuração de horas extras
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConfigHorasExtrasDto'
        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:
    GetConfigHorasExtrasDto:
      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'
        regraDePontoId:
          type: string
          description: Id da Regra de ponto
          example: regraDePontoId-id
        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
      required:
        - diaFechamento
        - considerarFeriadoDiaTrabalho
        - calcularSeparadoIntervalo
        - utilizarConfigPadrao
        - utilizarConfigPersonalizada
        - controlarMeiaFalta
        - utilizarConfigAvancada
        - regraDePontoConfigAvancada
        - regraDePontoId
        - tipoRegrasDePonto
        - step
    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

````