Cómo funciona el devengo

Lender no reconoce interés de forma continua. Lo reconoce en una ejecución de devengo. Una ejecución cubre una fecha de negocio y, para cada préstamo que selecciona, reconoce exactamente un mes contable.

​

Un mes por préstamo, en el aniversario del propio préstamo

---

El mes contable de un préstamo es su competência. Lo ancla la fecha de desembolso, no el calendario. Un préstamo desembolsado el 12 cierra cada competência el 12 de los meses siguientes. Un desembolso a fin de mes se ajusta al último día de un mes más corto. La fecha de negocio que le pasas a una ejecución selecciona la competência. Un préstamo reconoce solo cuando la fecha de negocio es uno de sus propios aniversarios. Una ejecución del 12 reconoce entonces los préstamos con fecha de desembolso el 12, y pasa por encima del resto. Planifica el calendario a partir de esto. Para cubrir toda la cartera a lo largo de un mes, arranca una ejecución en cada fecha de negocio.

​

Qué hace una ejecución

---

POST /api/v1/accrual-runs recibe la fecha de negocio y el modo de ejecución, y, opcionalmente, hasta 100 ids de producto de préstamo que acotan la ejecución. Tanto businessDate como mode son obligatorios. El driver programado envía monthly.

​

El monto que Lender reconoce

---

El reconocimiento sigue el método del interés efectivo. El costo amortizado arranca en el principal que amortiza el cronograma, menos la comisión de originación. Las retenciones quedan afuera: en Brasil, el IOF es un pass-through y nunca entra en el costo amortizado. Lender resuelve la tasa a partir del propio cronograma, así que el interés reconocido reproduce el contrato en lugar de una tasa aparte que tú mantengas. Donde la jurisdicción grava el ingreso por intereses, la ejecución reconoce también ese impuesto. El impuesto es un segundo monto sobre el mismo préstamo y la misma competência, con su propio posting balanceado. Interés e impuesto nunca comparten una transacción.

​

Una vez por préstamo, por mes, por monto

---

Un reconocimiento es único en tres cosas: la cuenta de préstamo, la competência y el tipo de monto. Una segunda ejecución para la misma fecha de negocio no reconoce nada nuevo para un préstamo ya reconocido. No duplica el interés ni encola un segundo posting. Esa unicidad es la garantía de la ruta del dinero. También hace que repetir una ejecución sea seguro tras una interrupción.

​

Qué produce una ejecución

---

Una ejecución responde con:

• El identificador de la ejecución y el estado de la ejecución.
• Una referencia de asiento — el identificador contable de la ejecución.
• El id de correlación que Lender deriva del modo, la fecha de negocio y los productos acotados.

Detrás de esa respuesta, la ejecución guarda un ítem por cada reconocimiento: la cuenta de préstamo, la competência, el tipo de monto y el monto. Esos ítems son con lo que Lender arma los postings. Usa el id de la referencia de asiento para atar la ejecución a tus propios registros contables: identifica una sola ejecución de forma exacta. El registro de la referencia también guarda el id de correlación y, como Lender deriva ese id del modo, la fecha de negocio y los productos acotados, una lectura por id de correlación devuelve la ejecución más reciente que lo comparte. Contabilidad y ejecuciones de devengo cubre las dos operaciones que la leen.

​

La ejecución no escribe el asiento en el ledger

---

Este límite importa. Una ejecución reconoce el interés y encola una intención de posting. No llama a Midaz y no espera una contabilización. El relay contabiliza después, y el ledger registra la transacción. Una ejecución exitosa significa que el reconocimiento y su intención son durables — no que el ledger ya muestre el asiento. Configura dos cosas antes de que un posting pueda contabilizarse:

• Dale al perfil contable de la versión del producto una regla para el evento accrual, con asientos balanceados. Donde la jurisdicción grava el ingreso por intereses, agrega también la regla opcional accrual_tax, para que el impuesto tenga asientos propios.
• Habilita el outbox y configura la conexión con el ledger. Consulta Configuración y despliegue.

Configura el perfil antes de la primera ejecución. Sin una regla de devengo, Lender no tiene asientos con los que armar un posting, y la ejecución deja ese préstamo afuera.

​

Préstamos que una ejecución pasa por alto

---

Un préstamo seleccionado todavía puede no reconocer nada:

• La jurisdicción suspende su devengo. En Brasil, las dos etapas más profundas de la escalera de provisión suspenden el devengo — consulta Pack regulatorio de Brasil.
• La fecha de negocio no es uno de sus aniversarios.
• Su interés para esa competência es cero.

Ninguno de estos casos falla la ejecución. Una ejecución reconoce lo que puede e informa lo que reconoció.

​

Devengo en un horario

---

La ejecución también tiene un driver programado dentro del servicio. Queda apagado hasta que lo habilitas, y tú fijas su expresión cron, que por defecto apunta al primer día de cada mes. Dale una expresión diaria: cada préstamo reconoce en su propio aniversario, así que solo un driver diario cubre toda la cartera a lo largo de un mes. Bajo multi-tenancy el driver corre una vez por cada tenant activo, contra los datos de ese tenant. La ruta programada y la ruta de la API usan el mismo código. Una ejecución desde cron y una ejecución desde una llamada se comportan igual.

​

Próximos pasos

---