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.
Construir, firmar, transmitir, correlacionar
Cada operación fluye por un único pipeline:
- Validar la operación contra los XSD de Nuclea.
- 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.
- 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.
- Transmitir el archivo a Nuclea sobre REST, protegido por mTLS y una firma JWS por solicitud.
- 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. |
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. |
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.

