> ## 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, qué produce la ejecución y a dónde va el posting resultante.

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

<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 de una solicitud desembolsada o activa, dentro de los productos que acotaste. Una cuenta de préstamo ya liquidada queda fuera. Una ejecución escanea hasta 10.000 cuentas de préstamo, así que acota una cartera mayor por producto y arranca más de una ejecución.
  </Step>

  <Step title="Lender reconoce el interés">
    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 posting">
    Una sola transacción de base de datos guarda la ejecución, un ítem por reconocimiento y la intención de posting balanceada detrás de cada ítem. O todo queda durable, o nada queda.
  </Step>

  <Step title="El relay entrega el posting">
    Después del commit de la ejecución, el relay del outbox contabiliza la transacción balanceada en Midaz, y Midaz la registra.
  </Step>
</Steps>

## 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](/es/lender/accounting-and-accrual-runs) 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](/es/lender/configuration-and-deploy).

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](/es/lender/brazil-regulatory-pack).
* 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

***

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

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

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

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