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

# ¿Qué es Lerian SCR?

> Lerian SCR es una fachada REST sobre el canal de consulta wsscr2n SCR3 de BACEN. Devuelve la posición de crédito consolidada de un cliente y audita cada consulta.

**Lerian SCR** es una fachada REST sobre el servicio web **wsscr2n** de BACEN, el canal de consulta SCR3. SCR es el *Sistema de Informações de Crédito*, el sistema de información crediticia de BACEN.

Un consumidor se autentica con un token máquina a máquina y le pide a Lerian SCR la posición de crédito consolidada de un cliente. El servicio consulta a wsscr2n por la institución, decodifica el resultado, audita la consulta y la devuelve.

Cada consulta escribe una fila de auditoría. La escritura de auditoría falla en modo cerrado: si la escritura de auditoría falla, la consulta falla, y el consumidor no obtiene ningún resultado.

Una caché de resultados, un límite de concurrencia por institución, la coalescencia single-flight de consultas idénticas, y un circuit breaker por institución protegen el canal.

## Qué hace y qué no hace Lerian SCR

***

**Lerian SCR hace:**

* **Llamar al canal wsscr2n.** Emite un `GET` HTTPS a la operación `/wsscr2n/cliente/resumo` de BACEN con autenticación HTTP Basic, sobre TLS 1.2 o posterior.
* **Decodificar los campos codificados.** BACEN responde con códigos. Lerian SCR resuelve cada código contra las tablas anexas de SCR y devuelve un par `{ code, description }`.
* **Auditar cada consulta.** Una consulta escribe una fila de auditoría. Sus datos personales llevan cifrado AES-256-GCM en reposo y un índice ciego HMAC-SHA256 para la búsqueda.
* **Derivar la institución a partir del token.** Un cuerpo de solicitud, un header o un parámetro de ruta nunca la establecen.
* **Proteger el canal tarifado.** Una caché de resultados, un tope de dos conexiones por institución, la coalescencia single-flight, y un circuit breaker por institución se ubican delante de BACEN.

**Lerian SCR no hace:**

* **Usar mTLS.** El canal autentica solo al servidor y agrega HTTP Basic encima. Lerian SCR no envía ningún certificado de cliente.
* **Registrar el documento del prestatario en el log.** Ninguna línea de log, span o mensaje de error lo lleva.
* **Conservar el registro de consentimiento.** La solicitud declara la autorización del titular conforme a la LC 105/2001. El registro de consentimiento en sí permanece con la institución.
* **Crear su propio esquema de base de datos.** Un operador aplica el esquema fuera de banda antes de que el servicio se inicie.

## A quién sirve

***

Lerian SCR sirve a los consumidores internos de una institución financiera, como un consumidor de scoring que necesita la posición de crédito consolidada de un prestatario. Un despliegue sirve a una sola institución, o a varias instituciones a la vez cuando la multi-tenancy está activa.

## Glosario

***

| Término | Significado |
| - | - |
| **SCR** | *Sistema de Informações de Crédito*, el sistema de información crediticia de BACEN. |
| **SCR3** | El contrato de consulta de SCR que atiende el servicio web wsscr2n. |
| **wsscr2n** | El servicio web de BACEN para la consulta SCR3. Lerian SCR es la fachada sobre él. |
| **WSCR0001** | La transacción de Sisbacen que otorga a una institución el acceso al servicio web de consulta. La credencial del canal es el usuario de servicio virtual de la institución, no este nombre. |
| **IF** | *Instituição financeira*, la institución financiera. Un tenant de Lerian SCR. |
| **Fecha de referencia (`AAAAMM`)** | Un mes de SCR, como un entero de seis dígitos de año y mes. BACEN también lo llama *data-base*. |
| **Posición** | El panorama de crédito consolidado de un prestatario para una fecha de referencia. Un resultado vacío significa que no hay posición, no un error. |
| **Tarifa** | El cargo de BACEN por una consulta, por cliente y por fecha de referencia. Un acierto de caché no lleva tarifa. |
| **Índice ciego** | El HMAC determinístico de un documento del prestatario. Hace que una fila sea buscable y mantiene el documento fuera del texto claro. |
| **Single-flight** | La coalescencia de consultas concurrentes idénticas en una sola llamada a BACEN. |
| **Circuit breaker** | La protección por institución que detiene las llamadas a BACEN tras fallos repetidos del canal. |

Para saber cómo se ubica Lerian SCR junto a los demás rieles nativos y las interfaces de socios, consulta [Mensajería nativa e interfaces de socios](/es/rails/native-messaging).