Un mes por préstamo, en el aniversario del propio préstamo
El mes contable de un préstamo es su competência. La fecha de desembolso lo ancla, 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. Por eso una ejecución del 12 reconoce los préstamos con fecha de desembolso el 12, y pasa por alto el resto. Planifica el calendario en torno a esto. Para cubrir una cartera completa a lo largo de un mes, inicia una ejecución en cada fecha de negocio.
Lo que hace una ejecución
POST /api/v1/accrual-runs toma la fecha de negocio y el modo de la ejecución y, de forma opcional, 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.
1
Lender selecciona los préstamos
No envías una lista. Lender lee su propia cartera y toma cada cuenta de préstamo en una solicitud desembolsada o activa, dentro de los productos que acotaste. Una cuenta de préstamo que ya liquidó queda fuera. Una ejecución escanea hasta 10,000 cuentas de préstamo, así que acota una cartera más grande por producto e inicia más de una ejecución.
2
Lender reconoce los intereses
Para cada préstamo, Lender resuelve la tasa de interés efectiva del cronograma contractual y toma la línea de esa competência. El reconocimiento trabaja sobre los flujos de caja contractuales. Lo que pagó el prestatario no lo cambia.
3
Lender escribe el reconocimiento y la intención de asiento
Una sola transacción de base de datos guarda la ejecución, un ítem por reconocimiento y la intención de asiento balanceada detrás de cada ítem. O todo eso es durable, o nada lo es.
4
El relay entrega el asiento
Después de que la ejecución hace commit, el relay del outbox asienta la transacción balanceada en Midaz, y Midaz la contabiliza.
El monto que reconoce Lender
El reconocimiento sigue el método de la tasa de interés efectiva. El costo amortizado empieza en el capital que amortiza el cronograma, menos la comisión de originación. Los impuestos retenidos quedan fuera: 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í el interés reconocido reproduce el contrato en lugar de una tasa aparte que tú mantienes. Donde la jurisdicción grava los ingresos por intereses, la ejecución también reconoce ese impuesto. El impuesto es un segundo monto sobre el mismo préstamo y la misma competência, con su propio asiento balanceado. Los intereses y el impuesto nunca comparten una transacción.
Una vez por préstamo, por mes, por monto
Un reconocimiento es único por 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 los intereses y no encola un segundo asiento. Esa unicidad es la garantía de la ruta del dinero. También hace que una ejecución sea segura de repetir después de una interrupción.
Lo que 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 diario: 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.
La ejecución no escribe el asiento en el ledger
Una ejecución reconoce intereses y encola una intención de asiento. No llama a Midaz, y no espera una contabilización. El relay asienta después, y el ledger contabiliza 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 asiento pueda contabilizarse:
- Dale al perfil contable de la versión del producto una regla para el evento
accrual, con patas balanceadas. Donde la jurisdicción grava los ingresos por intereses, agrega también la regla opcionalaccrual_tax, así el impuesto tiene sus propias patas. - Lender siempre inicializa el outbox. Configura la conexión al ledger para que el relay pueda entregar la intención durable. Consulta Configuración y despliegue.
Préstamos que una ejecución pasa por alto
Un préstamo seleccionado aún puede no reconocer nada:
- La jurisdicción suspende su devengo. En Brasil, las dos etapas más profundas de la escalera de provisiones suspenden el devengo (consulta Paquete regulatorio de Brasil).
- La fecha de negocio no es uno de sus aniversarios.
- Sus intereses para esa competência son cero.
Ejecutar el devengo con una programación
La ejecución también tiene un driver programado dentro del servicio. Permanece apagado hasta que lo habilitas, y tú defines su expresión cron, que de forma predeterminada es el 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 propios de ese tenant. La ruta programada y la ruta de API usan el mismo código. Una ejecución desde cron y una ejecución desde una llamada se comportan igual.
Próximos pasos
Contabilidad y ejecuciones de devengo
Perfiles contables, reglas de asiento y las operaciones de referencia de diario.
Arquitectura de Lender
Los cinco dominios, la unión de jurisdicción y el outbox que saca el dinero.
Definir un producto de préstamo
Productos, versiones y el perfil contable del que depende una ejecución.
Paquete regulatorio de Brasil
Etapas de provisión, impuestos y las divulgaciones que agrega el perfil brasileño.