Saltar al contenido principal
Lerian SPI publica hechos de negocio como CloudEvents 1.0 en modo de contenido binario. Cada uno de sus cuatro binarios, spi, dict, brcode y core, publica con su propio ce-source en su propio tema. Streaming Hub entrega estos eventos a los sistemas de tu institución. El resumen de streaming de eventos describe el envelope compartido.

Cómo te llegan los eventos


  • Streaming Hub. El hub lee los temas lerian.streaming.<ce-source> y entrega cada evento coincidente a tus suscripciones. Consulta Cómo funciona Streaming Hub.
  • Una excepción. Los siete eventos dict_med_operations viajan en el tema br-spi.dict.med.operations. Streaming Hub no lee ese tema, así que no los entrega. Léelos con tu propio consumidor de Kafka.
  • Suscríbete por la clave del catálogo. El campo event_types de una suscripción toma el eventKey del catálogo de Streaming Hub (GET /v1/catalog). Para estos eventos, la clave son los dos últimos segmentos del ce-type, por ejemplo spi_payment.settled. Consulta Gestionar suscripciones.
  • Fija el origen para las liquidaciones. Lerian SPB también publica settlement.settled y settlement.failed. Para recibir solo las liquidaciones de Lerian SPI en una suscripción de webhook o de cola, define el origin de la suscripción como br-spi-core.
  • Al menos una vez. Un evento puede llegar más de una vez. Elimina duplicados por el par (ce-source, ce-id).
  • No dependas del orden de llegada. Ordena los eventos por su ciclo de vida, no por el orden en que llegan.
  • Headers fijos. Cada evento lleva ce-tenantid default, ce-schemaversion 1.0.0 y ce-datacontenttype application/json.

Manifiesto de streaming


Cada binario sirve su manifiesto en GET /v1/streaming/manifest. El manifiesto lista los eventos que el binario publica, con la clave, el recurso, el evento y la versión de schema de cada uno. La ruta requiere el recurso streaming de Access Manager con la acción read.
Cada ce-type tiene la forma studio.lerian.<ce-source>.<resource>.<event>. Las tablas dan el valor completo.

spi: pagos, mensajes y aprobaciones

Pagos

Devoluciones

Liquidación en el riel

Pix Automático

Mensajes, reportes y participantes

Aprobaciones y operaciones

dict: claves de Pix, reclamos y MED

Claves

Reclamos

Registros de MED

El riel emite un evento de registro de MED cuando observa una nueva versión del registro en BACEN. El evento nombra el estado que alcanzó el registro. updated significa que el registro cambió y su estado no cambió.

Estadísticas y archivos de conjunto de CIDs

Operaciones de MED

Estos eventos viajan en el tema br-spi.dict.med.operations, que Streaming Hub no lee.

brcode: cobros y recurrencias

No registres un movimiento en el ledger a partir de brcode_charge.paid o brcode_cobr.concluded. Estos eventos registran el ciclo de vida de un cobro. Un consumidor que registra a partir del evento del cobro y de un evento de liquidación del mismo Pix registra el Pix dos veces.

Cobros

Recurrencias, cobros recurrentes y solicitudes

Cada uno de estos recursos emite un evento por cada estado que alcanza.

core: participantes y liquidaciones