Custodian Connector Management

Introduction

Custodian Connector Management lets Back Office Managers and Administrators establish automated data connections to custodian banks directly from Reluna — without engineering involvement. Transactions and positions from custodians are retrieved automatically and made available in the platform.

System connectors (pre-built by Reluna) can be connected in two steps. For custodians not in the library, Administrators can build a custom connector from scratch using a guided 5-step wizard.

The module is accessible at System Settings → Connectors.

Key Concepts

One connector can serve multiple connections - for example, the same custom connector can be reused for different companies or custodians that share the same data format.

Permission Requirements

Connections List

The Connections list shows all custodian connections the current user has access to, grouped under the Custodian Connectors section heading.

List Columns

The list only shows connections for companies the user has access to. Private connections are further restricted to users in the connection's Users Access list.

Connection Detail

Click any row to open the Connection Detail page. It is identical for system and custom connectors and contains two tabs:

The page header shows the connector name, a Connection Status badge, and the Actions dropdown (visible to Modify users only). A Failed connection displays a red inline banner with an Update Credentials shortcut button.

Connectors Library

The Connectors Library is a modal that opens when you click Add New on the Connections List. It shows all available connectors — both system and custom — and is the starting point for creating a connection or a new custom connector.

Browse & Search

The library has two tabs — System (default) and Custom. Both tabs share the same controls:

• Filter chips — All · SFTP External · SFTP Internal · Email

• Country dropdown — defaults to "All Countries"

• Search bar — filters by connector name (case-insensitive, substring match)

• Create Connector + button — visible on both tabs; requires Create permission

The Custom tab adds a Configuration Status column (Configured / Not Configured). On the System tab, connectors that already have a connection for your company display a ✓ checkmark.

Switching tabs resets search and filters to their defaults. Filters, search, and tab combine with and logic when multiple are active.

Connector Detail

Click the › chevron on any library row to open the Connector Detail page within the modal. It shows the connector name, logo, description, and an Additional Information panel (Category, Connection Type, Country, Data you get, Website, Privacy Policy, Terms of Services links). Click Connect to start the 2-step connection flow.

Connect a Connector

Creating a connection is a 2-step flow identical for both system and custom connectors. Start from Connectors Library → Connector Detail → Connect.

Step 1 Access & Visibility

Step 2 Connector Details

The credential form varies by the connector's protocol:

On completion, connection status is set to Active and you are returned to the Connections List.

Save and Close

Both steps have a Save and Close button. Clicking it saves all entered data and sets connection status to Not Connected. You can resume setup at any time from the Connections List.

Credentials are stored encrypted and are never exposed to other users.

Manage an Existing Connection

From the Connection Detail page, open the Actions dropdown (Modify permission required) to perform the following actions. Action availability depends on the current connection status:

Run Now

Triggers an immediate fetch-and-process cycle for this connection. Also available via the ▶ icon directly on the Connections List row. A toast confirms: "Run started. Files are being fetched and processed."

Update Credentials

Opens the Update Connection stepper - the same 2-step flow as creation, with all fields pre-populated. Company and Custodian are locked (read-only) and cannot be changed. On Step 2, the button shows Update instead of Connect.

For SFTP External connections, clicking Update re-tests the connection. If the test succeeds and the connection was previously Failed, status transitions to Active on save.

A Failed connection displays an inline red banner with a direct Update Credentials shortcut, reducing the number of clicks needed to restore the connection.

Disconnect

Stops data synchronisation for this connection. A confirmation dialog appears: "Are you sure you want to disconnect? You will no longer receive market data updates for your instruments." On confirmation, status transitions to Not Connected. The connection record is retained - it can be reconnected later via Update Credentials.

Create a Custom Connector

Overview

When a custodian is not available as a system connector, you can build a custom connector from scratch. Start from Connectors Library → Create Connector +. The wizard has 5 steps:

Save and Close is available at every step

Progress is saved with Configuration Status = Not Configured. The connector appears on the Custom tab and can be resumed at any time. The connector is fully usable only after completing all 5 steps and clicking Complete Creation.

Step 1 General Setup

Defines the connector's identity and the connection protocol. The Connection Type selection is permanent — it cannot be changed after the connector is first saved.

