Perfiles contables y reglas de posting
Un perfil contable ata una versión del producto al ledger. Define las reglas de posting — los asientos de que se disparan para cada tipo de evento financiero — y la organización de 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
Las reglas de posting se validan cuando se crea el perfil, así un producto no puede salir a producción con asientos que no balancearían.
Intenciones de posting y el relay
Lender no llama al ledger de forma inline. Cuando ocurre un evento financiero, persiste una intención de posting durable en la misma transacción de base de datos que cambia el estado del dominio, y luego un relay contabiliza la transacción balanceada en 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 caen en una sola transacción de base de datos, a través de un outbox transaccional.
- Idempotente — cada posting lleva una clave determinista, así los reintentos colapsan a una sola transacción del ledger.
- Falla cerrado — si el enrutamiento no puede resolver un destino de ledger no vacío, el posting se rechaza en lugar de escribirse en el lugar equivocado.
Ejecuciones de devengo
Una ejecución de devengo reconoce el interés y los demás montos basados en el tiempo. Una ejecución toma cada préstamo cuyo aniversario cae en su fecha de negocio, y produce los postings correspondientes.
POST /api/v1/accrual-runs inicia una ejecución. Lender selecciona por su cuenta las cuentas de préstamo candidatas, reconoce el interés de cada una y escribe una intención de posting por reconocimiento.
Referencias de asiento
Cada ejecución de devengo registra una referencia de asiento — el identificador contable de la propia ejecución. El registro de la referencia también guarda el id de correlación que Lender derivó para la ejecución. El id de la referencia de asiento identifica una sola ejecución de forma exacta; una lectura por id de correlación devuelve la ejecución más reciente que comparte ese modo, esa fecha de negocio y esos productos acotados.
Próximos pasos
Jurisdicciones
Mira cómo la jurisdicción activa moldea las divulgaciones y los endpoints.
Pack regulatorio de Brasil
Superpón CET, IOF y staging de PDD sobre el modelo contable.

