> ## 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](/es/platform/console/about-lerian-console).

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 **Institutions** en el menú lateral izquierdo de la página **Reporter**.

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ú (<Icon icon="ellipsis-vertical" />) 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

***

<Steps>
  <Step title="Abre el formulario">
    En la página **Institutions**, haz clic en **New Institution**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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).
  </Step>

  <Step title="Guarda">
    Haz clic en **Save**. Si Reporter rechaza la institución, el formulario muestra el motivo y conserva lo que escribiste.
  </Step>
</Steps>

<h3 id="scope-rules">
  Reglas de alcance
</h3>

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. | `account` |
| **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.

<Steps>
  <Step title="Abre el panel de propuestas">
    En la página **Institutions**, haz clic en **Propose from Midaz**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Busca las propuestas">
    Haz clic en **Find proposals**. Cada propuesta muestra el nombre, el CNPJ y el alcance propuesto en cada fuente de datos.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<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.
</Warning>

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

<h2 id="where-institutions-apply">
  Dónde se aplican las instituciones
</h2>

***

| Dónde | Qué pide la Console |
| - | - |
| **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 Filing** > **Activate document** | 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 activar un documento. |

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

* Cada suscripción muestra la institución para la que presenta, o **No institution set**. Define la institución antes de generar un borrador.
* **Activate for another institution** aparece en un documento activado cuando una institución todavía no lo presenta.
* **Set institution**, en el menú de una suscripción, cambia la institución de las próximas presentaciones. Los informes ya generados conservan su institución.

Para suscribirte a un documento y generar, corregir o adoptar sus presentaciones, 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](/es/products/reporter/console/generating-a-report) para generar un informe para una institución.
* Usa [Gestión de fuentes de datos](/es/products/reporter/console/managing-data-sources) para registrar las fuentes de datos que nombra un alcance.

<Card title="Equivalente en la API" type="tip" horizontal>
  [Endpoint de creación de institución](/es/reference/products/reporter/create-institution) y [Endpoint de propuesta de instituciones](/es/reference/products/reporter/propose-institutions)
</Card>


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