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

export const GAuditTrail = ({children}) => <Tooltip headline="Trilha de auditoria" tip="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." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

export const GPortfolio = ({children}) => <Tooltip headline="Portfólio" tip="Um agrupamento de contas pertencentes ao mesmo cliente, unidade de negócio ou finalidade, reunindo contas correntes, de poupança e de investimento em uma visão unificada." cta="Ver glossário" href="/pt/start-here/glossary">
    {children}
  </Tooltip>;

A gestão da carteira acompanha cada conta de empréstimo individualmente. A superfície de carteira lê o livro **em agregado**, para você ver o formato da <GPortfolio>carteira</GPortfolio> e quais empréstimos estão ficando 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 que as torna baratas o bastante para ficar num painel, e é 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: exposição em aberto, adimplente e inadimplente, a contagem de empréstimos ativos e inadimplentes, volume de desembolso e de repagamento, e 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, uma tendência mês a mês até a data, e 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. A carteira é derivada 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](/pt/products/lender/brazil-regulatory-pack) depende do mesmo retrato e o monta para o próprio dia útil dela quando nada mais montou, então uma instalação que deixa o job de retrato desligado e mantém a varredura ligada ainda assim tem um livro medido.

<Warning>
  Uma data de referência que ninguém mediu é recusada com `503`, nunca respondida com uma página de zeros. Um livro não medido e um livro sem nada em atraso produzem os mesmos números, e 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: a [varredura noturna de promoção de PDD](/pt/products/lender/brazil-regulatory-pack#the-nightly-promotion-sweep), que vem ligada, ou o job dedicado de retrato, que vem desligado. Com os dois desligados, repetir não adianta.
</Warning>

Cada resposta carrega a própria procedência: de qual retrato ela veio, a data de referência que esse retrato mediu, quando ele foi gerado, 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 <GAuditTrail>trilha de auditoria</GAuditTrail> dele — `GET /api/v1/loan-accounts/{id}/audit-events`, coberta em [Faça a gestão de um empréstimo](/pt/products/lender/service-a-loan). Todo repagamento, estorno e reprocessamento aparece lá.

## Próximos passos

***

<Card title="Pacote regulatório Brasil" icon="brazilian-real-sign" href="/pt/products/lender/brazil-regulatory-pack" horizontal>
  Estágios de PDD, a varredura noturna de promoção e o provisionamento que os estágios movem.
</Card>
