> ## 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 integração do streaming de eventos

> A documentação de streaming de eventos agora esclarece os contratos de integração do Lender, do Midaz, do Reporter e dos trilhos.

<Badge stroke icon="calendar-days" iconType="regular">20 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção da documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Afeta

***

Equipes que consomem eventos do Lender, do Midaz ou do Reporter, ou que operam streaming para Lender, Pix Switch, Boleto ou SLC.

## O que mudou

***

O evento `loan_account.debt_balance_changed` do Lender usa a major de schema `2` e o tópico `lender.loan_account.debt_balance_changed.v2`. `OUTBOX_RETRY_WINDOW_SEC` é o atraso mínimo entre tentativas para uma linha, e não uma janela total de novas tentativas. Uma chave de definição do catálogo nem sempre é a chave de despacho; derive o despacho de `ce-resourcetype` e `ce-eventtype`.

O Reporter escreve os eventos críticos no seu outbox durável de streaming no Mongo depois do commit do estado de negócio. As duas escritas não formam uma única transação atômica da aplicação. Apenas os fatos terminais de relatório e as transições críticas de prazo têm identificadores determinísticos; os consumidores devem tratar os demais valores de `ce-id` como opacos e deduplicar por `(ce-source, ce-id)`.

Os payloads de eventos de ciclo de vida do Midaz incluem `routeId`. Os fatos do CRM agora compartilham o tópico de aplicação `lerian.streaming.ledger`; `ce-resourcetype` continua sendo `holder` ou `instrument`, sem o segmento `crm_`.

Os guias também documentam um `STREAMING_TLS_CA_CERT` opcional no Lender, o streaming opcional do Pix Switch com as configurações obrigatórias de broker e de source quando habilitado, o outbox interno do Midaz no Boleto e a exigência de circuit breaker do SLC para um consumidor MQ RSFN.

Esta é uma correção da documentação que registra contratos implementados. Ela não anuncia um release de runtime.

## Impacto

***

**Classificação: Ação necessária.** Consumidores que derivam os tópicos anteriores do Lender ou do CRM, que supõem que todos os identificadores do Reporter são determinísticos ou que usam a orientação anterior de nova tentativa e de deploy podem rotear eventos de forma errada ou operar uma configuração sem suporte.

## O que você precisa fazer

***

<Steps>
  <Step>Atualize as subscriptions do Lender para `lender.loan_account.debt_balance_changed.v2` e derive as chaves de despacho do tipo de recurso e do tipo de evento do CloudEvents.</Step>
  <Step>Aceite `routeId` nos payloads de ciclo de vida do Midaz, use a forma documentada do tópico do CRM e mantenha `(ce-source, ce-id)` como chave de deduplicação do consumidor.</Step>
  <Step>Revise as suposições de entrega do Reporter, os controles de nova tentativa do Lender e a configuração de streaming antes do próximo deploy.</Step>
</Steps>

### Prazo

Conclua a revisão antes do próximo deploy de consumidor ou de integração de streaming.

## Recursos

***

* [Visão geral do streaming de eventos](/pt/reference/events/overview)
* [Eventos do Lender](/pt/reference/events/lender)
* [Eventos do Midaz](/pt/reference/events/midaz)