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

> La secuencia de incorporación, los flujos de transferencia y ciclo de vida, las operaciones de liquidez y las consultas asíncronas que conforman la superficie de mensajes de STR.

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

## Incorporación

***

La rotación de certificados y la activación GEN0006 son guías operativas, al igual que un eco de conectividad GEN0001. No son barreras exigidas por el código para enviar comandos.

Antes de generar 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 requiere un acuse de recibo GEN0006 ni un eco GEN0001.

## Transferencias bancarias

***

Declaras las partes tipadas de remitente y destinatario. La plataforma deriva el código de transferencia STR: STR0004, STR0005, STR0006, STR0007 o STR0008. Conserva la operación y el trabajo saliente, y solo entonces lo envía. El riel devuelve el estado `ACCEPTED`. Aceptó la solicitud, pero BACEN todavía no la liquidó. 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 principal. El id de la operación principal en la ruta de la solicitud vincula cada una con esa operación principal.

* Una **devolución** requiere una operación principal en un estado saliente liquidado: `SENT`, `CONFIRMED` o `DELIVERED` (proceso STR0010).
* Una **cancelación** requiere una operación principal que todavía la admita (proceso STR0011).

El riel rechaza una solicitud contra el estado incorrecto de la operación principal.

## IBS repasse

***

Un **IBS repasse** (STR0053) transfiere los valores de liquidación de IBS desde la cuenta de reservas hacia el comité gestor. El riel traduce la solicitud al mensaje STR0053, la conserva y la envía. 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) financia la Conta PI desde la cuenta de reservas.
* **Resgate** (LPI0003) recupera los fondos de vuelta a la cuenta de reservas.

Ambas devuelven `PENDING`. La respuesta de liquidación entrante (LPI0001R1 / LPI0003R1) lleva la operación a `SETTLED` o `REJECTED`. Lerian SPB proyecta el valor de la respuesta tal cual. Las franjas de la ventana operativa de GEN0021 se conservan y se pueden consultar. No imponen un rechazo genérico de todo envío fuera de una ventana operativa. La regla explícita de admisión relacionada con el horario es RLPI0007: durante la ventana de aporte adicional, se rechaza un aporte a una Conta PI extranjera. Los aportes a la propia Conta PI de la institución y los resgates siguen permitidos.

## Política de transferencia automática

***

Declaras la regla de transferencia automática de STR para una clase de cuenta con LPI0005. BACEN la reconoce (LPI0005R1) y luego informa cada transferencia automática que hace (LPI0006). Lerian SPB reenvía los valores informados tal cual y no hace ningún cálculo sobre ellos.

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

***

El riel clasifica cada monto declarado contra bandas configuradas semiabiertas y puede aplicar una anulación para un tipo de mensaje específico. La regla seleccionada determina el estado: un `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 de una banda, se aplica la siguiente banda. Por encima de todos los límites, se aplica el requisito del nivel superior.

Un operador puede firmar o rechazar una emisión en cola. La configuración de gobernanza se recarga en caliente a través de Systemplane.

## Composición curada de mensajes

***

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

## Consultas asíncronas de una sola parte

***

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

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

## Avisos entrantes y lista

***

* El riel registra los **avisos** (GEN0001, GEN0004, GEN0005) en un registro de avisos consultable.
* Las **difusiones de horario** (GEN0021) actualizan las franjas de la ventana operativa. Prevalece el último anuncio.
* Un envío de **roster de responsável** (GEN0019) reemplaza por completo la lista 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` contra un caso. El riel bloquea un caso terminal. Una vista de operaciones estancadas entre rieles enumera los elementos que necesitan atención. Expone solo las acciones que el riel puede hacer.
