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

> Consulta los eventos de dominio que emite y consume el Lerian Consignado — Dataprev, con nombres, payloads y semántica de entrega documentados.

La superficie de negocio de Lerian Consignado — Dataprev es totalmente orientada a eventos. La averbação, detectar la victoria en una subasta (leilão), las lecturas de margen y la conciliación ocurren todas mediante el intercambio de eventos sobre Kafka — ninguna 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 la red como **cadenas** decimales, nunca como floats. Cada evento lleva su versión de esquema en la cabecera `ce-schemaversion` y viaja en el [sobre CloudEvents](/es/reference/events/overview) compartido. Todos los hechos llevan la versión `1.0.0`, excepto `consignado_proposal.accepted`, que lleva `2.0.0`. El `ce-source` de Consignado es `consignado-gw`, que también nombra su espacio de nombres de tópicos (consulta [Nombres de tópicos](/es/reference/events/overview#nombres-de-tópicos)): los eventos emitidos llegan a `consignado-gw.<resource>.<event>`, con un sufijo `.v2` en el único hecho cuya versión mayor de esquema es 2. Cada hecho está **respaldado por outbox**: se escribe en la misma transacción de base de datos que el cambio de estado que reporta y luego se retransmite al broker.

## Eventos emitidos

Hechos que Consignado emite después de actuar sobre un comando o de captar un insumo del riel. Los campos opcionales están marcados con `?` — una clave ausente significa que el riel no envió nada, mientras que una cadena vacía se leería como un valor en blanco que el riel envió.

| Evento (`ce-type`)                                    | Tópico                                                | Se dispara cuando                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Payload principal                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `studio.lerian.consignado_solicitacao.received`       | `consignado-gw.consignado_solicitacao.received`       | El poller de descubrimiento de la subasta captó una solicitud de préstamo de trabajador en el riel — retransmitida para que el prestamista decida si puja.                                                                                                                                                                                                                                                                                                                                                                                         | `id_solicitacao`, `codigo_solicitante`, `cpf`, `matricula`, `nome_trabalhador`, `data_nascimento`, `inscricao_empregador`, `numero_inscricao_empregador`, `data_admissao`, `valor_liberado`, `nro_parcelas`, `margem_disponivel`, `elegivel_emprestimo`?, `data_hora_validade_solicitacao`, `pessoa_exposta_politicamente`?, `garantias` (`tem_garantias` más tres valores de garantía FGTS), `discovered_at`                                                                                                                                                                                                                                                                     |
| `studio.lerian.consignado_margin.fetched`             | `consignado-gw.consignado_margin.fetched`             | El riel respondió una lectura de margen — Consignado retransmite el margen que devolvió Dataprev.                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `request_ref`, `cpf`, `matricula`, `available_margin`, `remuneracao_disponivel`, `valor_total_vencimentos`?, `elegivel`?, `motivo_inelegibilidade`?, `tipo_bloqueio`?, `qtd_emprestimos_ativos_suspensos`?, `data_desligamento`?, `codigo_motivo_desligamento`?, `percentual_verba_rescisoria_disponivel`?, `as_of`                                                                                                                                                                                                                                                                                                                                                               |
| `studio.lerian.consignado_afastamento.reported`       | `consignado-gw.consignado_afastamento.reported`       | Una lectura de margen trajo una alerta de ausencia del trabajador — un evento por elemento de alerta, cubriendo las formas de afastamento y de desligamento.                                                                                                                                                                                                                                                                                                                                                                                       | `cpf`, `matricula`, `tipo_alerta_codigo`, `codigo_motivo_afastamento`?, `data_referencia`, `data_afastamento`?, `data_termino_afastamento`?, `codigo_motivo_desligamento`?, `data_desligamento`?, `data_aviso_previo`?, `data_fim_aviso_previo`?                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `studio.lerian.consignado_proposal.accepted`          | `consignado-gw.consignado_proposal.accepted.v2`       | Una averbação confirmada nombró una de las propuestas de este tenant — el testigo post-averbação vuelve a leer el contrato desde el riel y retransmite lo que el riel registró, textualmente, para que el prestamista pueda verificar los términos registrados contra una fuente independiente. Este hecho lleva el esquema `2.0.0` y el sufijo de tópico `.v2`. `matricula` identifica el vínculo laboral del trabajador (junto con `cpf`); reemplaza al antiguo `vinculo_ref`, que no nombraba ningún campo de Dataprev y siempre viajaba vacío. | `proposal_ref`, `id_solicitacao`, `numero_proposta`, `numero_contrato`, `cpf`, `matricula`, `numero_inscricao_empregador`, `principal_amount`, `liberated_amount`, `installment_amount`, `installment_count`, `monthly_rate`, `annual_rate`, `cet_monthly`, `cet_annual`, `iof_amount`, `situacao_emprestimo`?, `situacao_descricao`?, `garantia`? (bloque anidado: `tem_garantias` más tres valores opcionales de garantía FGTS; un bloque ausente significa que el riel no dijo nada), `accepted_at`, más detalle opcional de la lectura del riel, como nombres del trabajador y del empleador, historial de exclusión y portabilidad, y el estado del bloqueo de garantía FGTS |
| `studio.lerian.consignado_averbacao.confirmed`        | `consignado-gw.consignado_averbacao.confirmed`        | El riel aceptó la averbação (código de éxito de Dataprev).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `contract_id`, `numero_contrato`, `dataprev_success_code`, `averbado_at`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `studio.lerian.consignado_averbacao.rejected`         | `consignado-gw.consignado_averbacao.rejected`         | El riel rechazó la averbação.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `contract_id`, `numero_contrato`, `error_code`, `error_message`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `studio.lerian.consignado_contract.registered`        | `consignado-gw.consignado_contract.registered`        | Una averbação terminal completó su composición de registro — la entrega post-riel completa para prestamistas y fondos. Es el único hecho que efectiva el booking de un contrato aguas abajo; el acuse de la averbação y el testigo de la propuesta no deben crear ni avanzar un contrato registrado.                                                                                                                                                                                                                                               | `contract_id`, `numero_contrato`, `numero_proposta`?, `identity` (`cpf`, `matricula`, inscripción del empleador), `declared_terms` (importes, tasas, fechas y puerta de garantía declarados por el cliente), `rail_terms` (términos registrados post-riel con un bloque `garantia` opcional de tres estados), `margin_snapshot`, `signature`, digests y referencias de blobs en `artifacts`, `registration` (`averbado_at`, `response_code`, hash del adjunto), `fund_ref`?                                                                                                                                                                                                       |
| `studio.lerian.consignado_exclusao.confirmed`         | `consignado-gw.consignado_exclusao.confirmed`         | El riel confirmó una exclusión de averbação (cancelación). Los dos hechos de exclusión comparten un mismo payload; `fact_id` es determinista por (tenant, solicitud, desenlace), así que un suscriptor puede deduplicar las reemisiones.                                                                                                                                                                                                                                                                                                           | `fact_id`, `tenant_id`, `request_ref`, `settlement_id`, `loan_account_id`, `contract_id`, `status`, `provider_reference`?, `outcome_at`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `studio.lerian.consignado_exclusao.rejected`          | `consignado-gw.consignado_exclusao.rejected`          | El riel rechazó una exclusión de averbação.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | `fact_id`, `tenant_id`, `request_ref`, `settlement_id`, `loan_account_id`, `contract_id`, `status`, `reason_code`?, `message`?, `outcome_at`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `studio.lerian.consignado_reconciliation.received`    | `consignado-gw.consignado_reconciliation.received`    | El poller de conciliación captó un insumo (escrituración, repasse CEF D+2 o CSV del portal) — un evento por registro: por fila de contrato en la escrituración, por registro en el repasse. `records` lleva esa única entrada y se omite para la fuente CSV del portal.                                                                                                                                                                                                                                                                            | `competencia`, `source_kind`, `object_ref`, `records`. Cada registro cruza por `numero_contrato` y puede además llevar `cpf`? y `matricula`?, para que un repasse que no cruza con nada en el libro del consumidor aún identifique al trabajador por cuya cuenta se movió el dinero.                                                                                                                                                                                                                                                                                                                                                                                              |
| `studio.lerian.consignado_employment_status.reported` | `consignado-gw.consignado_employment_status.reported` | El riel reportó un cambio en la situación laboral del trabajador.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `report_ref`, `record_id`, `numero_contrato`, `status`, `effective_at`, `reason_code`?                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `studio.lerian.consignado_redirecionamento.confirmed` | `consignado-gw.consignado_redirecionamento.confirmed` | El riel confirmó una redirección de cobro en nómina hacia un vínculo activo elegible. `numero_contrato_novo` es opcional: solo viaja cuando el riel nombra un contrato nuevo.                                                                                                                                                                                                                                                                                                                                                                      | `request_ref`, `numero_contrato`, `source_vinculo_ref`, `target_vinculo_ref`, `target_matricula`, `target_cnpj`, `target_esocial_category`, `disruption_status`, `effective_at`, `provider_reference`, `numero_contrato_novo`?, `outcome_at`                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `studio.lerian.consignado_redirecionamento.rejected`  | `consignado-gw.consignado_redirecionamento.rejected`  | El riel rechazó una redirección de cobro en nómina.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `request_ref`, `numero_contrato`, `source_vinculo_ref`, `target_vinculo_ref`, `target_matricula`, `target_cnpj`, `target_esocial_category`, `disruption_status`, `effective_at`, `reason_code`, `outcome_at`                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

## Comandos consumidos

Comandos que Consignado consume desde Lender. Se suscribe por tópico, bajo el espacio de nombres del productor (`lender`); el servicio productor define la cabecera `ce-type`, así que no se lista aquí. La suscripción al comando de averbação solo está activa en los despliegues con averbação habilitada; el comando de margen siempre está suscrito. Ningún productor emite aún el comando de margen: Lender declara `lender.consignado_margin.requested` como una reserva de contrato (consulta [Eventos de Lender](/es/reference/events/lender)), así que el ciclo de ida y vuelta del margen, incluidos los hechos `consignado_margin.fetched` y `consignado_afastamento.reported` que produce, no lleva tráfico real hasta que ese comando entre en producción.

| Comando                                 | Tópico                                         | Campos decodificados principales                                                                                                                                                                                                                                                                                                               |
| --------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `consignado.margin.requested`           | `lender.consignado_margin.requested`           | `contract_ref`, `cpf`, `cnpj`, `matricula`, `esocial_category`, `codigo_inscricao_empregador`, `numero_inscricao_empregador`, más la tríada de consentimiento digital `canal_autorizacao_digital`, `data_hora_autorizacao_digital`, `nsu_autorizacao_digital` — todos obligatorios en el payload                                               |
| `consignado.averbacao.requested`        | `lender.consignado_averbacao.requested`        | `contract_id`, `numero_contrato`, `cpf`, `matricula`, los términos financieros aceptados completos (`principal_amount`, `liberated_amount`, `installment_amount`, `installment_count`, tasas, `iof_amount`, `first_deduction_competencia`), el bloque de garantía FGTS (`tem_garantias` más valores), la CCB firmada y las evidencias de firma |
| `consignado.exclusao.requested`         | `lender.consignado_exclusao.requested`         | `request_ref`, `settlement_id`, `loan_account_id`, `contract_id`, `numero_contrato`, `settled_at`                                                                                                                                                                                                                                              |
| `consignado.redirecionamento.requested` | `lender.consignado_redirecionamento.requested` | `request_ref`, `numero_contrato`, `source_vinculo_ref`, `target_vinculo_ref`, `target_matricula`, `target_cnpj`, `target_esocial_category`, `disruption_status`, `effective_at`                                                                                                                                                                |
