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

# Contrato de API y de eventos de Consignado de Lender

> La documentación de Lender y de Consignado ahora cubre nuevas operaciones de reparación, un endpoint de URL de portal que reemplaza al anterior y contratos de eventos y de configuración corregidos.

<Badge stroke icon="calendar-days" iconType="regular">12 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de documentación</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Acción requerida</Badge>

## Afecta a

***

Equipos que se integran con la API de Consignado de **Lender** o consumen sus eventos de Consignado, en especial los equipos que usan el endpoint de tasa mensual retirado o el tema anterior de recuperación de garantía.

## Qué cambió

***

La API de Consignado reemplaza `PUT /v1/credentials/dataprev/taxa-mensal` por `PUT /v1/credentials/dataprev/portal-base-url`. Configura una URL HTTPS del portal del trabajador, sin credenciales ni fragmento y con no más de 255 caracteres. El gateway usa esa URL como el contacto de tipo 0 en las propuestas de oferta.

La referencia de Lender ahora incluye nueve operaciones para divergencias de contratos de Consignado y ajustes compensatorios. También documenta el evento `lender.loan_account.debt_balance_changed` y corrige el evento de recuperación de garantía a `lender.guarantee_recovery_cash.allocated`, con tipo CloudEvents `studio.lerian.guarantee_recovery_cash.allocated`.

La documentación también aclara que `CONSIGNADO_ENABLED` controla solo el manejo heredado del `consignado.averbacao.rejected` entrante. La ruta de contratação, el firmante de CCB y el consumidor de averbação confirmada están retirados; las rutas de contabilización y de pago que los reemplazan se configuran de forma independiente.

Estas entradas alinean la documentación pública con el contrato implementado; no anuncian una release de runtime.

## Impacto

***

**Clasificación: Acción requerida.** Reemplaza las llamadas al endpoint de tasa mensual retirado y revisa las suscripciones de eventos, la configuración de despliegue y los runbooks operativos frente al contrato corregido.

## Qué debes hacer

***

<Steps>
  <Step>Reemplaza el uso de `PUT /v1/credentials/dataprev/taxa-mensal` por `PUT /v1/credentials/dataprev/portal-base-url`.</Step>
  <Step>Valida la URL del portal configurada antes de enviarla: solo HTTPS, sin credenciales ni fragmento y como máximo 255 caracteres.</Step>
  <Step>Actualiza los suscriptores de recuperación de garantía a `lender.guarantee_recovery_cash.allocated` y `studio.lerian.guarantee_recovery_cash.allocated`.</Step>
  <Step>Revisa cualquier runbook de `CONSIGNADO_ENABLED`: ya no controla las rutas retiradas de contratação, del firmante ni de averbação confirmada.</Step>
  <Step>Usa las operaciones documentadas de divergencia y de ajuste compensatorio donde tu integración repara contratos de Consignado.</Step>
</Steps>

### Plazo

Completa la revisión del endpoint y de las suscripciones de eventos antes de tu próximo despliegue de Consignado o release de integración.

## Recursos

***

* [API REST de Lender](/es/products/lender/lender-rest-api)
* [Eventos de Lender](/es/products/lender/lender-events)
* [Consignado privado](/es/products/lender/consignado-privado)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.