Saltar al contenido principal
Cada evento financiero de una jornada de crédito termina en el . La capa contable de Lender es cómo llega ahí: un producto declara sus reglas de posting una vez, y de ahí en adelante desembolsos, repagos, devengos y reversiones se contabilizan automática y rastreablemente.

​
Perfiles contables y reglas de posting

Un perfil contable ata una versión del producto al ledger. Define las reglas de posting — los asientos de que se disparan para cada tipo de evento financiero — y la organización de ledger y el ledger en los que se contabilizan las transacciones resultantes. Creas un perfil por producto: POST /api/v1/loan-products/{id}/accounting-profiles Las reglas de posting se validan cuando se crea el perfil, así un producto no puede salir a producción con asientos que no balancearían.

​
Intenciones de posting y el relay

Lender no llama al ledger de forma inline. Cuando ocurre un evento financiero, persiste una intención de posting durable en la misma transacción de base de datos que cambia el estado del dominio, y luego un relay contabiliza la transacción balanceada en Midaz de forma asíncrona. Esto es lo que hace confiables las contabilizaciones:
  • Sin postings perdidos — la intención se confirma junto con el cambio de estado, en un outbox transaccional.
  • Idempotente — cada posting lleva una clave determinista, así los reintentos colapsan a una sola transacción del ledger.
  • Falla cerrado — si el enrutamiento no puede resolver un destino de ledger no vacío, el posting se rechaza en lugar de escribirse en el lugar equivocado.
La ruta completa se describe en Lender en la plataforma.

​
Ejecuciones de devengo

El interés y otros montos basados en el tiempo se reconocen mediante una ejecución de devengo — un lote que calcula lo devengado durante un período en toda la cartera y produce los postings correspondientes.
1

Inicia una ejecución

POST /api/v1/accrual-runs encola una ejecución de devengo.
2

Reintenta si hace falta

POST /api/v1/accrual-runs/{id}/retry vuelve a encolar los ítems de una ejecución que no se completaron, sin volver a devengar lo que ya tuvo éxito.

​
Referencias de asiento

Una referencia de asiento ata un evento financiero de Lender a la transacción del ledger que lo registró, para que puedas rastrear un posting en ambas direcciones.
OperaciónPropósito
GET /api/v1/journal-referencesBusca una referencia de asiento por id de correlación.
GET /api/v1/journal-references/{id}Lee una referencia de asiento.
Reconcilia Lender contra el ledger por id de correlación: una referencia de asiento apunta a la transacción exacta de Midaz que produjo un repago o un devengo.

​
Próximos pasos

Portafolio y morosidad

Mira la cartera contabilizada en agregado.

Pack regulatorio de Brasil

Superpón CET, IOF y staging de PDD sobre el modelo contable.