> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo funciona el devengo

> Qué hace una ejecución de devengo: el mes contable que reconoce, el monto que calcula, lo que produce la ejecución y adónde va el asiento resultante.

Lender no reconoce intereses de forma continua. Reconoce intereses en una **ejecución de devengo**. Una ejecución cubre una fecha de negocio, y por 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**. 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`.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.

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 los que Lender construye los asientos.

Usa el id de referencia de diario para atar la ejecución a tus propios registros contables: identifica exactamente una ejecución. El registro de 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](/es/products/lender/accounting-and-accrual-runs) cubre las dos operaciones que lo leen de vuelta.

## 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 opcional `accrual_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](/es/products/lender/configuration-and-deploy).

Configura el perfil antes de la primera ejecución. Sin una regla de devengo, Lender no tiene patas con las que construir un asiento, y la ejecución deja ese préstamo afuera.

## 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](/es/products/lender/brazil-regulatory-pack)).
* La fecha de negocio no es uno de sus aniversarios.
* Sus intereses para esa competência son cero.

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

## 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

***

<CardGroup cols={2}>
  <Card title="Contabilidad y ejecuciones de devengo" icon="calculator" href="/es/products/lender/accounting-and-accrual-runs">
    Perfiles contables, reglas de asiento y las operaciones de referencia de diario.
  </Card>

  <Card title="Arquitectura de Lender" icon="diagram-project" href="/es/products/lender/lender-architecture">
    Los cinco dominios, la unión de jurisdicción y el outbox que saca el dinero.
  </Card>

  <Card title="Definir un producto de préstamo" icon="layer-group" href="/es/products/lender/define-a-loan-product">
    Productos, versiones y el perfil contable del que depende una ejecución.
  </Card>

  <Card title="Paquete regulatorio de Brasil" icon="brazilian-real-sign" href="/es/products/lender/brazil-regulatory-pack">
    Etapas de provisión, impuestos y las divulgaciones que agrega el perfil brasileño.
  </Card>
</CardGroup>
