> ## 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 de Consignado y contratos de streaming

> La documentación ahora cubre la API de cliente de Consignado y su guía, además de los contratos actuales de catálogo de streaming, enrutamiento y entrega.

<Badge stroke icon="calendar-days" iconType="regular">23 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Corrección de documentación</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Revisión recomendada</Badge>

## Afecta a

***

Equipos que se integran con la API de Consignado, consumen eventos de Midaz o de Consignado, u operan la entrega de eventos terminales de Fetcher.

## Qué cambió

***

La referencia de Consignado ahora cubre 55 operaciones orientadas al cliente, que incluyen configuración, margen, subastas, registro, administración de cartera, portabilidad, garantías, conciliación, operaciones y guía de configuración.

`GET /v1/streaming/manifest` de Midaz describe su catálogo público de eventos de negocio en JSON y su mapeo de temas. El antiguo stream Protobuf interno `billing_recorded` fue retirado y no es una ruta separada en el runtime actual.

`consignado.portability_proposal.received` es operativo. El poller programado de descubrimiento de portabilidad lo emite cuando encuentra una oferta M011 activa y registra su marcador durable con el envelope del outbox de streaming.

Fetcher persiste el estado terminal con un marcador pendiente antes de su inserción separada en el outbox durable. Su bucle de reparación reemite el mismo `ce-id` hasta que ese marcador se limpia. Los consumidores deben seguir deduplicando CloudEvents por `(ce-source, ce-id)`.

Los consumidores de SPI derivan las suscripciones v3 del stream de la aplicación productora en lugar de sobrescrituras de tema por evento. Bank Transfer usa un único tema de aplicación v3 y su restricción documentada de origen de CloudEvents. SISBAJUD garantiza el header de tenant solo para las emisiones de `block_account.created` de un único tenant.

Esta es una corrección de documentación de contratos implementados. No anuncia un release de runtime.

## Impacto

***

**Clasificación: Revisión recomendada.** La actualización agrega cobertura de API y de guía, y aclara el límite del catálogo público y el comportamiento de entrega. Se recomienda que los equipos que usan la API o los streams afectados confirmen su enrutamiento, sus supuestos de catálogo y su manejo de idempotencia.

## Qué debes hacer

***

<Steps>
  <Step>Revisa la referencia de API y la guía de Consignado antes de implementar o cambiar una integración.</Step>
  <Step>Usa el manifiesto de streaming de Midaz para los eventos de negocio públicos actuales en JSON. No infieras un stream `billing_recorded` separado.</Step>
  <Step>Si consumes eventos de Consignado, trata `consignado.portability_proposal.received` como un evento operativo.</Step>
  <Step>Mantén los consumidores de Fetcher idempotentes y deduplica CloudEvents por `(ce-source, ce-id)`.</Step>
</Steps>

### Plazo

Revisa antes del próximo despliegue de Consignado, de un consumidor de streaming o de Fetcher.

## Recursos

***

* [Resumen de streaming de eventos](/es/reference/events/overview)
* [Eventos de Midaz](/es/reference/events/midaz)
* [Eventos de Consignado](/es/reference/events/consignado)