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

> Eventos de domínio que o Lerian Consignado — Dataprev emite e consome.

A superfície de negócio do Lerian Consignado — Dataprev é inteiramente orientada a eventos. Consultar a margem de folha, a averbação, detectar a vitória em um leilão e a conciliação acontecem todos trocando eventos sobre Kafka — nenhum deles tem um endpoint HTTP. A única superfície HTTP que o Consignado expõe é a custódia de credenciais (certificado e material OAuth), documentada na [referência de API do Consignado](/pt/reference/rails/consignado/get-credential-status).

Valores monetários e taxas trafegam pelo fio como **strings** decimais, nunca como floats. Todo evento carrega a versão de esquema `1.0.0` no cabeçalho `ce-schemaversion` — uma única versão de todo o pacote estampada de forma idêntica em todos eles — e trafega no [envelope CloudEvents](/pt/reference/events/overview) compartilhado. `consignado.reconciliation.received` não carrega **nenhum CPF**: a conciliação casa por `numero_contrato`, então a PII é removida por construção.

## Eventos emitidos

Fatos que o Consignado emite de volta ao Lender após agir sobre um comando ou recolher uma entrada de conciliação.

| Evento (`ce-type`)                                 | Tópico                                                | Quando dispara                                                                                                             | Payload principal                                                                                                                                                                                                                                      |
| -------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `studio.lerian.consignado_margin.fetched`          | `lerian.streaming.consignado_margin.fetched`          | Um comando `consignado.margin.requested` foi tratado e o rail devolveu a margem do trabalhador.                            | `request_ref`, `cpf`, `matricula`, `available_margin`, `remuneracao_disponivel`, `as_of`                                                                                                                                                               |
| `studio.lerian.consignado_averbacao.confirmed`     | `lerian.streaming.consignado_averbacao.confirmed`     | O rail aceitou a averbação (código de sucesso da Dataprev).                                                                | `contract_id`, `numero_contrato`, `dataprev_success_code`, `averbado_at`                                                                                                                                                                               |
| `studio.lerian.consignado_averbacao.rejected`      | `lerian.streaming.consignado_averbacao.rejected`      | O rail rejeitou a averbação.                                                                                               | `contract_id`, `numero_contrato`, `error_code`, `error_message`                                                                                                                                                                                        |
| `studio.lerian.consignado_proposal.accepted`       | `lerian.streaming.consignado_proposal.accepted`       | Uma vitória em leilão foi detectada — o lance deste credor foi aceito.                                                     | `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` | O poller de conciliação recolheu uma entrada (escrituração, repasse D+2 da CEF ou CSV do portal) — um evento por registro. | `competencia`, `source_kind`, `object_ref`, `records`. Sem CPF neste fio.                                                                                                                                                                              |

## Comandos consumidos

Comandos que o Consignado consome do Lender. Ele assina por tópico; o serviço produtor define o cabeçalho `ce-type`, então não é listado aqui.

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