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

> Crédito con descuento en nómina en Brasil — el vocabulario, de dónde vienen las condiciones comerciales, el modelo de colateral y los topics 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>;

El **consignado privado** es crédito con descuento en nómina del sector privado. El empleador pagador retiene cada cuota en la fuente, del salario del deudor. Es un contexto brasileño acotado completo sobre el [Pack regulatorio de Brasil](/es/lender/brazil-regulatory-pack). Tiene su propio vocabulario, su propio modelo de colateral y sus propios topics 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 del préstamo.                         |

## De dónde vienen las condiciones comerciales

***

Tu motor de crédito fija el precio de un préstamo consignado. La tasa, la tasa anual, el CET, el IOF y el plan de cuotas son datos contratados que Lender registra — nunca valores que Lender calcula. Lender vincula esas condiciones a una versión de producto de préstamo.

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

## Garantías opcionales

***

Un contrato de consignado puede llevar colaterales de FGTS y verbas rescisórias junto al descuento en nómina. Un contrato o declara colateral y lleva al menos uno de los tres montos, o no declara ninguno y no lleva ninguno.

| Campo                              | Significado                                                     |
| ---------------------------------- | --------------------------------------------------------------- |
| `valorSaldoDisponivelGarantiaFgts` | Saldo de FGTS empeñado (proveniente de *consultar-saldo-fgts*). |
| `valorMultaRescisoriaGarantiaFgts` | Monto de multa rescisória de FGTS empeñado.                     |
| `percVerbaRescisoriaGarantia`      | Fracción de verbas rescisórias empeñada, con tope en `0.35`.    |

Los dos campos de FGTS son montos de dinero (strings decimales, escala 2). La fracción de verbas es un string decimal (escala 8). Lender valida cada campo.

El colateral es off-balance: los saldos de FGTS permanecen en custodia de CAIXA y no postean al ledger. Lender rastrea la pignoración como un registro de dominio en el contrato, no como un posting en Midaz.

## 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. Lender publica sus comandos en sus propios topics `lender.*`, y el gateway de descuento en nómina reporta los hechos de vuelta en topics `consignado-gw.*`.

**Suscríbete por topic, y publica los hechos en el topic del gateway.** El topic es la dirección en ambos lados.

| Topic                                                                                                        | Dirección | Significado                                                                                                            |
| ------------------------------------------------------------------------------------------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------- |
| `lender.consignado_exclusao.requested`                                                                       | out       | Pide al rail que elimine un descuento registrado.                                                                      |
| `lender.consignado_redirecionamento.requested`                                                               | out       | Pide al rail redirigir un contrato a un vínculo de reemplazo.                                                          |
| `consignado-gw.consignado_averbacao.confirmed` / `consignado-gw.consignado_averbacao.rejected`               | in        | El rail confirmó o rechazó la averbação.                                                                               |
| `consignado-gw.consignado_exclusao.confirmed` / `consignado-gw.consignado_exclusao.rejected`                 | in        | El rail confirmó o rechazó la eliminación.                                                                             |
| `consignado-gw.consignado_employment_status.reported`                                                        | in        | El rail reportó que un vínculo del trabajador fue suspendido o terminado.                                              |
| `consignado-gw.consignado_redirecionamento.confirmed` / `consignado-gw.consignado_redirecionamento.rejected` | in        | El rail confirmó o rechazó la redirección.                                                                             |
| `consignado-gw.consignado_reconciliation.received`                                                           | in        | Llegó un veredicto de reconciliación — escrituração de nómina, repasse CEF, CSV del portal o recuperación de garantía. |

El catálogo core que Lender publica alrededor de estos vive en [Eventos de Lender](/es/lender/lender-events).

## Gate de contratación

***

`CONSIGNADO_ENABLED` tiene `true` como valor por defecto. Usa `false` solo para retirar intencionalmente la ruta de contratação, su firmante de CCB y los casos de uso entrantes de confirmación/rechazo de averbação. El servicing de contratos existentes sigue disponible. Cuando lo deshabilites, deja también apagados `CONSUMER_CONSIGNADO_AVERBACAO_CONFIRMED_ENABLED` y `CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED`; el arranque rechaza esa configuración contradictoria.

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

## 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="Eventos de Lender" icon="tower-broadcast" href="/es/lender/lender-events" horizontal>
  El contrato de cable, los topics que Lender publica y cómo mantener seguro un handler.
</Card>
