El vocabulario
De dónde vienen los términos 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 hechos contratados que Lender registra. Lender vincula esos términos a una versión de producto de préstamo. Los campos de dinero y de tasa viajan por el cable como cadenas decimales (nunca floats), en consonancia con el modelo de dinero del ledger.
Garantías opcionales (garantias)
Un contrato de consignado puede llevar garantías de FGTS y de beneficios por rescisión junto con el descuento en nómina. Un contrato declara garantías y lleva al menos uno de los tres montos, o no declara ninguna y no lleva ninguno.
Los dos campos de FGTS son montos de dinero (cadenas decimales, escala 2). La fracción de verbas usa una cadena decimal (escala 8). Lender valida cada campo.
Las garantías están fuera de balance: los saldos de FGTS quedan bajo custodia de CAIXA y nunca se contabilizan en el ledger. Lender rastrea la pignoración como un registro de dominio en el contrato, no como un asiento de Midaz.
El ciclo de vida del riel
El riel de Dataprev combina comandos HTTP autenticados con hechos de negocio asíncronos. La API HTTP de Consignado admite la averbação en dos llamadas. La averbação ejecuta el Manual 003 de Dataprev. Después, el anexo de CCB envía la CCB firmada y las evidencias de firma (Manual 004). El gateway no consume un comando de averbação desde el stream de Lender.
- Los comandos de Lender usan
lerian.streaming.lender.commands. - Los hechos de Consignado usan
lerian.streaming.consignado-gw. - Los hechos de Lender usan
lerian.streaming.lender. - La identidad del evento viene de los headers CloudEvent calificados por fuente, no de un tema por evento.
Usa la referencia de API de Consignado para los comandos y las consultas del riel. Los contratos de productor y de consumidor viven en Eventos de Lender y Eventos de Consignado.
Interruptor de la rail de nómina
El valor predeterminado de
CONSIGNADO_ENABLED es true. Este ajuste activa la rail de exclusión de nómina y controla el tratamiento de la averbación rechazada entrante. Cuando lo desactivas, Lender rechaza la liquidación, la liquidación por recuperación de garantía y la liquidación final de nómina de un contrato consignado. La liquidación por portabilidad no se rechaza. Mantén también CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED desactivado. El arranque rechaza esa configuración contradictoria. Los flujos de registro y de pago se configuran de forma independiente.
Opcional: conciliación con Matcher
Esta integración está controlada por configuración y requiere que Matcher use
STREAMING_CLOUDEVENTS_SOURCE=matcher. Lender consume entonces match_run.completed desde lerian.streaming.matcher y enruta ce-source: matcher, ce-type: studio.lerian.matcher.match_run.completed, ce-resourcetype: match_run y ce-eventtype: completed. Si Matcher usa otra fuente, inspecciona su manifiesto de streaming y alinea ambos lados antes de habilitar la integración.
Próximos pasos
Paquete regulatorio de Brasil
CET, IOF, consentimiento de capitalización, clasificación en etapas de PDD y el resto del perfil BR.
Eventos de Lender
El contrato de transmisión, los temas que publica Lender y cómo un handler se mantiene seguro.