# Fintecor Reporting
# Server Requirements and On-Premise Installation
# Network Requirements
##### **How it is deployed**
Three components, delivered as Docker container images and run with Docker Compose on a single Linux server. The database can instead be pointed at an existing Database cluster if you already operate one.
##### **Network Requirements**
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/UWIimage.png)
Users need a current desktop browser and a DNS name pointing at the server, matching the TLS certificate. Two-factor authentication uses a standard authenticator app on the user’s phone; no SMS gateway is required.
# Installation
1. **Prepare the server**.
Provision the Linux host per the table above, install Docker Engine and the Compose plugin, set the time zone, and create the DNS record and TLS certificate for your reporting hostname.
2. **Prepare the database.**
Either let the delivered Compose stack run Oracle on the same host, or create an empty database and a dedicated user on your existing cluster. No schema work is needed — the application creates and migrates its own schema.
3. **Receive the delivery package.**
Fintecor supplies the two container images, a docker-compose.yml and a configuration template, either as files for an air-gapped install or from a private registry. The web application image is built for your specific reporting hostname, so confirm that URL to us before delivery.
4. **Load the images.**
```
docker load -i fintecorreporting-backend.tar
docker load -i fintecorreporting-frontend.tar
```
5. **Fill in the configuration file.**
Database URL, user and password; the browser origin allowed to call the API; the encryption key protecting two-factor secrets; etc.
6. **Start the stack.**
```
docker compose up -d
```
On first start the service creates its database schema and loads the supervisory glossary and the EBA / EGDQ validation rule set. *This takes a few minutes and happens only once.*
7. **Verify.**
All containers report healthy and the service answers its health check:
```
docker compose ps
curl http://localhost:8066/actuator/health
```
8. **Publish it.**
Point your reverse proxy at the two internal services over HTTPS on port 443 and restrict access to your corporate network or VPN.
9. **Go live.**
Log in with the administrator account supplied by Fintecor, change its password, enrol two-factor authentication, create your users and import your first reporting set.
10. **Set up backups.**
A nightly database dump plus the mapping-file volume is sufficient to restore the whole installation. Fintecor provides the exact commands.
##### **Upgrades and Support**
An upgrade is a new image plus a restart of one container; the schema migrates itself, and any release rolls back to the previous image in seconds. Template and validation-rule updates that follow regulatory changes are delivered the similar way, as part of your subscription.
# Technical Architecture
# Solution Architecture
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/9lkimage.png)
The platform is a three-tier application. A browser client talks over HTTPS to a stateless REST backend, which is the only component that touches the database.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/g8Yimage.png)
##### **Security**
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/yKkimage.png)
# On-premises and SaaS Compared
The two models differ in who operates the stack, not in what the software does.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Y8gimage.png)
##### **Technical Requirements**
##### On-premises
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Vioimage.png)
##### SaaS[](https://docs.fintecor.com/uploads/images/gallery/2026-09/S6wimage.png)
# System configuration and administration
**Context:** Setup form under System Configuration.
**Key Components & Elements:**
**Top Navigation Bar:**
- - **Users:** Switches to user management and account creation.
- **Financial Institutions:** Active section tab highlighting financial entity settings.
- **Data Lots:** Navigates to unit and data lot configuration.
- **General Configuration:** Opens system parameters and precision controls.
- **Licence**: Module where the Fintecor licence file is installed.
- **Reporting Set Updates:** module where signed Fintecor reporting set packages are previewed and imported.
# User Access & Role-Based Permission
There are two roles possible, Admin and User.
**Context:** Interface for provisioning new user accounts and assigning permissions within the system.
- **Key Components & Elements:**
- **User Detail Input Fields:** Captures essential user profile information, including username, full name, email address, phone number, and account password.
- **Role Assignment Controls:** Configures access privileges with options to assign either **Admin** or **User** system roles.
- **Security & Authentication Options:** Includes a toggle/checkbox option to enforce Google Authenticator (2FA) multi-factor authentication upon login.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-13.png)
# Financial institution configuration
**Context:** Interface within the System Configuration module where Financial institutions are defined and created.
**Key Components & Elements:**
- **Sub-Navigation Controls:**
- **All Financial Institutions:** Switches back to the list/grid view of existing entities.
- **Create New Financial Institution:** Active sub-tab highlighting the entity creation form.
- **Input Fields:**
- **Financial Institution Name:** Text input for entering the official legal entity name.
- **Internal Party Reference:** Text field for entering internal system mapping IDs or codes.
- **LEI:** Text field for entering the Legal Entity Identifier.
- **National Identifier:** Text field for specifying national regulatory registration numbers.
- **Reporting Level:** Dropdown menu to choose the consolidation scope (e.g., Individual/IND, Consolidated).
- **Reporting Currency:** Text input specifying the primary reporting currency code (e.g., EUR, USD).
- **National Currency:** Text input specifying the local operating currency code.
- **Country of Institution:** Text/search input to define the home country jurisdiction.
- **Status:** Dropdown menu to set the operational state (e.g., ACTIVE, INACTIVE).
- **LV Organization Code:** Text field for local Latvian organizational code tracking. Used for local reporting submission.
- **Telephone:** Contact phone number input. Used for local reporting submission.
- **Organization Management:** Text field for listing key executive/board metadata. Used for local reporting submission.
- **Responsible Person:** Text field to assign a primary compliance/reporting contact. Used for local reporting submission.
- **Primary Action Button:**
- **Create financial institution:** Submits the form and saves the new entity record into the system database
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-14.png)
**Context:** Administrative overview table displaying configured financial institution records, their regulatory parameters, and row-level management actions.
**Key Components & Elements:**
**Sub-Navigation Controls:**
- - **All Financial Institutions:** Active view tab displaying all registered entities.
- **Create New Financial Institution:** Action button to navigate directly to the entity creation form.
- **Data Grid Columns:**
- Displays ID, Name, Ide Internal Party Reference, LEI, National Identifier, Reporting Level, Reporting Currency, National Currency, Country, Status, LV Organization Code, Organization Management, Responsible Person, Telephone, Modified timestamp/user, and Created timestamp/user.
- **Row Action Buttons:**
- **Delete:** Red button with trash icon to permanently remove the financial institution record.
- **Edit (Pencil Icon):** Blue circular button to open the entity details in edit mode.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-15.png)
# Data lots configuration
**Context:** Interface within the System Configuration module where new Data Lots are defined and created.
**Key Components & Elements:**
**Sub-Navigation Controls:**
- - - - **All Data Lots:** Button/tab to return to the list view of all existing data lots.
- **Create New Lot:** Active sub-tab displaying the new data lot setup form.
- **Input Fields:**
- \**Lot number :* Numeric input/spinner control to assign a unique numerical sequence ID for the lot.
- \**Lot name :* Text input control to give the data lot a descriptive title.
- **Description:** Multi-line text area to specify details or notes about the data unit.
- **Primary Action Button:**
- **Create data lot:** Submits the parameters to create and store the new data lots.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/1h4image.png)
# General Configuration
**Context:** general configuration workspace to define used parameter values.
**Key Components & Elements:**
**General Configuration** is highlighted.
- **Parameter Form Controls:**
- **Parameter Column:** Displays available parameters list.
- **Value Inputs:** Input fields to define parameter value.
- **In XBRL CSV Checkboxes:** Toggles specifying whether each parameter value used for xbrl-csv purposes.
- **Description Column:** Shows explanations for each parameter key.
- **Modified by Column:** Displays audit metadata for the last user who updated the row.
- **Action Buttons:**
- **Save changes:** Primary action button (top-right of the form) to persist modified parameters to the server.
**Action Controls:** Features a "Save changes" button in the upper-right area to apply updated parameter configurations.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/e20image.png)
# System Logs & Revision History
**Context:** Visual representation of system activity surfaced through the notification interface and execution status indicators.
- **Key Components & Elements:**
- **Activity & Audit Stream:** Displays recorded events including configuration changes, user logins, and system operations.
- **Background Job Status:** Shows in-progress indicators and status updates for asynchronous background processes and scheduled tasks.
- **Notification Center Interface:** Illustrates how server-side logs and operational events are presented within the application UI.
- *Most system logs are kept server side not UI side.*
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/539image.png)
# Licence
Interface within the System Configuration module where the Fintecor licence file is installed and the reports it permits are listed.
[](https://docs.fintecor.com/uploads/images/gallery/2026-10/image.png)
**Key Components & Elements:**
**Install a licence**
- Choose .fclic file: Opens a file picker for the licence file supplied by Fintecor. Accepts `.fclic` and `.txt`. Displays the selected file name once chosen.
- Install: Uploads and installs the selected licence file. Disabled until a file is selected.
- Installation id: Read-only identifier of this installation, quoted to Fintecor when requesting a licence. Each installation has its own value.
- Copy: Copies the installation id to the clipboard.
**Licence summary (shown once a licence is installed)**
- Customer name: The organisation the licence was issued to.
- Licence: The licence identifier issued by Fintecor.
- Create new reports until:\*\* Date after which new reports can no longer be created from this module.
- Open existing reports until:\*\* Date after which existing reports can no longer be opened or exported. Shows `No end date` when the grant has no limit.
# Reporting Set Updates
Interface within the System Configuration module where signed Fintecor reporting set packages are previewed and imported. The package is checked and previewed first; nothing changes until the plan is confirmed.
[](https://docs.fintecor.com/uploads/images/gallery/2026-10/XBtimage.png)
**Package Selection**
Choose .fcpkg package: Opens a file picker for the package supplied by Fintecor. Accepts `.fcpkg` and `.zip`. The preview runs automatically once a file is selected.
Re-check: Re-runs the preview for the selected package without importing anything.
# Datasets administration and data load
# Datasets & Input Sources
**Context:** Main management interface showing the structured data hierarchy arranged by reporting period and assigned unit.
- **Key Components & Elements:**
- **Hierarchical Tree View:** Categorized drill-down structured by date and unit (e.g., 2026-06-30 → Lot 1 → Plot 1/Plot 4), including last run timestamps and status.
- **Execution Metadata:** Status indicators and last run timestamps displaying recent processing state.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-17.png)
**Context:** Modal dialog prompt triggered when adding a new dataset to the platform.
- **Key Components & Elements:**
- **Date:** date of data set. Should be equal to valid\_on used in data set.
- **Unit Selection Dropdown:** An expanded "Select unit" menu populated with available units/lots. Should be equal to lot\_type\_fk used in data set.
- **Plot FK:** optional field to define created result set unique identifier. By default generated as incremental value.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-19.png)
- **Operations with datasets:**
- **Run calculations** *- functionality in process. Used for E2E solution.*
- **Validate result set** *- functionality in process. Used for E2E solution.*
- **Import Direct Allocation data** - LastMile solution. Loading pre-calculated result data in Excel or csv format.
- **Export Direct Allocation data** - download existing direct allocation data for specific plot\_fk from result\_data\_direct table. Download Excel template for result\_data\_direct data.
- **Clear Direct Allocation data** - delete existing data from result\_data\_direct table for specified plot\_fk.
- **Delete** - delete all result data for specified plot\_fk.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/5rVimage.png)
- *For LastMile solution data can be loeaded directly to the table result\_data\_direct only for previously created Dataset.*
- *Excel file template for direct allocation data load:*
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Y54image.png)
# User Interface Guide and Navigation
User Guide
# Login page and Two-factor authetication
**Context:** Two-step login process for authenticating user access to the Fintecor Reporting platform.
**Key Components & Elements:**
- **Primary Login Card:** Form inputs for Username and Password, an environment/tenant selector, and the primary session submit button.
- **Secondary MFA Verification:** One-time passcode (OTP) input control, step-by-step security prompt, and passcode retry/resend options.[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-10.png)[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-11.png)
# Logout and Password Change
- **Logout and password change for user:**
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/xorimage.png)
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/9rbimage.png)
# Navigation structure
**Context:** A full-height view of the primary left-hand navigation sidebar menu within the reporting application.
- **Key Components & Elements:**
- **Hierarchical Tree Structure:** Displays parent and nested menu items organized by system functional areas, including **System Configuration**, **Datasets**, and **Reports**.
- **Active Selection State:** Highlights the currently active navigation item or folder path within the interface tree.
- *Report Configuration is not available*
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/foiimage.png)
- **Closing all opened tabs:**
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/2duimage.png)
- **Reporting group ordering**
In order to change ordering in Reports part click on the icon.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/htUimage.png)
Drag and drop levels of ordering.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/ppjimage.png)
# Night Mode
**Context:** Day and Night mode switch.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/0Qyimage.png)
- **Key Components & Elements:**
- **Theme Switcher:** Displays the upper right-hand corner control button used to toggle between light and dark visual themes.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/FOZimage.png)
# Operations with Reports
# Create New Report
**Key Components & Elements:**
- **Top Action Trigger:**
- **Create new report:** Primary blue button in the upper right used to instantiate a new reporting set or template package.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Kwsimage.png)
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Adeimage.png)
**Context:** The **"Create New Report"** dialog modal with the **"Select a set"** drop-down menu expanded.
- **Key Components & Elements:**
- Displays available regulatory frameworks and reporting sets (such as **BCL**, **EBA COREP**, **EBA FINREP**, etc.).
- Allows users to select the foundational regulatory template structure for building new report packages.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-21.png)
- **Context:** The **"Create New Report"** dialog modal fully populated before triggering generation.
- **Key Components & Elements:**
- **Configuration Fields:** Shows filled inputs including template scope (*"All templates"*), reporting date, unit scale, dataset selection, financial institution, report name, unique code, and version identifier.
- **Submit Action:** Primary action button to execute report populating and compilation.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-22.png)
**Context:** Interface toast notification / status banner following batch creation.
- **Key Components & Elements:**
- **Confirmation Banner:** Displays a green success indicator with the system message: *"125 reports created successfully"*.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/image-23.png)
# Operations with Report
**Context:** reporting workspace showing a list of possible actions for selected reporting set.
- **Toolbar Action Controls:**
- **Rename:** change name of selected reporting set.
- **Create copy**: create copy of selected reporting set
- **Compare**: compare two selected reporting sets.
- **Import full set**: import data from Excel to all templates.
- **Export full set**: Export reporting set to one Excel files, including all templates. Can be used as template for filling and importing data to reporting set.
- **Lock All/ Unlock All:** Toggles the report between read-only mode and active editing state for all included templates.
- **Delete all**: delete full reporting set with all templates.
- **Generate delivery file**: generates delivery file for selected reporting set. See "[Generate Delivery File](https://docs.fintecor.com/books/fintecor-reporting/page/generate-delivery-file "Generate Delivery File")".
- **Validate**: validate reporting set against all registered validation rules (EBA, ECB, local ruels etc.) See "[Validation Engine & Cross-Report Reconciliation](https://docs.fintecor.com/books/fintecor-reporting/page/validation-engine-cross-report-reconciliation "Validation Engine & Cross-Report Reconciliation")"
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/0wfimage.png)
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/JQOimage.png)
**Context:** Drill-down view for investigating a specific error or mismatch flagged by the reconciliation engine.
- **Key Components & Elements:**
- **Root-Cause Analysis Panel:** Displays underlying transactions causing the variance.
- **Resolution Options:** Tools to acknowledge warnings, override exceptions with justification notes, or route issues to data stewards.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/NFAimage.png)
**Context:** Audit log tracking historical validation job executions.
- **Key Components & Elements:**
- **Execution Timestamps:** Shows when validation suites were triggered, who ran them, and their success states.
- **Batch Controls:** Options to re-run specific validation suites or export execution logs for compliance audits.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/x3nimage.png)
# Operations with Template
**Context:** reporting workspace showing a list of possible actions for selected template.
- **Toolbar Action Controls:**
- **Freeze headings:** Pin/unpin row and column header labels so they remain visible while scrolling through large data tables.
- **Cell size:** Adjust row heights, column widths, and grid density for optimal table alignment.
- **Read -only:** Toggles the template between read-only mode and active editing state.
- **Save changes:** Persists manual entries, updates, or overrides made within the report grid.
- **Reload data:** Re-fetches current values directly from the backend result dataset overwriting all manual corrections.
- **Reload with corrections:** Re-fetches current values directly from the backend result dataset keeping all manual corrections.
- **Export/Import**: export template as separate Excel file/import template data from Excel as separate Excel file.
- **Add row**: add row for reports with dynamic rows.
- **Delete rows**: delete rows for reports with dynamic rows.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/rUDimage.png)
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/s8bimage.png)
**Context:** Illustrates template change log:
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Nrcimage.png)
**Context:** Illustrates "Save changes" functionality
- **Key Components & Elements:**
- When manual correction done in template (manually or using Import function), Save change button should be used to save corrections!
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/dPXimage.png)
- - Don't keep - don't keep manual corrections highlighting. Correction will be saved, but not highlighted.
- Keep corrections - all manual correction will be saves and highlighted with blue color
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/diximage.png)
.
# Data Breakdown & Lineage Inspection
**Context:** cell information page.
To open cells information page click on "!" for the selected cell.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/CBsimage.png)
**Context:** A detailed popup window triggered when inspecting a specific report cell or line item.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Teuimage.png)
- **Key Components & Elements:**
- **Header Details:** Displays key metrics such as cell coordinates/identifiers, calculated numeric values, formatting types, and target row/column conditions.
- **SQL Queries Section:** Outlines the underlying database queries executing against system data tables.
- **Action Options:** Includes action buttons such as **"See breakdown"** (to inspect underlying record details) and **"Export to Excel"**.
**Context:** The granular drill-down view displayed after clicking "See breakdown".
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/2fTimage.png)
- **Key Components & Elements:**
- **Data Table/Grid:** Shows the individual source records that aggregate into the parent report cell's total value.
- **Columns:** Displays source transaction attributes such as record IDs, source system flags, posting dates, amounts, and account codes.
- **Filtering & Pagination Controls:** Interfaces for filtering specific line items or sorting source records.
**Context:** A direct inspection view focused on data provenance and lineage flow.
- **Key Components & Elements:**
- **Lineage Diagram / Mapping Structure:** Visual representation tracing data from raw input tables down to calculated reporting output cells.
- **SQL Preview Panel:** Highlights code syntax and condition rules driving cross-table reconciliations.[](https://docs.fintecor.com/uploads/images/gallery/2026-09/MT8image.png)
# Validation Engine & Cross-Report Reconciliation
To run validation got to Reporting Set information page. See page "[Operation with Reporting set](https://docs.fintecor.com/books/fintecor-reporting/page/operations-with-report "Operations with Reporting set")". Click "Validate".
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/Klwimage.png)
**Context:** validation completed window.
- **Key Components & Elements:**
- **View results:** view validation results in UI.
- **Download validation results:** download validation results as Excel file.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/FCaimage.png)
**Context:** The main landing view for the validation engine module.
- **Key Components & Elements:**
- **Errors:** validation rules list, which failed.
- **Rules Run:** High-level counts of total rules checked, passed validations, failed checks, and active warnings.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/FTAimage.png)
**Context:** Interface for creating or editing specific cross-report validation logic.
- **Key Components & Elements:**
- **Rule Parameters:** Fields defining rule IDs, descriptions, source reports/cells, and target comparison cells.
- **Formula & Tolerance Builders:** Settings allowing tolerance thresholds or exact mathematical matching (`A == B`).
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/joaimage.png)
**Context:** A matrix grid comparing corresponding line items across different regulatory or financial reporting statements.
- **Key Components & Elements:**
- **Comparison Columns:** Side-by-side values from separate reports (e.g., Report A vs. Report B).
- **Variance Indicators:** Highlights data discrepancies, highlighting differences in red or yellow depending on predefined thresholds.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/rpmimage.png)
**Cross-Report Reconciliation**
To run Cross-Report validation rules select "Run cross-module rules (validate against other reporting sets)" and select for cross module reconciliation. Standard validation will be run including cross-module validation rules.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/F23image.png)
**Compare against previous period (time-shift rules)**
To run Cross-Report validation for Time-shift rules select Compare against previous period (time-shift rules)" and select previous reporting period Reporting set.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/1lrimage.png)
# Generate Delivery File
- Go to Reporting Set information page and select "Generate delivery file"
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/guFimage.png)
*\*For EBA reports function "Generate delivery file" could be unavailable in case filling indicators template for selected Report not fulfilled. Go to filling indicators template, fill filling indicators, save corrections and return to Reporting set information page.*
- When delivery filed generated, got to you Download folder.
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/oRFimage.png)
[](https://docs.fintecor.com/uploads/images/gallery/2026-09/j7Wimage.png)
Institution and reporting level data taken from "[Financial institution configuration](https://docs.fintecor.com/books/fintecor-reporting/page/financial-institution-configuration "System configuration and administration")"