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

> Los dos sentidos de transferencia — envío saliente y descubrimiento y descarga entrantes — la máquina de estados del protocolo del BACEN, la verificación de integridad por SHA-256, los presupuestos de reintento y el TTL del protocolo, y las acciones del operador sobre una transferencia.

Lerian STA mueve archivos en dos sentidos. Cada intercambio es una **transferencia** — un único archivo que se mueve entre la institución y el BACEN — rastreada por su **número de protocolo** a lo largo del ciclo de vida del protocolo del BACEN, con el **SHA-256** verificado en ambos extremos.

## Envío saliente

***

La institución, o un producto de Lerian aguas arriba, le entrega a Lerian STA un archivo para el BACEN. Lerian STA obtiene entonces un **número de protocolo** del BACEN, sube los bytes del archivo y hace que el BACEN los valide contra el **SHA-256** declarado.

La transferencia avanza por el ciclo de vida del BACEN:

| Estado                         | Significado                                           |
| ------------------------------ | ----------------------------------------------------- |
| **Protocolo generado**         | El BACEN ha asignado el número de protocolo.          |
| **Transmitiendo**              | Lerian STA está subiendo los bytes.                   |
| **Verificación de integridad** | El BACEN está validando el SHA-256 declarado.         |
| **Recibido**                   | El BACEN ha recibido el archivo.                      |
| **Entregado**                  | El BACEN ha entregado el archivo a su destino.        |
| **En procesamiento**           | El BACEN está procesando el archivo.                  |
| **Aceptado**                   | El BACEN ha aceptado el archivo — un éxito terminal.  |
| **Rechazado / Inconsistente**  | El BACEN ha rehusado el archivo — una falla terminal. |

La subida reintenta dentro de un **presupuesto acotado**; una vez agotado el presupuesto, la transferencia se cancela. Cada protocolo lleva además un **TTL** acotado de reloj de pared — 44 horas por defecto — para terminar la subida antes de que el BACEN lo expire.

## Descubrimiento y descarga entrantes

***

Lerian STA sondea al BACEN por cada tenant activo con una cadencia configurada en busca de archivos disponibles. Para cada archivo, coteja el **código de sistema del BACEN** del archivo contra las **configuraciones de fuente entrante** del tenant, luego descarga los bytes, los verifica contra el **SHA-256** que el BACEN reporta y almacena el artefacto de forma duradera en object storage.

Un desajuste de hash o una falla de descarga reintenta dentro de un presupuesto acotado. Una vez agotado el presupuesto, la transferencia se **pone en cuarentena** hacia una falla terminal — inconsistente o cancelada — en lugar de entregarse a su producto fuente.

## Acciones del operador

***

Un operador puede actuar sobre una transferencia que no ha alcanzado un estado terminal:

* **Cancelar** una transferencia no terminal.
* **Reintentar** una transferencia saliente fallida.
* **Marcar como urgente** para priorizar su manejo.

La cancelación también es **iniciada por el BACEN** cuando un protocolo expira.
