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

# Eventos de Consignado

> Eventos de dominio que emite y consume Lerian Consignado — Dataprev.

La superficie de negocio de Lerian Consignado — Dataprev es totalmente orientada a eventos. Consultar el margen de nómina, la averbação, detectar la victoria en una subasta (leilão) y la conciliación ocurren todos intercambiando eventos sobre Kafka — ninguno tiene un endpoint HTTP. La única superficie HTTP que expone Consignado es la custodia de credenciales (certificado y material OAuth), documentada en la [referencia de API de Consignado](/es/reference/rails/consignado/get-credential-status).

Los importes de dinero y las tasas viajan por el hilo como **cadenas** decimales, nunca como floats. Cada evento lleva la versión de esquema `1.0.0` en la cabecera `ce-schemaversion` — una única versión de todo el paquete estampada de forma idéntica en todos ellos — y viaja en el [sobre CloudEvents](/es/reference/events/overview) compartido. `consignado.reconciliation.received` no lleva **ningún CPF**: la conciliación cruza por `numero_contrato`, así que la PII se elimina por construcción.

## Eventos emitidos

Hechos que Consignado emite de vuelta a Lender tras actuar sobre un comando o recoger una entrada de conciliación.

| Evento (`ce-type`)                                 | Tópico                                                | Se dispara cuando                                                                                                           | Payload principal                                                                                                                                                                                                                                      |
| -------------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `studio.lerian.consignado_margin.fetched`          | `lerian.streaming.consignado_margin.fetched`          | Se manejó un comando `consignado.margin.requested` y el rail devolvió el margen del trabajador.                             | `request_ref`, `cpf`, `matricula`, `available_margin`, `remuneracao_disponivel`, `as_of`                                                                                                                                                               |
| `studio.lerian.consignado_averbacao.confirmed`     | `lerian.streaming.consignado_averbacao.confirmed`     | El rail aceptó la averbação (código de éxito de Dataprev).                                                                  | `contract_id`, `numero_contrato`, `dataprev_success_code`, `averbado_at`                                                                                                                                                                               |
| `studio.lerian.consignado_averbacao.rejected`      | `lerian.streaming.consignado_averbacao.rejected`      | El rail rechazó la averbação.                                                                                               | `contract_id`, `numero_contrato`, `error_code`, `error_message`                                                                                                                                                                                        |
| `studio.lerian.consignado_proposal.accepted`       | `lerian.streaming.consignado_proposal.accepted`       | Se detectó la victoria en una subasta (leilão) — se aceptó la puja de este prestamista.                                     | `proposal_ref`, `id_solicitacao`, `numero_proposta`, `cpf`, `vinculo_ref`, `principal_amount`, `installment_amount`, `installment_count`, `annual_rate`, `cet_monthly`, `cet_annual`, `iof_amount`, `fgts_guarantee_percent` (opcional), `accepted_at` |
| `studio.lerian.consignado_reconciliation.received` | `lerian.streaming.consignado_reconciliation.received` | El poller de conciliación recogió una entrada (escrituração, repasse D+2 de CEF o CSV del portal) — un evento por registro. | `competencia`, `source_kind`, `object_ref`, `records`. Sin CPF en este hilo.                                                                                                                                                                           |

## Comandos consumidos

Comandos que Consignado consume desde Lender. Se suscribe por tópico; el servicio productor establece la cabecera `ce-type`, así que no se lista aquí.

| Comando                          | Tópico                                            | Campos decodificados                                                                                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `consignado.margin.requested`    | `lerian.streaming.consignado_margin.requested`    | `contract_ref` (opcional), `cpf`, `cnpj`, `matricula`, `esocial_category`                                                                                                                                                                                                                          |
| `consignado.averbacao.requested` | `lerian.streaming.consignado_averbacao.requested` | `contract_id`, `numero_contrato`, `cpf`, `vinculo_ref`, `principal_amount`, `installment_amount`, `installment_count`, `annual_rate`, `cet_monthly`, `cet_annual`, `iof_amount`, `first_deduction_competencia`, `fgts_guarantee_percent` (opcional), `signed_ccb_base64`, `biometric_evidence_ref` |