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

# Gestión de instituciones

> Registra las instituciones para las que tu tenant presenta informes en el módulo Reporter de Lerian Console: CNPJ, alcance de datos por fuente de datos y propuestas leídas desde Midaz.

Una **institución** es un declarante regulatorio de tu tenant. Cada institución declara con su propio CNPJ y lee solo las filas que nombra su alcance. Gestiona las instituciones en la página **Institutions** de Reporter en [Lerian Console](https://docs.lerian.studio/es/platform/console/about-lerian-console.md).

Los informes, los plazos regulatorios y las presentaciones regulatorias usan las instituciones que registras aquí. Consulta [Dónde se aplican las instituciones](#where-institutions-apply).

## Acceder a la página Institutions

***

Para abrir la página **Institutions**, haz clic en **Settings** en el menú lateral izquierdo de la página **Reporter** y luego en **Institutions**.

La página lista las instituciones en una tabla con estas columnas: **Name**, **CNPJ**, **Data Sources**, **Last Modified** y **Actions**. La columna **Data Sources** nombra cada fuente de datos del alcance de la institución. Muestra **None** cuando el alcance está vacío.

El menú () de cada fila tiene **Edit** y **Delete**.

Cada acción en la pantalla Institutions necesita el permiso `institutions` correspondiente: `get` para ver y proponer instituciones, `post` para crear y confirmar, `put` para editar y `delete` para eliminar.

## Agregar una institución

***

**1. Abre el formulario**

En la página **Institutions**, haz clic en **New Institution**.

**2. Identifica la institución**

Ingresa el **Business name** y el **CNPJ**. El CNPJ puede ser numérico o alfanumérico, con o sin puntuación.

**3. Define el alcance**

Haz clic en **Add data source** y selecciona una fuente de datos. Luego indica a Reporter cuáles de sus filas pertenecen a la institución. Consulta [Reglas de alcance](#scope-rules).

**4. Guarda**

Haz clic en **Save**. Si Reporter rechaza la institución, el formulario muestra el motivo y conserva lo que escribiste.

### Reglas de alcance

El alcance nombra las filas de cada fuente de datos que pertenecen a la institución. Una institución sin ninguna fuente de datos en su alcance no lee nada.

Para cada fuente de datos, elige una de estas opciones:

* **The whole data source belongs to this institution**: la institución lee cada tabla de la fuente de datos.
* **Tables**: haz clic en **Add table** e ingresa el nombre de la tabla. Para cada tabla, elige una de estas opciones:
  * **Shared: every institution reads this table whole**: úsala para datos de referencia que necesita cada institución.
  * **Conditions**: haz clic en **Add condition**, escribe el **Field**, selecciona un **Operator** y escribe los **Values**, separados por comas. Una tabla con condiciones necesita al menos una condición con el operador **Equal** o el operador **In**. Estos dos operadores reclaman las filas de la institución.

### Guía de campos

| Campo | Qué ingresar | Ejemplo |
| - | - | - |
| **Business name** | Obligatorio. El nombre del declarante, de hasta 255 caracteres. | `Banco Exemplo S.A.` |
| **CNPJ** | Obligatorio. El formulario comprueba los dígitos verificadores. | `12.345.678/0001-95` |
| **Data source** | Una fuente de datos registrada en la página **Data Sources**. Una fuente de datos aparece una vez en un alcance. | `midaz-postgres` |
| **Table** | Una tabla de la fuente de datos. Una tabla aparece una vez en una fuente de datos. Escribe una tabla de otro esquema como `schema__table`. Escribe del mismo modo una colección cuyo nombre tiene un punto. | `account`, `audit__events` |
| **Field** | La columna que identifica las filas de la institución. | `organization_id` |
| **Operator** | **Equal**, **In**, **Not In**, **Greater Than**, **Greater or Equal**, **Less Than**, **Less or Equal** o **Between**. | **Equal** |
| **Values** | Uno o más valores, separados por comas. | `00000000-0000-0000-0000-000000000000` |

## Proponer instituciones desde Midaz

***

Reporter puede leer la tabla de organizaciones de Midaz y proponer una institución para cada organización que todavía no está registrada.

**1. Abre el panel de propuestas**

En la página **Institutions**, haz clic en **Propose from Midaz**.

**2. Selecciona las fuentes de datos**

En **Data sources to read**, selecciona las fuentes de datos PostgreSQL que leen Midaz. El panel lista las fuentes de datos PostgreSQL que registraste. No lista las fuentes de datos que provee la plataforma.

**3. Busca las propuestas**

Haz clic en **Find proposals**. Cada propuesta muestra el nombre, el CNPJ y el alcance propuesto en cada fuente de datos.

**4. Confirma una propuesta**

Haz clic en **Confirm** en una propuesta. El formulario **New Institution** se abre con la propuesta completada. Revísala y luego haz clic en **Save**. Cuando cierras el formulario, el panel de propuestas se abre de nuevo.

> [!WARNING]
>
> Midaz no comprueba los dígitos verificadores del CNPJ. Una propuesta con un CNPJ incorrecto muestra una advertencia. Corrige el CNPJ en el formulario antes de guardar.

## Editar una institución

***

Haz clic en el nombre de la institución, o selecciona **Edit** en el menú de la fila. Cambia los campos y luego haz clic en **Save**.

## Eliminar una institución

***

Selecciona **Delete** en el menú de la fila y confirma. Después de la eliminación, puedes registrar el mismo CNPJ de nuevo de inmediato.

## Dónde se aplican las instituciones

***

| Dónde | Qué pide la Console |
| - | - |
| **Reports** > **Generated Reports** > **New Report** | Con una institución, el asistente la usa. Con varias, elige una institución o **All institutions**. Sin ninguna, el asistente no pregunta. |
| **Overview** > **Add Reminder**, tipo **Regulatory** | La misma regla que para un informe. |
| **Regulatory Filings** > **Catalog** > **Subscribe** | Con una institución, el diálogo la usa. Con varias, elige la institución que presenta el documento. Una presentación nunca ofrece **All institutions**. Registra al menos una institución antes de suscribirte a un documento. |

Cuando el tenant tiene varias instituciones, **My Regulatory Documents** también muestra estos elementos:

* Un filtro **Institution** muestra una institución a la vez. Selecciona **All institutions** para ver todas las suscripciones y la institución para la que presenta cada una. Una suscripción sin institución muestra **No institution set**. Define la institución antes de generar un borrador.
* **Set institution**, en el menú de una suscripción, define la institución de las próximas presentaciones. Aparece solo para una suscripción sin institución. Los informes ya generados conservan su institución.

En el **Catalog**, la tarjeta de un documento suscrito muestra **Subscribe for another institution** cuando una institución todavía no lo presenta.

Abrir **Filings**, la página de una presentación y **Download** también requiere `reports:get`. Para suscribirte a un documento, generar y corregir sus presentaciones y actualizar su versión, necesitas `regulatory:post`. Para asignar sus campos y definir su institución, necesitas `regulatory:put`. Para desactivar una suscripción, necesitas `regulatory:delete`. Para aprobar un borrador, necesitas `regulatory-approval:post`.

## Próximos pasos

***

* Usa [Genera un informe](https://docs.lerian.studio/es/products/reporter/console/generating-a-report.md) para generar un informe para una institución.
* Usa [Gestión de fuentes de datos](https://docs.lerian.studio/es/products/reporter/console/managing-data-sources.md) para registrar las fuentes de datos que nombra un alcance.

> [card] Equivalente en la API
>
> [Endpoint de creación de institución](https://docs.lerian.studio/es/reference/products/reporter/create-institution.md) y [Endpoint de propuesta de instituciones](https://docs.lerian.studio/es/reference/products/reporter/propose-institutions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.