> ## 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 un cobro dinámico con vencimiento

> Usa este endpoint para actualizar un cobro con vencimiento. Solo se pueden actualizar los cobros en estado ACTIVE.



## OpenAPI

````yaml es/openapi/v3-current/indirect-pix.yaml PATCH /v1/collections/duedate/{collection_id}
openapi: 3.0.3
info:
  title: Plugin BR Pix Indirect - API completa
  description: |
    API completa para el sistema de pagos instantáneos Pix de Brasil, que
    incluye operaciones del diccionario de claves Pix, generación/decodificación
    de códigos QR, transacciones y límites transaccionales.
  version: 1.0.0
servers:
  - url: https://plugin-pix-indirect.api.lerian.net
security:
  - bearerAuth: []
paths:
  /v1/collections/duedate/{collection_id}:
    patch:
      tags:
        - Collections API
      summary: Actualizar un cobro dinámico con vencimiento
      description: >-
        Usa este endpoint para actualizar un cobro con vencimiento. Solo se
        pueden actualizar los cobros en estado ACTIVE.
      parameters:
        - name: collection_id
          in: path
          description: Identificador del cobro con vencimiento
          required: true
          schema:
            type: string
        - name: X-Account-Id
          in: header
          description: ID de la cuenta (formato UUID)
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateDueDateCollectionInput'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DueDateCollectionOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
      deprecated: false
      security:
        - bearerAuth: []
