Recepción
Las operaciones ingresan a Lerian SLC a través de la API de operaciones:
- Recepción individual. Una operación como JSON. La clave de deduplicación del llamador es
externalId. Un envío reintentado nunca se liquida dos veces. - Recepción por lotes. NDJSON, una operación por línea, hasta 50,000 líneas de forma predeterminada. Lerian SLC cuenta las líneas y los bytes antes de guardar nada, así que un lote que supera el límite responde 413 y no guarda nada. Una línea inválida se rechaza sola y no detiene el lote.
Enviar, firmar, transmitir, correlacionar
Lerian SLC envía dos tipos de tráfico a Núclea:
- Envíos en línea. Las operaciones de crédito, débito y anticipo van a Núclea como envíos JSON: SLC0914 para un crédito, SLC0913 para un débito y SLC0912 para un anticipo. Lerian SLC sondea SLC0915 para obtener el veredicto de Núclea sobre cada envío.
- Archivos ASLC. Las cancelaciones, los reenvíos a la IF Domicílio, las retransmisiones de estado a la credenciadora y los resúmenes del sweep viajan como archivos ASLC. Lerian SLC construye cada archivo como UTF-16BE sin BOM y valida esos bytes finales contra el XSD del mensaje antes de construir el envelope de seguridad. Comprime el archivo con GZIP y lo envuelve en el envelope de seguridad SPB, que un backend de custodia firma (consulta Orquestación de la firma).
externalId de la operación, rellenado con ceros a la izquierda cuando es más corto. Una línea ASLC023 o D+1 usa su NUliquid. Un PRO en el nivel de archivo, y un RET de ASLC060 o ASLC064, usan el número de control del archivo transmitido. Una línea cuya clave no coincide con nada se omite como no correlacionada.
Cuando un retorno se contradice a sí mismo
Un solo archivo de retorno puede indicar dos resultados diferentes para la misma referencia. Lerian SLC lo resuelve por política, sin importar el orden de las líneas en el archivo:- un resultado: se aplica tal como se indica.
- el mismo resultado repetido: se aplica exactamente una vez.
- una aceptación y un rechazo para la misma referencia: el rechazo gana, y Lerian SLC registra y cuenta la aceptación desplazada.
Familias de mensajes
Flujos de liquidación
- Crédito, débito y anticipo. Lerian SLC envía la operación y lee el veredicto de Núclea. Después de que Núclea la acepta, Lerian SLC reenvía el aviso de liquidación a la IF Domicílio a través de Núclea. Lee la respuesta de la IF Domicílio y la retransmite a la credenciadora. El resultado D+1 de la IF Domicílio cierra el ciclo de vida.
- Cancelación. La credenciadora informa una cancelación (crédito ASLC060, débito ASLC064). Lerian SLC la reenvía a la IF Domicílio (ASLC061, ASLC065) y lee la respuesta (ASLC062, ASLC066). Cuando la IF Domicílio confirma la cancelación, Lerian SLC emite
cancellation.confirmed_by_domicile.
Compensación y financiamiento para la IF Liquidante
Para la institución liquidante, Lerian SLC consume los mensajes de compensación de Núclea a través de la RSFN: la posición de compensación preliminar y final (SLC0001) y la divergencia de movimiento bilateral (SLC0002). GEN0015 informa un archivo disponible para recoger, y PAG0101 lleva el estado operacional de un participante. Desde Lerian SILOC, recibe la apertura (PAG0102) y el cierre (PAG0103) del ciclo y el valor del depósito (LDL0021). Lerian SLC mantiene la posición de compensación por ciclo de liquidación. Cuando un ciclo cierra, compara la instrucción de liquidación de cada participante con la posición final y marca el ciclo como conciliado cuando coinciden. Genera un evento
clearing.* para cada paso.
- Lerian SLC retransmite el valor del depósito a la institución como
clearing.deposit_required. - La institución hace el depósito en su propia conexión STR. Lerian SLC no envía el mensaje de depósito.
- La institución registra el resultado con el acuse de depósito,
SENToFAILED.SENTconfirma la instrucción de liquidación.FAILEDqueda registrado, deja la instrucción abierta y generafunding.deposit_failed. - Una operación de crédito o débito pasa de CONFIRMED a SETTLED cuando existen ambas confirmaciones: el acuse de depósito de la institución y el cierre del ciclo de Núclea.
Liquidación bruta (LBTR)
Desde Lerian SILOC, Lerian SLC recibe los avisos de liquidación bruta: un resultado de liquidación (LTR0001), una operación entre dos no liquidantes propios de la institución (LTR0007) y la cancelación de un resultado (LTR0012). La institución responde a través de Lerian SILOC:
- LTR0002 confirma un resultado o diverge de él.
- LTR0008 confirma o rechaza una operación de no liquidante.
- LTR0009 solicita la posición LBTR de la institución.
STREAMING_ENABLED es false, Lerian SLC no los entrega.
Ciclo de vida de la operación
Cada operación sigue un ciclo de vida de once estados. Núclea asigna su NUliquid cuando se acepta la operación.
Orquestación de la firma
Lerian SLC construye el payload sin firmar y delega la firma a un backend de custodia. Cada certificado registrado nombra su backend.
Los despliegues SaaS fijan la custodia en AWS KMS. Lerian SLC nunca recibe la clave privada de firma en texto claro: el cliente envuelve su material de clave localmente con un token de importación, y el servicio importa el material envuelto a una clave KMS para ese tenant y participante. El servicio almacena el certificado público y una referencia de clave.
Transporte
Lerian SLC transmite sus envíos en línea y sus archivos ASLC a Núclea a través de REST, protegido por mTLS y una firma JWS por solicitud. Sondea y confirma los retornos de Núclea por el mismo canal.
Defines el transporte saliente en tiempo de ejecución, y REST es el valor predeterminado. Un tenant configurado para Connect:Direct falla de forma cerrada con un error de transporte tipado. No recurre a REST.

