Perfiles contables y reglas de asiento
Un perfil contable vincula una versión de producto al ledger. Define las reglas de asiento: las patas de que se disparan para cada tipo de evento financiero. También define la organización del ledger y el ledger en los que se contabilizan las transacciones resultantes. Creas un perfil por producto:
POST /api/v1/loan-products/{id}/accounting-profiles
Lender valida las reglas de asiento cuando creas el perfil. Por eso un producto no puede entrar en producción con patas que no cuadren.
Intenciones de asiento y el relay
Lender no llama al ledger en línea. Cuando ocurre un evento financiero, Lender persiste una intención de asiento durable. Esa escritura ocurre en la misma transacción de base de datos que cambia el estado del dominio. Después, un relay envía la transacción balanceada a Midaz de forma asíncrona. Esto es lo que hace confiables las contabilizaciones:
- La intención se confirma junto con el cambio de estado: ambos aterrizan en una sola transacción de base de datos, a través de un outbox transaccional.
- Idempotente: cada asiento lleva una clave determinista, así que los reintentos colapsan en una sola transacción del ledger.
- Falla cerrado: si el enrutamiento no puede resolver un destino de ledger no vacío, Lender rechaza el asiento y no lo escribe en el lugar equivocado.
Corridas de devengo
Una corrida de devengo reconoce los intereses y los demás montos basados en el tiempo. Una corrida toma cada préstamo cuyo aniversario cae en la fecha hábil de la corrida, y produce los asientos correspondientes.
POST /api/v1/accrual-runs empieza una corrida. Lender selecciona por sí mismo las cuentas de préstamo candidatas, reconoce los intereses por cuenta y escribe una intención de asiento por cada reconocimiento.
Referencias de diario
Cada corrida de devengo registra una referencia de diario, el identificador contable propio de la corrida. El registro de la referencia también guarda el id de correlación que Lender derivó para la corrida. El id de la referencia de diario identifica exactamente una corrida. Una lectura por id de correlación devuelve la corrida más reciente que comparte ese modo, esa fecha hábil y ese ámbito de producto.
Próximos pasos
Jurisdicciones
Mira cómo la jurisdicción activa moldea las divulgaciones y los endpoints.
Paquete regulatorio de Brasil
Suma el CET, el IOF y la clasificación en etapas de PDD sobre el modelo contable.