Connection Type is locked after creation

The protocol you select determines the entire data retrieval infrastructure. Choose carefully — this field cannot be edited once the connector is saved.

Step 2 File Classification

Upload sample CSV files and define rules that tell the system which files contain Positions and which contain Transactions.

1. Click Import Files to upload one or more CSV files (max 10 MB each). ZIP files are automatically unpacked - contained CSVs appear as individual rows.

2. In the Rules for Transaction Files section, click Add Rule +to add a rule. Enter an Assign Table Name and fill in at least one pattern field:Starts With,Contains, orEnds With. Multiple patterns within one rule combine with AND logic.

3. Toggle Preview on a rule to see which uploaded files match it.

4. Repeat for theRules for Positions Filessection.

5. ClickNext Stepto proceed.

A file can match multiple rules — there is no exclusivity constraint. Rules are numbered sequentially and can be deleted individually.

Step 3 Separator Setup

Tell the system which delimiter is used in the CSV files so raw data is parsed into structured columns.

1. Select a global separator from the dropdown: Comma, Semicolon, Tab, Pipe, or Other. Selecting "Other" reveals a free-text input for a custom character.

2. Review theTransaction File Preview and Positions Files Preview sections. Each shows a per-table preview — raw unparsed text when no separator is selected, a parsed column table once a separator is applied.

3. If a specific table uses a different delimiter, override its per-tableSeparatordropdown independently.

4. Verify all previews show correctly parsed columns, then clickNext Step.

Changing the global separator updates all per-table dropdowns that haven't been manually overridden. Overridden tables retain their custom delimiter.

Step 4 Tables Merge

If a file type (Positions or Transactions) has two tables from the classification step, configure a merge before mapping. If both file types have a single table each, this step requires no configuration - click Next Step to proceed.

1. In the relevant section (Positions Files or Transaction Files), select the two tables to merge in the Tables to Match multi-select.

2. Select the key field f or each table from the column dropdowns - these are the columns the join is performed on.

3. Toggle Preview to see the merged result. The system performs a full outer join - all rows from both tables are included, with nulls for non-matching columns.

4. Click Next Step to proceed to Data Mapping.

Step 5 Data Mapping

The final step configures how raw custodian data maps to Reluna's internal transaction and position types using an IF/THEN rules engine.

Dashboard

The dashboard lists all supported types under Positions (Cash Positions, Security Positions) and Transactions (Buy, Sell, Withdraw, Fee, Income, FX, Interests, Security Transfer, Product Subscription, Margin, Income). Each row shows a File Status (Set / Not Set) and Fields Status (Mapped / Not Mapped). Click Configure on a type to open its mapping page.

Type / Field Mapping Page

Each type has a Types table (Type + optional Subtypes) and a Fields table. Click Configure > on any row to open its rule configuration.

Rule Configuration

Rules follow an IF/THEN model. Within a rule, conditions combine with AND; between rules, the first matching rule wins. A Default rule has no conditions and is evaluated last as a fallback.

Use Copy Settings From Another Type to duplicate all rules from a previously configured type — useful when multiple transaction types share similar mapping logic.

Completing Creation

Once at least one type is configured, click Complete Creation on the dashboard. Configuration Status transitions to Configured, and a Connect button becomes available on the connector's detail page. Remaining types can be added later via Edit Connector Configuration.

Modify a Custom Connector

Custom connector actions are available from two entry points: the connector's detail page in the Connectors Library, and the Actions dropdown on any Connection Detail page that uses a custom connector.

Edit Connector Configuration

Re-opens the 5-step wizard in edit mode. All steps show completion status and are directly clickable - no sequential navigation required. Buttons change to Close + Save Changes.

Changes affect all connections

Saving updated configuration applies toall future syncs across every connection using this connector. A warning is shown on every Save Changes click.

Delete Connector

Permanently removes the connector, its entire configuration, and all associated connections in Not Connected or Failed status. Connections in Active status block deletion - those connections must be disconnected first.

Deletion is permanent

There is no undo. Disconnect all active connections before deleting a connector.

Status Reference

Connection Status

Configuration Status