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

# Como o Lerian SLC funciona

> O pipeline de liquidação — intake canônico, construção do arquivo ASLC, assinatura delegada à custódia, transmissão e correlação de retornos — os fluxos de crédito, débito, antecipação e cancelamento, os fluxos de IF Domicílio de entrada e de clearing, e o ciclo de vida da operação.

O Lerian SLC roda um único pipeline de liquidação para cada operação de cartão: ele recebe uma operação, constrói o arquivo ASLC para ela, faz com que seja assinada sob a custódia do cliente, transmite-a para a Nuclea e correlaciona os retornos — fazendo a operação avançar ao longo do seu ciclo de vida pelo NUliquid.

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

Um modo de **pass-through auditado** também aceita artefatos pré-assinados pelo cliente e os repassa sob auditoria.

Os tipos de operação são **CREDIT**, **DEBIT**, **CANCELLATION**, **ANTICIPATION** e **SWEEP**.

## Construir, assinar, transmitir, correlacionar

***

Cada operação flui por um único pipeline:

1. **Validar** a operação contra os XSDs da Nuclea.
2. **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.
3. **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**.
4. **Transmitir** o arquivo para a Nuclea sobre **REST**, protegido por **mTLS** e uma assinatura **JWS por requisição**.
5. **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.                             |

Os arquivos carregam o seu próprio ciclo de vida de **10 estados**, rastreado por arquivo desde a construção até a transmissão e a correlação de retornos.

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

Em deployments SaaS, a custódia é fixada em cloud KMS via **importação de chave envelopada do lado do cliente**: o cliente envelopa e importa a própria chave, e o serviço armazena apenas o certificado público e uma referência de chave — nunca o material privado.

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