Intake
As operações entram no Lerian SLC por dois modos canônicos:
- API canônica — um intake REST/JSONL que carrega operações no formato canônico da Lerian, idempotente por
external_id, de modo que um envio repetido nunca liquida duas vezes. - XML ASLC direto — um upload de XML ASLC pronto, para chamadores que já o produzem.
Construir, assinar, transmitir, correlacionar
Cada operação flui por um único pipeline:
- Validar a operação contra os XSDs da Nuclea.
- Construir o arquivo ASLC — UTF-16BE, sem BOM, até 50.000 registros por arquivo, com divisão automática quando a contagem excede o limite.
- Assinar o arquivo sob a custódia do cliente (veja a orquestração de assinatura mais abaixo), depois aplicar GZIP e o SPB security envelope.
- Transmitir o arquivo para a Nuclea sobre REST, protegido por mTLS e uma assinatura JWS por requisição.
- Correlacionar os retornos da Nuclea —os retornos de arquivo PRO / ERR / RET e a mensagem de status ASLC028— de volta ao arquivo e às suas operações por nome de arquivo.
Famílias de mensagens
| Fluxo | Família de mensagens |
|---|---|
| Liquidação de crédito | ASLC027 / ASLC028 |
| Liquidação de débito | ASLC029 / ASLC030 |
| Antecipação | ASLC031 / ASLC034 |
| Retornos e devoluções | ASLC041 / ASLC042 / ASLC043 |
| Cancelamento | ASLC060–ASLC067 |
| Domicílio de entrada | ASLC022 / ASLC023 / ASLC024 / ASLC025 / ASLC032 / ASLC033 |
Fluxos de liquidação
- Crédito (adquirente). As operações entram pelo intake canônico, o Lerian SLC constrói o arquivo de crédito (ASLC027), assina-o e transmite-o, e correlaciona o status ASLC028 e os retornos PRO/ERR/RET, fazendo cada operação avançar pelo seu ciclo de vida de NUliquid.
- Débito e antecipação. O mesmo pipeline de intake-construir-assinar-transmitir roda com as famílias de débito (ASLC029 / ASLC030) e de antecipação (ASLC031 / ASLC034); os retornos de status e o rastreamento por NUliquid espelham o fluxo de crédito.
- Cancelamento. O adquirente informa um cancelamento (crédito ASLC060, débito ASLC064); o Lerian SLC o retransmite à IF Domicílio (ASLC061), recebe o retorno de processamento do domicílio (ASLC062), devolve o resultado ao adquirente (ASLC063 / ASLC067) e emite um evento de cancelamento-confirmado-pelo-domicílio que carrega o NUliquid.
IF Domicílio de entrada
Atuando como instituição de domicílio, o Lerian SLC recebe avisos de liquidação de crédito e débito (ASLC022 / ASLC024 / ASLC032), confirma-os (ASLC023 / ASLC025 / ASLC033) e emite retornos e devoluções (ASLC041 / ASLC042 / ASLC043). Um webhook com chave NUliquid sinaliza o crédito ao estabelecimento e carrega a evidência do retorno.
Clearing e fundeamento para a IF Liquidante
Para a instituição liquidante, o Lerian SLC consome o preview e o final de clearing de entrada (SLC0001), a mensagem SLC0002 e o status operacional (PAG0101) sobre a RSFN, constrói a posição de clearing por ciclo de liquidação e detecta a divergência de valor D0-versus-D+1. Ele levanta eventos de preview-disponível, final-disponível, depósito-requerido e prazo-de-depósito-se-aproximando.
Ciclo de vida da operação
Cada operação avança por um ciclo de vida de 11 estados, rastreado pelo seu NUliquid.
| Estado | Significado |
|---|---|
| CREATED | A operação foi aceita no Lerian SLC. |
| QUEUED | Está na fila para a próxima construção de arquivo. |
| SENT | O seu arquivo foi transmitido para a Nuclea. |
| ACKNOWLEDGED | A Nuclea acusou o recebimento. |
| ACCEPTED | A Nuclea aceitou a operação. |
| REJECTED | A Nuclea rejeitou a operação. |
| FORWARDED | O aviso de liquidação foi encaminhado à IF Domicílio. |
| CONFIRMED | O domicílio confirmou. |
| SETTLED | A operação liquidou. |
| D1_CONFIRMED | A liquidação está confirmada em D+1. |
| CANCELLED | A operação foi cancelada. |
Orquestração de assinatura
O Lerian SLC materializa o XML ASLC não assinado e então delega a assinatura a um backend de custódia escolhido por tenant. A chave privada nunca sai da custódia do cliente, e a Lerian nunca assina em nome do cliente.
| Backend de custódia | Onde a chave vive |
|---|---|
| Software key | Uma chave em software no ambiente do cliente. |
| PKCS#11 HSM | Um módulo de segurança de hardware. |
| Cloud KMS | Um serviço de gerenciamento de chaves na nuvem. |
| Vault | Um vault de segredos, por certificado. |
Transporte
As operações e os arquivos são enviados para a Nuclea sobre REST, protegidos por mTLS e uma assinatura JWS por requisição (a série online SLC0908 / SLC0912 / SLC0915 / SLC0999). Os retornos de entrada são consultados e confirmados sobre o mesmo canal REST.