> ## 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 saldos de colaboradores para preparar uma movimentação em um ciclo de banco de horas ## OpenAPI ````yaml https://api.pre.pontua.tech/api/public/doc-json get /banco-horas/movimentacoes/preparar 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: /banco-horas/movimentacoes/preparar: get: tags: - Banco de Horas summary: >- Busca saldos de colaboradores para preparar uma movimentação em um ciclo de banco de horas operationId: BancoHorasController_PrepararMovimentacao parameters: - name: tipoMovimentacao required: true in: query description: Tipo de movimentação do banco de horas schema: default: QUITACAO_INTEGRAL enum: - QUITACAO_INTEGRAL - QUITACAO_COM_LIMITE - QUITACAO_INDIVIDUAL - TRANSFERIR_SALDO - LANCAR_SALDO type: string - name: cicloBancoHorasId required: true in: query description: ID do ciclo do banco de horas schema: example: 123-456abc type: string - name: ocultarColaboradoresSaldoZerado required: false in: query description: Ocultar colaboradores com saldo zerado schema: example: false type: boolean - name: regrasAvancadas required: false in: query description: Mostrar regras avançadas da distribuição para folha de pagamento schema: example: false type: boolean - name: fechamentoCiclo required: false in: query description: A movimentação deverá fechar o ciclo schema: example: false type: boolean - name: limitePositivoMinutos required: false in: query description: Saldo positivo para manter na quitação schema: example: 120 type: number - name: limiteNegativoMinutos required: false in: query description: Saldo negativo para manter na quitação schema: example: -120 type: number - name: sinalSegmentacao required: false in: query description: Sinal de segmentação para filtrar schema: default: POSITIVO enum: - POSITIVO - NEGATIVO type: string - name: comparadorSegmentacao required: false in: query description: Comparador de segmentação para filtrar schema: default: MAIOR enum: - MAIOR - MENOR - IGUAL type: string - name: valorSaldoAtivoSegmentacao required: false in: query description: Valor do saldo ativo, em horas, de segmentação para filtrar schema: example: 100 type: number - name: colaboradorIds required: false in: query description: IDs de colaboradores específicos, separados por vírgula schema: example: 123-456abc,987-654321 type: string - name: unidadeNegocioId required: false in: query description: ID da unidade de negócio, para filtrar colaboradores schema: example: 123-456abc type: string responses: '200': description: Dados para gerenciamento do banco de horas content: application/json: schema: $ref: '#/components/schemas/GerenciarBancoHorasRespostaDto' 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: GerenciarBancoHorasRespostaDto: type: object properties: tipoMovimentacao: type: string description: Tipo de movimentação do banco de horas default: QUITACAO_INTEGRAL enum: - QUITACAO_INTEGRAL - QUITACAO_COM_LIMITE - QUITACAO_INDIVIDUAL - TRANSFERIR_SALDO - LANCAR_SALDO cicloBancoHorasId: type: string description: ID do ciclo do banco de horas example: 123-456abc ocultarColaboradoresSaldoZerado: type: boolean description: Ocultar colaboradores com saldo zerado example: false regrasAvancadas: type: boolean description: Mostrar regras avançadas da distribuição para folha de pagamento example: false fechamentoCiclo: type: boolean description: A movimentação deverá fechar o ciclo example: false limitePositivoMinutos: type: number description: Saldo positivo para manter na quitação example: 120 limiteNegativoMinutos: type: number description: Saldo negativo para manter na quitação example: -120 sinalSegmentacao: type: string description: Sinal de segmentação para filtrar enum: - POSITIVO - NEGATIVO default: POSITIVO comparadorSegmentacao: type: string description: Comparador de segmentação para filtrar enum: - MAIOR - MENOR - IGUAL default: MAIOR valorSaldoAtivoSegmentacao: type: number description: Valor do saldo ativo, em horas, de segmentação para filtrar example: 100 colaboradorIds: type: string description: IDs de colaboradores específicos, separados por vírgula example: 123-456abc,987-654321 unidadeNegocioId: type: string description: ID da unidade de negócio, para filtrar colaboradores example: 123-456abc ciclo: description: Ciclo do banco de horas allOf: - $ref: '#/components/schemas/CicloBancoHorasDto' colaboradores: description: Colaboradores do ciclo do banco de horas type: array items: $ref: '#/components/schemas/CicloBancoHorasColaboradorDto' required: - tipoMovimentacao - cicloBancoHorasId - ciclo - colaboradores 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 CicloBancoHorasDto: type: object properties: cicloBancoHorasId: type: string description: ID do ciclo do banco de horas example: 123-456abc dataInicio: format: date-time type: string description: Data de início do ciclo do banco de horas example: '2022-01-01T00:00:00.000Z' dataFim: format: date-time type: string description: Data do fim do ciclo do banco de horas example: '2022-01-31T00:00:00.000Z' fechado: type: boolean description: Indica se o ciclo do banco de horas está fechado example: false regraDePontoId: type: string description: ID da regra de ponto do ciclo do banco de horas example: 123-456abc regraDePonto: type: string description: Nome da regra de ponto do ciclo do banco de horas example: BH Padrão required: - cicloBancoHorasId - dataInicio - dataFim - fechado - regraDePontoId - regraDePonto CicloBancoHorasColaboradorDto: type: object properties: cicloId: type: string description: ID do ciclo do banco de horas example: 123-456abc colaboradorId: type: string description: ID do colaborador example: 123-456abc colaborador: type: string description: Nome do colaborador example: João Silva numeroDocumento: type: string description: CPF ou CNPJ do colaborador example: '15217510056' unidadeNegocio: type: string description: Nome da unidade de negócio do ciclo do banco de horas example: Pontua dataInicial: format: date-time type: string description: Data inicial do ciclo do banco de horas example: '2024-01-01T00:00:00.000Z' dataFinal: format: date-time type: string description: Data final do ciclo do banco de horas example: '2024-01-31T00:00:00.000Z' saldoInicial: type: string description: Saldo inicial do colaborador no ciclo do banco de horas example: '+0:37' creditos: type: string description: >- Somatório dos saldos positivos do colaborador no ciclo do banco de horas example: '+5:00' debitos: type: string description: >- Somatório dos saldos negativos do colaborador no ciclo do banco de horas example: '-3:00' saldoFinal: type: string description: >- Somatório total do saldo inicial, créditos e débitos do colaborador no ciclo do banco de horas example: '+2:37' saldoOperacao: type: string description: Saldo da operação, positivo ou negativo, a ser debitado ou creditado example: '-2:37' saldoDepoisOperacao: type: string description: Saldo do colaborador no ciclo de banco de horas depois da operação example: '0:00' transferirParaCiclo: description: >- Ciclo para o qual o saldo será transferido, para o caso de transferência de saldo allOf: - $ref: '#/components/schemas/CicloBancoHorasDto' required: - saldoInicial - creditos - debitos - saldoFinal ````