> ## 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. # Busca as jornadas diárias esperadas de um colaborador por um determinado período de tempo ## OpenAPI ````yaml https://api.pre.pontua.tech/api/public/doc-json get /frequency/expected 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: /frequency/expected: get: tags: - Frequência summary: >- Busca as jornadas diárias esperadas de um colaborador por um determinado período de tempo operationId: FrequencyController_getExpectedJourney parameters: - name: initialDate required: true in: query description: Data da inicial (dd/MM/yyyy) schema: example: 01/05/2024 type: string - name: finalDate required: true in: query description: Data da final (dd/MM/yyyy) schema: example: 31/05/2024 type: string - name: collaboratorId required: true in: query description: ID do colaborador schema: example: 123-456abc type: string - name: forceRecalculate required: false in: query description: >- A operação irá realizar todos os cálculos novamente e atualizar as frequências salvas schema: example: false type: boolean responses: '200': description: Jornada esperada content: application/json: schema: $ref: '#/components/schemas/JornadaEsperadaDto' examples: Semana de turno fixo: value: dataInicial: 01/07/2024 dataFinal: 07/07/2024 colaboradorId: FULANO.17 turnoAtual: turnoId: 123-456abc tipoTurno: turnoFixo nome: Turno 1 codigo: 5 ativo: true createdAt: '2024-05-02T00:00:00.000Z' updatedAt: '2024-05-02T00:00:00.000Z' jornadasDiarias: - data: '2024-07-01T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: SEGUNDA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-02T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: TERCA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-03T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: QUARTA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-04T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: QUINTA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-05T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: SEXTA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-06T00:00:00.000Z' folga: true turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: DSR diaSemana: SABADO - data: '2024-07-07T00:00:00.000Z' folga: true turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: DSR diaSemana: DOMINGO Semana de turno flexível: value: dataInicial: 01/07/2024 dataFinal: 07/07/2024 colaboradorId: FULANO.17 turnoAtual: turnoId: 456-678def tipoTurno: turnoFlexivel nome: Turno 2 codigo: 6 ativo: true createdAt: '2024-05-02T00:00:00.000Z' updatedAt: '2024-05-02T00:00:00.000Z' jornadasDiarias: - data: '2024-07-01T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-02T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-03T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-04T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-05T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-06T00:00:00.000Z' folga: true turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO - data: '2024-07-07T00:00:00.000Z' folga: true turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO Semana de revezamento: value: dataInicial: 01/07/2024 dataFinal: 07/07/2024 colaboradorId: FULANO.17 turnoAtual: turnoId: 678-123ghi tipoTurno: turnoRevezamento nome: Turno 3 codigo: 7 ativo: true createdAt: '2024-05-02T00:00:00.000Z' updatedAt: '2024-05-02T00:00:00.000Z' jornadasDiarias: - data: '2024-07-01T00:00:00.000Z' folga: false turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: NORMAL mesConfig: 1 diaConfig: 1 entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-02T00:00:00.000Z' folga: false turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: NORMAL mesConfig: 1 diaConfig: 2 entrada: '9:00' saida: '17:00' intervaloFlexivel: true intervalos: - maximo: '1:30' - data: '2024-07-03T00:00:00.000Z' folga: true turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: DSR mesConfig: 1 diaConfig: 3 - data: '2024-07-04T00:00:00.000Z' folga: false turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: NORMAL mesConfig: 1 diaConfig: 1 entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-05T00:00:00.000Z' folga: false turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: NORMAL mesConfig: 1 diaConfig: 2 entrada: '9:00' saida: '17:00' intervaloFlexivel: true intervalos: - maximo: '1:30' - data: '2024-07-06T00:00:00.000Z' folga: true turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: DSR mesConfig: 1 diaConfig: 3 - data: '2024-07-07T00:00:00.000Z' folga: false turnoVigenteId: 678-123ghi tipoTurnoVigente: turnoRevezamento diaRevezamento: tipoDiaTrabalho: NORMAL mesConfig: 1 diaConfig: 1 entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' Semana de troca de ciclo na quinta-feira: value: dataInicial: 01/07/2024 dataFinal: 07/07/2024 colaboradorId: FULANO.17 turnoAtual: turnoId: 987-654jkl tipoTurno: turnoCiclo nome: Turno 4 codigo: 8 ativo: true createdAt: '2024-05-02T00:00:00.000Z' updatedAt: '2024-05-02T00:00:00.000Z' jornadasDiarias: - data: '2024-07-01T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: SEGUNDA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-02T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: TERCA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-03T00:00:00.000Z' folga: false turnoVigenteId: 123-456abc tipoTurnoVigente: turnoFixo diaTurnoFixo: tipoDiaTrabalho: NORMAL diaSemana: QUARTA entrada: '8:00' saida: '18:00' intervaloFlexivel: false intervalos: - inicio: '12:00' fim: '13:00' - data: '2024-07-04T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-05T00:00:00.000Z' folga: false turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO grupoFlexivelConfiguracao: tempoTrabalho: '8:00' trabalhaSegunda: true trabalhaTerca: true trabalhaQuarta: true trabalhaQuinta: true trabalhaSexta: true trabalhaSabado: false trabalhaDomingo: false intervalos: - maximo: '1:30' - data: '2024-07-06T00:00:00.000Z' folga: true turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO - data: '2024-07-07T00:00:00.000Z' folga: true turnoVigenteId: 456-678def tipoTurnoVigente: turnoFlexivel tipoTurnoFlexivel: DIARIO 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: JornadaEsperadaDto: type: object properties: dataInicial: type: string description: Data inicial (dd/MM/yyyy) da jornada esperada example: 01/01/2022 dataFinal: type: string description: Data final (dd/MM/yyyy) da jornada esperada example: 31/12/2022 colaboradorId: type: string description: ID do colaborador example: 123-456abc turnoAtual: description: Dados sobre o turno atual do colaborador allOf: - $ref: '#/components/schemas/TurnoDto' jornadasDiarias: description: Dados sobre a jornada esperada em cada dia type: array items: $ref: '#/components/schemas/JornadaDiariaEsperadaDto' required: - dataInicial - dataFinal - colaboradorId - turnoAtual - jornadasDiarias 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 TurnoDto: type: object properties: turnoId: type: string description: ID do turno example: 123-456abc nome: type: string description: Nome do turno example: Turno diurno tipoTurno: type: string description: Tipo do turno enum: - turnoFixo - turnoFlexivel - turnoRevezamento - turnoCiclo default: turnoFixo codigo: type: number description: Código numérico de identificação único do turno example: 57 ativo: type: boolean description: Indica se o turno está ativo ou não default: true createdAt: format: date-time type: string description: Data de criação updatedAt: format: date-time type: string description: Data de atualização required: - turnoId - nome - tipoTurno - codigo - ativo - createdAt - updatedAt JornadaDiariaEsperadaDto: type: object properties: data: type: string description: Data da jornada example: '2023-07-23T00:00:00.000Z' folga: type: boolean description: >- Indica se é um dia de folga para o colaborador, devido às suas configurações de turno, regra de ponto, feriado, férias ou afastamento default: false turnoVigenteId: type: string description: ID do turno vigente nesta dada, considerando ciclos e histórico example: 123-456abc tipoTurnoVigente: type: string description: Tipo do turno vigente enum: - turnoFixo - turnoFlexivel - turnoRevezamento default: turnoFixo tipoTurnoFlexivel: type: string description: Tipo de flexibilidade do turno vigente enum: - DIARIO - SEMANAL - MENSAL - LIVRE default: DIARIO diaTurnoFixo: description: >- Dados sobre o turno fixo (se existir) referente à jornada de trabalho do dia allOf: - $ref: '#/components/schemas/DiaTurnoFixoDto' diaRevezamento: description: >- Dados sobre o turno de revezamento (se existir) referente à jornada de trabalho do dia allOf: - $ref: '#/components/schemas/DiaRevezamentoDto' grupoFlexivelConfiguracao: description: >- Dados sobre o turno flexível (se existir) referente à jornada de trabalho do grupo de dias correspondente allOf: - $ref: '#/components/schemas/GrupoFlexivelConfiguracaoDto' required: - data - folga - turnoVigenteId - tipoTurnoVigente DiaTurnoFixoDto: type: object properties: tipoDiaTrabalho: type: string description: Tipo do dia de trabalho da jornada default: NORMAL enum: - NORMAL - COMPENSADO - DSR - FOLGA diaSemana: type: string description: Dia da semana da jornada default: SEGUNDA enum: - DOMINGO - SEGUNDA - TERCA - QUARTA - QUINTA - SEXTA - SABADO entrada: type: string description: Horário de início esperado da jornada example: '8:00' saida: type: string description: Horário do fim esperado da jornada example: '18:00' intervaloFlexivel: type: boolean description: Possui intervalo flexível example: true intervalos: description: Horários de intervalo type: array items: $ref: '#/components/schemas/IntervaloDto' required: - tipoDiaTrabalho - diaSemana DiaRevezamentoDto: type: object properties: tipoDiaTrabalho: type: string description: Tipo do dia de trabalho da jornada default: NORMAL enum: - NORMAL - COMPENSADO - DSR - FOLGA mesConfig: type: number description: Ordem do mês example: 1 diaConfig: type: number description: Ordem do dia example: 1 entrada: type: string description: Horário de início esperado da jornada example: '8:00' saida: type: string description: Horário do fim esperado da jornada example: '18:00' intervaloFlexivel: type: boolean description: Possui intervalo flexível example: true intervalos: description: Horários de intervalo type: array items: $ref: '#/components/schemas/IntervaloDto' required: - tipoDiaTrabalho - mesConfig - diaConfig GrupoFlexivelConfiguracaoDto: type: object properties: tempoTrabalho: type: string description: Tempo total de trabalho esperado para o grupo flexível example: '8:00' viraNoite: type: string description: Horário de virada da data da jornada example: '1:00' trabalhaSegunda: type: boolean description: As segundas-feiras fazem parte desse grupo example: true trabalhaTerca: type: boolean description: As terças-feiras fazem parte desse grupo example: true trabalhaQuarta: type: boolean description: As quartas-feiras fazem parte desse grupo example: true trabalhaQuinta: type: boolean description: As quintas-feiras fazem parte desse grupo example: true trabalhaSexta: type: boolean description: As sextas-feiras fazem parte desse grupo example: true trabalhaSabado: type: boolean description: Os sábados fazem parte desse grupo example: false trabalhaDomingo: type: boolean description: Os domingos fazem parte desse grupo example: false intervalos: description: Horários de intervalo type: array items: $ref: '#/components/schemas/IntervaloDto' required: - tempoTrabalho - trabalhaSegunda - trabalhaTerca - trabalhaQuarta - trabalhaQuinta - trabalhaSexta - trabalhaSabado - trabalhaDomingo IntervaloDto: type: object properties: inicio: type: string description: Horário de início do intervalo, para intervalo não flexível example: '8:00' fim: type: string description: Horário do fim do intervalo, para intervalo não flexível example: '18:00' minimo: type: string description: Tempo mínimo de intervalo, para intervalo flexível example: '0:30' maximo: type: string description: Tempo máximo de intervalo, para intervalo flexível example: '1:30' ````