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

# Cancela um fechamento



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json patch /fechamentos/cancelar/{fechamentoId}
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:
  /fechamentos/cancelar/{fechamentoId}:
    patch:
      tags:
        - Fechamento
      summary: Cancela um fechamento
      operationId: FechamentoController_CancelarFechamento
      parameters:
        - name: fechamentoId
          required: true
          in: path
          description: Id do fechamento
          schema:
            example: a2f2cbed-e141-465c-a769-f1591be5f35c
            type: string
      responses:
        '200':
          description: Fechamento cancelado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FechamentoDto'
        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:
    FechamentoDto:
      type: object
      properties:
        fechamentoId:
          type: string
          description: ID do fechamento
          example: '123456789'
        codigo:
          type: number
          description: Código do fechamento
          example: 123
        tipo:
          type: string
          description: Tipo do fechamento
          enum:
            - INTEGRAL
            - PARCIAL
          default: PARCIAL
        status:
          type: string
          description: Status do fechamento
          enum:
            - RASCUNHO
            - EM_ANDAMENTO
            - CONCLUIDO
            - CANCELADO
          default: EM_ANDAMENTO
        dataInicio:
          format: date-time
          type: string
          description: Data de início do fechamento
          example: '2024-05-01T00:00:00.000Z'
        dataFim:
          format: date-time
          type: string
          description: Data de fim do fechamento
          example: '2024-05-31T00:00:00.000Z'
        gerarFolhaDePonto:
          type: boolean
          description: Gerar folha de ponto
          default: false
        enviarFolhaDePonto:
          type: boolean
          description: Enviar folha de ponto
          default: false
        tipoRegraDePonto:
          type: string
          description: Tipo de regra de ponto
          enum:
            - HORAS_EXTRAS
            - BANCO_DE_HORAS
            - MISTO
          default: BANCO_DE_HORAS
        unidadeNegocio:
          type: string
          description: Unidade de negócio do fechamento
          example: Pontua
        cadastroUnidadeNegocio:
          type: string
          description: Número de cadastro da unidade de negócio
          example: '94522114000145'
        colaboradores:
          description: Colaboradores no fechamento
          type: array
          items:
            $ref: '#/components/schemas/FechamentoColaboradorDto'
        numeroColaboradores:
          type: number
          description: >-
            Número total de colaboradores do fechamento (pode ser usado para
            paginação)
          example: 237
        paginaColaboradores:
          type: number
          description: Página para paginação de colaboradores do fechamento
          example: 0
        limiteColaboradores:
          type: number
          description: Limite para paginação de colaboradores do fechamento
          example: 10
        responsavel:
          type: string
          description: Nome do responsável pelo fechamento
          example: João Silva
        cicloBancoHoras:
          description: Ciclo de banco de horas do fechamento
          allOf:
            - $ref: '#/components/schemas/CicloBancoHorasDto'
        departamento:
          type: string
          description: Nome do departamento dos colaboradores do fechamento
          example: Técnico
        equipe:
          type: string
          description: Nome da equipe dos colaboradores do fechamento
          example: Desenvolvedores
        turno:
          type: string
          description: Nome do turno dos colaboradores do fechamento
          example: Manhã
        tipoTurno:
          type: string
          description: Tipo do turno dos colaboradores do fechamento
          enum:
            - turnoFixo
            - turnoFlexivel
            - turnoRevezamento
            - turnoCiclo
          default: turnoFixo
      required:
        - fechamentoId
        - codigo
        - tipo
        - status
        - dataInicio
        - dataFim
        - tipoRegraDePonto
        - colaboradores
        - numeroColaboradores
        - responsavel
    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
    FechamentoColaboradorDto:
      type: object
      properties:
        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'
        cargaHoraria:
          type: string
          description: Carga horária esperada do turno
          example: '8:48'
        horasTrabalhadas:
          type: string
          description: Horas trabalhadas no período
          example: '8:00'
        creditos:
          type: string
          description: Somatório de horas do período com saldo positivo
          example: '2:37'
        debitos:
          type: string
          description: Somatório de horas do período com saldo negativo
          example: '7:23'
        saldo:
          type: string
          description: >-
            Saldo comparativo entre a carga horária esperada e as horas
            trabalhadas, positivo ou negativo
          example: '-4:46'
        adicionalNoturno:
          type: string
          description: Horas trabalhadas em período de adicional noturno
          example: '4:00'
        bancoHorasPeriodo:
          type: string
          description: Horas de banco de horas no período
          example: '+0:48'
        bancoHorasTotal:
          type: string
          description: >-
            Horas de banco de horas mais saldos iniciais e de movimentação do
            ciclo de banco de horas durante o período
          example: '+0:48'
        faltas:
          type: number
          description: Número de faltas no período
          example: 2.5
        faltasHoras:
          type: string
          description: >-
            Total de faltas em horas no período, a ser mostrada caso a regra de
            ponto estiver configurada para tal
          example: '7:23'
        pendencia:
          type: boolean
          description: Indica se o colaborador possui alguma pendência no período
          example: false
        possuiFechamentoDuplicado:
          type: boolean
          description: >-
            Indica se o colaborador possui outro fechamento em aberto com o
            mesmo período
          example: false
        saldosPercentuais:
          description: Saldos percentuais de banco de horas e horas extras no período
          type: array
          items:
            $ref: '#/components/schemas/SaldoPercentualFechamentoDto'
      required:
        - colaboradorId
        - colaborador
        - numeroDocumento
        - cargaHoraria
        - horasTrabalhadas
        - creditos
        - debitos
        - saldo
    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
    SaldoPercentualFechamentoDto:
      type: object
      properties:
        percentual:
          type: string
          description: Percentual excedende do saldo
          example: '0.5'
        horasReferencia:
          type: string
          description: Saldo original para referência
          example: '+1:30'
        saldoHoras:
          type: number
          description: Valor do saldo calculado em horas
          example: 1.5
        saldo:
          type: string
          description: Saldo calculado
          example: '+2:30'
        bancoHoras:
          type: boolean
          description: Indica se o saldo é de banco de horas
          example: false
        horasExtras:
          type: boolean
          description: Indica se o saldo é de horas extras
          example: true
        configPadrao:
          type: boolean
          description: Indica se o saldo é de configuração padrão de horas extras
          example: false
        configPersonalizada:
          type: boolean
          description: Indica se o saldo é de configuração personalizada de horas extras
          example: false
        configAvancada:
          type: boolean
          description: Indica se o saldo é de configuração avançada
          example: true
      required:
        - percentual
        - horasReferencia
        - saldoHoras
        - saldo
        - bancoHoras
        - horasExtras

````