Pular para o conteúdo principal
O Lerian SPI publica fatos de negócio como CloudEvents 1.0 em modo binário de conteúdo. Cada um dos seus quatro binários, spi, dict, brcode e core, publica sob o próprio ce-source no próprio tópico. O Streaming Hub entrega esses eventos aos sistemas da sua instituição. A visão geral de streaming de eventos descreve o envelope compartilhado.

Como os eventos chegam até você


  • Streaming Hub. O hub lê os tópicos lerian.streaming.<ce-source> e entrega cada evento correspondente às suas subscriptions. Veja Como o Streaming Hub funciona.
  • Uma exceção. Os sete eventos dict_med_operations trafegam no tópico br-spi.dict.med.operations. O Streaming Hub não lê esse tópico, então não os entrega. Leia-os com seu próprio consumidor Kafka.
  • Assine pela chave do catálogo. O campo event_types de uma subscription recebe o eventKey do catálogo do Streaming Hub (GET /v1/catalog). Para esses eventos, a chave são os dois últimos segmentos do ce-type, por exemplo spi_payment.settled. Veja Gerenciar subscriptions.
  • Fixe a origem para liquidações. O Lerian SPB também publica settlement.settled e settlement.failed. Para receber apenas as liquidações do Lerian SPI numa subscription de webhook ou de fila, defina o origin da subscription como br-spi-core.
  • Pelo menos uma vez. Um evento pode chegar mais de uma vez. Elimine duplicatas pelo par (ce-source, ce-id).
  • Não dependa da ordem de chegada. Ordene os eventos pelo ciclo de vida deles, não pela ordem em que chegam.
  • Headers fixos. Cada evento carrega ce-tenantid default, ce-schemaversion 1.0.0 e ce-datacontenttype application/json.

Manifesto de streaming


Cada binário serve seu manifesto em GET /v1/streaming/manifest. O manifesto lista os eventos que o binário publica, com a chave, o recurso, o evento e a versão de schema de cada um. A rota exige o recurso streaming do Access Manager com a ação read.
Cada ce-type tem a forma studio.lerian.<ce-source>.<resource>.<event>. As tabelas dão o valor completo.

spi: pagamentos, mensagens e aprovações

Pagamentos

Devoluções

Liquidação no trilho

Pix Automático

Mensagens, relatórios e participantes

Aprovações e operações

dict: chaves Pix, reivindicações e MED

Chaves

Reivindicações

Registros do MED

O trilho emite um evento de registro do MED quando observa uma nova versão do registro no BACEN. O evento nomeia o status que o registro atingiu. updated significa que o registro mudou e o status dele não mudou.

Estatísticas e arquivos de conjunto de CIDs

Operações do MED

Esses eventos trafegam no tópico br-spi.dict.med.operations, que o Streaming Hub não lê.

brcode: cobranças e recorrências

Não registre um lançamento no ledger a partir de brcode_charge.paid ou brcode_cobr.concluded. Esses eventos registram o ciclo de vida de uma cobrança. Um consumidor que registra a partir do evento da cobrança e de um evento de liquidação do mesmo Pix registra o Pix duas vezes.

Cobranças

Recorrências, cobranças recorrentes e solicitações

Cada um desses recursos emite um evento para cada status que atinge.

core: participantes e liquidações