> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Consignado privado

> A jornada brasileira principal do Lender — crédito com desconto em folha, da originação ativa (contratação ativa) até a assinatura da CCB e o acompanhamento do ciclo de vida da averbação.

export const GReconciliation = ({children}) => <Tooltip headline="Reconciliação" tip="O processo de comparar dois conjuntos de registros — por exemplo, seu ledger interno contra extratos bancários — para verificar se correspondem e sinalizar discrepâncias." cta="Ver glossário" href="/pt/glossary">
    {children}
  </Tooltip>;

export const GICPBrasil = ({children}) => <Tooltip headline="ICP-Brasil" tip="Infraestrutura de Chaves Públicas Brasileira — a infraestrutura oficial de chave pública do Brasil para certificados digitais. Documentos como a CCB de um contrato de crédito são assinados com um certificado ICP-Brasil válido para ter validade jurídica." cta="Ver glossário" href="/pt/glossary">
    {children}
  </Tooltip>;

O **consignado privado** é crédito com desconto em folha do setor privado: as parcelas são retidas na fonte do salário do tomador pelo empregador pagador. É a jornada mais profunda que o Lender oferece hoje — um contexto brasileiro delimitado completo sobre o [Pacote regulatório do Brasil](/pt/lender/brazil-regulatory-pack), com seu próprio fluxo de originação, instrumento de crédito e eventos de ciclo de vida.

## 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:

<Steps>
  <Step title="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.
  </Step>

  <Step title="Renderiza e assina a CCB">
    A **CCB** é renderizada como PDF e assinada com uma assinatura digital <GICPBrasil>ICP-Brasil</GICPBrasil>, produzindo o instrumento de crédito juridicamente vinculante.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Solicita a averbação">
    O Lender emite `consignado.averbacao.requested` para que um gateway externo de desconto em folha execute a averbação real junto à entidade pagadora.
  </Step>
</Steps>

A resposta reflete o progresso da **originação core** — aprovada na contratação. O **ciclo de vida da averbação** é acompanhado separadamente através de eventos, porque depende de a entidade pagadora agir.

## 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](/pt/lender/lender-in-the-platform) 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. |

Os campos de dinheiro e taxa cruzam o fio como strings decimais (nunca floats), consistente com o modelo de dinheiro do ledger.

## Opcional: reconciliação com o Matcher

***

<Warning>
  Esta integração fica **desligada por padrão** e é controlada por configuração. Documente-a e habilite-a apenas quando sua implantação a tiver ligado explicitamente.
</Warning>

Contratos de consignado podem ser opcionalmente reconciliados contra o [Matcher](/pt/matcher/what-is-matcher). Quando habilitada, um veredito de <GReconciliation>reconciliação</GReconciliation> 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

***

<Card title="Pacote regulatório do Brasil" icon="brazilian-real-sign" href="/pt/lender/brazil-regulatory-pack" horizontal>
  CET, IOF, consentimento de capitalização, staging de PDD e o resto do perfil BR.
</Card>

<Card title="O Lender na plataforma" icon="sitemap" href="/pt/lender/lender-in-the-platform" horizontal>
  Como os eventos e postings por trás desta jornada são entregues.
</Card>