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

# API do Consignado e contratos de streaming

> A documentação agora cobre a API e o guia do cliente Consignado, além dos contratos atuais de catálogo, roteamento e entrega de streaming.

<Badge stroke icon="calendar-days" iconType="regular">23 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção de documentação</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisão recomendada</Badge>

## Afeta

***

Equipes que integram com a API do Consignado, consomem eventos do Midaz ou do Consignado ou operam a entrega de eventos terminais do Fetcher.

## O que mudou

***

A referência do Consignado agora cobre 55 operações voltadas ao cliente, incluindo configuração, margem, leilões, registro, gestão da carteira, portabilidade, garantias, conciliação, operações e orientações de configuração.

O `GET /v1/streaming/manifest` do Midaz descreve seu catálogo público de eventos de negócio em JSON e o mapeamento de tópicos. O antigo stream Protobuf interno `billing_recorded` foi descontinuado e não é uma rota separada no runtime atual.

O `consignado.portability_proposal.received` está operacional. O poller agendado de descoberta de portabilidade o emite quando encontra uma oferta M011 ativa e registra seu marcador durável com o envelope do outbox de streaming.

O Fetcher persiste o estado terminal com um marcador pendente antes de seu insert separado no outbox durável. Seu loop de reparo reemite o mesmo `ce-id` até que esse marcador seja limpo. Os consumidores devem continuar a deduplicar CloudEvents por `(ce-source, ce-id)`.

Os consumidores do SPI derivam subscriptions v3 do stream da aplicação produtora, e não de overrides de tópico por evento. O Bank Transfer usa um tópico de aplicação v3 e sua restrição documentada de source de CloudEvents. O SISBAJUD garante o header de tenant apenas para emissões de `block_account.created` single-tenant.

Esta é uma correção de documentação de contratos implementados. Não anuncia um release de runtime.

## Impacto

***

**Classificação: Revisão recomendada.** A atualização adiciona cobertura de API e de guia e esclarece o limite do catálogo público e o comportamento de entrega. Recomenda-se que as equipes que usam a API ou os streams afetados confirmem seu roteamento, suas suposições sobre o catálogo e seu tratamento de idempotência.

## O que você precisa fazer

***

<Steps>
  <Step>Revise a referência da API do Consignado e o guia antes de implementar ou alterar uma integração.</Step>
  <Step>Use o manifesto de streaming do Midaz para os eventos de negócio públicos atuais em JSON. Não presuma um stream `billing_recorded` separado.</Step>
  <Step>Se você consome eventos do Consignado, trate `consignado.portability_proposal.received` como um evento operacional.</Step>
  <Step>Mantenha os consumidores do Fetcher idempotentes e deduplique CloudEvents por `(ce-source, ce-id)`.</Step>
</Steps>

### Prazo

Revise antes do próximo deploy de Consignado, de consumidor de streaming ou de Fetcher.

## Recursos

***

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