Skip to main content
An institution is one regulatory declarant of your tenant. Each institution files under its own CNPJ and reads only the rows that its scope names. Manage institutions on the Institutions page of Reporter in the Lerian Console. Reports, regulatory deadlines, and regulatory filings use the institutions that you register here. See Where institutions apply.

Accessing the Institutions page


To open the Institutions page, click Settings in the left-side menu of the Reporter page, then click Institutions. The page lists the institutions in a table with these columns: Name, CNPJ, Data Sources, Last Modified, and Actions. The Data Sources column names each Data Source in the scope of the institution. It shows None when the scope is empty. The menu () of each row has Edit and Delete. Each action on the Institutions screen needs the matching institutions permission: get to see and propose institutions, post to create and confirm, put to edit, and delete to delete.

Add an institution


1

Open the form

On the Institutions page, click New Institution.
2

Identify the institution

Enter the Business name and the CNPJ. The CNPJ can be numeric or alphanumeric, with or without punctuation.
3

Define the scope

Click Add data source and select a Data Source. Then tell Reporter which of its rows belong to the institution. See Scope rules.
4

Save

Click Save. If Reporter refuses the institution, the form shows its reason and keeps what you typed.

Scope rules

The scope names the rows of each Data Source that belong to the institution. An institution with no Data Source in its scope reads nothing. For each Data Source, choose one of these:
  • The whole data source belongs to this institution: the institution reads every table of the Data Source.
  • Tables: click Add table and enter the table name. For each table, choose one of these:
    • Shared: every institution reads this table whole: use it for reference data that every institution needs.
    • Conditions: click Add condition, type the Field, select an Operator, and type the Values, comma separated. A table with conditions needs at least one condition with the is or the is one of operator. These two operators claim the rows of the institution.

Field guide

Propose institutions from Midaz


Reporter can read the organization table of Midaz and propose one institution for each organization that is not registered yet.
1

Open the proposals panel

On the Institutions page, click Propose from Midaz.
2

Select the Data Sources

Under Data sources to read, select the PostgreSQL Data Sources that read Midaz. The panel lists the PostgreSQL Data Sources that you registered. It does not list Data Sources provided by the platform.
3

Find the proposals

Click Find proposals. Each proposal shows the name, the CNPJ, and the proposed scope in each Data Source.
4

Confirm a proposal

Click Confirm on a proposal. The New Institution form opens with the proposal filled in. Review it, then click Save. When you close the form, the proposals panel opens again.
Midaz does not check the CNPJ check digits. A proposal with an incorrect CNPJ shows a warning. Correct the CNPJ in the form before you save.

Edit an institution


Click the name of the institution, or select Edit in the row menu. Change the fields, then click Save.

Delete an institution


Select Delete in the row menu and confirm. After the deletion, you can register the same CNPJ again at once.

Where institutions apply


When the tenant has several institutions, My Regulatory Documents also shows these items:
  • An Institution filter shows one institution at a time. Select All institutions to see every subscription and the institution it files for. A subscription with no institution shows No institution set. Set the institution before you generate a draft.
  • Set institution in the menu of a subscription sets the institution for the next filings. It appears only for a subscription that has no institution. Reports already generated keep their institution.
On the Catalog, the card of a subscribed document shows Subscribe for another institution when an institution does not file it yet. Opening Filings, a filing page, and Download also needs reports:get. Subscribing to a document, generating and correcting its filings, and updating its version need regulatory:post. Mapping its fields and setting its institution need regulatory:put. Deactivating a subscription needs regulatory:delete. Approving a draft needs regulatory-approval:post.

Next steps