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

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

<Badge stroke icon="calendar-days" iconType="regular">12 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização de documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Quem é afetado

***

Times que integram com a API de Consignado do **Lender** ou consomem seus eventos de Consignado, especialmente quem usa o endpoint retirado de taxa mensal ou o tópico anterior de recuperação de garantias.

## 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 contato de tipo 0 nas propostas de oferta.

A referência do Lender agora inclui nove operações para divergências de contratos 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 garantias para `lender.guarantee_recovery_cash.allocated`, com o tipo 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 foram retirados; os caminhos substitutos de booking e pagamento são configurados de modo independente.

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

## Impacto

***

**Classificação: Ação necessária.** Substitua as chamadas ao endpoint retirado de taxa mensal e revise assinaturas de eventos, configuração de deployment e procedimentos operacionais segundo o contrato corrigido.

## O que você precisa fazer

***

<Steps>
  <Step>Substitua o uso de `PUT /v1/credentials/dataprev/taxa-mensal` por `PUT /v1/credentials/dataprev/portal-base-url`.</Step>
  <Step>Valide a URL do portal antes de enviá-la: somente HTTPS, sem credenciais nem fragmento e com no máximo 255 caracteres.</Step>
  <Step>Atualize os assinantes de recuperação de garantias para `lender.guarantee_recovery_cash.allocated` e `studio.lerian.guarantee_recovery_cash.allocated`.</Step>
  <Step>Revise qualquer procedimento de `CONSIGNADO_ENABLED`: ele não controla mais os caminhos retirados de contratação, assinador ou averbação confirmada.</Step>
  <Step>Use as operações documentadas de divergência e ajuste compensatório quando sua integração reparar contratos de Consignado.</Step>
</Steps>

### Prazo

Conclua a revisão do endpoint e das assinaturas de eventos antes do próximo deployment de Consignado ou release da integração.

## Recursos

***

* [API REST do Lender](/pt/lender/lender-rest-api)
* [Eventos do Lender](/pt/lender/lender-events)
* [Consignado privado](/pt/lender/consignado-privado)