> ## 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 e de eventos do Consignado no Lender

> A documentação do Lender e do Consignado agora cobre novas operações de reparo, um endpoint substituto de URL do portal e contratos corrigidos de eventos e de configuração.

12 de agosto de 2026Atualização de documentaçãoAção necessária

## Afeta

***

Equipes que integram com a API de Consignado do Lender ou consomem os seus eventos de Consignado, especialmente as equipes que usam o endpoint descontinuado de taxa mensal ou o tópico anterior de recuperação de garantia.

## O que mudou

***

A API de Consignado substitui `PUT /v1/credentials/dataprev/taxa-mensal` por `PUT /v1/credentials/dataprev/portal-base-url`. Configure uma URL HTTPS do portal do trabalhador, sem credenciais nem fragmento e com no máximo 255 caracteres. O gateway usa essa URL como o contato tipo 0 nas propostas de lance.

A referência do Lender agora inclui nove operações para divergências de contrato de Consignado e ajustes compensatórios. Ela também documenta o evento `lender.loan_account.debt_balance_changed` e corrige o evento de recuperação de garantia para `lender.guarantee_recovery_cash.allocated`, com o type CloudEvents `studio.lerian.guarantee_recovery_cash.allocated`.

A documentação também esclarece que `CONSIGNADO_ENABLED` controla apenas o tratamento legado de entrada de `consignado.averbacao.rejected`. A rota de contratação, o assinador de CCB e o consumidor de averbação confirmada estão descontinuados; os caminhos substitutos de contabilização e de pagamento são configurados de forma independente.

Essas entradas alinham a documentação pública ao contrato implementado; não anunciam um release de runtime.

## Impacto

***

**Classificação: Ação necessária.** Substitua as chamadas ao endpoint descontinuado de taxa mensal e revise as subscriptions de eventos, a configuração de deploy e os runbooks operacionais em relação ao contrato corrigido.

## O que você precisa fazer

***

**Step 1**

Substitua o uso de `PUT /v1/credentials/dataprev/taxa-mensal` por `PUT /v1/credentials/dataprev/portal-base-url`.

**Step 2**

Valide a URL do portal configurada antes de enviá-la: apenas HTTPS, sem credenciais nem fragmento e com no máximo 255 caracteres.

**Step 3**

Atualize os subscribers de recuperação de garantia para `lender.guarantee_recovery_cash.allocated` e `studio.lerian.guarantee_recovery_cash.allocated`.

**Step 4**

Revise qualquer runbook de `CONSIGNADO_ENABLED`: ele não controla mais os caminhos descontinuados de contratação, de assinador e de averbação confirmada.

**Step 5**

Use as operações documentadas de divergência e de ajuste compensatório onde a sua integração repara contratos de Consignado.

### Prazo

Conclua a revisão do endpoint e das subscriptions de eventos antes do seu próximo deploy de Consignado ou release de integração.

## Recursos

***

* [API REST do Lender](https://docs.lerian.studio/pt/products/lender/lender-rest-api.md)
* [Eventos do Lender](https://docs.lerian.studio/pt/products/lender/lender-events.md)
* [Consignado privado](https://docs.lerian.studio/pt/products/lender/consignado-privado.md)


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