> ## 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. # Mostra informações de frequência da equipe do gestor ## OpenAPI ````yaml https://api.pre.pontua.tech/api/public/doc-json get /frequency/management 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/management: get: tags: - Frequência summary: Mostra informações de frequência da equipe do gestor operationId: FrequencyController_getTeamFrequencyData parameters: - name: searchText description: Texto pesquisado para filtrar consulta required: false in: query schema: type: string - name: pagina description: Página que deseja retornar os resultados required: false in: query schema: example: 0 type: number - name: limite description: Quantidade de itens que retorna na consulta. Min 1 - Max 100 required: false in: query schema: example: 100 type: number - 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 - description: ID da unidade de negócio required: false name: businessUnitId in: query 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: Informações de frequência da equipe content: application/json: schema: $ref: '#/components/schemas/TeamFrequencyDataDto' 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: [] - cookie: [] components: schemas: TeamFrequencyDataDto: type: object properties: page: type: number description: Número da página retornada example: 0 limit: type: number description: Número de registros por pagina example: 10 total: type: number description: Quantidade total de colaboradores example: 237 initialDate: type: string description: Data inicial (dd/MM/yyyy) para a pontualidade e saldos example: 01/05/2024 finalDate: type: string description: Data final (dd/MM/yyyy) para a pontualidade e saldos example: 31/05/2024 dadosColaboradores: description: Dados dos colaboradores type: array items: $ref: '#/components/schemas/DadosColaboradorDashboardDto' required: - total - initialDate - finalDate - dadosColaboradores 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 DadosColaboradorDashboardDto: type: object properties: colaborador: description: Dados do colaborador allOf: - $ref: '#/components/schemas/ColaboradorDto' pontualidade: type: string description: Porcentagem da carga horária cumprida example: 100% saldo: type: string description: >- Total do saldo comparativo entre os horários de entrada e saída reais e os esperados, positivo ou negativo example: '+7:23' required: - colaborador - saldo ColaboradorDto: type: object properties: colaboradorId: type: string description: ID referente ao Colaborador example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 nomeCompleto: type: string description: Nome completo do colaborador example: Douglas Fernandez Coelho nomeOuRazaoSocial: type: string description: Nome ou razão social example: Douglas Vitor tipoColaborador: type: string description: Identificação se será um Colaborador CLT ou Prestador de Serviço enum: - PRESTADOR_SERVICO - CLT - EXTERNO - API default: CLT tipoIdentificacao: type: string description: Identificação se o documento é um CPF ou CNPJ enum: - CNPJ - CPF default: CPF numeroDocumento: type: string description: CPF ou CNPJ example: 152.175.100-56 situacao: type: string description: Situação do empregado enum: - ATIVO - INATIVO - RASCUNHO default: ATIVO estadoCivil: type: string description: Estado civil default: SOLTEIRO enum: - SOLTEIRO - CASADO - SEPARADO - DIVORCIADO - VIUVO genero: type: string description: Gênero default: MASCULINO enum: - MASCULINO - FEMININO - OUTRO dataNascimento: format: date-time type: string description: Data de nascimento example: '2026-05-11T13:08:56.420Z' nomeFantasia: type: string description: Nome fantasia example: STW Tecnologia inscricaoEstadual: type: string description: Inscrição estadual example: '123456789' isentoInscricaoEstadual: type: boolean description: Inscrição estadual está isenta? default: false inscricaoMunicipal: type: string description: Inscrição municipal example: '987654321' isentoInscricaoMunicipal: type: boolean description: Inscrição municipal está isenta? default: false numeroPrevidenciario: type: string description: Número do tipo de vínculo previdenciário do empregado example: N586692225 matriculaEsocial: type: string description: Matrícula do eSocial example: xxxxxxxxx matriculaInterna: type: string description: Matrícula interna da empresa example: '49172594718' email: type: string description: Email do empregado example: douglas@pontua.com.br telefoneCelular: type: string description: Número do telefone celular do empregado example: '62993610391' endereco: description: Endereço da unidade de negócio allOf: - $ref: '#/components/schemas/EnderecoDto' tipoVinculo: type: string description: Tipo de vínculo default: CLT enum: - CLT - APRENDIZ - ESTAGIO - AUTONOMO - INTERMITENTE - OUTROS adicionalInsalubridade: type: boolean description: Se o empregado terá adicional de Insalubridade example: false valorInsalubridade: type: string description: Selecionar o grau de Insalubridade default: GRAU_MEDIO_20 enum: - GRAU_MINIMO_10 - GRAU_MEDIO_20 - GRAU_MAXIMO_40 adicionalPericulosidade: type: boolean description: Se o empregado terá adicional de Insalubridade example: false cargo: description: Cargo referente ao colaborador allOf: - $ref: '#/components/schemas/Cargo' departamento: description: Departamento referente ao colaborador allOf: - $ref: '#/components/schemas/Departamento' equipe: description: Equipe referente ao colaborador allOf: - $ref: '#/components/schemas/Equipe' remuneracao: type: number description: Salário do empregado example: 7400 tipoRemuneracao: type: string description: Tipo de remuneraçã do empregado enum: - SALARIO_FIXO - POR_HORA - DIARIAS - PRESTACAO_SERVICO default: SALARIO_FIXO fusoHorario: type: string description: Fuso horário default: SAO_PAULO enum: - MANAUS - NORONHA - RIO_BRANCO - SAO_PAULO localTrabalho: description: Local de Trabalho do colaborador allOf: - $ref: '#/components/schemas/LocalTrabalho' centroCusto: description: Centro de custo do colaborador allOf: - $ref: '#/components/schemas/CentroCusto' dataAdmissao: format: date-time type: string description: Data de admissão do colaborador example: null dataInicio: format: date-time type: string description: Data de inicio do colaborador example: null dataDemissao: format: date-time type: string description: Data de demissão do colaborador example: null calendarioId: type: string description: >- ID referente ao calendário de trabalho da empresa, onde colocorá o colaborador example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 turno: description: Turno do empregado allOf: - $ref: '#/components/schemas/Turno' foto: type: string description: Url para download da foto example: https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg usarConfigPadrao: type: boolean description: Status sobre o uso das configurações padrões estabelecidas example: true liberarAcesso: type: boolean description: Liberar acesso ao sistema ao colaborador example: true enviarAcessoEmail: type: boolean description: Enviar acesso ao sistema por EMAIL ao colaborador example: true enviarAcessoSms: type: boolean description: Enviar acesso ao sistema por SMS ao colaborador example: true solicitarCadastroFacial: type: boolean description: Solicitar Cadastro da Facial ao colaborador example: true nivelAcesso: type: string description: "Nível\tde acesso às permissões do sistema, dado ao usuário" default: USER enum: - ADMIN - GESTOR - USER biometriaAtiva: type: boolean description: Biometria example: true step: type: string description: Path da próxima pagina enum: - DADOS - COMPLEMENTO - ALOCACAO - PREFERENCIA - DEFINICOES - ACESSO - CONCLUIDO default: COMPLEMENTO batidaPonto: description: Batida de ponto do colaborador allOf: - $ref: '#/components/schemas/BatidaPontoDto' unidadeNegocio: description: Unidade de negocio do colaborador allOf: - $ref: '#/components/schemas/UnidadeNegocioDto' regraDePonto: description: Regra de ponto do colaborador allOf: - $ref: '#/components/schemas/RegraDePontoDto' facialId: description: Dados do cadastro de reconhecimento facial allOf: - $ref: '#/components/schemas/FacialId' createdAt: format: date-time type: string description: Data de criação example: '2026-05-11T13:08:56.421Z' updatedAt: format: date-time type: string description: Data de update example: '2026-05-11T13:08:56.421Z' intercom_user_jwt: type: string description: Token JWT do usuário para autenticação no Intercom example: abc123xyz required: - colaboradorId - tipoColaborador - tipoIdentificacao - numeroDocumento - situacao - email - telefoneCelular - endereco - cargo - departamento - equipe - localTrabalho - centroCusto - dataAdmissao - dataInicio - calendarioId - turno - usarConfigPadrao - liberarAcesso - enviarAcessoEmail - enviarAcessoSms - solicitarCadastroFacial - nivelAcesso - biometriaAtiva - step - batidaPonto - unidadeNegocio - regraDePonto - createdAt - updatedAt EnderecoDto: type: object properties: codigoPostal: type: string description: Número do código postal (CEP) example: 74840-060 estado: type: string description: Sigla do Estado example: GO cidade: type: string description: Nome da cidade example: Goiânia bairro: type: string description: Nome do bairro example: Parque Amazonia rua: type: string description: Nome da rua example: Av. Arumã complemento: type: string description: Complemento do endereço example: Qd. 176 Lt. 09 numero: type: string description: Número do endereço example: '382' required: - codigoPostal - estado - cidade - bairro - rua Cargo: type: object properties: cargoId: type: string description: ID referente ao cargo example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 nome: type: string description: Nome do Cargo example: Analista de Marketing required: - cargoId - nome Departamento: type: object properties: departamentoId: type: string description: ID referente ao departamento example: c9f447fe-f97f-4f24-974d-9f92eb3049dc nome: type: string description: Nome do departamento example: Desenvolvimento required: - departamentoId - nome Equipe: type: object properties: equipeId: type: string description: ID referente à equipe example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 nome: type: string description: Nome da equipe example: Squad Plataforma required: - equipeId - nome LocalTrabalho: type: object properties: localTrabalhoId: type: string description: ID referente ao local de trabalho example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 nome: type: string description: Nome do local de trabalho example: Sede Goiânia required: - localTrabalhoId - nome CentroCusto: type: object properties: centroCustoId: type: string description: ID referente ao centro de custo example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 nome: type: string description: Nome do centro de custo example: Tecnologia / R&D required: - centroCustoId - nome Turno: type: object properties: turnoId: type: string description: ID referente ao turno, onde colocorá o colaborador example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 tipoTurno: type: string description: Tipo do turno enum: - turnoFixo - turnoFlexivel - turnoRevezamento - turnoCiclo default: turnoFixo nome: type: string description: Nome do turno example: Horário comercial createdAt: format: date-time type: string description: Data de criação example: '2026-05-11T13:08:52.937Z' updatedAt: format: date-time type: string description: Data do ultimo update example: '2026-05-11T13:08:52.937Z' required: - turnoId - tipoTurno - nome - createdAt - updatedAt BatidaPontoDto: type: object properties: batidaPontoId: type: string description: ID da batida de ponto example: 123-456abc status: type: string description: Status da batida de ponto default: RASCUNHO enum: - ATIVO - INATIVO - RASCUNHO step: type: string description: Path da próxima pagina enum: - INDIVIDUAL - COLETIVO - REGRAS_GERAIS - CONCLUIDO default: INDIVIDUAL ambientesSelecionados: type: array description: Ambientes selecionados da batida example: - ambiente-individual items: type: string enum: - INDIVIDUAL - COLETIVO habilitarRegistroAppIndividual: type: boolean description: Habilitar registro no app individual example: true geolocalizacaoIndividual: type: boolean description: Habilitar geolocalização de registro de ponto example: true controleDispositivo: type: boolean description: Habilitar controle de dispositivo example: true sessaoUnica: type: boolean description: Permitir sessões únicas example: true raioPadrao: type: boolean description: >- Considerar o raio definido no local de trabalho para sugestão do registro example: true fusoHorarioPadrao: type: boolean description: >- Considerar fuso horário definido no cadastro para o registro de ponto example: true localTrabalhoPadrao: type: boolean description: Considerar o local de trabalho definido no cadastro do colaborador example: true modoOffline: type: boolean description: Permitir registro de ponto em modo offline example: true habilitarPortalOnlineIndividual: type: boolean description: Habilitar registro no portal online example: true cadastroIP: type: boolean description: Permitir batida de ponto somente em endereço de IP cadastrado example: true localNavegador: type: boolean description: Obter localização do navegador example: true valorRegistroPrincipal: type: string description: Tipo de registro de ponto principal default: FOTO enum: - RECONHECIMENTO_FACIAL - INDIVIDUAL - FOTO - SIMPLES valorOffline: type: string description: Tipo de registro de ponto offline default: FOTO enum: - FOTO - INDIVIDUAL - SIMPLES - NAO_PERMITIR valorPortalOnline: type: string description: Tipo de registro de ponto online default: FOTO enum: - FOTO - RECONHECIMENTO_FACIAL - PIN - REGISTRO_INDIVIDUAL_PORTAL habilitarRegistroAppColetivo: type: boolean description: Habilitar registro no app coletivo example: true geolocalizacaoColetivo: type: boolean description: Habilitar geolocalização de registro de ponto example: true habilitarRegistroPortalColetivo: type: boolean description: Habilitar registro coletivo no portal online example: true descricao: type: string description: Descrição das regras gerais example: Regras gerais da batida de ponto permitirAfastamento: type: boolean description: Permitir que o colaborador lance o afastamento example: true permitirAjusteHorario: type: boolean description: Permitir o ajuste de horário example: true preenchimentoAutomaticoAjusteHorario: type: boolean description: Permitir o preenchimento automático no ajuste de horário example: true permitirJustificativaPontoRetroativo: type: boolean description: Permitir justificativa de ponto retroativo example: true aceiteColaborador: type: boolean description: Habilitar aceite do colaborador example: true anexosObrigatorios: type: boolean description: Tornar anexos obrigatórios em todas as solicitações example: true visualizarSaldoBancoDeHoras: type: boolean description: Habilitar visualização do saldo de hora extra e banco de horas example: true folhaDePonto: type: boolean description: >- Permitir que os colaboradores visualizem o Relatório de Folha de Ponto example: true visualizarRelatorioBancoDeHoras: type: boolean description: >- Permitir que os colaboradores visualizem o Relatório de Banco de Horas example: true solicitarFotoReconhecimentoFacial: type: boolean description: Solicitar do colaborador a foto para reconhecimento facial example: true aprovacaoAutomatica: type: boolean description: Habilitar aprovação automática example: true diasRetroativosPermitidos: type: number description: Quantidade de dias retroativos permitidos example: 1 valorAceiteColaborador: type: string description: Tipo de aceite do colaborador default: ASSINATURA_ELETRONICA enum: - ASSINATURA_ELETRONICA - CONFIRMACAO_ABERTURA enderecosIP: description: Endereços IP type: array items: $ref: '#/components/schemas/EnderecoIPDto' localizacoes: description: Localizações type: array items: $ref: '#/components/schemas/LocalizacaoDto' createdAt: format: date-time type: string description: Data de criação example: '2026-05-11T13:08:54.946Z' updatedAt: format: date-time type: string description: Data de atualização example: '2026-05-11T13:08:54.946Z' required: - batidaPontoId - status - step - ambientesSelecionados - habilitarRegistroAppIndividual - geolocalizacaoIndividual - controleDispositivo - sessaoUnica - raioPadrao - fusoHorarioPadrao - localTrabalhoPadrao - modoOffline - habilitarPortalOnlineIndividual - cadastroIP - localNavegador - valorRegistroPrincipal - valorOffline - valorPortalOnline - habilitarRegistroAppColetivo - geolocalizacaoColetivo - habilitarRegistroPortalColetivo - descricao - permitirAfastamento - permitirAjusteHorario - preenchimentoAutomaticoAjusteHorario - permitirJustificativaPontoRetroativo - aceiteColaborador - anexosObrigatorios - visualizarSaldoBancoDeHoras - folhaDePonto - visualizarRelatorioBancoDeHoras - solicitarFotoReconhecimentoFacial - aprovacaoAutomatica - diasRetroativosPermitidos - valorAceiteColaborador - enderecosIP - localizacoes - createdAt - updatedAt UnidadeNegocioDto: type: object properties: unidadeNegocioId: type: string description: ID da unidade de negócio example: '1234567890' nome: type: string description: Nome da unidade de negócio example: Transportadora Brasil Ltda step: type: string description: Step de configuração enum: - DADOS - CONTATO - PERSONALIZACAO - CONCLUIDO default: DADOS status: type: string description: Status da unidade de negócio default: RASCUNHO enum: - ATIVO - INATIVO - RASCUNHO tipoIdentificacao: type: string description: Tipo de identificação default: CNPJ enum: - CNPJ - CPF numeroCadastro: type: string description: CPF ou CNPJ example: 36.937.877/0001-08 email: type: string description: Email da unidade de negócio example: unidade.go@tbrasil.com.br emailNotificacao: type: string description: Email de notificações da unidade de negócio example: unidade.go@tbrasil.com.br endereco: type: string description: Endereço da unidade de negócio logo: type: string description: Caminho da logo da unidade de negócio example: //logo.png createdAt: format: date-time type: string description: Data de criação example: '2026-05-11T13:08:52.937Z' updatedAt: format: date-time type: string description: Data do ultimo update example: '2026-05-11T13:08:52.937Z' required: - unidadeNegocioId - nome - step - status - tipoIdentificacao - numeroCadastro - email - emailNotificacao - endereco - createdAt - updatedAt 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 FacialId: type: object properties: id: type: string description: ID referente do cadastro da FacialId no nosso banco example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6 codigoFacial: type: string description: Código referente ao rosto da pessoa na FacialId example: FULANO.10 situacao: type: string description: Stituação de cadastro na FacialId example: Ativo dataExpiracao: format: date-time type: string description: Data de expiração das fotos enviadas para o cadastro example: '2025-07-23T00:00:00.000Z' EnderecoIPDto: type: object properties: enderecoIPId: type: string description: Identificador do endereço de IP example: 123-456abc descricao: type: string description: Descrição do endereço de IP example: IP da Rede Algar IPRedeExterna: type: string description: IP da rede externa example: 179.175.108.115 required: - descricao - IPRedeExterna LocalizacaoDto: type: object properties: localizacaoId: type: string description: Identificador da localização example: 123-456abc endereco: type: string description: Endereço da localização example: Av. Arumã, 382 - Parque Amazônia, Goiânia, Goiás, Brasil - 74840-170 nome: type: string description: Nome da localização example: Tron Matriz raioMetros: type: number description: O raio da localização em metros example: 1 latitude: type: number description: A latitude da localização example: -16.66238706 longitude: type: number description: A longitude da localização example: -49.37023003 required: - endereco - nome - raioMetros - latitude - longitude ````