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

# Integración con Lerian STA

> Qué emite Lerian STA — los eventos terminales por transferencia sobre un outbox transaccional en un canal de auditoría y un canal de negocio firmado, el claim-check que lleva el éxito entrante, y la cadena de reconciliación de STA a consumidor a Midaz.

Lerian STA es orientado a eventos en sus bordes. Publica un **evento terminal por transferencia** a través de un **outbox transaccional**, de modo que un evento llega a los consumidores si y solo si el cambio de estado de la transferencia se ha confirmado. Los consumidores son los servicios de **producto fuente** que poseen los archivos que Lerian STA entrega.

## Canales de eventos

***

Lerian STA publica en dos canales:

* Un **canal de auditoría**, indexado por el **producto fuente** del archivo, que lleva los hechos de éxito entrante y de falla entrante para observabilidad y reconciliación.
* Un **canal de negocio firmado**, indexado por **sentido y producto fuente**, para consumidores de producto externos. Sus tipos de evento terminales son `sta.transfer.accepted`, `sta.transfer.rejected`, `sta.transfer.inconsistent`, `sta.transfer.canceled` y `sta.transfer.download_finished`.

Cada evento lleva un **código de error** enumerado y, en el éxito entrante, el **claim-check**.

## El claim-check

***

Al completarse una descarga entrante, Lerian STA emite su evento terminal de **descarga finalizada**, indexado por el producto fuente del archivo. El evento lleva un **claim-check** — el object key, el SHA-256, el tamaño, el nombre del archivo y el tipo de documento — pero no los bytes mismos.

El producto de dominio consumidor se suscribe a su propia clave, recupera el artefacto duradero por su object key, **vuelve a verificar** el SHA-256 y reconcilia el resultado en el ledger de **Midaz**. Lerian STA es el límite de transporte e integridad; el producto consumidor posee la contabilización en el ledger.

## Límite con Midaz

***

Lerian STA no escribe en Midaz por sí mismo. Entrega el archivo y el claim-check; el producto consumidor — por ejemplo, **Lerian SISBAJUD** para archivos de órdenes judiciales de activos — realiza la reconciliación en el ledger. Esto mantiene a Lerian STA como una capa pura de transporte e integridad, independiente del significado de negocio de cualquier archivo.

## Convenciones de integración

***

* **Eventos acoplados al commit.** Cada evento fluye por el outbox transaccional, de modo que se publica solo cuando el cambio de estado de su transferencia se ha confirmado.
* **Claim-check, no payload.** Los consumidores reciben una referencia al artefacto duradero, lo recuperan y vuelven a verificar su SHA-256 antes de actuar sobre él.
* **Suscripción por clave.** Cada consumidor de producto fuente se suscribe solo a su propia clave, de modo que un archivo descubierto llega exactamente al producto que lo posee.