Skip to main content
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 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 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.
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, 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: 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 dele — GET /api/v1/loan-accounts/{id}/audit-events, coberta em Faça a gestão de um empréstimo. Todo repagamento, estorno e reprocessamento aparece lá.

​
Próximos passos

Pacote regulatório Brasil

Estágios de PDD, a varredura noturna de promoção e o provisionamento que os estágios movem.