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

> Dos sentidos de transferencia (saliente y entrante), máquina de estados del BACEN, verificación SHA-256, reintentos, TTL y acciones del operador.

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. Un **número de protocolo** rastrea la transferencia a lo largo del ciclo de vida del protocolo del BACEN. Cada extremo verifica el **SHA-256**.

## 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. El BACEN valida los bytes 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 que Lerian STA agota el presupuesto de reintentos, cancela la transferencia. Cada protocolo lleva además un **TTL** acotado de reloj de pared — 44 horas por defecto. Lerian STA debe terminar la subida antes de que el BACEN expire el protocolo.

## Descubrimiento y descarga entrantes

***

Lerian STA sondea al BACEN en busca de archivos disponibles, por cada tenant activo, con una cadencia configurada.

Para cada archivo, Lerian STA coteja el **código de sistema del BACEN** del archivo contra las **configuraciones de fuente entrante** del tenant. Luego descarga los bytes. Verifica los bytes contra el **SHA-256** que el BACEN reporta. Almacena el archivo de forma duradera en object storage.

Un desajuste de hash o una falla de descarga reintenta dentro de un presupuesto acotado. Una vez que Lerian STA agota el presupuesto, pone la transferencia en cuarentena hacia una falla terminal — inconsistente o cancelada. No la entrega a su producto fuente.

## Acciones del operador

***

Un operador solo puede actuar cuando el estado y la configuración de la transferencia lo permiten:

* **Cancelar** solo cuando la máquina de estados canónica permite la transición a `Canceled`; no se permite desde todos los estados no terminales.
* **Reintentar** una transferencia saliente solo si no es terminal, aún tiene presupuesto de carga y el TTL del protocolo no venció.
* **Marcar como urgente** solo una transferencia entrante en `AvailableForDownload` cuya configuración de fuente tenga habilitada la urgencia; de otro modo falla de forma cerrada.

Lerian STA también cancela una transferencia cuando su protocolo del BACEN expira.