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.

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 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): 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), 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