O vocabulário
De onde vêm as condições comerciais
Seu motor de crédito precifica um empréstimo consignado. A taxa, a taxa anual, o CET, o IOF e o plano de parcelas são dados contratados que o Lender registra — nunca valores que o Lender calcula. O Lender vincula essas condições a uma versão de produto de empréstimo. Os campos de dinheiro e taxa cruzam o fio como strings decimais (nunca floats), consistente com o modelo de dinheiro do ledger.
Garantias opcionais
Um contrato de consignado pode carregar colaterais de FGTS e verbas rescisórias junto ao desconto em folha. Um contrato ou declara colateral e carrega pelo menos um dos três valores, ou não declara nenhum e não carrega nenhum.
Os dois campos de FGTS são valores monetários (strings decimais, escala 2). A fração de verbas é uma string decimal (escala 8). O Lender valida cada campo.
O colateral é off-balance: os saldos de FGTS permanecem em custódia da CAIXA e nunca postam no ledger. O Lender acompanha o penhor como um registro de domínio no contrato, não como um posting no Midaz.
O ciclo de vida do trilho
O trilho da Dataprev combina comandos HTTP autenticados com fatos de negócio assíncronos. Em
develop, a averbação é admitida pela API HTTP de Consignado; o gateway não consome um comando de averbação do fluxo Lender.
- Os comandos do Lender usam
lerian.streaming.lender.commands. - Os fatos de Consignado usam
lerian.streaming.consignado-gw. - A identidade do evento vem dos cabeçalhos de CloudEvent qualificados pela fonte, não de um tópico por evento.
Use a referência da API de Consignado para comandos e consultas do trilho. Os contratos de produtor e consumidor estão em eventos do Lender e eventos de Consignado.
Gate de contratação
CONSIGNADO_ENABLED tem true como valor padrão. A rota de contratação, seu assinador de CCB e o consumidor de entrada de averbação confirmada foram retirados; essa configuração agora controla apenas o tratamento legado de entrada de averbação recusada. O servicing de contratos existentes continua disponível. Quando o desabilitar, mantenha também CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED desligado; a inicialização rejeita essa configuração contraditória. Os fluxos substitutos de booking e pagamento são configurados de modo independente.
Opcional: reconciliação com o Matcher
Esta integração é controlada por configuração e exige que o Matcher use
STREAMING_CLOUDEVENTS_SOURCE=matcher. O Lender então consome match_run.completed de lerian.streaming.matcher e roteia ce-source: matcher, ce-type: studio.lerian.matcher.match_run.completed, ce-resourcetype: match_run e ce-eventtype: completed. Se o Matcher usar outra fonte, consulte seu manifesto de streaming e alinhe os dois lados antes de habilitar a integração. O handler traduz o veredito em uma transição de estágio de PDD e na intenção de posting correspondente no ledger.
Próximos passos
Pacote regulatório do Brasil
CET, IOF, consentimento de capitalização, staging de PDD e o resto do perfil BR.
Eventos do Lender
O contrato de fio, os tópicos que o Lender publica e como manter um handler seguro.

