> ## 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 habilitación, los flujos de transferencia y de ciclo de vida, las operaciones de liquidez y las consultas asíncronas que componen la superficie de mensajes 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 habilitación sigue un orden obligatorio, y cada paso es su propio recurso. Un envío intentado antes de superar la verificación de disponibilidad es rechazado.

1. **Rota** el certificado de firma ICP-Brasil.
2. **Actívalo** ante el BACEN (GEN0006, confirmado por GEN0006R1).
3. Confirma que el riel reporta **`READY`**.
4. Supera una **prueba de eco de conectividad** (GEN0001, respondida por GEN0001R1).
5. A partir de aquí se permiten los envíos.

## 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. La respuesta es `SUBMITTED` —el despacho fue aceptado, no liquidado—. El BACEN confirma de forma asíncrona, y la operación pasa a `SETTLED` o `REJECTED`.

## Devoluciones y cancelaciones

***

Una devolución y una cancelación son ambas subrecursos de una operación padre y están ligadas estructuralmente a ella por el id del padre en la ruta de la solicitud.

* Una **devolución** requiere que el padre esté `SETTLED` (pipeline STR0010).
* Una **cancelación** requiere que el padre todavía admita una (pipeline STR0011).

Una solicitud contra el estado incorrecto del padre es rechazada.

## Repase del IBS

***

Un **repase del IBS** (STR0053) transfiere los valores de liquidación del IBS desde la cuenta de reservas hacia el comité gestor. La solicitud se traduce al mensaje STR0053, se persiste, se despacha y se 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`, proyectada literalmente. Un aporte enviado fuera de la ventana operativa es rechazado.

## Política de transferencia automática

***

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

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

***

Cada emisión se verifica contra una banda de valor configurada. Un envío cuyo monto supera su banda queda en `PENDING_APPROVAL` y aparece en la cola de aprobación; solo despacha una vez que se alcanza el quórum de aprobación. Un monto por debajo de la banda pasa directamente a `SUBMITTED`. Las emisiones en cola pueden firmarse o denegarse.

## 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, la solicitud es rechazada.

## Consultas asíncronas de una sola parte

***

Las lecturas de posición de reservas y de calendario devuelven un id de correlación y `PENDING`; la respuesta del BACEN llega de forma asíncrona y se relee por ese id. 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

***

* Los **avisos** (GEN0001, GEN0004, GEN0005) se registran literalmente.
* Las **difusiones de calendario** (GEN0021) actualizan las franjas de la ventana operativa —gana el último anuncio—.
* El **roster de responsables** completo del participante se anuncia por reemplazo total (GEN0019).

## 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, y los casos terminales quedan bloqueados. Una vista de operaciones atascadas entre rieles lista los elementos que requieren atención, exponiendo solo las acciones que el riel realmente puede realizar.