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

# Mapea tu plan de cuentas

> Elige el ledger en el que Lender contabiliza, mapea cada evento contable a tus cuentas, lee el plan de vuelta y cámbialo después.

Lender contabiliza cada evento de dinero de un producto en el ledger (El libro financiero central que registra todas las transacciones, saldos y operaciones de una organización. Es la única fuente de verdad de las finanzas de una unidad de negocio.) del producto, en Midaz. Mapeas esos eventos a tus cuentas una vez, en un plan. Las cuentas son tuyas. Lender define la forma de cada asiento de partida doble (Cada movimiento financiero se registra como al menos dos operaciones: un débito en una cuenta y un crédito en otra, por lo que el sistema siempre cuadra.) y rechaza un plan que no cuadra.

Esta guía es para el back office y el contador del cliente. Cubre el ledger, los eventos contables y las cuentas que defines. [Contabilidad y corridas de devengo](https://docs.lerian.studio/es/products/lender/accounting-and-accrual-runs.md) cubre cómo llega un asiento al ledger.

## Antes de empezar

***

* Crea primero el producto de préstamo y una versión. Consulta [Definir un producto de préstamo](https://docs.lerian.studio/es/products/lender/define-a-loan-product.md).
* Para configurar un plan, tu rol necesita `loan_product` `write` y `accounting` `write`. Los roles operator, editor y admin tienen ambos.
* Para cambiar un plan, o para designar una cuenta de suspenso, tu rol necesita `accounting` `supersede`. Solo el rol admin lo tiene.

## El ledger del producto

***

Un plan nombra la organización de Midaz y el ledger de Midaz en los que se contabilizan los asientos del producto.

* En modo multi-tenant, la organización es obligatoria. En modo single-tenant, un plan sin destino usa el valor predeterminado del entorno.
* Nombra solo la organización, y Lender reutiliza el ledger en el que el producto ya contabiliza allí. Si el producto no tiene ninguno, Lender busca o crea un ledger llamado `lender-product-<loan product id>`. La respuesta nombra el ledger elegido.
* Toda versión de un producto contabiliza en el ledger que eligió la primera versión configurada (`LENDER-0453`). Varios productos pueden compartir un ledger.
* Lender rechaza un ledger con validación de rutas activada (`LENDER-0452`). Lender no envía ninguna ruta contable a Midaz.
* Lender rechaza una organización o un ledger que Midaz no conoce (`LENDER-0442`). Si Midaz no responde, Lender responde `503` con `LENDER-0441`. Repite la solicitud.

`MIDAZ_LEDGER_ACCOUNT_PROVISIONING_ENABLED` es `true` por defecto. Consulta [Configuración y despliegue](https://docs.lerian.studio/es/products/lender/configuration-and-deploy.md). Lender entonces adopta el activo por código o lo crea. Crea cada cuenta antes del primer asiento en ella.

* La naturaleza de una pierna define el tipo de cuenta. Una naturaleza de crédito crea una cuenta `deposit`. Una naturaleza de débito crea una cuenta `lender_debit`.
* La dirección de una cuenta queda fija cuando se crea la cuenta.
* Lender adopta una cuenta que ya existe. Compara la dirección de la cuenta con la naturaleza de la pierna y rechaza el asiento si difieren.

Una cuenta por contrato tiene el alias `<prefix>:<id>`. El prefijo es tuyo, con como máximo 17 caracteres. El id son los 32 dígitos hexadecimales del id de la cuenta de préstamo. Lender crea una cuenta por contrato para una posición del prestatario con el titular del CRM del contrato como dueño.

## Anatomía de una regla de asiento

***

Una **regla de asiento** mapea un evento contable a 2 a 16 piernas. Una regla también puede llevar `metadata`, un mapa de valores de texto. Cada pierna mueve dinero en una cuenta.

| Campo | Qué significa |
| - | - |
| `account` | La cuenta, como su alias en Midaz. Tiene como máximo 50 letras, dígitos, `:`, `_` y `-`, con una `@` inicial opcional. También puede ser `@external/<ASSET>`. Lender rechaza cualquier otra cosa (`LENDER-0429`). |
| `role` | El rol económico reservado de la pierna: `principal`, `interest`, `iof`, `tax`, `cash`, `unapplied_cash`, `counterparty` o `suspense`. |
| `component` | Un código abierto, como `iof`, para una pierna sin rol reservado. Define `role` o `component`, nunca ambos. |
| `side` | `debit` o `credit`. |
| `nature` | La naturaleza de la cuenta, no el lado de la pierna. Usa `debit` para un activo o un gasto. Usa `credit` para un pasivo, patrimonio o ingreso. Una cuenta regularizadora tiene su propia naturaleza: rendas a apropriar, cada provisión y el ajuste del art. 22 tienen naturaleza de crédito. Toda pierna que nombra una cuenta declara la misma naturaleza. |
| `optional` | Permite que Lender omita el monto de una pierna de componente, o lo asiente como cero. Solo una pierna de componente puede ser opcional. |
| `perOperation` | Contabiliza la pierna en una cuenta para cada contrato. `account` pasa a ser un prefijo de como máximo 17 caracteres. |

### Posiciones por contrato

Una pierna que contabiliza lo que debe un prestatario debe ser por contrato (`LENDER-0408`). Estos son los códigos de monto: `principal`, `interest`, `fees`, `penalties`, `unapplied_cash`, `assignment_retained` y `returned_payment`. Dos tipos de pierna son la excepción:

* Una pierna de ingreso o de gasto.
* El crédito de `accrual_withholding` en rendas a apropriar.

La comisión de originación retenida es por contrato en los dos extremos, en una sola cuenta: el crédito `origination_fee` en `disbursement` y el débito de `accrual_fee_amortization`. Una cuenta de comisión compartida se acepta, pero bloquea toda baja por pérdida (`LENDER-0411`), y ningún cambio de plan lo corrige.

Algunas cuentas nunca son por contrato:

* La cuenta del impuesto sobre el ingreso, porque es un pasivo de la institución con la autoridad fiscal (`LENDER-0419`).
* Una cuenta de ingreso o de gasto (`LENDER-0987`).
* La cuenta de contrapartida de `renegotiation_derecognition` y `renegotiation_recognition`. Esta cuenta puente es una sola cuenta para el producto.

### Ejemplo

Esta es la regla `disbursement` de un plan. Los códigos de cuenta son solo una ilustración.

```json theme={null}
{
  "eventType": "disbursement",
  "legs": [
    { "account": "1100-10-001", "role": "principal", "side": "debit", "nature": "debit", "perOperation": true },
    { "account": "@external/BRL", "role": "cash", "side": "credit", "nature": "debit" },
    { "account": "2300-40-001", "component": "iof", "side": "credit", "nature": "credit", "optional": true },
    { "account": "2400-10-001", "component": "origination_fee", "side": "credit", "nature": "credit", "optional": true, "perOperation": true }
  ]
}
```

`@external/<ASSET>` es la cuenta que Midaz crea para cada activo. Registra el dinero que entra al ledger o sale de él. Consulta [Cuentas](https://docs.lerian.studio/es/products/midaz/accounts.md).

Tu cuenta de tesorería puede estar en el mismo ledger. Entonces la pierna `cash` puede nombrarla. Lender activa el saldo negativo solo para las cuentas de crédito que lista para eso, y nunca para la cuenta `cash`. Consulta [Sobregiro de Saldo](https://docs.lerian.studio/es/products/midaz/balance-overdraft.md). Por eso Midaz rechaza un desembolso mayor que el saldo de esa cuenta. El asiento queda estacionado como un caso (`LENDER-0458`). Mantén el efectivo en la cuenta.

## Los eventos contables

***

Un plan puede llevar tres tipos de evento: eventos que todo plan necesita, eventos opcionales y eventos que Lender deriva.

### Eventos obligatorios

Lender rechaza un plan que no tiene uno de estos eventos.

| Evento | Lender asienta cuando | Qué contabilizan las piernas |
| - | - | - |
| `disbursement` | Lender libera un préstamo. | Un débito del principal por contrato. Un crédito del efectivo neto. Un crédito de cada impuesto que la jurisdicción retiene, como el IOF, y de la comisión de originación que retiene una versión. |
| `repayment` | Un pago salda una cuota. | Un débito del efectivo. Un crédito del principal y de los intereses que el pago salda, por contrato. La cuenta de intereses es la que `accrual` debita (`LENDER-0440`). |
| `prepayment` | Un prestatario paga un préstamo antes del cronograma, en todo o en parte. | Cinco piernas en este orden: débito `cash`, débito opcional `charge_rebate`, débito opcional `iof_refund`, crédito `principal`, crédito opcional `iof_due`. |
| `accrual` | Una corrida de devengo reconoce los intereses de un mes. | Un débito de los intereses por cobrar, por contrato. Un crédito del ingreso por intereses. |
| `accrual_withholding` | Los intereses se retienen en un activo problemático (Res. CMN 4.966 art. 17). | Un débito de los mismos intereses por cobrar que `accrual` debita. Un crédito de rendas a apropriar, en una cuenta compartida que no es el ingreso de `accrual`. |
| `renegotiation_gain` | Una renegociación no sustancial (Res. CMN 4.966 art. 22) deja una ganancia. | Un débito de la cuenta de ajuste del contrato. Un crédito de la ganancia. |
| `renegotiation_loss` | Una renegociación no sustancial (Res. CMN 4.966 art. 22) deja una pérdida. | Un débito de la pérdida. Un crédito de la cuenta de ajuste del contrato. |
| `collection_unapplied` | Llega un pago y el contrato lo mantiene como efectivo no aplicado. | Un débito de `cash`. Un crédito de `unapplied_cash`, por contrato. |
| `collection_reapply` | Lender aplica el efectivo no aplicado a una cuenta por cobrar, como hace la liquidación diaria en la fecha de vencimiento. | Un débito de `unapplied_cash`, su único débito. Un crédito de cada cuenta por cobrar que salda. |
| `collection_refund` | Lender devuelve el efectivo no aplicado al prestatario. | Un débito de `unapplied_cash`. Un crédito de `cash`. |
| `provision_constitution` | La medición de una fecha hábil aumenta la provisión adicional de un contrato. | Un débito del gasto. Un crédito de la provisión. El evento lleva solo el aumento. |
| `provision_reversal` | La medición de una fecha hábil reduce esa provisión. | Un débito de la provisión. Un crédito de una cuenta de gasto o de ingreso por reversión. |
| `provision_incurred_constitution` | La medición de una fecha hábil aumenta la pérdida incurrida (Res. BCB 352 art. 76). | Un débito del gasto. Un crédito de la provisión de la pérdida incurrida. |
| `provision_incurred_reversal` | La medición de una fecha hábil reduce la pérdida incurrida. | Un débito de esa provisión. Un crédito de una cuenta de gasto o de ingreso por reversión. |

Las dos constituciones acreditan dos cuentas de provisión distintas. Lender rechaza un plan que acredita una sola cuenta para ambas (`LENDER-0455`).

### Eventos opcionales

La última columna dice qué pasa si la dejas fuera.

| Familia | Eventos | Inclúyela cuando | Sin ella |
| - | - | - | - |
| Impuesto sobre el ingreso | `accrual_tax` | El ingreso por intereses paga PIS/COFINS. | La corrida de devengo calcula el impuesto y no asienta nada. Cuenta el impuesto como reconocido y no asentado. |
| Comisión de originación retenida | `accrual_fee_amortization`, más la pierna opcional `origination_fee` en `disbursement` | El producto retiene una comisión de originación en el desembolso. Contabilízala por contrato, en una sola cuenta. | Lender rechaza cada centavo de la comisión. |
| Cargo aplicado después de la liberación | `charge_appropriation`, más una pierna de crédito `fees` por contrato en `repayment` | Una versión declara una plantilla de cargo que un operador puede aplicar después de la liberación. La plantilla tiene un monto fijo. | Lender rechaza el plan (`LENDER-0989`). |
| Renegociación sustancial | `renegotiation_derecognition`, `renegotiation_recognition` | El producto renegocia de forma sustancial según la Res. CMN 4.966 art. 22. El contrato antiguo termina y empieza uno nuevo. | Un producto debe llevar ambos eventos para renegociarse de forma sustancial. |
| Cesión, riesgo transferido | `assignment_derecognition`, `assignment_retained_settlement` | Vendes cuentas por cobrar a un fondo. El segundo evento hace falta para vender una cuenta por cobrar a mitad de un ciclo. | Lender rechaza la aceptación de una venta sobre un producto sin `assignment_derecognition` y abre un caso de excepción. |
| Cesión, riesgo retenido | `assignment_secured_borrowing`, `assignment_funding_amortization`, `assignment_funding_payoff` | Vendes cuentas por cobrar y respondes por ellas. Los dos primeros van juntos. El tercero aún no es obligatorio. | Lender rechaza una venta con riesgo retenido sobre un producto que no tiene los dos primeros. |
| Recompra de cesión | `assignment_repurchase` | Un bancarizador puede liquidar antes una cuenta por cobrar vendida. | Lender rechaza el recibo de liquidación del fondo. |
| Refinanciación | `refinance_payoff`, `refinance_payoff_reversal` | El producto se refinancia. | Un producto debe llevar ambos eventos para refinanciarse. |
| Pago devuelto | `returned_payment_recognition`, `returned_payment_provision_constitution`, `returned_payment_provision_reversal`, `returned_payment_write_off` | Los pagos finales pueden devolverse después de que termina el mandato de nómina. | Lender rechaza un plan que lleva el primer evento sin los otros tres (`LENDER-0406`). |
| Remesa del empleador | `payroll_payer_provision_constitution`, `payroll_payer_provision_reversal` | La regla `repayment` lleva la pierna `payroll_payer_receivable`. | Lender rechaza el plan (`LENDER-0423`). |
| Cuentas de compensación | `compensation_control`, con los controles `written_off_credit` y `guarantee_received` | Mantienes controles fuera de balance para crédito dado de baja o para garantías. | Lender rechaza una baja y no escribe nada (`LENDER-0975`). |
| Recuperación de crédito dado de baja | `credit_loss_recovery` | Un prestatario con crédito dado de baja puede pagar después. | Lender rechaza la recuperación y no escribe nada (`LENDER-0980`). |

Para los eventos de cesión, consulta [Ceder cuentas por cobrar](https://docs.lerian.studio/es/products/lender/assignment-of-receivables.md).

### Eventos que no configuras

Lender deriva estos eventos de las reglas anteriores. Un plan no puede llevarlos. Si envías uno, Lender responde `422`.

| Evento | Contabiliza en las cuentas de | Qué hace |
| - | - | - |
| `reversal` | `repayment` | Revierte un pago. Invierte el lado de cada pierna del pago. |
| `accrual_reversal` | `accrual` | Saca del ingreso los intereses que un cierre contabilizó más allá del contrato. |
| `accrual_withholding_reversal` | `accrual_withholding` | Saca de rendas a apropriar los intereses que un cierre retuvo más allá del contrato. |
| `accrual_suspension` | `accrual`, `accrual_withholding` | Saca otra vez del ingreso los intereses de un mes cerrado, cuando una caracterización tardía convierte el contrato en un activo problemático dentro de ese mes. |
| `accrual_tax_suspension` | `accrual_tax` | Devuelve el PIS/COFINS que un mes cerrado contabilizó sobre los intereses que mueve la suspensión. |
| `suspended_income_recognition` | `accrual`, `accrual_withholding` | Reconoce como ingreso los intereses retenidos cuando llega el cobro. |
| `accrual_fee_amortization_reversal` | `accrual_fee_amortization` | Devuelve la comisión liberada más allá de una revaluación. |
| `interest_capitalization` | `disbursement`, `accrual` | Mueve de los intereses por cobrar al principal por cobrar los intereses facturados que una reprogramación llevó al principal. |
| `interest_unapplied` | `repayment`, `collection_unapplied` | Mueve de los intereses por cobrar al efectivo no aplicado, adeudado de vuelta al prestatario, los cobros de intereses pagados por días posteriores a una liquidación. |
| `modification_tax` | `disbursement` | Financia en el principal el impuesto que cobra una modificación del cronograma. |
| `late_charge_recognition` | `repayment`, `accrual` | Reconoce como ingreso la multa y los intereses de mora recibidos. |
| `late_charge_recognition_reversal` | `repayment`, `accrual` | Devuelve ese ingreso. |
| `late_charge_capitalization` | `disbursement`, `repayment` | Mueve al principal un cargo por mora reconocido que una reprogramación llevó al principal. |
| `late_charge_withholding` | `repayment`, `accrual_withholding` | Mantiene fuera del ingreso el cargo por mora que una reprogramación llevó a un contrato que el art. 17 suspende. |
| `late_charge_waiver` | `renegotiation_loss`, `repayment` | Lleva a la pérdida del art. 22 el cargo por mora que una reprogramación condonó. |
| `renegotiation_loss_unwind` | `accrual`, `renegotiation_loss` | Reconoce de vuelta un ajuste del art. 22 a medida que corre el contrato. |
| `renegotiation_gain_unwind` | `accrual`, `renegotiation_loss` | El espejo de la reversión gradual de la pérdida. |
| `renegotiation_gain_reversal` | `renegotiation_gain` | Saca del resultado una ganancia del primer día mientras el art. 17 la retiene. |
| `collection_reapply_reversal` | `collection_reapply` | Devuelve al efectivo no aplicado una liquidación hecha en la fecha de vencimiento. |
| `refinance_disbursement_reversal` | `disbursement` | Cierra el contrato nuevo de una refinanciación que el riel deshizo. |
| `returned_payment_collection` | `returned_payment_recognition` | Contabiliza de vuelta la deuda de pago devuelto cuando el prestatario paga por otro medio. |
| `charge_assessment` | `repayment`, `charge_appropriation` | Cobra un cargo aplicado cuando Lender lo aplica, contra las cuentas por cobrar de cargos del contrato. |
| `charge_appropriation_reversal` | `charge_appropriation` | Revierte una apropiación de cargo. |
| `compensation_control_release` | `compensation_control` | Libera un control. Es la regla de apertura con los lados invertidos. |
| `credit_loss_recovery_reversal` | `credit_loss_recovery` | Devuelve una recuperación, en las cuentas en que la contabilizó la recuperación. |

## Verificaciones que Lender hace a tu plan

***

Lender verifica el plan cuando lo configuras o lo cambias. No escribe nada cuando una verificación falla.

| Código | Se rechaza cuando | Corrección |
| - | - | - |
| `LENDER-0406` | El plan lleva `returned_payment_recognition` sin las tres reglas que provisionan y dan de baja la deuda. | Agrega las tres reglas y reenvía. |
| `LENDER-0408` | Una pierna contabiliza una posición del prestatario en una cuenta que todos los contratos comparten. | Contabiliza esa pierna por contrato. |
| `LENDER-0419` | El impuesto sobre el ingreso se contabiliza por contrato. | Contabiliza las dos piernas del impuesto en cuentas compartidas de la institución. |
| `LENDER-0423` | La regla `repayment` lleva `payroll_payer_receivable` y el plan no tiene el par de provisión del empleador. | Agrega las dos reglas `payroll_payer_provision_*` y reenvía. |
| `LENDER-0426` | Una versión cobra multa e intereses de mora y `repayment` no tiene una pierna de crédito `penalties` por contrato. | Agrega una pierna de crédito con `component` `penalties` y `perOperation` true. |
| `LENDER-0429` | Una cuenta no es un alias de Midaz. | Reescribe la cuenta, por ejemplo `1100-10-001`. |
| `LENDER-0430` | La jurisdicción retiene un impuesto en el desembolso y `disbursement` no tiene una pierna de crédito para él. | Agrega una pierna de crédito con ese `component`, por ejemplo `iof`. Márcala como `optional` si algunas versiones no retienen nada. |
| `LENDER-0440` | `repayment` no tiene una pierna de crédito `interest`. | Agrega una en la cuenta que `accrual` debita. |
| `LENDER-0442` | Midaz no conoce la organización, o ningún ledger en ella, con esos ids. | Corrige `midazOrganizationId` y `midazLedgerId`. |
| `LENDER-0452` | El ledger tiene activada la validación de rutas de Midaz. | Desactívala en el ledger, o nombra otro ledger. |
| `LENDER-0453` | El producto ya contabiliza en otro ledger. | Nombra el ledger del detalle, o solo su organización. |
| `LENDER-0455` | Las dos constituciones de provisión acreditan una sola cuenta de provisión. | Acredita una provisión separada para la pérdida incurrida. |
| `LENDER-0987` | Una pierna de ingreso o de gasto se contabiliza por contrato. | Contabiliza cada pierna de ingreso y de gasto en una cuenta compartida. |
| `LENDER-0989` | El plan no puede contabilizar un cargo aplicado después de la liberación. | Agrega la pierna de crédito `fees` por contrato a `repayment` y la regla `charge_appropriation`, cada una en una cuenta propia. |

Configurar un plan para una versión que ya tiene uno responde `409 Conflict`.

La [lista de errores de Lender](https://docs.lerian.studio/es/reference/products/lender/lender-error-list.md) trae el texto completo de cada código.

## Lee un plan de vuelta

***

| Operación | Finalidad |
| - | - |
| `GET /api/v1/accounting-profiles` | Listar los planes con su cobertura. |
| `GET /api/v1/accounting-profiles/{id}` | Leer un plan completo. |

La lista muestra, para cada plan, `eventTypes`, `missingEventTypes`, `effectiveFrom` y `createdAt`. `missingEventTypes` nombra los eventos obligatorios para los que el plan no tiene regla. Queda vacía cuando el plan está completo.

La lectura por id devuelve el plan completo. Trae `postingRules` con las piernas, `midazOrganizationId`, `midazLedgerId`, `effectiveFrom` y `createdAt`. No tiene campo de cobertura. Un id que Lender no conoce responde `404` con `LENDER-0454`.

## Cambia el plan

***

Configuras una versión una vez. Su primer plan rige desde `1900-01-01`, y una segunda llamada de configuración responde `409`. Todo plan es inmutable. Una versión guarda una cadena de planes con fecha, y un cambio agrega un plan con fecha a toda versión configurada del producto.

Un cambio pertenece al producto, no a una versión.

`POST /api/v1/loan-products/{id}/accounting-profiles/supersessions`

El cuerpo trae el plan nuevo completo y `effectiveFrom`. `effectiveFrom` es siempre el primer día de un mes que aún no ha abierto mañana. El último día de un mes, la opción más temprana es el primer día del mes después del siguiente. El plan nuevo contabiliza en el mismo ledger que el anterior (`LENDER-0443`).

El plan nuevo mantiene toda posición por contrato del plan anterior. Una cuenta compartida de saldo mantiene su cuenta y su modo: una provisión, un valor por pagar o el efectivo. Las cuentas de ingreso y de gasto pueden cambiar. Lender rechaza un cambio que envía dos posiciones de una cuenta por contrato a cuentas distintas (`LENDER-0986`).

El plan vigente en un día es el plan con el mayor `effectiveFrom` hasta ese día. Un contrato queda en el plan que guarda su saldo hasta que el saldo se transfiere.

**1. Registra el cambio**

Envía el cambio. Lee `movedPositions` en la respuesta. Lista cada posición cuyo saldo cambia de cuenta.

**2. Deja que los saldos se muevan**

El saldo de un contrato se mueve dentro de su primer asiento después del cambio. El cierre del mes de vigencia mueve los contratos que no tuvieron asiento. No hace falta nada más.

**3. Opcional: barre los contratos que aún esperan**

Después del cierre del mes anterior a la vigencia, `POST /api/v1/loan-products/{id}/accounting-profiles/supersessions/sweeps` los mueve ahora, con un asiento por contrato. Exige el header `X-Idempotency`. Cada repetición exige una clave nueva, porque la misma clave devuelve la respuesta anterior.

**4. Resuelve lo que detiene a un contrato**

`LENDER-0450` lista las causas posibles, no la que vale para un contrato, y todo contrato que estaba listo se movió. Revisa en este orden: el cierre del mes anterior a la vigencia; un cambio anterior que sigue abierto (barre ese primero); asientos estacionados (consulta [Contabilidad y corridas de devengo](https://docs.lerian.studio/es/products/lender/accounting-and-accrual-runs.md)); un monto que el ledger retiene. Luego repite el barrido con una clave `X-Idempotency` nueva. No repitas en bucle.

En el Console, consulta **Chart of accounts changes** y **Move waiting contracts** en [Crédito](https://docs.lerian.studio/es/products/lender/console/credit.md).

## Cuentas de suspenso

***

Algunos asientos necesitan una cuenta de suspenso. Un desembolso en partes y un ajuste compensatorio las usan. Designas una cuenta para cada moneda y rol.

| Rol | Qué recibe | Cuenta predeterminada para BRL |
| - | - | - |
| `suspense` | El residuo de la CCB, de cualquier lado. | `suspensao-brl`, naturaleza de crédito |
| `below` | Lo que un desembolso en partes aún debe al prestatario. | `valores-a-liberar-brl`, naturaleza de crédito |
| `above` | Lo que el prestatario pagó por encima del valor liberado. | `pago-a-maior-brl`, naturaleza de débito |
| `loss` | El gasto de un exceso de desembolso que se queda el prestatario. | `perdas-brl`, naturaleza de débito |

`PUT /api/v1/internal/accounting/suspense-accounts/{currency}/{role}` designa la cuenta, con `gl_account` en el cuerpo. Una cuenta designada debe existir ya en el ledger. Lender nunca la crea, a menos que tenga el nombre exacto del valor predeterminado.

Un contrato conserva la cuenta que guarda su primer monto en un rol. Una cuenta nueva rige para los contratos que aún no tienen ninguna. Cuando Lender aprovisiona las cuentas del ledger, un rol en BRL sin cuenta designada contabiliza en el valor predeterminado. `GET` en la misma ruta responde `404` con `LENDER-0449` cuando no designaste ninguna. Consulta [Contabilidad](https://docs.lerian.studio/es/products/lender/console/accounting.md).

## En el Console

***

La pantalla para configurar un plan exige los mismos dos permisos que la API. Abre **Credit**, abre el producto y la versión, y elige la acción de configurar el perfil contable. Consulta [Crédito](https://docs.lerian.studio/es/products/lender/console/credit.md).

**1. Elige la institución financiera**

**Financial institution** nombra la organización. Lender crea en ella el ledger del producto, o reutiliza el ledger que ya creó.

**2. Revisa la hoja**

La hoja empieza como una copia del plan más reciente del producto, cuando la pantalla puede editar todas sus reglas. Revisa cada cuenta antes de registrar.

**3. Marca las piernas por contrato**

Marca como **Per contract** cada pierna que contabiliza una posición del prestatario.

**4. Registra el plan**

**Record accounting profile** guarda el plan de forma definitiva. Cerrar la página descarta una hoja que no registraste.

La pantalla registra estos eventos: los eventos obligatorios, `payroll_payer_provision_constitution`, `payroll_payer_provision_reversal`, `refinance_payoff`, `refinance_payoff_reversal`, `assignment_derecognition`, `assignment_retained_settlement`, `assignment_repurchase`, `credit_loss_recovery` y `compensation_control`.

La pantalla no registra estos eventos: `accrual_fee_amortization`, `charge_appropriation`, `renegotiation_derecognition`, `renegotiation_recognition`, `assignment_secured_borrowing`, `assignment_funding_amortization`, `assignment_funding_payoff` y los cuatro eventos `returned_payment_*`. Para llevar uno de ellos, envía el plan con `POST /api/v1/loan-products/{id}/accounting-profiles`, con los mismos dos permisos. Un producto solo renegocia de forma sustancial con el par `renegotiation_derecognition` y `renegotiation_recognition`, así que envías ese plan por la API.

La pantalla no copia un plan que tiene una regla que ella no edita. La hoja abre entonces vacía, y el aviso **This chart has rules this screen cannot edit** nombra esas reglas.

## Concilia con Midaz

***

Cada asiento es una transacción de Midaz. Usa estos campos para encontrarla.

| Campo de Midaz | Qué pone Lender en él |
| - | - |
| Descripción | El evento, dos puntos y la referencia del origen: `<eventType>:<reference>`. |
| Metadata `correlationId` | La clave del asiento. |
| Metadata `loanAccountId` | La cuenta de préstamo del asiento, cuando se conoce. |
| Metadata `requestId` | La solicitud de API que causó el asiento, cuando se conoce. |

Consulta [Contabilidad y corridas de devengo](https://docs.lerian.studio/es/products/lender/accounting-and-accrual-runs.md) para recibos, referencias de diario y asientos estacionados.

## Próximos pasos

***

> [card] [Contabilidad y corridas de devengo](https://docs.lerian.studio/es/products/lender/accounting-and-accrual-runs.md)
>
> Mira cómo llega un asiento al ledger y cómo las corridas de devengo contabilizan intereses.

> [card] [Definir un producto de préstamo](https://docs.lerian.studio/es/products/lender/define-a-loan-product.md)
>
> Crea el producto y la versión que el plan atiende.

> [card] [Crédito en el Console](https://docs.lerian.studio/es/products/lender/console/credit.md)
>
> Configura el plan y ejecuta cambios de plan en el Console.

> [card] [Paquete regulatorio de Brasil](https://docs.lerian.studio/es/products/lender/brazil-regulatory-pack.md)
>
> Superpón CET, IOF y etapas de PDD sobre el modelo contable.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.