Skip to main content
Lerian Consignado publica sus hechos de negocio como CloudEvents 1.0. Los hechos emitidos entran al outbox transaccional antes de la publicación.
Los contratos de payload a continuación describen el objeto data del CloudEvent. Una propiedad marcada con ? puede estar ausente. null es válido solo donde un contrato de payload lo escribe explícitamente.

Contrato de stream de la aplicación

El tema identifica la aplicación que produce el evento, no un evento en particular. Enruta por ce-source, ce-resourcetype y ce-eventtype. Usa ce-type como su compuesto calificado por fuente. Nunca infieras un evento a partir del nombre del tema.

Catálogo de eventos emitidos

Notación del payload

El wire usa JSON con nombres de propiedad en snake_case. Estos alias describen los formatos que usan los esquemas:
originador_ref es el originador cuya oferta produjo el contrato. fundo_ref es el fondo que recibió el contrato en una cesión. En consignado.contract.registered, fund_ref es el fondo al que la averbação atribuye el contrato.

Contratos de payload

El gateway descubre una solicitud de préstamo abierta en Dataprev.Asunto: id_solicitacao
El gateway descubre una oferta de portabilidad M011 activa y la registra con su envelope de outbox.Asunto: id_solicitacao
El gateway lee el margen del trabajador desde Dataprev.Asunto: request_ref
El gateway constata la propuesta aceptada del riel frente a la oferta durable del cliente.Asunto: proposal_ref
Dataprev confirma la averbação.Asunto: contract_id
Dataprev rechaza la averbação.Asunto: contract_id
El registro del contrato alcanza su límite inmutable. dados_cadastrais_digest_sha256 es el digest SHA-256 del cadastro que el gateway almacenó en la averbação.Asunto: numero_contrato
El cliente confirma que el trabajador recibió los fondos.Asunto: numero_contrato
Un cliente reemplaza un CCB firmado o un pago ya confirmado. El payload apunta al recurso corregido. Los consumidores lo recuperan mediante M2M autenticado y verifican su digest SHA-256. El ce-resourcetype del evento distingue el tipo de corrección.Asunto: numero_contrato
Dataprev acepta la propia exclusión de portabilidad del lado de origen de este gateway. El contrato sale de la institución, por lo que la administración de cartera downstream puede detenerse. Este hecho no reporta el lado de la institución receptora y no lleva ningún monto de liquidación.Asunto: numero_contrato
Dataprev rechaza la propia exclusión de portabilidad del lado de origen de este gateway. El contrato permanece vigente.Asunto: numero_contrato
La exclusión del contrato alcanza un estado terminal exitoso.Asunto: numero_contrato
La exclusión del contrato alcanza un estado terminal rechazado.Asunto: numero_contrato
El gateway normaliza un registro contable, de repasse o de CSV de portal.Asunto: object_ref
El gateway lee un registro de suspensión o terminación de empleo.Asunto: record_id
Se reporta una alerta de ausencia o terminación del trabajador.Asunto: SHA-256(payload)
Cambia el throughput efectivo de Dataprev de un tenant.Asunto: tenant_id
Una cesión de crédito se registra en el dominio del gateway.Asunto: idempotency_key
Un repasse esperado supera su plazo o no tiene un plazo calculable.Asunto: object_ref
Un movimiento resuelve un repasse vencido.Asunto: object_ref
El gateway no puede establecer una observación actual del riel para las expectativas.Asunto: object_ref
Se publica una ventana operativa del calendario de descuentos.Asunto: competencia_consulta
Un job programado del gateway recibe el rechazo del cambio de competencia de Dataprev, y el gateway abre una pausa para el tenant. Solo los despliegues en Lerian Cloud emiten este hecho. hold_until es el fin de la primera espera, no el fin del cambio de competencia.Asunto: tenant/<tenant_id>
La pausa del tenant termina. Solo los despliegues en Lerian Cloud emiten este hecho. episode tiene el mismo valor que en el hecho de pausa que cierra.Asunto: tenant/<tenant_id>

Comandos consumidos desde Lender

Estos son comandos entrantes, no eventos emitidos por Consignado. Llegan en lerian.streaming.lender.commands con ce-source: lender y ce-type: studio.lerian.lender.<resource>.<event>. La averbação no es un comando de Lender. Envíala mediante la operación HTTP autenticada.

Reglas de entrega y compatibilidad

  • Deduplica por (ce-source, ce-id) y haz que los handlers sean idempotentes.
  • Lee ce-schemaversion antes de decodificar. El header lleva el esquema 1.0.0, y el tema nunca lo lleva.
  • El dinero y las tasas son cadenas decimales. Los timestamps están en UTC, en formato RFC 3339. Los valores de solo fecha usan YYYY-MM-DD, y las competências usan YYYYMM.
  • Las claves de comando entrantes desconocidas o no admitidas terminan en el DLQ del consumidor de Consignado.
  • La falta de un identificador de negocio obligatorio impide la publicación o la ejecución del comando. Consignado nunca lo genera.