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

# Guias do Lender atualizados para jobs agendados e novas recusas

> A documentação do Lender agora descreve a varredura noturna de promoção de PDD, a regra de mês civil da apropriação, as chaves de idempotência obrigatórias na originação, a promoção de versão e o recebível de pagamento devolvido.

<Badge stroke icon="calendar-days" iconType="regular">20 de setembro 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>

## Afeta

***

Equipes que integram com as APIs de originação, gestão da carteira ou contabilidade do Lender, e equipes que operam uma instalação do Lender.

## O que mudou

***

Sete guias do Lender foram reescritos contra o serviço como ele está hoje, e duas páginas voltaram.

**A apropriação reconhece um mês de calendário, não um aniversário do empréstimo.** Uma rodada fecha o último mês civil que já tinha terminado por inteiro antes da data de referência dela, e fecha o mesmo mês para cada empréstimo que seleciona. Os guias descreviam antes uma grade de aniversário por empréstimo, que não existe mais. O driver agendado agora vem habilitado e dispara todo dia, e a cadência diária é uma repetição de um único reconhecimento mensal, não uma forma de percorrer aniversários. Uma rodada também cobre a carteira inteira, em vez de parar num número fixo de contas de empréstimo.

**Dois dos jobs que esta atualização documenta vêm habilitados.** A varredura noturna de promoção de PDD avança os estágios de provisionamento da Res. CMN 4.966 conforme os empréstimos envelhecem, em instalações de tenant único e multi-tenant, e monta o retrato da carteira de que ela depende quando nada mais montou. O heartbeat diário de apropriação é o outro. Outras varreduras também vêm habilitadas; a conciliação de cobrança e o job dedicado de retrato da carteira seguem desligados por padrão.

**A originação ganhou duas recusas e uma chave obrigatória.** Criar uma proposta de empréstimo e movê-la — aprovar, recusar, desistir, desembolsar — agora exigem o cabeçalho `X-Idempotency`, e a guarda falha fechada em vez de deixar passar um pedido desprotegido. A originação também recusa um produto de empréstimo que não está ativo (`LENDER-0225`) na criação, na aprovação e na liberação, e recusa uma proposta que não nomeia a versão corrente do produto (`LENDER-0226`) apenas na criação.

**Um produto vivo pode ser reapontado.** Uma operação nova promove uma versão a corrente num produto que já está ativo, carregando as mesmas checagens de prontidão que a ativação carrega, e não mudando nada para contratos e propostas já abertos.

**Um pagamento final devolvido num consignado quitado abre um recebível.** Quando a exclusão de folha já chegou ao trilho e não foi rejeitada, estornar o pagamento que quitou não revive mais o contrato: abre um recebível de pagamento devolvido contra o tomador, fora da operação de crédito, com operações próprias de listar, ler e cobrar.

**A repetição de apropriação funciona agora.** Repetir uma rodada remonta os lançamentos que o ledger nunca confirmou e os enfileira sob a mesma chave determinística, e informa item a item o que ela não conseguiu reenviar.

A página do console do Lender e a página de carteira e inadimplência estão publicadas de novo, as duas ajustadas ao que o build e a API de fato respondem.

## Impacto

***

**Classificação: Ação necessária.** Um cliente que não envia chave de idempotência nas quatro escritas de proposta que antes não exigiam uma (criar, aprovar, recusar, desistir; o desembolso já exigia) é recusado, e um cliente que origina contra um produto que nunca foi ativado é recusado. As duas são recusas novas, não esclarecimentos de documentação.

## O que você precisa fazer

***

Envie `X-Idempotency` em toda escrita de proposta de empréstimo, e trate um `400` como defeito de cliente, não como falha transitória. Ative os produtos de empréstimo contra os quais você origina, e nomeie a versão corrente ao criar uma proposta. Revise todo job que vem habilitado contra as suas próprias expectativas de agendamento antes de atualizar, e releia o guia de apropriação se você construiu algo em torno da regra de aniversário.

## Recursos

***

* [Como funciona a apropriação](/pt/products/lender/how-accrual-works)
* [Contabilidade e rodadas de apropriação](/pt/products/lender/accounting-and-accrual-runs)
* [Origine um empréstimo](/pt/products/lender/originate-a-loan)
* [Defina um produto de empréstimo](/pt/products/lender/define-a-loan-product)
* [Faça a gestão de um empréstimo](/pt/products/lender/service-a-loan)
* [Pacote regulatório Brasil](/pt/products/lender/brazil-regulatory-pack)
* [Carteira e inadimplência](/pt/products/lender/portfolio-and-delinquency)
* [Console do Lender](/pt/products/lender/lender-console)


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