> ## 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 > Préstamos con descuento en nómina en Brasil: el vocabulario, de dónde vienen los términos comerciales, el modelo de garantías y los temas de ciclo de vida de la averbação. **Consignado privado** es el préstamo del sector privado con descuento en nómina. El empleador pagador retiene cada cuota en la fuente, del salario del prestatario. Funciona como un contexto acotado brasileño completo sobre el [Paquete regulatorio de Brasil](/es/products/lender/brazil-regulatory-pack). Tiene su propio vocabulario, su propio modelo de garantías y sus propios temas de ciclo de vida. ## El vocabulario *** | Término | Glosa | | --------------- | ----------------------------------------------------------------------------------------------------------- | | **Consignado** | Crédito con descuento en nómina — los pagos se retienen del salario en la fuente. | | **Averbação** | Registro del descuento en nómina ante la entidad pagadora, para que las cuotas se retengan en cada período. | | **Margem** | El margen consignable — la porción del salario disponible para el descuento. | | **Vínculo** | El vínculo laboral entre prestatario 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 los términos 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 hechos contratados que Lender registra, nunca valores que Lender calcula. Lender vincula esos términos a una versión de producto de préstamo. Los campos de dinero y de tasa viajan por el cable como cadenas decimales (nunca floats), en consonancia con el modelo de dinero del ledger. ## Garantías opcionales (garantias) *** Un contrato de consignado puede llevar garantías de FGTS y de beneficios por rescisión junto con el descuento en nómina. Un contrato declara garantías y lleva al menos uno de los tres montos, o no declara ninguna y no lleva ninguno. | Campo | Significado | | ---------------------------------- | ------------------------------------------------------------------- | | `valorSaldoDisponivelGarantiaFgts` | Monto del saldo de FGTS pignorado (desde *consultar-saldo-fgts*). | | `valorMultaRescisoriaGarantiaFgts` | Monto de la multa por rescisión de FGTS pignorado. | | `percVerbaRescisoriaGarantia` | Fracción de las verbas por rescisión pignorada, con tope en `0.35`. | Los dos campos de FGTS son montos de dinero (cadenas decimales, escala 2). La fracción de verbas usa una cadena decimal (escala 8). Lender valida cada campo. Las garantías están fuera de balance: los saldos de FGTS quedan bajo custodia de CAIXA y nunca se contabilizan en el ledger. Lender rastrea la pignoración como un registro de dominio en el contrato, no como un asiento de Midaz. ## El ciclo de vida del riel *** El riel de Dataprev combina comandos HTTP autenticados con hechos de negocio asíncronos. En `develop`, la API HTTP de Consignado admite la averbação. El gateway no consume un comando de averbação desde el stream de Lender. * Los comandos de Lender usan `lerian.streaming.lender.commands`. * Los hechos de Consignado usan `lerian.streaming.consignado-gw`. * La identidad del evento viene de los headers CloudEvent calificados por fuente, no de un tema por evento. | Clave del evento | Dirección | Comportamiento en ejecución | | ------------------------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `consignado.redirecionamento.requested` | salida | El gateway ejecuta el comando cuando hay un adaptador conectado y, en caso contrario, devuelve un rechazo con nombre. | | `consignado.exclusao.requested` | salida | El gateway resuelve el mismo servicio idempotente de exclusión que HTTP; cuando el runtime no está disponible devuelve un error con nombre. | | `consignado.contract.registered` / `consignado.disbursement.confirmed` | entrada | Hechos de contabilización y de comprobante de pago. | | `consignado.averbacao.rejected` / `consignado.employment_status.reported` | entrada | Hechos de rechazo y de estado laboral. | | `consignado.redirecionamento.confirmed` / `consignado.redirecionamento.rejected` | entrada | Resultados de la redirección. | | `consignado.exclusao.confirmed` / `consignado.exclusao.rejected` | entrada | Resultados de la exclusión. | | `consignado.reconciliation.received` | entrada | Conciliación de la contabilidad de nómina, del repasse de CEF, del CSV del portal o de la recuperación de garantías. | | `consignado.contract_correction.available` / `consignado.disbursement_correction.available` | entrada | El gateway publica punteros autenticados a recursos de CCB o de pago corregidos; Lender los recupera y verifica sus digests SHA-256. | | `consignado.portabilidade.efetivada` / `consignado.portabilidade.rejeitada` | entrada | Cuando el consumidor de resultados está habilitado y el manifiesto del gateway desplegado declara el evento, los resultados de exclusión por portabilidad del lado de origen cierran la administración de cartera tras la efectivación o preservan el rechazo publicado. | Usa la [referencia de API de Consignado](/es/reference/rails/consignado/fetch-consignado-worker-margin) para los comandos y las consultas del riel. Los contratos de productor y de consumidor viven en [Eventos de Lender](/es/products/lender/lender-events) y [Eventos de Consignado](/es/reference/events/consignado). ## Compuerta de contratación *** El valor predeterminado de `CONSIGNADO_ENABLED` es `true`. La ruta de contratação, su firmante de CCB y el consumidor entrante de averbação confirmada están retirados. Este ajuste ahora controla solo el manejo entrante heredado de averbação rechazada. La administración de cartera de los contratos existentes sigue disponible. Cuando lo deshabilitas, mantén también `CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED` desactivado. El arranque rechaza esa configuración contradictoria. Los flujos de reemplazo de contabilización y de pago se configuran de forma independiente. ## Opcional: conciliación con Matcher *** Esta integración está controlada por configuración y requiere que Matcher use `STREAMING_CLOUDEVENTS_SOURCE=matcher`. Lender consume entonces `match_run.completed` desde `lerian.streaming.matcher` y enruta `ce-source: matcher`, `ce-type: studio.lerian.matcher.match_run.completed`, `ce-resourcetype: match_run` y `ce-eventtype: completed`. Si Matcher usa otra fuente, inspecciona su manifiesto de streaming y alinea ambos lados antes de habilitar la integración. El handler traduce el veredicto en una transición de etapa de PDD y en la intención de asiento correspondiente en el ledger. ## Próximos pasos *** CET, IOF, consentimiento de capitalización, clasificación en etapas de PDD y el resto del perfil BR. El contrato de transmisión, los temas que publica Lender y cómo un handler se mantiene seguro.