Skip to main content
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 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 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.
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, 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: 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 — 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.