> ## 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 inmediato > Usa este endpoint para actualizar un cobro inmediato. Solo se pueden actualizar los cobros en estado ACTIVE. **Campos mutables (se pueden actualizar):** - expirationSeconds: Tiempo en segundos hasta que expira el cobro - receiverKey: Clave PIX que recibirá el pago - debtorDocument: CPF/CNPJ del pagador (debe proporcionarse junto con debtorName) - debtorName: Nombre del pagador (debe proporcionarse junto con debtorDocument) - description: Descripción personalizada del cobro - additionalInfo: Información adicional en pares clave-valor - tags: Arreglo de etiquetas personalizadas **Campos inmutables (no se pueden actualizar):** - id: Identificador único del cobro - accountId: Identificador de la cuenta - txId: Identificador de la transacción - amount: Monto original del cobro - status: Estado del cobro (gestionado por el sistema) - pactualId: ID del proveedor externo - emv: Payload del código QR - locationUrl: URL del código QR - createdAt: Marca de tiempo de creación - updatedAt: Marca de tiempo de la última actualización **Restricciones de estado:** - Los cobros SOLO se pueden actualizar cuando el estado es ACTIVE - Los cobros con estado COMPLETED, DELETED o EXPIRED no se pueden actualizar ## OpenAPI ````yaml es/openapi/v3-current/indirect-pix.yaml PUT /v1/collections/immediate/{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/immediate/{collection_id}: put: tags: - Collections API summary: Actualizar un cobro inmediato description: >- Usa este endpoint para actualizar un cobro inmediato. Solo se pueden actualizar los cobros en estado ACTIVE. **Campos mutables (se pueden actualizar):** - expirationSeconds: Tiempo en segundos hasta que expira el cobro - receiverKey: Clave PIX que recibirá el pago - debtorDocument: CPF/CNPJ del pagador (debe proporcionarse junto con debtorName) - debtorName: Nombre del pagador (debe proporcionarse junto con debtorDocument) - description: Descripción personalizada del cobro - additionalInfo: Información adicional en pares clave-valor - tags: Arreglo de etiquetas personalizadas **Campos inmutables (no se pueden actualizar):** - id: Identificador único del cobro - accountId: Identificador de la cuenta - txId: Identificador de la transacción - amount: Monto original del cobro - status: Estado del cobro (gestionado por el sistema) - pactualId: ID del proveedor externo - emv: Payload del código QR - locationUrl: URL del código QR - createdAt: Marca de tiempo de creación - updatedAt: Marca de tiempo de la última actualización **Restricciones de estado:** - Los cobros SOLO se pueden actualizar cuando el estado es ACTIVE - Los cobros con estado COMPLETED, DELETED o EXPIRED no se pueden actualizar parameters: - name: collection_id in: path description: Identificador del cobro inmediato 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/UpdateImmediateCollectionInput' responses: '200': description: Cobro actualizado correctamente content: application/json: schema: $ref: '#/components/schemas/ImmediateCollectionOutput' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' '422': description: Unprocessable Entity 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: UpdateImmediateCollectionInput: properties: additionalInfo: additionalProperties: type: string description: >- AdditionalInfo es el nuevo mapa de clave-valor para información adicional example: status: updated version: '2' type: object amount: description: >- Amount es el nuevo monto de la cobranza en formato decimal con 2 decimales example: '150.00' type: string debtorDocument: description: >- DebtorDocument es el nuevo CPF o CNPJ del pagador (debe proporcionarse junto con DebtorName) example: '98765432109' type: string debtorName: description: >- DebtorName es el nuevo nombre del pagador (debe proporcionarse junto con DebtorDocument) example: Maria Santos type: string description: description: Description es la nueva descripción personalizada para la cobranza example: Updated payment description type: string expirationSeconds: description: >- ExpirationSeconds es el nuevo tiempo de expiración en segundos (debe ser mayor que 0) example: 7200 type: integer metadata: additionalProperties: {} description: >- Metadata es un mapa para actualizar pares clave-valor personalizados (merge patch RFC 7386) type: object receiverKey: description: Nueva clave Pix que recibirá el pago example: '+5511988888888' minLength: 1 type: string tags: description: Tags es el nuevo arreglo de etiquetas personalizadas example: - updated - revised items: type: string type: array type: object ImmediateCollectionOutput: properties: additionalInfo: additionalProperties: type: string description: AdditionalInfo contiene información adicional de clave-valor example: customerId: '67890' orderId: '12345' type: object amount: description: Amount es el monto de la cobranza en formato decimal example: '100.00' type: string createdAt: description: CreatedAt es la marca de tiempo en que se creó la cobranza example: '2024-01-15T10:30:00Z' type: string debtorDocument: description: DebtorDocument es el CPF o CNPJ del pagador example: '12345678901' type: string debtorName: description: DebtorName es el nombre del pagador example: João da Silva type: string description: description: Description es la descripción personalizada de la cobranza example: 'Payment for order #12345' type: string emv: description: EMV es el payload del código QR en formato EMV example: 00020126580014br.gov.bcb.pix... type: string expirationSeconds: description: ExpirationSeconds es el tiempo en segundos hasta la expiración example: 3600 type: integer id: description: ID es el identificador único de la cobranza example: 550e8400-e29b-41d4-a716-446655440000 type: string locationUrl: description: >- LocationURL es la URL para acceder a la ubicación/código QR de la cobranza example: https://api.example.com/qr/550e8400 type: string metadata: additionalProperties: {} description: >- Metadata son los metadatos personalizados asociados con esta cobranza type: object receiverKey: description: Clave Pix que recibirá el pago example: '+5511999999999' type: string status: description: Status es el estado actual de la cobranza example: ACTIVE type: string tags: description: Tags es un arreglo de etiquetas personalizadas example: - ecommerce - subscription items: type: string type: array txId: description: TxID es el identificador de la transacción example: TXN123456789 type: string updatedAt: description: UpdatedAt es la marca de tiempo de la última actualización example: '2024-01-15T10:30:00Z' type: string 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. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````