O vocabulário
| Termo | Significado |
|---|---|
| Consignado | Crédito com desconto em folha — os repagamentos são retidos do salário na fonte. |
| Averbação | Registro do desconto em folha junto à entidade pagadora, para que as parcelas sejam retidas a cada período. |
| Margem | A margem consignável — a parcela do salário disponível para o desconto. |
| Vínculo | O vínculo empregatício entre tomador e empregador contra o qual o empréstimo é descontado. |
| Competência | O período de folha (uma referência AAAAMM) em que uma parcela é descontada. |
| CCB | Cédula de Crédito Bancário — o instrumento de crédito bancário emitido e assinado para o contrato. |
Contratação ativa — originação numa única chamada
A originação ativa acontece através de um único endpoint:
POST /api/v1/br/consignado/contracts
Essa única chamada orquestra toda a originação:
Revalida a margem
O Lender revalida a margem consignável do tomador contra o vínculo empregatício antes de comprometer, assim um contrato nunca é originado além da margem disponível.
Renderiza e assina a CCB
A CCB é renderizada como PDF e assinada com uma assinatura digital , produzindo o instrumento de crédito juridicamente vinculante.
Cria e aprova a proposta core
O Lender cria e aprova a proposta de empréstimo core — que carrega sua extensão BR de consignado — e a persiste, reutilizando a mesma maquinaria de originação de qualquer outro empréstimo.
O ciclo de vida da averbação
Como a averbação acontece num rail externo de folha, o Lender a modela como uma conversa assíncrona sobre o backbone de streaming em vez de uma chamada síncrona. Por cima do catálogo de eventos core, o contexto de consignado contribui com seus próprios sinais:
| Evento | Direção | Significado |
|---|---|---|
consignado.margin.requested / consignado.margin.fetched | out / in | Pede ao rail a margem consignável, e a recebe. |
consignado.proposal.accepted | in | O tomador aceitou a proposta. |
consignado.averbacao.requested | out | Pede ao rail que registre o desconto em folha. |
consignado.averbacao.confirmed / consignado.averbacao.rejected | in | O rail confirmou ou recusou a averbação. |
consignado.exclusao.requested | out | Pede ao rail que remova um desconto registrado. |
consignado.reconciliation.received | in | Um veredito de reconciliação chegou para o contrato. |
Opcional: reconciliação com o Matcher
Contratos de consignado podem ser opcionalmente reconciliados contra o Matcher. Quando habilitada, um veredito de do Matcher sobre um contrato é traduzido em um efeito downstream sobre o empréstimo — uma transição de estágio de PDD e uma intenção de posting no ledger correspondente. Com a integração desligada, o consumidor de reconciliação é um no-op: nada é exigido para que a jornada core de consignado funcione.
Próximos passos
Pacote regulatório do Brasil
CET, IOF, consentimento de capitalização, staging de PDD e o resto do perfil BR.
O Lender na plataforma
Como os eventos e postings por trás desta jornada são entregues.