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

# Cómo funciona Lerian SLC

> El pipeline de liquidación — intake canónico, construcción del archivo ASLC, firma delegada en custodia, transmisión y correlación de retornos — los flujos de crédito, débito, anticipación y cancelación, los flujos de IF Domicílio de entrada y de clearing, y el ciclo de vida de la operación.

Lerian SLC corre un único pipeline de liquidación para cada operación de tarjeta: toma una operación, construye el archivo ASLC para ella, la hace firmar bajo la custodia del cliente, la transmite a Nuclea y correlaciona los retornos —haciendo avanzar la operación a lo largo de su ciclo de vida por el NUliquid.

## Intake

***

Las operaciones entran a Lerian SLC por dos modos canónicos:

* **API canónica** — un intake REST/JSONL que transporta operaciones en la forma canónica de Lerian, idempotente por `external_id`, de modo que un envío reintentado nunca liquida dos veces.
* **XML ASLC directo** — una carga de XML ASLC listo, para llamadores que ya lo producen.

Un modo de **pass-through auditado** también acepta artefactos prefirmados por el cliente y los reenvía bajo auditoría.

Los tipos de operación son **CREDIT**, **DEBIT**, **CANCELLATION**, **ANTICIPATION** y **SWEEP**.

## Construir, firmar, transmitir, correlacionar

***

Cada operación fluye por un único pipeline:

1. **Validar** la operación contra los XSD de Nuclea.
2. **Construir** el archivo ASLC — UTF-16BE, sin BOM, hasta **50.000** registros por archivo, con división automática cuando el conteo excede el límite.
3. **Firmar** el archivo bajo la custodia del cliente (ver la orquestación de firma más abajo), luego aplicar **GZIP** y el **SPB security envelope**.
4. **Transmitir** el archivo a Nuclea sobre **REST**, protegido por **mTLS** y una firma **JWS por solicitud**.
5. **Correlacionar** los retornos de Nuclea —los retornos de archivo **PRO / ERR / RET** y el mensaje de estado **ASLC028**— de vuelta al archivo y a sus operaciones **por nombre de archivo**.

## Familias de mensajes

***

| Flujo                   | Familia de mensajes                                       |
| ----------------------- | --------------------------------------------------------- |
| Liquidación de crédito  | ASLC027 / ASLC028                                         |
| Liquidación de débito   | ASLC029 / ASLC030                                         |
| Anticipación            | ASLC031 / ASLC034                                         |
| Retornos y devoluciones | ASLC041 / ASLC042 / ASLC043                               |
| Cancelación             | ASLC060–ASLC067                                           |
| Domicílio de entrada    | ASLC022 / ASLC023 / ASLC024 / ASLC025 / ASLC032 / ASLC033 |

## Flujos de liquidación

***

* **Crédito (adquirente).** Las operaciones entran por el intake canónico, Lerian SLC construye el archivo de crédito (**ASLC027**), lo firma y lo transmite, y correlaciona el estado **ASLC028** y los retornos PRO/ERR/RET, haciendo avanzar cada operación por su ciclo de vida de NUliquid.
* **Débito y anticipación.** El mismo pipeline de intake-construir-firmar-transmitir corre con las familias de débito (**ASLC029 / ASLC030**) y de anticipación (**ASLC031 / ASLC034**); los retornos de estado y el rastreo por NUliquid reflejan el flujo de crédito.
* **Cancelación.** El adquirente informa una cancelación (crédito **ASLC060**, débito **ASLC064**); Lerian SLC la retransmite a la **IF Domicílio** (**ASLC061**), recibe el retorno de procesamiento del domicilio (**ASLC062**), devuelve el resultado al adquirente (**ASLC063 / ASLC067**) y emite un evento de cancelación-confirmada-por-domicilio que lleva el NUliquid.

## IF Domicílio de entrada

***

Actuando como institución de domicilio, Lerian SLC recibe avisos de liquidación de crédito y débito (**ASLC022 / ASLC024 / ASLC032**), los confirma (**ASLC023 / ASLC025 / ASLC033**) y emite retornos y devoluciones (**ASLC041 / ASLC042 / ASLC043**). Un webhook con clave NUliquid señala el crédito al comercio y lleva la evidencia del retorno.

## Clearing y fondeo para la IF Liquidante

***

Para la institución liquidante, Lerian SLC consume el preview y el final de clearing de entrada (**SLC0001**), el mensaje **SLC0002** y el estado operativo (**PAG0101**) sobre la RSFN, construye la **posición de clearing por ciclo de liquidación** y detecta la divergencia de valor **D0-versus-D+1**. Levanta eventos de preview-disponible, final-disponible, depósito-requerido y plazo-de-depósito-por-vencer.

## Ciclo de vida de la operación

***

Cada operación avanza por un ciclo de vida de **11 estados**, rastreado por su NUliquid.

| Estado            | Significado                                              |
| ----------------- | -------------------------------------------------------- |
| **CREATED**       | La operación fue aceptada en Lerian SLC.                 |
| **QUEUED**        | Está en cola para la próxima construcción de archivo.    |
| **SENT**          | Su archivo fue transmitido a Nuclea.                     |
| **ACKNOWLEDGED**  | Nuclea acusó recibo.                                     |
| **ACCEPTED**      | Nuclea aceptó la operación.                              |
| **REJECTED**      | Nuclea rechazó la operación.                             |
| **FORWARDED**     | El aviso de liquidación fue reenviado a la IF Domicílio. |
| **CONFIRMED**     | El domicilio confirmó.                                   |
| **SETTLED**       | La operación liquidó.                                    |
| **D1\_CONFIRMED** | La liquidación está confirmada en D+1.                   |
| **CANCELLED**     | La operación fue cancelada.                              |

Los archivos llevan su propio ciclo de vida de **10 estados**, rastreado por archivo desde la construcción hasta la transmisión y la correlación de retornos.

## Orquestación de firma

***

Lerian SLC materializa el XML ASLC sin firmar y luego **delega la firma en un backend de custodia elegido por tenant**. La clave privada nunca sale de la custodia del cliente, y Lerian nunca firma en nombre del cliente.

| Backend de custodia | Dónde vive la clave                              |
| ------------------- | ------------------------------------------------ |
| **Software key**    | Una clave en software en el entorno del cliente. |
| **PKCS#11 HSM**     | Un módulo de seguridad de hardware.              |
| **Cloud KMS**       | Un servicio de gestión de claves en la nube.     |
| **Vault**           | Un vault de secretos, por certificado.           |

En despliegues SaaS, la custodia se fija a cloud KMS vía **importación de clave envuelta del lado del cliente**: el cliente envuelve e importa su propia clave, y el servicio almacena solo el certificado público y una referencia de clave —nunca el material privado.

## Transporte

***

Las operaciones y los archivos se envían a Nuclea sobre **REST**, protegidos por **mTLS** y una firma **JWS por solicitud** (la serie en línea SLC0908 / SLC0912 / SLC0915 / SLC0999). Los retornos de entrada se sondean y confirman sobre el mismo canal REST.