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