O vocabulário
De onde vêm os termos 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 fatos contratados que o Lender registra, nunca valores que o Lender calcula. O Lender vincula esses termos a uma versão de produto de empréstimo. Os campos de valor e de taxa trafegam como strings decimais (nunca floats), de forma consistente com o modelo de dinheiro do ledger.
Garantias opcionais
Um contrato de consignado pode carregar garantia de FGTS e de verbas rescisórias junto com o desconto em folha. Um contrato ou declara garantia e carrega pelo menos um dos três valores, ou não declara nenhuma e não carrega nenhum.
Os dois campos de FGTS são valores monetários (strings decimais, escala 2). A fração de verbas usa uma string decimal (escala 8). O Lender valida cada campo.
A garantia fica fora do balanço: os saldos de FGTS ficam sob custódia da CAIXA e nunca são lançados no ledger. O Lender acompanha a garantia dada como um registro de domínio no contrato, não como um lançamento no Midaz.
O ciclo de vida do trilho
O trilho Dataprev combina comandos HTTP autenticados com fatos de negócio assíncronos. Em
develop, a API HTTP do Consignado admite averbação. O gateway não consome um comando de averbação vindo do stream do Lender.
- Os comandos do Lender usam
lerian.streaming.lender.commands. - Os fatos do Consignado usam
lerian.streaming.consignado-gw. - A identidade do evento vem de headers CloudEvent qualificados por source, não de um tópico por evento.
Use a referência da API do Consignado para comandos e consultas do trilho. Os contratos de produtor e consumidor ficam em Eventos do Lender e Eventos do Consignado.
Gate de contratação
O padrão de
CONSIGNADO_ENABLED é true. A rota de contratação, o assinador de CCB dela e o consumidor de entrada de averbação confirmada foram aposentados. Essa configuração agora controla apenas o tratamento legado de entrada de averbação rejeitada. A gestão da carteira de contratos existentes continua disponível. Quando você a desabilita, mantenha também CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED desligado. A inicialização rejeita essa configuração contraditória. Os fluxos substitutos de contabilização e pagamento se configuram de forma independente.
Opcional: conciliação com o Matcher
Essa 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 outro source, inspecione o manifesto de streaming dele 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 lançamento correspondente no ledger.
Próximos passos
Pacote regulatório Brasil
CET, IOF, consentimento de capitalização, estágios de PDD e o restante do perfil BR.
Eventos do Lender
O contrato de transmissão, os tópicos que o Lender publica e como um handler se mantém seguro.