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

# Muda status de um parâmetro de folha de pagamento



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json patch /payment-sheet/parameter/{paymentSheetParameterId}/status
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:
  /payment-sheet/parameter/{paymentSheetParameterId}/status:
    patch:
      tags:
        - Payment Sheet
      summary: Muda status de um parâmetro de folha de pagamento
      operationId: PaymentSheetParameterController_changeStatus
      parameters:
        - name: paymentSheetParameterId
          required: true
          in: path
          description: ID do parâmetro de folha de pagamento
          schema:
            type: string
      requestBody:
        required: true
        description: Dados para mudança de status
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeStatusDto'
      responses:
        '200':
          description: Parâmetro editado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentSheetParameterDto'
        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:
    ChangeStatusDto:
      type: object
      properties:
        isActive:
          type: boolean
          description: Indica se o recurso ficará ativo ou inativo
          example: true
      required:
        - isActive
    PaymentSheetParameterDto:
      type: object
      properties:
        id:
          type: string
          description: Id do parâmetro de folha de pagamento
          example: 123-abc
        code:
          type: number
          description: Código numérico do parâmetro de folha de pagamento
          example: 1
        name:
          type: string
          description: Nome do parâmetro de folha de pagamento
          example: Keevo NG Folha
        source:
          type: string
          description: Fonte do parâmetro de folha de pagamento
          example: Keevo
        isActive:
          type: boolean
          description: Indica se o parâmetro de folha de pagamento está ativo
          example: true
        businessUnit:
          description: Unidade de negócio do parâmetro de folha de pagamento
          allOf:
            - $ref: '#/components/schemas/BusinessUnitDto'
        fields:
          description: Campos do parâmetro de folha de pagamento
          type: array
          items:
            $ref: '#/components/schemas/PaymentSheetParameterFieldDto'
        automation:
          description: Vínculos de automação do parâmetro de folha de pagamento
          type: array
          items:
            $ref: '#/components/schemas/AutomationBindingDto'
        createdAt:
          format: date-time
          type: string
          description: Data de criação do parâmetro de folha de pagamento
          example: '2023-07-23T00:00:00.000Z'
        updatedAt:
          format: date-time
          type: string
          description: Data de atualização do parâmetro de folha de pagamento
          example: '2023-07-23T00:00:00.000Z'
      required:
        - id
        - code
        - name
        - source
        - isActive
        - createdAt
        - updatedAt
    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
    BusinessUnitDto:
      type: object
      properties:
        id:
          type: string
          description: ID da unidade de negocio
          example: b5887a64-6aa1-43e8-b233-ffadc7f92ca6
        name:
          type: string
          description: Nome da unidade de negocio
          example: Tron
        documentNumber:
          type: string
          description: CPF ou CNPJ da unidade de negocio
          example: '15621118054'
        logo:
          type: string
          description: Url para download da foto da unidade de negócio
          example: https://s3-bucket.s3.amazonaws.com/files/tenant_x/file.jpg
      required:
        - id
        - name
        - documentNumber
    PaymentSheetParameterFieldDto:
      type: object
      properties:
        systemEvent:
          type: string
          description: Evento de folha de pagamento no sistema
          enum:
            - CT_FULL_SETTLEMENT
            - CT_SETTLEMENT_WITH_LIMIT
            - CT_INDIVIDUAL_SETTLEMENT
            - CT_BALANCE_TRANSFER
            - CT_BALANCE_ENTRY
            - CT_POSITIVE_BALANCE
            - CT_NEGATIVE_BALANCE
            - OT_STANDARD_100_PERCENT
            - OT_STANDARD_50_PERCENT
            - OT_NIGHT
            - OT_DAY_OFF
            - OT_HOLIDAY
            - OT_CUSTOM_PHASE_ONE
            - OT_CUSTOM_PHASE_TWO
            - OT_ADVANCED
            - OT_INTERVAL_COMPENSATED
            - OT_INTRAJOURNEY
            - OT_INTERJOURNEY
            - ABSENCE_DAYS
            - ABSENCE_HOURS
            - ABSENCE_DATES
            - HALF_ABSENCE_DAYS
            - HALF_ABSENCE_HOURS
            - HALF_ABSENCE_DATES
            - VACATION_DAYS
            - LEAVE_DAYS
            - SCHEDULE_ADJUSTMENT_DAYS
            - ALLOWANCE_DAYS
            - DISCOUNTED_ALLOWANCE_DAYS
            - CERTIFICATE_DAYS
            - SUSPENSION_DAYS
            - CERTIFICATE_DATES
            - HOLIDAYS_AT_WORK
            - HOLIDAY_HOURS_AT_WORK
            - DELAYS_AND_ANTICIPATIONS
            - TOTAL_WORKED_HOURS
            - TOTAL_NEGATIVE_HOURS
            - TOTAL_POSITIVE_HOURS
            - NIGHT_DIFFERENTIAL
          default: OT_STANDARD_50_PERCENT
        advancedPercentage:
          type: number
          description: >-
            Percentual (decimal) de acréscimo, caso seja um evento de regra
            avançada ([OT_ADVANCED]). Caso contrário, o valor será sempre 0.
          example: 0.5
        eventId:
          type: string
          description: Id do evento de folha de pagamento
          example: 123-abc
        eventCode:
          type: string
          description: Código do evento de folha de pagamento
          example: '250087'
        description:
          type: string
          description: Descrição do evento de folha de pagamento
          example: Keevo NG Folha
        isActive:
          type: boolean
          description: Indica se o evento de folha de pagamento está ativo
          example: true
      required:
        - systemEvent
        - eventId
        - eventCode
        - description
        - isActive
    AutomationBindingDto:
      type: object
      properties:
        name:
          type: string
          description: Nome do vínculo de automação do parâmetro de folha de pagamento
          example: Departamento X
        type:
          type: string
          description: Tipo da entidade da automação
          enum:
            - DEPARTMENT
            - BUSINESS_UNIT
            - PUNCH_RULE
          default: DEPARTMENT
        departmentId:
          type: string
          description: Id do departamento
          example: 123-abc
        businessUnitId:
          type: string
          description: Id da unidade de negócio
          example: 123-abc
        punchRuleId:
          type: string
          description: Id da regra de ponto
          example: 123-abc
      required:
        - name
        - type

````