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

# Cartera y morosidad

> Lee la cartera de préstamos activa en agregado: el panel de cartera, el registro de préstamos morosos y la foto nocturna que ambos leen.

export const GAuditTrail = ({children}) => <Tooltip headline="Registro de auditoría" tip="Un registro cronológico e inmutable de cada acción y transacción en el sistema, esencial para el cumplimiento normativo y la resolución de disputas." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

export const GPortfolio = ({children}) => <Tooltip headline="Portafolio" tip="Una agrupación de cuentas que pertenecen al mismo cliente, unidad de negocio o propósito. Reúne cuentas corrientes, de ahorro y de inversión en una vista unificada." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

La administración sigue cada cuenta de préstamo por separado. La superficie de cartera lee el libro **en agregado**, para que veas la forma de la <GPortfolio>cartera</GPortfolio> y cuáles préstamos se están atrasando sin consultar préstamo por préstamo.

Las dos lecturas responden desde una **foto** de una fecha de negocio, nunca desde un barrido vivo del libro. Eso es lo que las hace suficientemente baratas para ponerlas en un panel, y también por eso responden por una fecha y no por "ahora".

## Panel de cartera

***

`GET /api/v1/dashboard/portfolio` devuelve el cuadro agregado del libro activo para una fecha de negocio: exposición pendiente, al día y morosa, el conteo de préstamos activos y morosos, volumen de desembolso y de pago, y los índices de cartera en riesgo a 30, 60 y 90 días. Junto a ellos vienen el conteo de préstamos y la exposición por tramo de morosidad, una tendencia mes a mes hasta la fecha, y las filas de detalle del tramo que pediste.

Acota la lectura con `productIds` y `productVersionIds`. Omite `asOf` y Lender toma el día hábil corriente en Brasil.

## Préstamos morosos

***

`GET /api/v1/dashboard/delinquent-loans` devuelve el registro detrás de los números: las cuentas de préstamo que están en un tramo de morosidad, página por página, para que priorices cobranza y provisión. Pide un tramo con `bucketCode` — `current`, `1_30`, `31_60`, `61_90`, `91_plus`, o los acumulados `par30`, `par60` y `par90` — y acota al libro de un solo oficial de crédito con `assignedOfficerId`.

Brasil tiene un alias, `GET /api/v1/br/dashboard/delinquent-loans`, que agrega un filtro por la *carteira* regulatoria C1 a C5 de la Res. BCB 352/2023 a todos los filtros de arriba: la fecha de negocio, los productos, las versiones de producto, el tramo, el oficial de crédito y la paginación siguen valiendo. La carteira se deriva del producto, así que una que ningún producto declara devuelve una página vacía.

## De dónde salen los números

***

Un job nocturno de foto, apagado por defecto, mide cada cuenta de préstamo viva contra el día hábil y escribe la foto desde la que responden estas dos lecturas. El **barrido de promoción de PDD** descrito en el [Paquete regulatorio de Brasil](/es/products/lender/brazil-regulatory-pack) depende de la misma foto y la arma para su propio día hábil cuando nada más la armó, así que una instalación que deja el job de foto apagado y mantiene el barrido encendido igual tiene un libro medido.

<Warning>
  Una fecha de negocio que nadie midió se rechaza con `503`, nunca se responde con una página de ceros. Un libro sin medir y un libro sin nada en atraso producen los mismos números, y responder el primero como si fuera el segundo reportaría una cartera sana que nadie miró. Toma el rechazo como "reintenta", no como "el libro está vacío". El reintento solo pasa a responder cuando algún productor midió esa fecha: el [barrido nocturno de promoción de PDD](/es/products/lender/brazil-regulatory-pack#the-nightly-promotion-sweep), que viene encendido, o el job dedicado de foto, que viene apagado. Con los dos apagados, reintentar no sirve.
</Warning>

Cada respuesta carga su propia procedencia: de qué foto salió, la fecha de negocio que esa foto midió, cuándo se generó, si la política de frescura la considera vieja, y por qué.

## La auditoría es por cuenta

***

Las vistas de cartera son lecturas agregadas; el registro autoritativo e inmutable de lo que pasó con un préstamo puntual es su <GAuditTrail>rastro de auditoría</GAuditTrail> — `GET /api/v1/loan-accounts/{id}/audit-events`, cubierto en [Administrar un préstamo](/es/products/lender/service-a-loan). Cada pago, reversión y reproceso aterriza ahí.

## Próximos pasos

***

<Card title="Paquete regulatorio de Brasil" icon="brazilian-real-sign" href="/es/products/lender/brazil-regulatory-pack" horizontal>
  Etapas de PDD, el barrido nocturno de promoción y la provisión que mueven las etapas.
</Card>