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

> Secuencia de habilitación, flujos de transferencia y ciclo de vida, operaciones de liquidez y consultas asíncronas que componen la mensajería del STR.

Lerian SPB expone la superficie de mensajes del STR como un conjunto de operaciones tipadas. Cada flujo persiste su trabajo antes de despachar, devuelve un estado aceptado-pero-no-liquidado y se concilia contra la respuesta asíncrona del BACEN.

## Habilitación

***

La rotación de certificados y la activación GEN0006 son guía operativa, al igual que un eco de conectividad GEN0001; no son puertas exigidas por el código para enviar comandos.

Antes de producir efectos secundarios, un comando verifica la disponibilidad del riel. `READY` y `DEGRADED` admiten comandos; `PENDING_CONFIGURATION` y `UNAVAILABLE` los bloquean. La disponibilidad evalúa la configuración del canal y el estado del certificado. No exige una confirmación GEN0006 ni un eco GEN0001.

## Transferencias bancarias

***

Declaras las partes tipadas de origen y destino. La plataforma deriva el código de transferencia STR — STR0004, STR0005, STR0006, STR0007 o STR0008. Persiste la operación y el trabajo saliente, y solo entonces despacha. El riel devuelve el estado `ACCEPTED` — aceptó la solicitud, pero el BACEN aún no lo liquidó. El BACEN confirma la transferencia de forma asíncrona, y la operación pasa a `CONFIRMED` o `REJECTED`.

## Devoluciones y cancelaciones

***

Una devolución y una cancelación son ambas subrecursos de una operación padre. El id del padre en la ruta de la solicitud liga cada una a ese padre.

* Una **devolución** requiere un padre en estado de salida liquidada: `SENT`, `CONFIRMED` o `DELIVERED` (pipeline STR0010).
* Una **cancelación** requiere un padre que todavía admita una (pipeline STR0011).

El riel rechaza una solicitud contra el estado incorrecto del padre.

## Repasse del IBS

***

Un **repasse del IBS** (STR0053) transfiere los valores de liquidación del IBS desde la cuenta de reservas hacia el comité gestor. El riel traduce la solicitud al mensaje STR0053, la persiste y la despacha. El BACEN la confirma de forma asíncrona.

## Liquidez de la Conta PI

***

Dos operaciones mueven liquidez entre la cuenta de reservas-liquidación de una institución y su Conta PI:

* **Aporte** (LPI0001) fondea la Conta PI desde la cuenta de reservas.
* **Rescate** (LPI0003) devuelve fondos a la cuenta de reservas.

Ambas devuelven `PENDING`. La respuesta de liquidación entrante (LPI0001R1 / LPI0003R1) mueve la operación a `SETTLED` o `REJECTED`. Lerian SPB proyecta el valor de la respuesta literalmente. Las franjas operativas GEN0021 se persisten y se pueden consultar; no imponen un rechazo genérico de cada envío fuera de una ventana operativa. La regla explícita de admisión relacionada con el calendario es RLPI0007: durante la ventana de aporte adicional, se rechaza un aporte a una Conta PI ajena. Los aportes a la propia Conta PI de la institución y los rescates siguen permitidos.

## Política de transferencia automática

***

Declaras la regla de transferencia automática del STR para una clase de cuenta con LPI0005. El BACEN la reconoce (LPI0005R1) y más tarde reporta cada transferencia automática que realiza (LPI0006). Lerian SPB reenvía los valores reportados literalmente y no hace ninguna aritmética sobre ellos.

## Cola de aprobación para emisiones de alto valor

***

El riel clasifica cada monto declarado según bandas configuradas semiabiertas y puede aplicar una sobrescritura para un tipo de mensaje específico. La regla seleccionada determina el estado: `requiredSignatures` de `0` envía la emisión a `SUBMITTED`; un valor distinto de cero la envía a `PENDING_APPROVAL`. En el límite superior de una banda aplica la siguiente; por encima de todos los límites, aplica el requisito del nivel superior. Un operador puede firmar o denegar una emisión en cola. La configuración de gobernanza se recarga en caliente mediante Systemplane.

## Composición curada de mensajes

***

Una superficie de composición controlada por catálogo construye un tipo de mensaje STR de una lista permitida (STR0004, STR0005, STR0006, STR0007, STR0008 o STR0053). El tipo elegido debe resolverse en el catálogo de capacidades y ser públicamente enviable. De lo contrario, el riel rechaza la solicitud.

## Consultas asíncronas de una sola parte

***

Las lecturas de posición de reservas y de calendario devuelven un id de correlación con `PENDING`. La respuesta del BACEN llega de forma asíncrona. La relees por ese id de correlación. Lerian SPB proyecta lo que el BACEN envía y no calcula ninguna posición propia.

| Consulta                       | Código STR | Devuelve                                                                 |
| ------------------------------ | ---------- | ------------------------------------------------------------------------ |
| Saldo de la cuenta de reservas | STR0013    | Id de correlación + `PENDING`, luego el saldo que reporta el BACEN       |
| Extracto de reservas           | STR0014    | Id de correlación + `PENDING`, luego el extracto en modo mensaje         |
| Calendario operativo del STR   | STR0001    | Id de correlación + `PENDING`, luego las franjas de la ventana operativa |

## Avisos entrantes y roster

***

* El riel registra los **avisos** (GEN0001, GEN0004, GEN0005) en un log de avisos consultable.
* Las **difusiones de calendario** (GEN0021) actualizan las franjas de la ventana operativa —gana el último anuncio—.
* Un envío de **roster de responsables** (GEN0019) reemplaza por completo el roster del participante.

## Conciliación y recuperación

***

Las discrepancias de liquidación abren casos de conciliación. Los operadores registran acciones `ACKNOWLEDGE`, `RESOLVE`, `DISMISS` o `INVESTIGATE` sobre un caso. El riel bloquea un caso terminal. Una vista de operaciones atascadas entre rieles lista los elementos que necesitan atención. Expone solo las acciones que el riel puede realizar.
