> ## 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. # Integración con Lerian Consignado — Dataprev > Integración a través de la API HTTP autenticada, el flujo de comandos de Lender, los hechos de negocio de Consignado, y las suscripciones de entrega de eventos. Usa la API HTTP para la superficie completa de Consignado orientada al cliente. Usa CloudEvents para consumir hechos de negocio inmutables y, al integrar a través de Lender, para enviar los comandos admitidos. Las dos interfaces son complementarias. El flujo de eventos no es la autoridad para toda operación del riel. ## API HTTP La API cubre las credenciales del tenant, el margen y los datos del trabajador, las subastas y las ofertas, el registro, los documentos, y el desembolso. También cubre las correcciones de contrato, el ciclo de vida del contrato, la portabilidad en ambas direcciones, el refinanciamiento, la renegociación, y las garantías. Las operaciones restantes cubren la conciliación, los fondos, las cesiones, el uso, el throughput, y las suscripciones de entrega. Empieza con [obtener el margen del trabajador](/es/reference/rails/consignado/fetch-consignado-worker-margin), y luego usa la navegación de la Referencia de la API para encontrar las demás familias de operaciones. Cada página de operación proviene del contrato OpenAPI `develop`. ## Comandos de Lender consumidos El gateway lee un único flujo de comandos de aplicación y despacha según el source y la clave de evento de CloudEvent. La selección se hace por clave, nunca por nombre de topic. El gateway pone en cuarentena una clave que no maneja en su propia dead-letter queue, en lugar de omitirla. | Clave de evento | Comportamiento en runtime | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `consignado_margin.requested` | Hace la lectura de margen del trabajador contra el riel. El propio consumidor se ejecuta solo cuando el riel de Dataprev y el streaming están habilitados. | | `consignado_exclusao.requested` | Usa el mismo servicio de exclusión idempotente que la operación HTTP cuando el runtime está disponible; de lo contrario, devuelve un error de indisponibilidad con nombre. | | `consignado_redirecionamento.requested` | Se ejecuta cuando un adaptador de redirección está conectado; de lo contrario, devuelve un rechazo con nombre que puede reproducirse después de la configuración. | Averbação no es un comando de Lender en `develop`. Envíala a través de la operación HTTP autenticada. ## Hechos de negocio declarados y operacionales El contrato de runtime contiene 25 definiciones de hechos de negocio, y cada una de ellas tiene un sitio de emisión de producción identificado en `develop`. No existe un interruptor por hecho. El conjunto de hechos publicados es una proyección del catálogo de runtime. Un despliegue o bien emite un hecho, o bien no ejecuta el flujo que lo produce. La configuración decide qué emite un despliegue, nunca el hecho. El descubrimiento de portabilidad entrante está desactivado por defecto. El hecho `consignado.portability_proposal.received` aparece solo donde ese flujo está habilitado. Hace commit de forma atómica junto con su marcador duradero cuando el poller programado de descubrimiento de portabilidad encuentra una oferta activa. Lo mismo aplica para cualquier comando del riel que un despliegue no ejecute. Los hechos operacionales cubren: * solicitudes de subasta y propuestas de portabilidad entrante * margen, empleo, e informes de ausencia * aceptación de propuesta, registro de contrato (`consignado.contract.registered`, incluida la evidencia del artefacto CCB firmado), desembolso, y disponibilidad de corrección * averbação, exclusión, redirección, y resultados de portabilidad del lado de origen * conciliación, excepciones de repasse, y calendarios * fondos, cesión, y cambios de throughput Consulta [Eventos de Consignado](/es/reference/events/consignado) para ver el catálogo completo y el mapeo exacto de resource/event de CloudEvent. ## Flujos de aplicación Con el contrato v3 de lib-streaming: * los hechos van a `lerian.streaming.consignado-gw` * el gateway lee los comandos de Lender desde `lerian.streaming.lender.commands` * los tipos de hecho usan `studio.lerian.consignado-gw..` * los tipos de comando usan `studio.lerian.lender..` Enruta por el source, el tipo de resource, y el tipo de event de CloudEvent. No infieras un evento únicamente a partir de un nombre de topic. ## 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 eventos de negocio. ## Contrato de confiabilidad * Los hechos de negocio entran en un outbox transaccional antes de la 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 del payload usan `snake_case`. Las marcas de tiempo usan UTC RFC 3339. * Un identificador de negocio requerido faltante es terminal y va a la DLQ del consumidor en lugar de a Dataprev.