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

> La jornada brasileña insignia de Lender — crédito con descuento en nómina, desde la originación activa (contratação ativa) hasta la firma de la CCB y el seguimiento del ciclo de vida de la averbação.

export const GReconciliation = ({children}) => <Tooltip headline="Reconciliación" tip="El proceso de comparar dos conjuntos de registros — por ejemplo, tu ledger interno contra extractos bancarios — para verificar que coincidan y señalar discrepancias." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GICPBrasil = ({children}) => <Tooltip headline="ICP-Brasil" tip="Infraestrutura de Chaves Públicas Brasileira — la infraestructura oficial de clave pública de Brasil para certificados digitales. Documentos como la CCB de un contrato de crédito se firman con un certificado ICP-Brasil válido para tener validez jurídica." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

El **consignado privado** es crédito con descuento en nómina del sector privado: las cuotas se retienen en la fuente del salario del deudor por el empleador pagador. Es la jornada más profunda que Lender ofrece hoy — un contexto brasileño acotado completo sobre el [Pack regulatorio de Brasil](/es/lender/brazil-regulatory-pack), con su propio flujo de originación, instrumento de crédito y eventos de ciclo de vida.

## El vocabulario

***

| Término         | Glosa                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Consignado**  | Crédito con descuento en nómina — los repagos se retienen del salario en la fuente.                     |
| **Averbação**   | Registro del descuento en nómina con la entidad pagadora, para que las cuotas se retengan cada período. |
| **Margem**      | El margen consignable — la porción del salario disponible para el descuento.                            |
| **Vínculo**     | El vínculo laboral entre deudor y empleador contra el que se descuenta el préstamo.                     |
| **Competência** | El período de nómina (una referencia `YYYYMM`) en el que se descuenta una cuota.                        |
| **CCB**         | *Cédula de Crédito Bancário* — el instrumento de crédito bancario emitido y firmado para el contrato.   |

## Contratação ativa — originación en una sola llamada

***

La originación activa ocurre a través de un único endpoint:

`POST /api/v1/br/consignado/contracts`

Esa única llamada orquesta toda la originación:

<Steps>
  <Step title="Revalida el margen">
    Lender revalida el **margem** consignable del deudor contra el **vínculo** laboral antes de comprometer, así un contrato nunca se origina más allá del margen disponible.
  </Step>

  <Step title="Renderiza y firma la CCB">
    La **CCB** se renderiza como PDF y se firma con una firma digital <GICPBrasil>ICP-Brasil</GICPBrasil>, produciendo el instrumento de crédito jurídicamente vinculante.
  </Step>

  <Step title="Crea y aprueba la solicitud core">
    Lender crea y aprueba la solicitud de préstamo core — que lleva su extensión BR de consignado — y la persiste, reutilizando la misma maquinaria de originación que cualquier otro préstamo.
  </Step>

  <Step title="Solicita la averbação">
    Lender emite `consignado.averbacao.requested` para que un gateway externo de descuento en nómina ejecute la averbação real con la entidad pagadora.
  </Step>
</Steps>

La respuesta refleja el progreso de la **originación core** — aprobada en la contratação. El **ciclo de vida de la averbação** se rastrea por separado a través de eventos, porque depende de que actúe la entidad pagadora.

## El ciclo de vida de la averbação

***

Como la averbação ocurre en un rail externo de nómina, Lender la modela como una conversación asíncrona sobre el backbone de streaming en lugar de una llamada síncrona. Encima del [catálogo de eventos](/es/lender/lender-in-the-platform) core, el contexto de consignado aporta sus propias señales:

| Evento                                                             | Dirección | Significado                                            |
| ------------------------------------------------------------------ | --------- | ------------------------------------------------------ |
| `consignado.margin.requested` / `consignado.margin.fetched`        | out / in  | Pide al rail el margen consignable, y recíbelo.        |
| `consignado.proposal.accepted`                                     | in        | El deudor aceptó la propuesta.                         |
| `consignado.averbacao.requested`                                   | out       | Pide al rail que registre el descuento en nómina.      |
| `consignado.averbacao.confirmed` / `consignado.averbacao.rejected` | in        | El rail confirmó o rechazó la averbação.               |
| `consignado.exclusao.requested`                                    | out       | Pide al rail que elimine un descuento registrado.      |
| `consignado.reconciliation.received`                               | in        | Llegó un veredicto de reconciliación para el contrato. |

Los campos de dinero y tasa cruzan el cable como strings decimales (nunca floats), consistente con el modelo de dinero del ledger.

## Opcional: reconciliación con Matcher

***

<Warning>
  Esta integración está **desactivada por defecto** y controlada por configuración. Documéntala y actívala solo cuando tu despliegue la haya habilitado explícitamente.
</Warning>

Los contratos de consignado pueden reconciliarse opcionalmente contra [Matcher](/es/matcher/what-is-matcher). Cuando está habilitada, un veredicto de <GReconciliation>reconciliación</GReconciliation> de Matcher sobre un contrato se traduce en un efecto downstream sobre el préstamo — una transición de etapa de PDD y una intención de posting al ledger correspondiente. Con la integración desactivada, el consumidor de reconciliación es un no-op: nada se requiere para que la jornada core de consignado funcione.

## Próximos pasos

***

<Card title="Pack regulatorio de Brasil" icon="brazilian-real-sign" href="/es/lender/brazil-regulatory-pack" horizontal>
  CET, IOF, consentimiento de capitalización, staging de PDD y el resto del perfil BR.
</Card>

<Card title="Lender en la plataforma" icon="sitemap" href="/es/lender/lender-in-the-platform" horizontal>
  Cómo se entregan los eventos y postings detrás de esta jornada.
</Card>