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

# Regulatory Filing

> Suscríbete a un documento regulatorio para una institución, asigna tus tablas a sus campos y luego genera, corrige y aprueba la presentación en el módulo Reporter de Lerian Console.

Reporter tiene tres pantallas regulatorias, en el grupo **Regulatory Filings** del menú de la izquierda. Reporter guarda el contrato de cada documento: los campos que necesita su archivo. Te suscribes a un documento, asignas tus tablas y columnas a sus campos y generas un borrador. Luego corriges el borrador si es necesario y lo apruebas. El borrador aprobado se convierte en la presentación.

| Pantalla | Qué hace |
| - | - |
| **Catalog** | Lista los documentos que este entorno puede presentar. Aquí te suscribes. |
| **My Regulatory Documents** | Lista tus suscripciones. Aquí verificas la preparación, abres el mapeo y gestionas las versiones. |
| **Filings** | Lista los borradores y las presentaciones aprobadas. Aquí generas, corriges, apruebas y descargas. |

Una presentación se hace para una institución. Registra al menos una institución en la página [Institutions](https://docs.lerian.studio/es/products/reporter/console/managing-institutions.md) antes de suscribirte a un documento.

## Explorar el catálogo

***

En el menú de la izquierda de la página de **Reporter**, abre **Regulatory Filings** y luego **Catalog**. Cada tarjeta muestra el título y la versión del documento.

La línea **Reference mapping** de una tarjeta indica si Lerian incluye un mapeo para Midaz. Con un mapeo de referencia, te suscribes sin asignar nada. El mapeo de referencia necesita una cuenta COSIF en cada ruta de operación y el CNPJ de la organización. Sin uno, asignas los campos desde el principio.

Cuando hay una versión más nueva de un documento, la tarjeta muestra **Update**. Ese botón actualiza todas las suscripciones activas que están atrás. Una suscripción inactiva mantiene su versión. Una suscripción sigue generando con su versión adoptada hasta que la actualizas.

Cuando el catálogo está vacío, no hay ningún documento regulatorio montado en este entorno. Un administrador monta el catálogo regulatorio en el servicio Reporter.

## Suscribirse a un documento

***

**1. Abrir el diálogo**

En una tarjeta del **Catalog**, haz clic en **Subscribe**. Se abre el diálogo **Subscribe to document**.

**2. Elegir la institución**

Con una institución, el diálogo la usa. Con varias, elige la institución que presenta el documento.

**3. Elegir el mapeo**

Cuando el documento incluye un mapeo de referencia, elige **Use the reference mapping for Midaz** o **Map my own database**. **Map my own database** empieza desde un mapeo vacío. Sin un mapeo de referencia, el diálogo no pregunta.

**4. Suscribirse**

Haz clic en **Subscribe**. El diálogo **Document subscribed** muestra lo que el mapeo inicial puede leer ahora y lo que no puede leer.

La suscripción fija la versión publicada más reciente del documento. Para cambiar la versión después, usa **Update**. Consulta [Gestionar una suscripción](#manage-a-subscription).

## Asignar los campos

***

En **My Regulatory Documents**, selecciona **Open mapping** en el menú () de una suscripción. La página del mapeo muestra la versión del mapeo y dos secciones:

* **What this mapping reads**: las consultas del mapeo. Una consulta lee una tabla de una de tus fuentes de datos, o las filas de otra consulta. Para agregar una consulta que lee una tabla, haz clic en **Add query**. Una consulta puede unir tablas, filtrar filas y calcular un valor y dar a un valor el signo de más o de menos a partir de otra columna. También puede agrupar y sumar filas, y leer cada elemento de una lista en una colección de MongoDB. **Preview the rows** muestra las primeras filas que devuelve una consulta. No guarda nada.
* **What the document asks for**: una fila por cada campo que declara el regulador. Para cada conjunto, elige la consulta que llena sus filas. Luego elige de dónde se lee cada campo. Un conjunto que el documento permite consolidar también acepta consultas de tus otras fuentes de datos.

| De dónde se lee el campo | Qué ingresas |
| - | - |
| **A column of this set query** | La columna de la consulta que llena el conjunto. |
| **A column matched onto the published rows** | La columna. Esta opción aparece cuando el documento publica filas para el conjunto. |
| **The same value every time** | El valor. |
| **A value given when the filing is generated** | El parámetro del documento que llena el campo. |
| **Filled by a person on the draft** | Un valor, o una nota que dice lo que todavía falta. Reporter rechaza un campo sin valor y sin nota. |

Haz clic en **Save mapping**. Si Reporter rechaza el mapeo, la página muestra el motivo y conserva tus cambios.

Un mapeo de referencia se abre bloqueado. Para editarlo, haz clic en **Edit mapping** y confirma que lo sacas de la referencia. Aun así, puedes agregar fuentes de tus otras fuentes de datos a los conjuntos que lo permiten, sin desbloquear la referencia. Para empezar de nuevo, haz clic en **Start over** y luego selecciona **Restore the reference mapping for Midaz** o **Start from a blank mapping**. Cuando restauras el mapeo de referencia, las fuentes adicionales se conservan. Las presentaciones ya generadas conservan el mapeo que las generó.

## Verificar la preparación

***

En **My Regulatory Documents**, Reporter verifica cada suscripción activa contra tus bases de datos como están ahora. La columna **Readiness** muestra el resultado. Haz clic en el resumen para abrir o cerrar los detalles. Las suscripciones desactivadas quedan ocultas hasta que selecciones **Show deactivated**.

| Resultado | Qué significa |
| - | - |
| **Ready** | Cada campo que necesita el documento está lleno. |
| **N required fields are missing** | Nada llena esos campos todavía. El resultado los lista. |
| **Will not generate** | El mapeo lee una fuente de datos que nadie registró, o una tabla o colección que tu base de datos no tiene. También puede leer una columna o campo que no existe. O los registros de una colección de MongoDB guardan valores de un tipo que el mapeo no puede leer. O el mapeo pide algo que Reporter no puede ejecutar. |
| **Partly checked** | Una tabla respondió, pero no dijo qué columnas tiene. |
| **Not checked** | Una base de datos no respondió, o ninguna consulta se ejecutó contra tus bases de datos. |

Las advertencias se listan aparte y no bloquean la generación. Para verificar otra vez, abre el mapeo y haz clic en **Check now**.

## Generar un borrador

***

**1. Abrir el diálogo**

Abre **Filings** y haz clic en **New filing**. Elige un documento al que estás suscrito. La lista muestra solo suscripciones activas. Haz clic en **Continue**.

**2. Llenar los parámetros**

El documento define los parámetros que necesita la presentación. Escribe un mes de competencia como `YYYY-MM` y una fecha como `YYYY-MM-DD`. Algunos documentos se presentan en meses específicos. El campo indica qué meses.

**3. Generar**

Haz clic en **Generate**. El diálogo **Draft generated** lista los campos en blanco. Un campo en blanco es un campo que el mapeo no pudo llenar. No es una falla de generación.

**4. Abrir la presentación**

Haz clic en **Open the filing**.

Cuando el documento declara una remesa, Reporter rechaza un segundo original una vez que el período tiene uno aprobado, y rechaza un reemplazo cuando el período no tiene original aprobado. El diálogo indica entonces qué hacer a continuación: generar un reemplazo, o generar y aprobar primero el original.

El borrador es un informe con el estado `Draft`. Aparece en **Filings**. No aparece en la cola de [Generated Reports](https://docs.lerian.studio/es/products/reporter/console/managing-reports.md).

## Encontrar una presentación

***

**Filings** lista todos los documentos regulatorios generados: borradores por revisar, presentaciones aprobadas y generaciones que fallaron, con el motivo. Filtra la lista por documento o por institución. Para ver una suscripción, selecciona **See filings** en su menú en **My Regulatory Documents**.

La lista muestra solo las generaciones actuales. Un borrador más nuevo o una presentación aprobada de la misma suscripción, el mismo periodo y la misma remesa toma el lugar de un borrador más antiguo, que pasa a ser historia. Una generación que no termina como borrador no reemplaza nada. Para listar los más antiguos, selecciona **Show superseded generations**. Un borrador reemplazado no se puede corregir ni aprobar.

## Corregir y aprobar la presentación

***

La página de la presentación muestra el estado, los campos en blanco, el **File content**, las **Corrections** y la **Provenance**. **Provenance** muestra el documento, la versión del documento, la versión del mapeo, la hora de generación, los parámetros y el checksum del archivo (SHA-256).

Mientras un campo obligatorio esté en blanco, no puedes aprobar ni descargar la presentación. La página lista cada campo en blanco.

### Corregir una cifra

**1. Elegir la celda**

En la página de la presentación de un `Draft`, encuentra la cifra en **File content**. Busca en un conjunto o selecciona **Only corrected**. Haz clic en la celda. Se abre el diálogo **Correct** con el conjunto, la fila y el campo ya elegidos.

**2. Ingresar la corrección**

Ingresa el **New value**. En **Why (recorded in the audit trail)**, escribe por qué cambia la cifra. El motivo es obligatorio.

**3. Aplicar**

Haz clic en **Apply correction**.

Una corrección es una intervención manual en el archivo. Reporter no recalcula nada. Si el valor se suma en otras líneas, o si otras líneas se suman en él, corrígelas también. Cuando el dato está mal en el origen, corrige el origen y genera otra vez. Una advertencia lista las líneas por encima de una corrección que no corregiste. No bloquea la aprobación.

Algunas celdas quedan bloqueadas. Un campo que identifica la fila no puede cambiar. Un campo derivado sigue al campo del que viene. El CNPJ de la institución es fijo en el origen.

**Corrections** muestra cada cambio, quién lo hizo y el motivo.

### Aprobar el borrador

**1. Abrir el diálogo**

En la página de la presentación de un `Draft`, haz clic en **Approve**. La Console oculta **Approve** mientras un campo obligatorio esté en blanco.

**2. Confirmar**

Haz clic en **Approve as the filing**.

El borrador se convierte en la presentación, con el estado `Final`. Una presentación `Final` rechaza correcciones, y su procedencia no cambia.

### Descargar y reemplazar

Haz clic en **Download** en la página de la presentación para obtener el archivo. El formato del archivo viene de la presentación. Puedes descargar una presentación `Draft` o `Final` sin campo obligatorio en blanco.

Cuando el documento declara una remesa de reemplazo, una presentación `Final` también ofrece **Generate a replacement**. El botón aparece solo mientras la suscripción está activa.

## Gestionar una suscripción

***

En **My Regulatory Documents**, la fila de una suscripción puede mostrar estos elementos:

* **Update**: aparece cuando el catálogo tiene una versión más nueva. Las presentaciones ya producidas conservan su versión. Después de la actualización, el diálogo muestra lo que la nueva versión hace con tu mapeo.
* **Version history** en el menú (): lista cada versión adoptada, de la más nueva a la más antigua.
* **Set institution** en el menú: aparece cuando el tenant tiene varias instituciones y la suscripción no tiene ninguna. Define la institución de las próximas presentaciones. Una suscripción que ya tiene institución la conserva. Para presentar el documento para otra institución, suscríbelo de nuevo desde el **Catalog**.
* **Deactivate** en el menú: detiene la presentación del documento. La suscripción sigue en la lista como **Inactive** después de que selecciones **Show deactivated**. No se elimina nada, y los informes ya generados a partir de ella siguen legibles.

Para restaurar una suscripción inactiva con su mapeo y su versión, haz clic en **Reactivate** en su fila. Cuando el documento no tiene una suscripción activa, su tarjeta en el catálogo también tiene **Reactivate**. La tarjeta también ofrece una nueva suscripción. Muestra **Start from Lerian's mapping** cuando el documento incluye un mapeo de referencia, y **Start from an empty mapping** cuando no lo incluye. El mapeo que editaste sigue guardado en la suscripción desactivada.

## Permisos

***

Abrir las pantallas regulatorias requiere `regulatory:get`. **Filings**, la página de la presentación y **Download** también requieren `reports:get`. Suscribirse a un documento o reactivarlo, generar un borrador, corregir una cifra y actualizar una versión requieren `regulatory:post`. Guardar un mapeo y definir una institución requieren `regulatory:put`. Desactivar una suscripción requiere `regulatory:delete`. Aprobar un borrador requiere `regulatory-approval:post`.

## Próximos pasos

***

* Usa [Gestión de instituciones](https://docs.lerian.studio/es/products/reporter/console/managing-institutions.md) para registrar las instituciones que presentan documentos.
* 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 lee un mapeo.
* Usa [Gestión de informes](https://docs.lerian.studio/es/products/reporter/console/managing-reports.md) para los informes operativos generados a partir de Templates.


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