Saltar al contenido principal
La administración sigue cada cuenta de préstamo por separado. La superficie de cartera lee el libro en agregado. Con ella, ves la forma de la y cuáles préstamos se atrasan, 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 las hace suficientemente baratas para ponerlas en un panel. 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. El cuadro trae exposición pendiente, al día y morosa, el conteo de préstamos activos y morosos, y volumen de desembolso y de pago. También trae 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, y una tendencia mes a mes hasta la fecha. También vienen 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. Lender deriva la carteira 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 depende de la misma foto. Arma la foto para su propio día hábil cuando nada más la armó. Por eso, una instalación que deja el job de foto apagado y mantiene el barrido encendido igual tiene un libro medido.
Lender rechaza con 503 una fecha de negocio que nadie midió, y nunca la responde con una página de ceros. Un libro sin medir y un libro sin nada en atraso producen los mismos números. 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 productor es el barrido nocturno de promoción de PDD, que viene encendido, o el job dedicado de foto, que viene apagado. Con los dos apagados, reintentar no sirve.
Cada respuesta carga su propia procedencia. Nombra de qué foto salió, la fecha de negocio que esa foto midió y cuándo se generó. También dice 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 (GET /api/v1/loan-accounts/{id}/audit-events), cubierto en Administrar un préstamo. Cada pago, reversión y reproceso aterriza ahí.

​
Próximos pasos

Paquete regulatorio de Brasil

Etapas de PDD, el barrido nocturno de promoción y la provisión que mueven las etapas.