components:
  schemas:
    UpdateDueDateCollectionInput:
      properties:
        additionalInfo:
          additionalProperties:
            type: string
          description: AdditionalInfo es un mapa de clave-valor para información adicional
          example:
            customerId: '67890'
            orderId: '12345'
          type: object
        amount:
          allOf:
            - $ref: '#/components/schemas/AmountObject'
          description: >-
            Amount es el objeto de configuración del monto (para actualizaciones
            de multa/interés/descuento/abono)
        debtor:
          allOf:
            - $ref: '#/components/schemas/DebtorInput'
          description: >-
            Debtor es la información del deudor (nombre y documento requeridos
            si se proporciona)
        description:
          description: >-
            Description es un mensaje o descripción personalizada para la
            cobranza
          example: 'Payment for order #12345'
          type: string
        dueDate:
          description: >-
            DueDate es la fecha de vencimiento de la cobranza en formato
            YYYY-MM-DD (ISO8601)
          example: '2024-12-31'
          type: string
        metadata:
          additionalProperties: {}
          description: >-
            Metadata es un mapa para actualizar pares clave-valor personalizados
            (merge patch RFC 7386)
          type: object
        receiverKey:
          description: Clave Pix que recibirá el pago
          example: '+5511999999999'
          type: string
        tags:
          description: Tags es un arreglo de etiquetas personalizadas para categorización
          example:
            - ecommerce
            - subscription
          items:
            type: string
          type: array
        validAfterDue:
          description: >-
            ValidAfterDue es la cantidad de días después de la fecha de
            vencimiento durante los cuales la cobranza permanece válida
          example: 5
          type: integer
      type: object
    DueDateCollectionOutput:
      properties:
        additionalInfo:
          additionalProperties:
            type: string
          description: >-
            AdditionalInfo es un mapa de clave-valor para información adicional
            (opcional)
          example:
            customerId: '67890'
            orderId: '12345'
          type: object
        amount:
          allOf:
            - $ref: '#/components/schemas/AmountObject'
          description: Amount es el objeto de configuración del monto (requerido)
        createdAt:
          description: >-
            CreatedAt es la marca de tiempo en que se creó la cobranza
            (requerido)
          example: '2024-01-15T10:30:00Z'
          type: string
        debtor:
          allOf:
            - $ref: '#/components/schemas/DebtorOutput'
          description: Debtor es la información del deudor (requerido)
        deletedAt:
          description: >-
            DeletedAt es la marca de tiempo en que se eliminó la cobranza
            (opcional, anulable)
          example: '2024-01-25T10:30:00Z'
          type: string
        description:
          description: >-
            Description es la descripción personalizada de la cobranza
            (opcional)
          example: 'Payment for order #12345'
          type: string
        dueDate:
          description: >-
            DueDate es la fecha de vencimiento de la cobranza en formato
            YYYY-MM-DD (requerido)
          example: '2024-12-31'
          type: string
        emv:
          description: EMV es el payload del código QR en formato EMV (requerido)
          example: 00020126580014br.gov.bcb.pix...
          type: string
        id:
          description: ID es el identificador único de la cobranza (requerido)
          example: 550e8400-e29b-41d4-a716-446655440010
          type: string
        locationUrl:
          description: >-
            LocationURL es la URL para acceder a la ubicación/código QR de la
            cobranza (requerido)
          example: https://api.example.com/qr/550e8400
          type: string
        metadata:
          additionalProperties: {}
          description: >-
            Metadata son los metadatos personalizados asociados con esta
            cobranza
          type: object
        receiver:
          allOf:
            - $ref: '#/components/schemas/ReceiverOutput'
          description: Receiver es la información del receptor (requerido)
        receiverKey:
          description: Clave Pix que recibirá el pago
          example: '+5511999999999'
          type: string
        review:
          description: Review es el número de revisión de la cobranza (requerido)
          example: 0
          type: integer
        status:
          description: >-
            Status es el estado actual de la cobranza (requerido)

            Valores válidos: ACTIVE, COMPLETED, REMOVED_BY_RECEIVER,
            REMOVED_BY_PSP
          example: ACTIVE
          type: string
        tags:
          description: Tags es un arreglo de etiquetas personalizadas (opcional)
          example:
            - ecommerce
            - subscription
          items:
            type: string
          type: array
        txId:
          description: TxID es el identificador de la transacción (requerido)
          example: TXabcdefghijklmno123456789
          type: string
        updatedAt:
          description: >-
            UpdatedAt es la marca de tiempo de la última actualización
            (requerido)
          example: '2024-01-20T14:45:00Z'
          type: string
        validAfterDue:
          description: >-
            ValidAfterDue es la cantidad de días después de la fecha de
            vencimiento durante los cuales la cobranza permanece válida
            (requerido)
          example: 5
          type: integer
      type: object
    ErrorFormat:
      type: object
      description: El mensaje de error de la respuesta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Un identificador único y estable para el error.
        title:
          type: string
          description: Un breve resumen del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
    AmountObject:
      properties:
        abatement:
          allOf:
            - $ref: '#/components/schemas/AbatementObject'
          description: >-
            Abatement es la configuración del descuento por pronto pago
            (opcional)
        discount:
          allOf:
            - $ref: '#/components/schemas/DiscountObject'
          description: Discount es la configuración del descuento (opcional)
        fine:
          allOf:
            - $ref: '#/components/schemas/FineObject'
          description: Fine es la configuración de la multa (opcional)
        interest:
          allOf:
            - $ref: '#/components/schemas/InterestObject'
          description: Interest es la configuración del interés (opcional)
        original:
          description: >-
            Original es el monto original de la cobranza en formato decimal con
            2 decimales
          example: '100.00'
          type: string
      required:
        - original
      type: object
    DebtorInput:
      properties:
        address:
          description: Address es la dirección del deudor (opcional)
          example: Rua das Flores, 123
          type: string
        city:
          description: City es la ciudad del deudor (opcional)
          example: São Paulo
          type: string
        document:
          description: >-
            Document es el CPF (11 dígitos) o CNPJ (14 dígitos) del deudor
            (requerido)
          example: '12345678901'
          type: string
        email:
          description: Email es la dirección de correo electrónico del deudor (opcional)
          example: joao@example.com
          type: string
        name:
          description: Name es el nombre completo del deudor (requerido)
          example: João da Silva
          type: string
        state:
          description: State es el estado del deudor (opcional)
          example: SP
          type: string
        zipCode:
          description: ZipCode es el código postal del deudor (opcional)
          example: 01310-100
          type: string
      required:
        - document
        - name
      type: object
    DebtorOutput:
      properties:
        address:
          description: Address es la dirección del deudor (opcional)
          example: Rua das Flores, 123
          type: string
        city:
          description: City es la ciudad del deudor (opcional)
          example: São Paulo
          type: string
        document:
          description: >-
            Document es el CPF (11 dígitos) o CNPJ (14 dígitos) del deudor
            (requerido)
          example: '12345678901'
          type: string
        email:
          description: Email es la dirección de correo electrónico del deudor (opcional)
          example: joao@example.com
          type: string
        name:
          description: Name es el nombre completo del deudor (requerido)
          example: João da Silva
          type: string
        state:
          description: State es el estado del deudor (opcional)
          example: SP
          type: string
        zipCode:
          description: ZipCode es el código postal del deudor (opcional)
          example: 01310-100
          type: string
      type: object
    ReceiverOutput:
      properties:
        address:
          description: Address es la dirección del receptor (requerido)
          example: Rua das Flores, 123
          type: string
        city:
          description: City es la ciudad del receptor (requerido)
          example: São Paulo
          type: string
        document:
          description: Document es el CPF o CNPJ del receptor (requerido)
          example: '12345678901'
          type: string
        name:
          description: Name es el nombre del receptor (requerido)
          example: João da Silva
          type: string
        state:
          description: State es el estado del receptor (requerido)
          example: SP
          type: string
        tradeName:
          description: >-
            TradeName es el nombre comercial del receptor (opcional, para
            personas jurídicas)
          example: Company Name
          type: string
        zipCode:
          description: ZipCode es el código postal del receptor (requerido)
          example: 01310-100
          type: string
      type: object
    AbatementObject:
      properties:
        modality:
          description: >-
            Modality es el tipo de descuento por pronto pago. Valores aceptados:
            FIXED_VALUE, PERCENT
          example: PERCENT
          type: string
        value:
          description: >-
            Value es el valor del descuento por pronto pago (monto o porcentaje)
            como cadena
          example: '3.00'
          type: string
      required:
        - modality
        - value
      type: object
    DiscountObject:
      properties:
        discountDateFixed:
          description: >-
            DiscountDateFixed es un arreglo de descuentos de fecha fija.
            Requerido cuando no se proporciona value. Mín. 1, Máx. 3 elementos.
          items:
            $ref: '#/components/schemas/DiscountDateFixed'
          maxItems: 3
          minItems: 1
          type: array
        modality:
          description: >-
            Modality es el tipo de descuento. Valores aceptados:
            FIXED_VALUE_UNTIL_THE_DATES_INFORMED, PERCENTAGE_DATE_REPORTED,
            AMOUNT_PER_CALENDAR_DAY_ADVANCE, AMOUNT_ADVANCE_BUSINESS_DAY,
            PERCENTAGE_ADVANCE_CURRENT_DAY, PERCENTAGE_ADVANCE_BUSINESS_DAY
          example: AMOUNT_ADVANCE_BUSINESS_DAY
          type: string
        value:
          description: >-
            Value es el valor del descuento (monto o porcentaje) como cadena.
            Requerido cuando no se proporciona discountDateFixed.
          example: '5.00'
          type: string
      required:
        - modality
      type: object
    FineObject:
      properties:
        modality:
          description: >-
            Modality es el tipo de multa. Valores aceptados: FIXED_VALUE,
            PERCENT
          example: PERCENT
          type: string
        value:
          description: Value es el valor de la multa (monto o porcentaje) como cadena
          example: '2.00'
          type: string
      required:
        - modality
        - value
      type: object
    InterestObject:
      properties:
        modality:
          description: >-
            Modality es el tipo de interés. Valores aceptados:
            VALUE_CALENDAR_DAYS, PERCENTAGE_PER_DAY_CALENDAR_DAYS,
            PERCENTAGE_PER_MONTH_CALENDAR_DAYS,
            PERCENTAGE_PER_YEAR_CALENDAR_DAYS, VALUE_WORKING_DAYS,
            PERCENTAGE_PER_DAYWORKING_DAYS, PERCENTAGE_PER_MONTH_WORKING_DAYS,
            PERCENTAGE_PER_YEAR_WORKING_DAYS
          example: PERCENTAGE_PER_MONTH_CALENDAR_DAYS
          type: string
        value:
          description: Value es el valor del interés (monto o porcentaje) como cadena
          example: '1.00'
          type: string
      required:
        - modality
        - value
      type: object
    DiscountDateFixed:
      properties:
        date:
          description: Date es la fecha del descuento en formato YYYY-MM-DD
          example: '2024-12-25'
          type: string
        value:
          description: Value es el valor del descuento para esta fecha como cadena
          example: '10.00'
          type: string
      required:
        - date
        - value
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````