> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar una regla de tarifa

> Utilice este endpoint para actualizar los campos de una regla de tarifa específica por su identificador. Si cambia la tabla de tarifas referenciada, el solicitante también debe tener permiso de lectura sobre dicha tabla de tarifas.



## OpenAPI

````yaml es/openapi/v3-current/matcher.yaml patch /v1/fee-rules/{feeRuleId}
openapi: 3.1.0
info:
  title: APIs de Matcher
  description: >-
    Referencia completa de la API para el motor de conciliación Matcher, que
    proporciona conciliación automatizada de transacciones entre Midaz Ledger y
    sistemas externos.
  version: 3.0.0
  license:
    name: Elastic License 2.0
    url: https://www.elastic.co/licensing/elastic-license
servers:
  - url: https://matcher.sandbox.lerian.net
security: []
paths:
  /v1/fee-rules/{feeRuleId}:
    patch:
      tags:
        - Configuration Fee Rules
      summary: Actualizar una regla de tarifa
      description: >-
        Utilice este endpoint para actualizar los campos de una regla de tarifa
        específica por su identificador. Si cambia la tabla de tarifas
        referenciada, el solicitante también debe tener permiso de lectura sobre
        dicha tabla de tarifas.
      operationId: updateFeeRule
      parameters:
        - description: Un identificador único para rastrear la solicitud entre servicios.
          in: header
          name: X-Request-Id
          schema:
            type: string
        - description: El identificador único de la regla de tarifa.
          in: path
          name: feeRuleId
          required: true
          schema:
            type: string
            format: uuid
        - $ref: '#/components/parameters/XIdempotencyKey'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFeeRuleRequest'
        description: Actualizaciones de la regla de tarifa
        required: true
      responses:
        '200':
          description: >-
            Regla de tarifa actualizada correctamente.


            La respuesta incluye el encabezado `X-Idempotency-Replayed`.


            Si el valor es false, la solicitud acaba de ser procesada. Si el
            valor es true, la respuesta es una repetición de una solicitud
            procesada anteriormente.


            Consulte [Reintentos e
            idempotencia](/es/reference/retries-idempotency) para más detalles.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeRuleResponse'
          headers:
            X-Idempotency-Replayed:
              $ref: '#/components/headers/XIdempotencyReplayed'
        '400':
          description: Cuerpo de la solicitud no válido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: La solicitud no tiene credenciales de autenticación válidas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: No tiene permiso para acceder a este recurso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Regla de tarifa no encontrada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflicto — prioridad o nombre duplicado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Ocurrió un error inesperado en el servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  parameters:
    XIdempotencyKey:
      name: X-Idempotency-Key
      in: header
      required: false
      description: >-
        Clave de idempotencia opcional para reintentos seguros. También acepta
        `Idempotency-Key` como nombre de encabezado alternativo. Si se envía la
        misma clave nuevamente y la solicitud original ya fue procesada, se
        devuelve la respuesta en caché con `X-Idempotency-Replayed: true`.


        Consulte [Reintentos e idempotencia](/es/reference/retries-idempotency)
        para más detalles.
      schema:
        type: string
  schemas:
    UpdateFeeRuleRequest:
      description: Payload de solicitud para actualizar una regla de tarifa
      properties:
        feeScheduleId:
          description: >-
            Tabla de tarifas actualizada que se aplicará cuando esta regla
            produzca una coincidencia
          type: string
        name:
          description: Nombre de visualización actualizado de la regla de tarifa
          example: Updated Rule
          maxLength: 100
          type: string
        side:
          description: Lado de la transacción actualizado
          example: LEFT
          enum:
            - LEFT
            - RIGHT
            - ANY
          type: string
        priority:
          description: >-
            Prioridad de evaluación actualizada (debe permanecer única dentro
            del contexto)
          minimum: 0
          type: integer
        predicates:
          description: Condiciones actualizadas para esta regla
          items:
            $ref: '#/components/schemas/FieldPredicateRequest'
          maxItems: 50
          type: array
      type: object
    FeeRuleResponse:
      description: >-
        Una regla de tarifa que asocia metadatos de transacción con una tabla de
        tarifas dentro de un contexto de conciliación
      properties:
        id:
          description: Identificador único de la regla de tarifa
          example: 550e8400-e29b-41d4-a716-446655440000
          format: uuid
          type: string
        contextId:
          description: Contexto de conciliación al que pertenece esta regla
          example: 550e8400-e29b-41d4-a716-446655440000
          format: uuid
          type: string
        feeScheduleId:
          description: Tabla de tarifas aplicada cuando esta regla produce una coincidencia
          example: 550e8400-e29b-41d4-a716-446655440000
          format: uuid
          type: string
        name:
          description: Nombre de visualización de la regla de tarifa
          example: BB Right-Side Rule
          type: string
        side:
          description: Lado de la transacción al que se aplica esta regla
          example: RIGHT
          enum:
            - LEFT
            - RIGHT
            - ANY
          type: string
        priority:
          description: >-
            Prioridad de evaluación (los números más bajos se evalúan primero;
            las reglas LEFT, RIGHT y ANY comparten el mismo espacio de
            prioridad)
          example: 0
          type: integer
        predicates:
          description: Condiciones que deben cumplirse todas para que se aplique esta regla
          items:
            $ref: '#/components/schemas/FieldPredicateResponse'
          type: array
        createdAt:
          description: Marca de tiempo de creación en formato RFC 3339
          example: '2025-01-15T10:30:00Z'
          format: date-time
          type: string
        updatedAt:
          description: Marca de tiempo de la última actualización en formato RFC 3339
          example: '2025-01-15T10:30:00Z'
          format: date-time
          type: string
      type: object
    ErrorResponse:
      description: Respuesta de error estándar devuelta por todos los endpoints de la API
      type: object
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Código de error de aplicación estable.
          example: MTCH-0001
        title:
          type: string
          description: Título de error legible por humanos.
          example: Bad Request
        message:
          type: string
          description: Mensaje de error legible con detalles.
          example: context not found
        error:
          type: string
          description: >-
            Obsoleto. Mensaje de error para compatibilidad con versiones
            anteriores.
          deprecated: true
        details:
          description: Contexto de error adicional como pares clave-valor
          additionalProperties: {}
          type: object
    FieldPredicateRequest:
      description: >-
        Una condición utilizada para evaluar si una regla de tarifa se aplica a
        una transacción
      properties:
        field:
          description: Campo de la transacción a evaluar
          example: institution
          maxLength: 255
          type: string
        operator:
          description: Operador de comparación
          example: EQUALS
          enum:
            - EQUALS
            - IN
            - EXISTS
          type: string
        value:
          description: >-
            Valor único con el que comparar (se usa con los operadores EQUALS y
            EXISTS)
          example: Banco do Brasil
          maxLength: 1024
          type: string
        values:
          description: Lista de valores con los que comparar (se usa con el operador IN)
          items:
            type: string
          maxItems: 100
          type: array
      required:
        - field
        - operator
      type: object
    FieldPredicateResponse:
      description: Una condición evaluada dentro de una regla de tarifa
      properties:
        field:
          description: Campo de la transacción que se está evaluando
          example: institution
          type: string
        operator:
          description: Operador de comparación
          example: EQUALS
          enum:
            - EQUALS
            - IN
            - EXISTS
          type: string
        value:
          description: Valor único que se está comparando
          example: Banco do Brasil
          type: string
        values:
          description: Lista de valores que se están comparando
          items:
            type: string
          type: array
      type: object
  headers:
    XIdempotencyReplayed:
      description: >-
        Indica si esta respuesta fue servida desde la caché de idempotencia.
        Cuando es `true`, la respuesta es una repetición de la solicitud
        original con la misma clave de idempotencia.


        Consulte [Reintentos e idempotencia](/es/reference/retries-idempotency)
        para más detalles.
      schema:
        type: boolean
      example: false
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Autenticación con token Bearer (formato: "Bearer {token}")'

````