> ## 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 identidade e entrega do streaming de eventos

> A documentação de streaming de eventos agora esclarece a identidade de evento, a entrega, a nomeação de tópicos e o roteamento do Streaming Hub nos produtos Lerian.

18 de agosto de 2026Correção da documentaçãoAção necessária

## Afeta

***

Equipes que consomem eventos dos produtos Lerian, que operam o Streaming Hub ou que usam os contratos de eventos do Consignado, do Lender, do Midaz, do Fetcher ou do SPB.

## O que mudou

***

Os guias de streaming de eventos agora identificam um CloudEvent pelo par `(ce-source, ce-id)`, e não por `ce-id` sozinho. A entrega continua sendo pelo menos uma vez, então os consumidores devem manter os handlers idempotentes.

Os guias também corrigem contratos específicos de cada produto: a identidade de evento do Midaz pode conter underscores, o catálogo ativo e a superfície HTTP do Consignado estão documentados, e o Streaming Hub aceita eventos de tenant não vazios e os combina apenas com subscriptions daquele tenant. O endpoint do EventBridge dele é o nome do event bus; `DetailType` vem do tipo de evento correspondente.

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 deduplicam apenas por `ce-id`, que interpretam os tipos de evento do Midaz supondo hífens ou que configuram o roteamento do Streaming Hub pela orientação anterior podem processar eventos de forma incorreta ou perder entregas.

## O que você precisa fazer

***

**Step 1**

Deduplique cada consumidor por `(ce-source, ce-id)` e mantenha o processamento idempotente.

**Step 2**

Revise a interpretação de tipos de evento e de tópicos, em especial as identidades do Midaz que usam underscores.

**Step 3**

No Streaming Hub, verifique se os tenants das subscriptions coincidem com os valores de `ce-tenantid` do produtor e configure o EventBridge com o nome do event bus.

### Prazo

Conclua a revisão antes do próximo deploy de consumidor ou do Streaming Hub.

## Recursos

***

* [Visão geral do streaming de eventos](https://docs.lerian.studio/pt/reference/events/overview.md)
* [Operar o Streaming Hub](https://docs.lerian.studio/pt/platform/streaming-hub/operating-streaming-hub.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.