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:
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.
Renderiza y firma la CCB
La CCB se renderiza como PDF y se firma con una firma digital , produciendo el instrumento de crédito jurídicamente vinculante.
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.
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 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. |
Opcional: reconciliación con Matcher
Los contratos de consignado pueden reconciliarse opcionalmente contra Matcher. Cuando está habilitada, un veredicto de 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
Pack regulatorio de Brasil
CET, IOF, consentimiento de capitalización, staging de PDD y el resto del perfil BR.
Lender en la plataforma
Cómo se entregan los eventos y postings detrás de esta jornada.