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

# Carteira e inadimplência

> Leia a carteira de empréstimos ativa em agregado: o painel da carteira, o registro de empréstimos inadimplentes e o retrato noturno que os dois leem.

A gestão da carteira acompanha cada conta de empréstimo individualmente. A superfície de carteira lê o livro em agregado. Com ela, você vê o formato da carteira (Um agrupamento de contas pertencentes ao mesmo titular, unidade de negócio ou finalidade. Reúne contas correntes, de poupança e de investimento em uma visão unificada.) e quais empréstimos ficam para trás, sem consultar empréstimo por empréstimo.

As duas leituras respondem a partir de um **retrato** de uma data de referência, nunca de uma varredura viva do livro. Isso as torna baratas o bastante para ficar num painel. É também por isso que elas respondem por uma data, e não por "agora".

## Painel da carteira

***

`GET /api/v1/dashboard/portfolio` retorna o quadro agregado do livro ativo para uma data de referência. O quadro traz exposição em aberto, adimplente e inadimplente, a contagem de empréstimos ativos e inadimplentes, e volume de desembolso e de repagamento. Ele também traz os índices de carteira em risco em 30, 60 e 90 dias. Junto deles, vêm a contagem de empréstimos e a exposição por faixa de inadimplência, e uma tendência mês a mês até a data. Também vêm as linhas detalhadas da faixa que você pediu.

Delimite a leitura com `productIds` e `productVersionIds`. Omita `asOf` e o Lender usa o dia útil corrente no Brasil.

## Empréstimos inadimplentes

***

`GET /api/v1/dashboard/delinquent-loans` retorna o registro por trás dos números: as contas de empréstimo que estão em uma faixa de inadimplência, página a página, para você priorizar cobrança e provisionamento. Peça uma faixa com `bucketCode` (`current`, `1_30`, `31_60`, `61_90`, `91_plus`, ou as cumulativas `par30`, `par60` e `par90`), e delimite à carteira de um único oficial de crédito com `assignedOfficerId`.

O Brasil tem um alias, `GET /api/v1/br/dashboard/delinquent-loans`, que acrescenta um filtro pela *carteira* regulatória C1 a C5 da Res. BCB 352/2023 a todos os filtros acima: a data de referência, os produtos, as versões de produto, a faixa, o oficial de crédito e a paginação continuam valendo. O Lender deriva a carteira do produto, então uma que nenhum produto declara retorna uma página vazia.

## De onde vêm os números

***

Um job noturno de retrato, desligado por padrão, mede cada conta de empréstimo viva contra o dia útil e grava o retrato de que essas duas leituras respondem. A **varredura de promoção de PDD** descrita no [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md) depende do mesmo retrato. Ela monta o retrato para o próprio dia útil dela quando nada mais o montou. Uma instalação que deixa o job de retrato desligado e mantém a varredura ligada, portanto, ainda assim tem um livro medido.

> [!WARNING]
>
> O Lender recusa com `503` uma data de referência que ninguém mediu, e nunca a responde com uma página de zeros. Um livro não medido e um livro sem nada em atraso produzem os mesmos números. Responder o primeiro como se fosse o segundo relataria uma carteira saudável que ninguém olhou. Trate a recusa como "tente de novo", não como "o livro está vazio".
>
> A repetição só passa a responder depois que algum produtor mediu aquela data. O produtor é a [varredura noturna de promoção de PDD](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md#the-nightly-promotion-sweep), que vem ligada, ou o job dedicado de retrato, que vem desligado. Com os dois desligados, repetir não adianta.

Cada resposta carrega a própria procedência. Ela nomeia de qual retrato veio, a data de referência que esse retrato mediu e quando ele foi gerado. Ela também diz se a política de frescor o considera velho, e por quê.

## A auditoria é por conta

***

As visões de carteira são leituras agregadas. O registro autoritativo e imutável do que aconteceu com um empréstimo específico é a trilha de auditoria (Um registro cronológico e imutável de cada ação e transação no sistema, essencial para conformidade regulatória e resolução de disputas.) dele (`GET /api/v1/loan-accounts/{id}/audit-events`), coberta em [Faça a gestão de um empréstimo](https://docs.lerian.studio/pt/products/lender/service-a-loan.md). Todo repagamento, estorno e reprocessamento aparece lá.

## Próximos passos

***

> [card] [Pacote regulatório Brasil](https://docs.lerian.studio/pt/products/lender/brazil-regulatory-pack.md)
>
> Estágios de PDD, a varredura noturna de promoção e o provisionamento que os estágios movem.


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