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

> Integración con Lerian STA: registros de auditoría y negocio en outbox transaccional, claim-check de entrada y enrutamiento por producto fuente.

Lerian STA está orientado a eventos en sus bordes. Una transición terminal puede crear atómicamente registros separados de auditoría y negocio mediante **outboxes transaccionales**, con un sumidero adicional de log duradero posterior al commit. Un registro de outbox llega a los consumidores solo cuando el cambio de estado de la transferencia se confirma. 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** que lleva los hechos de éxito entrante y de falla entrante para observabilidad y reconciliación.
* Un **canal de negocio firmado**, enrutado como `sta.{direction}.{sanitized-source-product}` con fallback `unrouted`, 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`.

Los eventos de negocio llevan un **código de error** enumerado solo para resultados sin éxito; los eventos exitosos `Accepted` y `DownloadFinished` lo omiten. Los eventos de éxito entrante llevan el **claim-check**.

## El claim-check

***

Al completarse una descarga entrante, Lerian STA emite su evento terminal de **descarga finalizada**, enrutado por el producto fuente del archivo. El evento lleva un **claim-check** — `object_key`, `sha256`, `size_bytes` y `file_name` — pero no los bytes mismos. `document_type` se incluye solo cuando no está vacío.

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

## Límite del ledger

***

Lerian STA no escribe por sí mismo en el ledger del cliente. Entrega el archivo y el claim-check. El producto consumidor realiza la reconciliación en el ledger — por ejemplo, **Lerian SISBAJUD** para archivos de órdenes judiciales de activos. 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 registro de outbox de auditoría o negocio queda disponible solo después de que el cambio de estado de su transferencia se confirma.
* **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.** Los clientes eligen sus suscripciones del broker. STA enruta los eventos de negocio firmados por dirección y producto fuente saneado, con fallback `unrouted`; no impone que solo un suscriptor pueda recibir un archivo.