El vocabulario
De dónde vienen las condiciones comerciales
Tu motor de crédito fija el precio de un préstamo consignado. La tasa, la tasa anual, el CET, el IOF y el plan de cuotas son datos contratados que Lender registra — nunca valores que Lender calcula. Lender vincula esas condiciones a una versión de producto de préstamo. Los campos de dinero y tasa cruzan el cable como strings decimales (nunca floats), consistente con el modelo de dinero del ledger.
Garantías opcionales
Un contrato de consignado puede llevar colaterales de FGTS y verbas rescisórias junto al descuento en nómina. Un contrato o declara colateral y lleva al menos uno de los tres montos, o no declara ninguno y no lleva ninguno.
Los dos campos de FGTS son montos de dinero (strings decimales, escala 2). La fracción de verbas es un string decimal (escala 8). Lender valida cada campo.
El colateral es off-balance: los saldos de FGTS permanecen en custodia de CAIXA y no postean al ledger. Lender rastrea la pignoración como un registro de dominio en el contrato, no como un posting en Midaz.
El ciclo de vida de la averbação
Como la averbação ocurre en un rail externo de nómina, Lender la modela como una conversación asíncrona sobre el backbone de streaming en lugar de una llamada síncrona. Lender publica sus comandos en sus propios topics
lender.*, y el gateway de descuento en nómina reporta los hechos de vuelta en topics consignado-gw.*.
Suscríbete por topic, y publica los hechos en el topic del gateway. El topic es la dirección en ambos lados.
El catálogo core que Lender publica alrededor de estos vive en Eventos de Lender.
Gate de contratación
CONSIGNADO_ENABLED tiene true como valor por defecto. Usa false solo para retirar intencionalmente la ruta de contratação, su firmante de CCB y los casos de uso entrantes de confirmación/rechazo de averbação. El servicing de contratos existentes sigue disponible. Cuando lo deshabilites, deja también apagados CONSUMER_CONSIGNADO_AVERBACAO_CONFIRMED_ENABLED y CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED; el arranque rechaza esa configuración contradictoria.
Opcional: reconciliación con Matcher
Los contratos de consignado pueden reconciliarse opcionalmente contra Matcher. Cuando está habilitada, un veredicto de de Matcher sobre un contrato se traduce en un efecto downstream sobre el préstamo — una transición de etapa de PDD y una intención de posting al ledger correspondiente. Con la integración desactivada, el consumidor de reconciliación es un no-op.
Próximos pasos
Pack regulatorio de Brasil
CET, IOF, consentimiento de capitalización, staging de PDD y el resto del perfil BR.
Eventos de Lender
El contrato de cable, los topics que Lender publica y cómo mantener seguro un handler.