Skip to main content
Usa la API HTTP para la superficie completa de Consignado orientada al cliente. Usa CloudEvents para consumir hechos de negocio inmutables y, al integrar mediante Lender, para enviar los comandos compatibles. Las dos interfaces son complementarias; el flujo de eventos no es la autoridad para cada operación del riel.

​
API HTTP

La API cubre credenciales de tenant, margen y datos del trabajador, subastas y ofertas, registro, documentos, desembolso, ciclo de vida del contrato, portabilidad, refinanciación, renegociación, garantías, conciliación, fondos, cesiones, uso, throughput y suscripciones de entrega. Comienza con consultar el margen del trabajador, y después usa la navegación de la referencia de la API para encontrar las demás familias de operaciones. Cada página de operación se genera a partir del contrato OpenAPI de develop.

​
Comandos Lender consumidos

El gateway lee un flujo de comandos de aplicación y envía según la fuente de CloudEvent y la clave de evento. Averbação no es un comando Lender en develop. Envíala mediante la operación HTTP autenticada.

​
Hechos de negocio declarados y operativos

El manifiesto de runtime declara 21 hechos de negocio, y los 21 tienen puntos de emisión en producción en develop. consignado.portability_proposal.received se emite cuando el proceso programado de descubrimiento de portabilidad encuentra una oferta M011 vigente y confirma atómicamente su marcador duradero junto con el sobre del outbox de streaming. Los hechos operativos cubren:
  • solicitudes de subasta y propuestas de portabilidad entrantes
  • informes de margen, empleo y ausencias
  • aceptación de propuestas, registro de contratos (consignado.contract.registered, incluida la evidencia del artefacto CCB firmado) y desembolso
  • resultados de averbação, exclusión y redireccionamiento
  • conciliación, excepciones de repasse y calendarios
  • cambios de fondos, cesiones y throughput
Consulta eventos de Consignado para ver el catálogo completo y el mapeo exacto de recurso/evento de CloudEvent.

​
Flujos de aplicación

Con el contrato lib-streaming v3:
  • los hechos se producen en lerian.streaming.consignado-gw
  • los comandos Lender se consumen desde lerian.streaming.lender.commands
  • los tipos de hecho usan studio.lerian.consignado-gw.<resource>.<event>
  • los tipos de comando usan studio.lerian.lender.<resource>.<event>
Enruta por fuente de CloudEvent, tipo de recurso y tipo de evento. No infieras un evento solo a partir del nombre de un tópico.

​
Suscripciones de entrega

Usa la API de suscripciones para registrar un destino HTTPS, inspeccionarlo, rotar su secreto de firma, probar la entrega o revocarlo. Trata el secreto de firma como de solo escritura. Una prueba exitosa demuestra la entrega al endpoint configurado; no cambia la semántica de al menos una vez de los hechos de negocio.

​
Contrato de fiabilidad

  • Los hechos de negocio ingresan en un outbox transaccional antes de su publicación.
  • La entrega es al menos una vez.
  • Deduplica por (ce-source, ce-id).
  • Los valores monetarios viajan como cadenas decimales, nunca como punto flotante binario.
  • Los campos de payload usan snake_case; las marcas de tiempo usan UTC RFC 3339.
  • La ausencia de un identificador de negocio obligatorio es terminal y va a la DLQ del consumidor en lugar de a Dataprev.