> ## 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.

# Contratos de integración de event streaming

> La documentación de event streaming ahora aclara los contratos de integración de Lender, Midaz, Reporter y los rieles.

<Badge stroke icon="calendar-days" iconType="regular">20 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Corrección de documentación</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Acción requerida</Badge>

## Afecta a

***

Equipos que consumen eventos de Lender, Midaz o Reporter, u operan el streaming de Lender, Pix Switch, Boleto o SLC.

## Qué cambió

***

El evento `loan_account.debt_balance_changed` de Lender usa la versión mayor de esquema `2` y el tema `lender.loan_account.debt_balance_changed.v2`. `OUTBOX_RETRY_WINDOW_SEC` es el retraso mínimo entre intentos para una fila, no una ventana total de reintentos. La clave de definición del catálogo no siempre es la clave de despacho; deriva el despacho de `ce-resourcetype` y `ce-eventtype`.

Reporter escribe los eventos críticos en su outbox de streaming durable en Mongo después del commit del estado de negocio. Las dos escrituras no son una única transacción atómica de la aplicación. Solo los facts terminales de informe y las transiciones críticas de fecha límite tienen identificadores determinísticos; los consumidores deben tratar los demás valores de `ce-id` como opacos y deduplicar por `(ce-source, ce-id)`.

Los payloads de los eventos de ciclo de vida de Midaz incluyen `routeId`. Los facts de CRM ahora comparten el tema de aplicación `lerian.streaming.ledger`; `ce-resourcetype` sigue siendo `holder` o `instrument`, sin un segmento `crm_`.

Las guías también documentan un `STREAMING_TLS_CA_CERT` opcional en Lender, el streaming opcional de Pix Switch con los ajustes de broker y de fuente obligatorios cuando se habilita, el outbox interno de Midaz en Boleto y el requisito de circuit breaker de SLC para un consumidor de MQ RSFN.

Esta es una corrección de documentación que registra contratos implementados. No anuncia una versión en tiempo de ejecución.

## Impacto

***

**Clasificación: acción requerida.** Los consumidores que derivan los temas anteriores de Lender o de CRM, que suponen que todos los identificadores de Reporter son determinísticos, o que usan la orientación previa de reintentos y despliegue pueden enrutar los eventos de forma incorrecta u operar una configuración no admitida.

## Qué debes hacer

***

<Steps>
  <Step>Actualiza las suscripciones de Lender para `lender.loan_account.debt_balance_changed.v2` y deriva las claves de despacho del recurso y del tipo de evento de CloudEvents.</Step>
  <Step>Acepta `routeId` en los payloads de ciclo de vida de Midaz, usa la forma documentada del tema de CRM y conserva `(ce-source, ce-id)` como clave de deduplicación del consumidor.</Step>
  <Step>Revisa los supuestos de entrega de Reporter, los controles de reintento de Lender y la configuración de streaming antes del próximo despliegue.</Step>
</Steps>

### Plazo

Completa la revisión antes del próximo despliegue de consumidor o de integración de streaming.

## Recursos

***

* [Resumen de event streaming](/es/reference/events/overview)
* [Eventos de Lender](/es/reference/events/lender)
* [Eventos de Midaz](/es/reference/events/midaz)