arrow-left

Only this pageAll pages
gitbookPowered by GitBook
triangle-exclamation
Couldn't generate the PDF for 607 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

BackOffice User Guides

welcome

Loading...

Loading...

Loading...

Users and roles guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Person guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Accounts guide

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Definitions

Privilege - The most granular element defining a single action the employee can perform. For example, a user with the ADD_PERSON privilege can add new person records.

Role - A set of privileges defining activities the user can perform with the respective role.

BackOffice User - A human operator who accesses the Tuum system through the BackOffice interface.

API user - A programmatic operator who accesses the Tuum system through API endpoints.

BackOffice administrator

Tuum Customer Implementation Manager creates for your company the first BackOffice user with the ADMIN role. With this user, you can start defining roles with the relevant permission sets, create additional BackOffice and API users, and assign them appropriate roles.

To create roles and additional users, the employee with the ADMIN role user should log into the Tuum BackOffice and go to Administration > User management.

circle-info

If necessary, you can create multiple BackOffice users with ADMIN roles.

User management

Below, you can learn more about how to perform user management activities in the Tuum system.

Role management page

The Role management page is where you can create and manage roles.

To access it, navigate to:

  1. Administration > Access management > Roles.

  2. The Roles page opens.

circle-info

You can use the filtering controls in the table header to refine how the table content is displayed. Find more information about filtering table content .

Remove role

To remove a role:

  1. Go to Administration > Access management > Roles.

  2. On the Roles page, click Delete next to the name of the role that needs to be removed.

circle-info

You can delete a role only if it is not assigned to any users.

  1. The Confirmation modal opens.

  2. Click Confirm to proceed, or Cancel to discard.

User management page

The User management page enables you to create and manage both BackOffice and API users.

To access it, navigate to:

  1. Administration > Access management > Users.

  2. The User management page opens.

circle-info

You can use the filtering controls in the table header to refine how the table content is displayed. Find more information about filtering table content .

Organisational units management page

The Organisational units management page is where you can create and manage organisational units.

To access it, navigate to:

  1. Administration > Access management > Organisation.

  2. The Organisational units page opens.

User credentials

hashtag
Options for credentials

For BackOffice users, there are two options for managing user credentials:

  1. Single Sign-On (SSO) - If your company uses SSO through Google or Microsoft Azure, user credentials will be managed via these identity providers. For more details, refer to the relevant provider instructions.

Assign and remove roles

To assign or remove user roles:

  1. Go to Administration > Access management > Users.

  2. In the list of the users, click the Technical ID of the user that needs to be modified.

Privileges

There are two types of privileges:

  • View privileges. This group of privileges grants view-only access. For example, VIEW_CONTRACT_EVENTS, VIEW_DEPOSIT_OFFER.

  • Action privileges. This group of privileges grants permissions to add, edit, delete items. For example, MANAGE_USERS, BLOCK_ACCOUNT, ADD_LOAN_OFFER.

In the BackOffice, all privileges are grouped per business domain. For example, ACCOUNT, DEBT, DEPOSIT, etc.

BackOffice global features

The BackOffice global features allow the BackOffice user to navigate through the BackOffice and adjust their working preferences. Below are highlights of the tools available for users to manage their experience within the BackOffice.

hashtag
Main menu

The main menu has been thoughtfully relocated to the left while maintaining its familiar elements and order, inspiring a seamless and smooth user experience.

Modify role

Modifying a role means granting or revoking privileges. To do that, follow these steps:

  1. Go to Administration > Access management > Roles.

  2. Click the Code to open the Role management page.

About BackOffice user guide

Welcome to the Tuum BackOffice user guide. This resource offers all essential information for operating Tuum's core banking system via its graphical interface, BackOffice.

hashtag
General features

Review the and pages to understand the main features of Tuum BackOffice and how to use them.

Organisation management

An organisational unit represents a structural part of your company within the Tuum platform. It reflects how your organisation is arranged in real life, for example, by departments, branches, or regions, and allows you to mirror that hierarchy in the system.

Organisational units help structure users, roles, and responsibilities. By assigning employees to specific units, you can clearly define access rights and visibility boundaries in line with your company’s internal setup.

Below, you can learn more about how to perform organisational unit management activities in the Tuum system.

Files

This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

Field name
Description

See the Files section below:

Search users

You can find a list of all users by following these steps:

  1. Go to Administration > Access management > Users.

  2. The Users page opens.

If you need to find a particular user, click Filter and enter the Technical ID, Username, First name

Modify organisational unit

Modifying an organisational unit means updating its details. To do that, follow these steps:

  1. Go to Administration > Access management > Organisation.

  2. Click the Unit code to open the details page.

Organisational units management page
Create organisational unit
Modify organisational unit
Add users to organisational unit
Modify user roles in organisational unit
Remove user in organisational unit
User management page
Create users
User credentials
Search users
Assign and remove roles
Change user password
Delete user
herearrow-up-right
herearrow-up-right

Tuum-managed credentials - Alternatively, you can manage user credentials directly in Tuum by associating passwords with usernames. To learn more, follow the instructions below for creating a BackOffice user password.

hashtag
Create BackOffice user password

After the BackOffice admin has created a new BackOffice user, the Tuum system will send an email. This email will confirm the account creation and include instructions for setting up a password.

The email contains the link to the Tuum system page, where a user can create a password.

circle-info
  • The BackOffice user must create the password that follows the company password policy. You can find more information about the password policy configuration herearrow-up-right.

  • If the link for password creation has expired, the user should follow the instructions in the Change password - user section to create a password.

hashtag
Create API user password

The BackOffice admin should create a password for the API user by following the instructions in the chapter Change password - BackOffice admin.

On the User details page, scroll down to the Roles section, and click Edit next to the role.

  1. You can:

    • Assign a role by toggling On next to the role name.

    • Remove a role by toggling Off next to the role name.

  2. To confirm the changes, click Save.

You can check the list of the available privileges in BackOffice by following these steps:
  1. Go to Administration > Access management > Roles > Add.

  2. The Role management page opens.

  3. All privileges are grouped by product or functionality. To view the list of privileges, click Expand.

circle-info

The Tuum system automatically updates the list of privileges whenever new features are added. By default, all new privileges are assigned to the Admin role. If you want to assign these new privileges to any other role, you must do so manually.

hashtag
Side panel

Enhance your productivity with the feature-rich side panel. Easily access your favourite pages, copied content, and page history.

hashtag
Prompt and efficient assistance

Looking for assistance is now simple and fast. You can effortlessly search or request content from the BackOffice user guide using the side panel ask or search field. You can follow the steps outlined in the summary or explore the BackOffice user guide to learn more about the topic of your interest.

hashtag
Favourites

Discover the power of the favourites feature and take control of your browsing experience. Save your most visited pages for an increase in efficiency and convenience.

hashtag
Favourites extra icon

Add more favourites with a single click using the star icon next to the breadcrumbs. And remember, you can also do so in the side panel.

hashtag
Clipboard

Your copying history is saved in the clipboard. Enjoy the easy access to texts, links, and excerpts. It is your personal memory vault that ensures nothing valuable slips away.

hashtag
Display modes

Create a personal workspace that suits you with customisable visual modes and zoom settings. Your preferences are saved for future logins so you can seamlessly continue your work without distractions.

hashtag
Content menu toggle

The content menu toggle gives you the power to keep your content menu open or closed just the way you like it.

hashtag
Content width toggle

Minimise or maximise the main content space with the content width toggle for a more comfortable browsing experience with just one click.

hashtag
Profile icon

Clicking on the profile icon reveals a link to your profile settings and a logout button.

hashtag
Loading spinner

Keep an eye on the loading spinner – a subtle signal that your data is loading in the background. Plus, give it a click anytime to swiftly return to the dashboard.

hashtag
Bank day icon

The current banking day is always visible here. Look out for a vibrant red icon, signalling an ongoing banking day change process.

On the Role management page, find the necessary privileges group.

  • Click Expand to select privileges.

  • You can:

    • Grant a privilege by toggling On next to the privilege name.

    • Revoke a privilege by toggling Off next to the privilege name.

  • To confirm the changes, click Save.

  • hashtag
    Domain knowledge

    Use the shortcuts below to quickly access user guides related to this domain's knowledge.

    global
    content feature

    File type *

    Select the file type.

    These values can be defined on the PERSON.DOCUMENT lookup page. For more information, see Create lookup codes.

    Available options for a private person are:

    • Birth certificate;

    • CV;

    • Dealer/broker contract;

    • Document copy;

    • Proof of address;

    • Selfie;

    • Terms and conditions;

    • Verification video.

    Available options for a legal person are:

    • Annual report;

    • Articles of association;

    • Business representation;

    Additional files can be added by clicking Add .

    File *

    Click the upload icon to upload the file.

    ,
    Last name
    or
    Role
    .
    circle-info

    You can use the filtering controls in the table header to refine how the table content is displayed. Find more information about filtering table content herearrow-up-right.

    Go to Organisational unit tab and click Edit.

    1. Update the organisational unit details, then click Save.

    Relationships - legal

    This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Relationship type *

    Select the relationship type:

    • Accountant;

    • Director;

    Private or legal person *

    Select or start typing the name, identification or registration number, or e-mail of a private or legal person.

    Role

    Enter the role of the representative.

    See the Relationships section below as it appears when creating a legal person:

    circle-info

    A legal person may represent another party, be represented, or have no representation relationship. These roles are shown in the legal person’s profile:

    • Representing person – The individual or entity authorised to act on behalf of the legal person.

    • Represented person

    Additional contacts - legal

    This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Contact type code

    Enter the company's contact type code.

    E-mail *

    Enter the company's e-mail address.

    Phone country code *

    Select the country code.

    See the Additional contacts section below as it appears when creating a legal person:

    Relationships - private

    This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Relationship type *

    Select the relationship type:

    • Beneficiary;

    • Parent.

    Additional relationships can be added by clicking Add .

    Private or legal person *

    Select or start typing the name, identification number, registration number, or e-mail of a private or legal person.

    Status *

    By default, the status is set to Active.

    See the Relationships section below as it appears when creating a private person:

    circle-info

    A private person in the system may represent someone else, be represented, or have no representation relationship. These roles are displayed in the person's profile:

    • Representing person – An individual authorised to act on behalf of another person.

    • Represented person

    Work - private

    This list of parameters applies only to the creation of a private person.

    Field name
    Description

    Business area

    Select the area(s) of business for the workplace. Multiple options can be selected. These values can be defined on the PERSON.PERSON lookup page by selecting PERSON_BUSINESS_AREA as the Lookup type. For more information, see .

    Example values include:

    • Agriculture, forestry and fishing;

    • Construction

    Activity

    Select the activity performed by the person at work. These values can be defined on the PERSON.PERSON lookup page by selecting PERSON_ACTIVITY as the Lookup type. For more information, see . Example values include:

    • Entrepreneur;

    • Executive;

    Employment time

    Select the employment duration. Available options are:

    • More than 4 years;

    • Trial;

    See the Work section below as it appears when creating a private person:

    Users and roles

    hashtag
    About user management

    The Tuum BackOffice user management allows your organisation to manage role-based access controls of users who interact with the Tuum system. By defining specific roles equipped with only the necessary permissions, you can ensure that your organisation's employees and applications access only the resources required for their tasks.

    The flexible role customisation capabilities of the Tuum BackOffice allow your organisation to adapt to ever-changing business needs while ensuring that workflows remain efficient and secure.

    On the other pages you will find detailed information about:

    Additional info - legal

    This list of parameters applies only to the creation of a legal person.

    Field name
    Description

    Date of incorporation/registration

    Select the company's date of registration.

    Format: DD.MM.YYYY

    Web address

    Enter the company's web address.

    Counterparty sector code

    Select the counterparty sector code. This parameter defines the financial sector to which the company belongs. The code is assigned by the relevant regulatory authority, such as the European Banking Authority (EBA) in the European Union. Available options are:

    • Central banks;

    • Credit institutions;

    See the Additional info section below as it appears when creating a legal person:

    Home - private

    This list of parameters applies only to the creation of a private person.

    Field name
    Description

    Property type

    Select the property type of the person's home. Available options are:

    • Living with parents;

    • Other;

    Building type

    Select the building type of the person's home. Available options are:

    • Apartment;

    • Other;

    See the Home section below as it appears when creating a private person:

    About accounts v2

    In Tuum, account functionality is based on two different logical setups:

    1. Account product – the core logic used for all new clients.

    2. Account parameter rule – the core logic used for earlier Tuum clients who have not yet migrated to the Account product setup.

    If you are using the Account product setup, begin with the Account product section. There you will find explanations of the setup’s components and links to detailed configuration instructions.

    If you are using the Account parameter rule setup, start with the section instead. For instructions on additional elements related to the account, use the table of contents to find the relevant component and follow the guidance provided there.

    Person groups

    Person groups are customer segmentation categories such as Platinum or Economy, typically used for marketing and customer profiling.

    circle-info

    This section is visible only if you have the VIEW_PERSON_GROUP privilege.

    hashtag
    Create person group

    1. Go to Persons > Settings > Person groups.

    2. On the Person groups page, click Add .

    1. The Create person group page opens, where you can define the Person group code, Person type, and Description.

    circle-info

    For more information on assigning a group code, see the instructions for adding a new or person.

    Find and confirm account application

    hashtag
    Find account application

    There are two ways to find an account application.

    1. If you want to perform a global search for any account application:

      • Go to Accounts > Search > Applications.

      • Fill in the search criteria and click Search.

      • Click on the Application identifier of the account application you are interested in to see full details.

    1. If you need to search for any account application for a dedicated person:

      • Go to Persons > Search.

      • Fill in search parameters > click the Search button.

    hashtag
    Confirm account application

    After submitting an account application, the account application details page will open.

    • Click Confirm > Yes to confirm the account application.

    View actions log and processes

    To view a person's action history and processes, follow these steps:

    1. Search for the person whose action logs and processes you want to view.

    2. Click the person's name to view their details.

    3. From the right-side panel, check the Actions log and Processes boxes to see these sections.

    1. The Actions log section displays details including who created the action, when it occurred, status changes, and the action performed (activated or inactivated).

    2. The Processes section shows information about who initiated each process, when it started, the process ID, type, status, and reason.

    Search persons

    After creating a person, you can search for them on the Search persons page using the quick or advanced search options.

    To search for a specific private or legal person, follow these steps:

    1. Go to Persons > Search.

    2. On the Search persons page, fill in the relevant parameters.

    1. You can enable Advanced search to access additional filters, allowing for a more granular search and narrowing down the results.

    2. When you click Search, a list of persons is displayed, showing identification numbers, names, e-mail addresses, and other relevant details.

    1. Click the person's name to view their details.

    Risks

    This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Risk type *

    Select the applicable type of risk.

    To add more risk types, see . Additional risks can be added by clicking Add .

    Risk level *

    Select the level of risk. To add more risk levels, see .

    Date *

    Select the date of the risk evaluation.

    Format: DD.MM.YYYY

    See the Risks section below:

    Remove user in organisational unit

    To remove users in organisational unit, follow these steps:

    1. Go to Administration > Access management > Organisation.

    2. Click the Unit code to open the details page.

    1. Go to Users tab and click Delete next to the name of the role that needs to be removed.

    1. The Confirmation modal opens.

    2. Click Confirm to proceed, or Cancel to discard.

    Create organisational unit

    To create a new organisational unit, follow these steps:

    1. Go to Administration > Access management > Organisation.

    2. On the Organisational units page, click Add.

    1. The New organisational unit page opens.

    2. , then click Create.

    Enabling account product

    Before you can use the account product feature, the Tuum team must first enable it. Customers currently using the Account Parameter Rule functionality need to complete all required preparations prior to transitioning to the account product solution.

    Users can verify that the setting is enabled after account migration by following these steps:

    1. Go to Administration > Settings > System properties.

    2. From the content menu, choose account-api.

    3. From the list of rules, find the USE_ACCOUNT_PRODUCT code.

    4. Check if its value is set to Yes.

    circle-exclamation

    Once USE_ACCOUNT_PRODUCT is set to Yes, the value of USE_ACCOUNT_PARAMETER_RULES is ignored.

    Manage person details

    This page allows you to view and update key information related to a person.

    From this page, you can:

    Search account products

    Use the Search account products page to search and filter available account products.

    To search for an account product, follow these steps:

    1. Go to Accounts > Products > Account products.

    2. On the Account products search page, enter the desired search parameters and click Search.

    circle-info

    The search results include many columns that may not fit on your screen. To choose which columns are shown first, click Settings to customise the visible columns.

    1. Click the Product code to view the account product details.

    1. The Account product details page opens.

    Role management

    Use Role management to create roles and assign privileges that control BackOffice actions.

    Below, you will find the following information:

    Delete user

    To delete a user, follow these steps:

    1. Go to Administration > Access management > Users.

    2. In the list of the users, click the Technical ID of the user that needs to be deleted.

    1. On the User details page, click Delete user.

    1. The Confirmation modal opens.

    2. Click Delete to confirm, or Cancel to discard.

    Post confirmation processing

    After the account application is confirmed, the subsequent processing will depend on your selection for the account setup type. To find out more, find the relevant explanation for STANDARD or EXTERNAL_VIRTUAL selection options.

    Create role

    To create a new role, follow these steps:

    1. Go to Administration > Access management > Roles.

    2. On the Roles page, click Add.

    Add or view comments

    To add or view a person's comments, follow these steps:

    1. whose comments you want to view or add.

    2. Click the person's name to view their details.

    3. From the right-side panel, check the

    Risk types and levels

    To record person-related risks for either a legal or private person, the Tuum system provides two key parameters:

    • ;

    • .

    These parameters are interrelated: the risk type defines the nature or category of the risk (e.g. credit risk), while the risk level indicates its potential impact (e.g. low, medium, or high).

    Identification numbers - private

    This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Custom fields

    circle-info

    For information on generic terms and functions of custom fields in the Tuum system, please refer to the chapter.

    Custom fields allow Tuum customers to add additional data to private or legal person records. For example, custom fields can include information such as bank details, bank identifiers, location, and address.

    To add the custom fields, follow these steps:

    Edit person's data

    To edit a person's data, start with these steps:

    1. whose status you want to change.

    2. Click the person's name to view their details.

    3. The person details page opens.

    Account types

    The following table presents the available account types in the Tuum system and their corresponding features.

    Account type
    Description

    Create account with parameter rule

    If you have the account parameter rule configured, the account creation form will be adjusted according to the rule setup.

    Let us consider an example of a parameter rule set for Finnish clients:

    If you create a new currency account for a Finnish customer, you will see the following parameters:

    In this example the the selection of jurisdiction country and account type parameters define the available values for the following parameters:

    Organisational unit parameters

    The following parameters are used when creating an organisational unit. Mandatory fields are marked with a red asterisk (*).

    hashtag
    Configuration

    Field name
    Description

    Open a savings account

    This operation opens a new savings account linked to an existing customer currency account. It can only be completed through internal API requests and is not supported in the Tuum BackOffice system.

    circle-info

    For detailed instructions and usage, refer to the . However, we assume your organisation has set up a method for creating savings accounts, so you do not need to get into the specifics of the corresponding API call.

    Currency account

    For currency accounts, Tuum can be configured in three ways:

    1. Standard (Account type setup code: STANDARD enabled): The Tuum system generates account numbers.

    1. External (Account type setup code:

    Add users to organisational unit

    To add users to an organisational unit, follow these steps:

    1. Go to Administration > Access management > Organisation.

    2. Click the Unit code to open the details page.

    About person

    In the Tuum system, creating a record for each person is essential for managing client or customer information effectively. This foundational step is necessary to begin leveraging other capabilities of the Tuum system, such as accounts, payments, cards, and loan features.

    hashtag
    Person types

    There are two types of persons in the system:

    View or add comments

    You can add or view comments on the savings account for reference or internal use.

    To view or add comments to the savings account, follow these steps:

    1. you want to view or comment on.

    2. Click the account number to open its details.

    Set up a savings account

    To set up a savings account, establish a connection between your savings account and an existing currency account. This involves configuring the savings account’s Account type interest method with parameters that match the Method assignment code, Account holder type, and Currency of the currency account. Once completed, the currency account will function as the servicing account for the savings account.

    hashtag
    Configuration steps

    To create a new account type interest method, follow these steps:

    Create lookup codes

    circle-info

    For information on generic terms and functions of lookups in the Tuum system, please refer to the chapter.

    Before creating a person profile, you can set up lookup codes for parameters such as education, employment type, marital status, and others.

    To manage these lookup codes, follow these steps:

    Registration numbers - legal

    This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Add or view external contracts

    To add or view a person's external contracts, follow these steps:

    1. whose external contracts you want to view or add.

    2. Click the person's name to view their details.

    3. From the content menu, click

    Account application statuses - External

    These account application statuses apply if the Tuum configuration for accounts is .

    APPLICATION STATUS CODE
    DESCRIPTION

    Legal entity identifier - legal

    This list of parameters applies only to the creation of a legal person.

    Field name
    Description

    Withdraw savings

    Savings can be withdrawn from the savings account either partially or in full, depending on the account’s terms and available balance.

    To withdraw savings from the savings account, follow these steps:

    1. from which you want to withdraw savings.

    2. Click the account number to view its details.

    Tax numbers

    This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Create users

    hashtag
    User types

    The Tuum system has two types of users:

    1. BackOffice user is a user for human operators who access the Tuum system through the BackOffice interface. These users are identities for employees of your company who perform their daily tasks and should not have a system role included in their role set.

    Create currency account without application

    circle-info

    This explanation applies to the standard account configuration.

    Follow the steps below to open a currency account without using an account application.

    1. Go to Persons > Search for the person who needs to get an account created.

    Block or unblock the savings account

    Use the block account feature to temporarily restrict access to savings accounts when required for security, legal, or risk management reasons.

    To block or unblock the savings account, start with these steps:

    1. you want to block or unblock.

    2. Click the account number to open its details.

    Close the savings account

    If a savings account is no longer needed by the account holder, or if the client relationship is ending, use the close account feature to permanently close it.

    To close the savings account, follow these steps:

    1. you want to close.

    2. Click the account number to open its details.

    Savings account operations

    This page provides a clear overview of the savings account operations, along with access to additional actions available for managing the account. The following actions are accessible from their respective pages:

    Savings account

    A savings account is a type of account designed to help customers save money for specific goals while earning a higher interest rate. To open a savings account, you must have an existing currency account (called the servicing account) and provide an initial deposit. Multiple savings accounts can be linked to the same servicing account, allowing flexible goal management.

    For more information, see the following sections:

    Find related accounts
    View or add comments
    Block or unblock the savings account
    Close the savings account
    Set up a savings account
    Open a savings account
    Fund a savings account
    Withdraw savings
    View savings account details
    Savings account operations
    Account parameter rule
    Change status of a person
    Edit person's data
    Add or view comments
    View actions log and processes
    Add or view external contracts
    Role management page
    Privileges
    Create role
    Modify role
    Remove role
    Standard
    External virtual
    API documentation herearrow-up-right
    ;
  • Human health and social work activities;

  • Education.

  • Student;

  • Unemployed.

  • Up to 1 year;
  • Up to 2 years;

  • Up to 3 years;

  • Up to 4 years.

  • Fixed employment length

    Enter the duration of the fixed-term employment in months. This applies when the person works as a contractor.

    Create lookup codes
    Create lookup codes
    Role management
    BackOffice administrator
    User management
    General governments;
  • Households;

  • Non-financial corporations;

  • Other financial corporations.

  • Business area

    Select the company's business area.

    Business model description

    Enter a description of the company's business model.

    Part ownership;
  • Private;

  • Rented.

  • Private house.

    Click the Identification number to access the person view page.

  • From the person content menu, choose Account > Account applications.

  • Click on the Application identifier of the account application you are interested in to see full details.

  • default currency,

  • customer group,

  • residency countries,

  • tax residency countries,

  • interest method assignment code.

  • circle-info

    The availability of the predefined items depend on the account parameter rule configuration.

    private
    legal
    – The individual who is being represented by someone else.
  • Represents as – Indicates that the current person is being represented by another individual.

  • Related as – Indicates that the current person is acting as a representative for someone else.

  • Representing start date *

    Select the start date of the representation.

    Format: DD.MM.YYYY

    Value *

    Enter the numerical value associated with the risk.

    Source name *

    Enter the name of the source that provided the risk data. For example: Hawk.ai.

    Source reference *

    Enter the reference ID from the source system used for risk evaluation. For example: ID-928292.

    Source link

    Provide a link to the process results or detailed risk assessment, if available.

    Risk types and levels
    Risk types and levels

    Document copy;

  • Flow of funds;

  • Group structure chart;

  • Organisational structure chart;

  • Ownership structure;

  • Proof of address;

  • Registry extract.

  • Enter the required details

    A customer account with a number, which can be used for payments but does not store its balance. The reference to the master account ID is mandatory for such account types.

    Shadow

    A hidden customer account related to the credit contract disbursements and repayments if currency accounts are not in use.

    circle-info
    • Only Currency and Internal account types can be created via the BackOffice interface.

    • To create other types of accounts, use the create account APIarrow-up-right endpoint.

    Currency

    A customer account that allows holding balances in multiple currencies on one account. It can have fees, interest conditions, and contractual overdraft conditions. Note: See more about currency accounts.

    Savings

    This account is designed to help customers save for specific goals while earning a higher interest rate. To open one, customers need to have an existing currency (servicing) account and make an initial deposit.

    Note: See more about savings accounts.

    Internal

    Bank's technical account used to reflect incoming or outgoing funds movements. The funds held in internal accounts are not categorised as customer deposits. Note: See more about internal accounts.

    Virtual

    Organisational unit code *

    Enter a unique organisational unit code.

    Example: MB_UK

    Organisational unit level

    This field is automatically set to 1 when no Parent is selected. If a Parent is selected, the Organisational unit level is automatically assigned based on the Parent’s level.

    Note: This field is read-only and cannot be edited manually.

    Name *

    Enter the name that corresponds to and describes the organisational unit code.

    Example: UK branch

    Telephone

    Enter the phone number.

    E-mail

    Enter a valid e-mail address.

    Example: [email protected]

    hashtag
    Address

    Field name
    Description

    Street

    Enter the street of the address.

    City

    Enter the city of the address.

    State

    Enter the state of the address.

    Zip

    Enter the ZIP code.

    Country code

    Select the country code.

    Timezone

    Select the time zone of the address.

    Parent

    Select an existing organisational unit from the list to assign it as the parent of the new organisational unit. If no Parent is selected, the organisational unit will be created at the top level.

    The PENDING status indicates that the Tuum system received a response from the Account service provider notifying Tuum that its AML review process is ongoing.

    ACCEPTED

    The ACCEPTED status indicates that the Tuum system has received a message from the account service provider stating that the AML review process has been successfully completed. The message includes the assigned primary account number. The Tuum system will proceed to the account opening.

    REJECTED

    The REJECTED status indicates that the Tuum system has received a message from the account service provider stating that the AML review process has failed. It is the final status and terminates the account application's processing.

    PROCESSED

    The PROCESSED status indicates that the Tuum system has completed the account opening process. The application also includes the assigned account number by the account service provider.

    ERROR

    The ERROR status indicates that the account application processing has encountered a technical error during the account opening process. You can manually retry the failed part of the process for failover.

    INSERTED

    The INSERTED status indicates a draft account application has been created.

    • You can edit or cancel the application at this stage.

    • The application needs to be confirmed to proceed with application processing towards account opening.

    PREPARED

    After confirmation, the application becomes uneditable and enters the PREPARED status. The Tuum system automatically sends the account application to the account service provider for account opening due diligence and account number assignment.

    CANCELLED

    The CANCELLED status indicates that either:

    • the draft account application was cancelled or

    • the confirmed application was cancelled before the subsequent processing steps were finished.

    External or Hybrid

    PENDING

    – The individual or entity that the legal person is authorised to represent.
  • Represents as – Indicates that the legal person is being represented by another party.

  • Related as – Indicates that the legal person is acting as a representative for another party.

  • Executive officer;
  • Member of board;

  • Representative;

  • Shareholder;

  • Supervisory board member.

  • Additional relationships can be added by clicking Add .

    Percentage of signature

    Enter the representative's signature percentage.

    Status *

    By default, the status is set to Active.

    Representing start date *

    Select the start date of the representation.

    Format: DD.MM.YYYY

    Beneficiary

    Select Yes if the representing person is a beneficial owner of the company; otherwise, select No.

    On the Role management page, enter the Role name and, if needed, provide a description.

  • Scroll the list of the grouped privileges. Click Expand to open available set of privileges.

  • Grant the Privileges by toggling On next to each privilege name.

  • circle-info

    To assign all privileges, toggle On the option next to Toggle all.

    1. Click Submit to create a new role.

    circle-info

    Role naming rules:

    • Use capital letters only.

    • Use underscores instead of the word spaces.

    For example, if you need to create a role for a bank official, use BANK_OFFICIAL.

    circle-exclamation
    • A role can contain an unlimited number of privileges.

    • To work with accounts and contracts, users must access the customer profile. For this reason, the privilege VIEW_PERSON is mandatory.

    Comments
    box to see the
    Comments section
    .
  • Click Add to add a new comment.

    1. Enter your comment and click Save to apply it.

    1. This is how the added comments will appear, with the most recent one shown first:

    Search for the person
    You can define how these parameters are used, including the criteria for assigning them, based on your internal risk policy framework.

    Below are theoretical examples to help illustrate how risk type and risk level can be applied.

    circle-info

    The examples below are for illustrative purposes only and are not predefined in the Tuum system. You must define the appropriate risk types and risk levels based on your organisation’s risk policies, as described below.

    hashtag
    Create risk type

    1. Go to Persons > Settings > Risk types.

    2. On the Risk types page, click Add .

    1. The Create risk type page opens, where you can define the Risk type code, Person type, and Description.

    For example, you can create different risk types such as Credit risk, Operational risk, or Reputation risk, depending on your risk classification needs.

    circle-info

    You can add a risk type either when creating a person or editing an existing one.

    hashtag
    Create risk level

    1. Go to Persons > Settings > Risk levels.

    2. On the Risk levels page, click Add .

    1. The Create risk level page opens, where you can define the Risk level code and Description.

    For example, you can create risk levels such as High, Medium, and Low to indicate the impact or severity of the risk. A High risk level means that the person is considered to carry the greatest level of risk.

    circle-info

    You can add a risk level either when creating a person or editing an existing one.

    hashtag
    Assign risk

    When assigning a risk to a person, you must select both the Risk type and the Risk level. For example, the outcome could be Risk type: Operational risk with an Impact level: Medium.

    circle-info

    See how to add a risk when creating a person.

    Risk type
    Risk level
    See the Identification numbers section below as it appears when creating a private person:

    Identification numbers *

    Enter the identification number. Additional identification numbers can be added by clicking Add .

    Identification number country *

    Select the country of identification.

    Primary

    Primary is automatically assigned to the first identification number created. It cannot be changed or removed. Only non-primary identification numbers can be deleted.

    While multiple identification numbers can be added, only the first one is marked as primary.

    Go to Administration > Settings > Custom fields.
  • From the content menu, select Person > Person.

  • Click Add field set.

    1. The Create field set modal opens. Enter the Field set ID and Field set name.

    2. Click Create to create new field set.

    1. Find your field set on the Custom fields page to customise it.

    2. Click Add field.

    1. The Create field modal opens. Enter the required parameters and click Create.

    1. The created fields will appear on the Custom fields page.

    1. When you return to Persons > Create, you will see the custom field you created.

    Custom fields
    To edit a person's data, please follow the specific instructions for each section.
    • If you wish to edit the Details section, follow the instructions here.

    • For any other section, please refer to the instructions here.

    hashtag
    Edit data in Details section

    To edit a person's existing data in Details sections, follow these steps:

    1. From the right-side panel, check the Details box to see the Details section.

    2. Click Edit to change the existing details.

    1. Edit the necessary parameters, then click Save to apply the changes.

    hashtag
    Edit data in any other section

    To update a person's data in any section except Details, follow these steps:

    1. Check the section navigator on the content sidebar to make the section data visible for editing.

    2. Click the section navigator to navigate to the section where the data you want to change is located.

    3. Follow the instructions provided in the Edit data item chapter.

    Search for the person
    EXTERNAL_VIRTUAL
    enabled): Account numbers are generated by an external account service provider such as LHV Bank (LHV), Banking Circle (BC), or CurrencyCloud (CC).
    1. Hybrid (Account type setup code: STANDARD and EXTERNAL_VIRTUAL enabled): Both the Standard and External options are used simultaneously. The decision about which option to use is made at the account opening.

    Depending on the configuration, two different account opening processes exist for currency accounts.

    1. Opening a currency account without an account application applies to standard configuration.

    2. Opening a currency account with an account application applies primarily to external and hybrid configurations but can also be used for the standard configuration if preferred.

    circle-info

    Please ensure you are familiar with the setup your company uses to access the appropriate explanations.

    Go to Users tab and click Add.

    1. Select the user from the dropdown list, then assign a role by toggling On next to the role name.

    2. When you are finished, click Save.

    circle-info

    If you need to create a new user, refer to the User management section to learn more.

    Private person - a physical individual. Private persons typically represent themselves, but they may also represent others if authorised through consents or mandates.
  • Legal person - an organisation, such as a business or non-profit entity. Legal persons are always represented by private persons.

  • The Person module in Tuum BackOffice allows you to create and configure person records, define essential parameters, and manage related data such as risk types, levels, and person groups. It also enables you to search for existing persons and control access through person privileges.

    Here you will learn about:

    The Account details page opens.

  • Click View/add comments at the top right of the page.

    1. The Account comments modal opens.

    1. View existing comments, if any, or add a new one by entering your comment and clicking Add comment.

    2. If no comments exist, the added comment will appear in the modal; otherwise, your new comment will be added to the list of existing comments.

    3. When you are finished viewing or adding comments, and have clicked Add comment if needed, click Close to exit the modal.

    Search for the account

    Find any currency account that you intend to use as the basis for the savings account.

  • On the Account details page, check the following parameters: Default currency, Person type, Interest method assignment code. These values must correspond exactly to the appropriate settings used when setting up the savings account.

    1. Create a new account type interest method for savings accounts.

      1. In the Interest method main settings section, enter values for Method assignment code, Account holder type, and Currency, ensuring they match the corresponding values assigned to the servicing account.

      2. Select Savings as the Account type.

      3. Set all other parameter values according to your requirements.

    1. After completing all required fields, click Create new account type interest.

    circle-info

    Alternatively, you can first create a new Account type interest method for currency accounts, followed by a separate interest method for savings accounts.

    Once the interest method is created, proceed to open a savings account linked to any currency account which Account type interest method matches the configured settings.

    Go to Administration > Settings > Lookups.
  • In the content menu, you’ll see a list of modules based on your subscription. Under the PERSON module, lookup options are available for address, document, financial data, personal information, and relationships.

    1. Select the lookup type from the drop-down menu.

    2. Click the add icon to create new lookup codes. The example below shows the PERSON > FINANCIAL DATA page.

    1. The Create new lookup modal opens.

    2. Enter the lookup code and add the translations.

    3. Click Create to save the new lookup.

    circle-info

    Lookup codes must be added on the PERSON module lookup page, as this is a mandatory field when creating a person record. Other parameters are optional.

    Lookups
    See the Registration numbers section below as it appears when creating a legal person:

    Registration numbers *

    Enter the registration number of the legal person. Additional registration numbers can be added by clicking Add .

    Registration country *

    Select the registration country from the list.

    Primary

    Primary is automatically assigned to the first registration number created. It cannot be changed or removed. Only non-primary registration numbers can be deleted.

    While multiple registration numbers can be added, only the first one is marked as primary.

    External contracts
    .
    circle-info

    The content menu shows person-related modules (e.g. accounts, loans, deposits, cards) based on your subscription. Viewing or deleting external contracts requires the VIEW_EXTERNAL_CONTRACTS privilege.

    1. Click Add external contract to create a new contract.

    2. The External contracts modal opens.

    3. Complete the required fields and click Create to add the contract.

    1. This is how the created external contract will appear:

    1. Checking the Show history box will display the validity range.

    Search for the person
    See the Legal entity identifier section below as it appears when creating a legal person:

    Lei code

    Enter the LEI code.

    A Legal Entity Identifier (LEI) is a unique 20-character alphanumeric code used globally to identify legal entities participating in financial transactions.

    Local operating unit

    Enter the local operating unit.

    Local operating units are organisations authorised to issue LEIs.

    Registration date

    Enter the company's date of registration.

    Format: DD.MM.YYYY

    The Account details page opens.

  • Click Withdraw savings at the bottom left of the page.

    1. The Withdraw money from the savings account modal opens.

    2. Enter the withdrawal amount and click Withdraw.

    circle-info

    Withdrawn funds will always be deposited into the currency account that is used as the servicing account. If the savings account is blocked, you will not be able to withdraw funds or top up the account.

    Search for the account

    Primary is automatically assigned to the first tax number created. It cannot be changed or removed. Only non-primary tax numbers can be deleted.

    While multiple tax numbers can be added, only the first one is marked as primary.

    See the Tax numbers section below:

    Tax number type *

    Select one of the following:

    • Tax number;

    • VAT number.

    Additional tax numbers can be added by clicking Add .

    Tax number *

    Enter the tax or VAT number.

    Tax country code *

    Select the tax country.

    Primary

    API user is a user for applications communicating with Tuum through API endpoints. These users are identities for other IT systems of your company integrated with Tuum and should have a system role included in their role set.

    circle-exclamation

    Tuum has a unique system user with the username modular.system. The system reserves this user for maintenance purposes. Tuum customers should not modify or use this user.

    hashtag
    User creation flow

    To enable a new user to perform tasks within the Tuum system, follow these three steps:

    1. Create a BackOffice or API user.

    2. Assign roles to restrict a user's permissions to perform authorised tasks.

    3. Set up credentials to enable secure access to the Tuum system.

    Below you can find more details about each step.

    hashtag
    Create users and add roles

    To create a new user:

    1. Go to Administration > Access management > Users.

    2. On the Users page, click Add.

    circle-info

    Only users with the MANAGE_USERS privilege can add new employees to the BackOffice.

    1. Enter the user details. The username and email must be unique within the Tuum system.

    2. Select required roles. To assign a role, toggle On next to the role name.

      • If you are creating a BackOffice user, do not assign the System role to the user.

      • If you are creating an API user, assign the System role to the user.

    3. Click Submit to complete the creation of a new user.

    circle-info

    If you need to create a new role, refer to the Role management section to learn more.

    Fill in search parameters > click the Search button.

  • Click on the person’s Identification number to view the Person details.

  • Once on the Person details page, go to the content menu Accounts > Accounts.

  • On the Accounts page > click the Create account button.

    1. Fill in the account parameters > click the Create button.

    circle-info

    You can set account parameter rules to restrict the options for new account parameter values. To learn more, look at the account opening example with the account parameter rule enabled.

    The Account details page opens.

    To block or unblock the savings account, follow the specific instructions for each section.

    • If you wish to block the savings account, follow the instructions here.

    • If you wish to unblock the savings account, refer to the instructions here.

    hashtag
    Block the savings account

    1. Click Block account at the top right of the page.

    1. The Block account modal opens.

    1. Select a reason for the status change from the dropdown menu, add a comment if needed, and click Yes to confirm blocking the savings account, or No to cancel the action.

    hashtag
    Unblock the savings account

    1. If the savings account is blocked and you wish to unblock it, click Unblock account at the top right of the page.

    1. A confirmation modal opens.

    2. Add a comment if needed, then click Yes to confirm unblocking the savings account, or No to cancel the action.

    Search for the account

    The Account details page opens.

  • Click Close saving at the top right of the page.

    1. A confirmation modal opens.

    2. Click Yes to confirm closing the savings account, or No to cancel the action.

    Search for the account

    Phone number *

    Enter the phone number.

    Preferred method of contact

    Select Yes if this is the preferred way to contact the company; otherwise, select No.

    Description

    Enter a description of the contact. Additional contacts can be added by clicking Add .

    Users and roles

    Person guide

    Account guide

    Account how-to guides

    Deposit guide

    Payment guide

    Loan guide

    Loan how-to guides

    Loan penalty guide

    Loan campaign guide

    Card guide

    Card how-to guides

    Finance guide

    Base interest rate guide

    Administration guide

    BackOffice content page features

    The BackOffice content page features allow the BackOffice user to customise their viewing preferences within the content area. These features apply to the pages with new design and are related to specific content elements displayed on those pages.

    This chapter highlights the tools available to manage and optimise your experience within specific content element groups in the BackOffice.

    hashtag
    Page layout

    The layout of the content page includes a page summary header, if available, and content sections in the middle, along with a content sidebar that features action buttons and various content section navigators on the right.

    hashtag
    Summary header

    The summary header represents a collection of the most prominent data items for the business object, in this example, a person, across all content sections. Its purpose is to give users a quick and comprehensive overview of the business object at a glance.

    hashtag
    Action buttons

    The action buttons, which allow the user to perform critical activities on the business object, in this example, inactivating the person's record or restricting access to it, are located at the top of the content sidebar on the right.

    circle-info

    For more information about the action buttons in the content sidebar, refer to the chapter for an illustrative example.

    hashtag
    Section navigators

    The section navigators on the content sidebar present a comprehensive list of distinct content sections. Each item in this list serves a dual purpose:

    1. A checkbox on the left controls whether its corresponding section is visible in the main content area. A checked box makes the section visible, while an unchecked box hides it.

    2. When a checkbox is checked, the item also acts as a navigator. Clicking on the item's label will smoothly scroll the user to that visible section in the main content area, which is indicated by an arrow on the right.

    hashtag
    Page content section features

    The primary component for displaying a list of data entities in a specific section of the page is a basic table. The tools located in the table header enable users to customise and rearrange the view of the table's content, as illustrated below.

    hashtag
    Show history toggle

    Check the box next to Show history to display past records, if any are available.

    hashtag
    Show more details

    If an icon with three dots appears in square brackets , it indicates that some table columns cannot be displayed within the visible area of the screen.

    Click Show more to reveal the list of hidden columns. You can also to make a hidden column visible.

    hashtag
    Download items

    You can download items by clicking Download next to the document or file you want to download. The download will begin automatically and save the document or file to your default download folder.

    hashtag
    Select items per page

    You can adjust how many items are shown per page:

    hashtag
    Organise displayed columns

    You can customise which columns are shown and in what order.

    Click Settings to customise which columns are visible.

    • To relocate the column into a different position: Click and hold the reorder handle next to the column name, then drag and drop the column to the desired position. Changes take effect immediately.

    • To show or hide a specific column: Check or uncheck the box next to its name. Changes are applied instantly.

    hashtag
    Filter data items

    Many sections include a Filter icon, which helps narrow down search results when working with large sets of data. For example, in the Actions log section, click Filter to open the search bar.

    Start typing your search term, and results will begin to appear as you type. You can enter values such as a user’s first or last name, or the name of a specific parameter you're looking for.

    hashtag
    Sort data items

    You can sort data items by clicking Sort in any column header.

    When you hover over a column header, both up and down arrows appear, indicating that the column is currently unsorted. Clicking the icon will cycle through sorting states: ascending (↑), descending (↓), and back to unsorted.

    hashtag
    Edit data item

    To edit a data item, click Edit, make the necessary changes or select a different option, then click Save to apply your updates.

    hashtag
    Delete data item

    To delete a data item, click Delete.

    Review the confirmation modal below, then click Confirm to proceed or Cancel to stop the deletion.

    Person details - private

    This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Person type *

    Select the person type. Available options are:

    • Private (default);

    • Legal.

    Customer type

    Select the customer type. Available options are:

    • Customer (default);

    • Beneficiary.

    The available values can be defined on the PERSON.PERSON lookup page by selecting CUSTOMER_TYPE as the Lookup type. For more information, see

    Given name

    Enter the first name of the person. This is a free-text field.

    See the Person details section below as it appears when creating a private person:

    Create person

    To create a new private or legal person in Tuum BackOffice, follow these steps:

    1. Go to Persons > Create.

    2. On the Create new person page, a list of configurable parameters is displayed.

    1. The Create person page opens with parameter selection for a Private person. To create a legal person, select Legal as the person type. The available parameters will automatically adjust based on your selection.

    chevron-rightCreate private person parametershashtag
    • ;

    • ;

    chevron-rightCreate legal person parametershashtag
    • ;

    • ;

    1. Fill in the required parameters and add optional ones if needed. Once completed, click Submit to finalise the person creation process.

    circle-info

    Depending on the settings of the Tuum system for your organisation, the successful creation of the person sets its state to Pending or Active. For more information, refer to the .

    Modify user roles in organisational unit

    Modifying user roles means assigning or removing them. To do that, follow these steps:

    1. Go to Administration > Access management > Organisation.

    2. Click the Unit code to open the details page.

    1. Go to Users tab and click Edit next to the user whose roles you want to update.

    1. You can:

      • Assign a role by toggling On next to the role name.

      • Remove a role by toggling Off next to the role name.

    Fund a savings account

    There are several ways to fund a savings account, each suited to different needs, from regular automated deposits to single manual transfers. The following provides an overview of the available options for funding a savings account:

    • Automated recurring transfers

    • Top up the savings account

    To find out more about each option, refer to the particular chapter below.

    hashtag
    Automated recurring transfers

    The primary method for funding a savings account is by setting up a recurring deposit schedule (e.g. monthly on a specific date). This automates the transfer of a fixed amount from the linked currency account to the savings account at the specified frequency.

    This operation can only be completed through internal API requests and is not supported in the Tuum BackOffice system.

    circle-info

    For detailed instructions and usage, refer to the . However, we assume your organisation has implemented a method for setting up recurring transfers, so you do not need to get into the specifics of the corresponding API call.

    hashtag
    Top up the savings account

    The top-up function allows for flexible transfers from the linked currency account to the savings account. It can be used to make the initial deposit during account creation, as well as any subsequent manual contributions as needed.

    To top up the savings account, or add funds, follow these steps:

    1. to which you want to top up savings.

    2. Click the account number to view its details.

    3. The Account details page opens.

    1. The Top up savings account modal opens.

    2. Enter the top-up amount and click Top up.

    You can also transfer funds from another financial institution via a standard bank transfer. Use the savings account number as the recipient and the account holder's name as the beneficiary. Other details may vary depending on the payment context.

    hashtag
    Custom booking to savings account

    It is also possible to make a manual custom booking into the savings account. However, this method is considered an exception and should only be used when necessary. For detailed instructions, refer to .

    Documents - private

    This list of parameters applies only to the creation of a private person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Document type *

    Select the type of document. These values can be defined on the PERSON.DOCUMENT lookup page. For more information, see .

    Example values include:

    • Driver’s licence;

    • ID card;

    Number *

    Enter the document number.

    Issuing country *

    Select the issuing country of the document.

    See the Documents section below as it appears when creating a private person:

    About accounts

    The accounts guide explains how to create and manage accounts using the Tuum BackOffice interface. Before getting started, please note the meaning of the following terms.

    • Account - an entity that records customers' (private and legal persons) or banks' transactions and balances in different currencies.

    • Account type - a set of attributes that determines the behaviour of an account. Each account type has a dedicated set of additional features.

    • Account service provider - an institution that provides account numbers.

    circle-info

    You can find the definitions of other terms in the section explaining the use of the dedicated account feature.

    Here you will learn about:

    External contracts parameters

    Field name
    Description

    Contract number *

    A unique identifier assigned to the external contract.

    Contract type code *

    A predefined code that specifies the type of contract (e.g. due diligence, dealer agreement, service contract). This value is selected from a dropdown list and must be configured in the system beforehand.

    Status code

    Indicates whether the contract is currently Active or Inactive. Select the appropriate status from the dropdown.

    Start date

    The date the contract becomes effective. Select the date from the calendar.

    End date

    The date the contract expires or is no longer valid. Select the date from the calendar.

    Account product

    Account product marks a shift away from a technical, finance-driven account parameter rule setup toward a more business-centric account configuration model. It replaces complex technical field combinations with a clearer configuration structure and decouples account configuration from finance-oriented account class codes.

    The account is now directly linked to a unique product code, making it clear which rules apply to the account throughout its lifecycle. Previously, each account parameter rule was uniquely identified by multiple parameters—person type, account type, jurisdiction country, and class code. These parameters could be filled or empty and could change on the account, adding complexity and making it unclear which rule was actually valid.

    Account class codes can now be changed without affecting account configuration. Previously, changing or clearing the class code could unintentionally change the account parameter rule, because they were directly linked, causing the class code to control which attribute values were allowed on the account instead of serving only its intended financial configuration purpose.

    circle-exclamation

    hashtag
    Migrating from Account parameter rule to Account product

    Customers using the Account parameter rule functionality must transition to the newer and more flexible Account product solution. For more information on migrating from Account parameter rule to Account product, contact the Tuum team. To learn more about enabling the Account product feature, see .

    Create account product

    The Create account product page lets you set up a new account product in two steps:

    1. Create a draft account product, which is fully editable but not yet usable.

    2. Confirm the draft account product to make it usable and only partially editable or delete it.

    hashtag
    Create a draft account product

    To create an account product, follow these steps:

    1. Go to Accounts > Products > Account products.

    2. On the Account products search page, click Add in the upper-right corner.

    1. The Create new product page opens.

    2. , then click Submit.

    circle-info

    While an account product is in Draft status, you can . To find account products in Draft status, see .

    hashtag
    Confirm or delete the draft account product

    After submission, you can either:

    1. Click Confirm to activate the account product.

    2. Click Delete to delete the account product.

    hashtag
    Confirm draft account product

    If you click Confirm, a confirmation modal opens. Enter a comment if needed, then click Confirm to activate the account product, or Cancel to go back.

    hashtag
    Delete draft account product

    If you click Delete, a confirmation modal opens. Click Confirm to delete the account product, or Cancel to discard the action.

    Account application statuses - Standard

    These account application statuses apply if the Tuum configuration for accounts is Standard or Hybrid.

    APPLICATION STATUS CODE
    DESCRIPTION

    INSERTED

    The INSERTED status indicates a draft account application has been created.

    • You can edit or cancel the application at this stage.

    • The application needs to be confirmed to proceed with application processing towards account opening.

    PREPARED

    After confirmation, the application becomes uneditable and enters the PREPARED status. The account application is ready for a manual approval process to change its status to PENDING, ACCEPTED, or REJECTED.

    CANCELLED

    The CANCELLED status indicates the draft account application was cancelled.

    External virtual

    The explanation below applies when you have selected the EXTERNAL_VIRTUAL as the Account setup type when creating the account application.

    hashtag
    Application processing

    After confirming the account application, the Tuum system automatically sends it to the Account service provider for AML review.

    • The account service provider will review the application and respond with acceptance or rejection.

    • In case the AML review takes longer, the Account service provider sends a response with a pending status.

    hashtag
    Pending applications

    When the Tuum system receives a response with the pending status, it means the AML review process with the Account service provider is still ongoing.

    Next, the Tuum system sets the account application to PENDING status. The application stays in this intermediary status until the Account service provider sends the message about accepting or rejecting it.

    hashtag
    Accepted applications

    When the Tuum system receives the response with acceptance, it means the application has met all the account opening criteria of the Account service provider. The response then also contains the assigned account number.

    Next, the Tuum system sets the account application to the ACCEPTED status and starts fully automated account opening processing with the account number assigned by the Account service provider.

    If successful, the account application gets the status PROCESSED, and the primary account number of the opened account will be visible on the account application details page.

    circle-info

    Keep monitoring the account application by checking its status until it reaches the PROCESSED status.

    hashtag
    Rejected applications

    When the Tuum system receives a rejecting response, it means the application has not met the required criteria for opening an account with the Account service provider.

    Next, the Tuum system sets the account application to the REJECTED status, which is the final status and ends the application's processing.

    circle-info

    For more information, refer to the explanations about .

    Standard

    The explanation below applies when you have selected STANDARD as the Account setup type when creating the account application.

    hashtag
    Application processing

    The account application will go through a manual approval process after the account application confirmation.

    • Click Accept if the application meets all the account opening criteria.

    • Click Reject if it does not meet the required criteria for account opening.

    • Click Mark for review if additional due diligence about the applicant is required to decide whether to accept or reject the application.

    After clicking the Accept, Reject, or Mark for review button, the confirmation modal will open. In this modal, you can:

    • select the status change reason and

    • fill in a comment.

    Click Yes to confirm the application status change.

    hashtag
    Pending applications

    Clicking the Mark for review button sets the account application to PENDING status. In this intermediary status, the decision to accept or reject the application must be made.

    Once you have finished the additional due diligence, click the Accept or Reject button to change the application's status.

    hashtag
    Accepted applications

    Clicking the Accept button sets the account application to the ACCEPTED status and starts fully automated account opening processing.

    If successful, the account application gets the status PROCESSED, and the primary account number of the opened account will be visible on the account application details page.

    circle-info

    Keep monitoring the account application by checking its status until it reaches the PROCESSED status.

    hashtag
    Rejected applications

    Clicking the Reject button sets the account application to the REJECTED status, which is the final status and ends the application's processing.

    circle-info

    For more information, refer to the explanations about .

    Change status of a person

    Person statuses help manage and understand a person's data record throughout its existence in the Tuum system, supporting operational workflows, data governance, and compliance.

    This diagram illustrates the possible status transitions for a person in the Tuum system.

    To change a person's status, follow the steps outlined below.

    hashtag
    Common steps

    View savings account details

    On the Savings account details page, you can get an overview of the savings account details and balances.

    hashtag
    View savings account details

    On the Savings account details page, you can view key information including the Account details and Savings details sections, as well as your account numbers and current balances.

    To view Savings account details page, follow these steps:

    Person details - legal

    This list of parameters applies only to the creation of a legal person. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Currency account parameters

    Parameter name
    Type
    Description

    Person details page

    The purpose of the person details page is to provide a comprehensive management and viewing interface for a specific person's (customer's) profile and associated financial products. It allows you to efficiently review, navigate, and administer a person's complete record within the Tuum system.

    hashtag
    Person's summary

    The summary card, located prominently at the top centre of the content area, offers a quick overview of the person's essential details and status. It displays key details such as:

    Create currency account with application

    circle-info

    This explanation applies primarily to external and hybrid account configurations and the standard configuration if selected.

    hashtag
    About account application

    Find related accounts

    As savings accounts are always connected to servicing accounts, you may occasionally need to quickly identify this relationship. This section explains how to find related accounts in Tuum, specifically how to locate a savings account from a servicing account, and vice versa.

    hashtag
    Find savings account from the servicing account

    To find a savings account from the servicing account details page, follow these steps:

    Description

    A brief summary or additional details about the contract.

    Download

    Provides access to download the uploaded contract document or related files.

    Source name *

    The name of the organisation, system, or individual that provided the contract.

    Source reference *

    A reference ID or code used by the source system to identify the contract.

    Source link *

    A direct URL or link to the original source of the contract.

    Enabling account product
    Create person
    Search persons
    Create lookup codes
    Risk types and levels
    Person groups
    Person privileges
    Person details page
    Manage person details
    Click Top up savings at the bottom left of the page.
    Custom booking to savings account
    API documentation herearrow-up-right
    Search for the account
    Custom bookings
    Account parameter rule
    Account types
    Search accounts
    Account view page
    Account price list
    Account limits
    Account class codes
    Account access rights
    Account review rules
    Account interest
    Allowed operations
    Account transactions
    Custom bookings
    Account transaction types
    Transaction reversals
    Reservations
    Account privileges
    Enter all required parameter values
    edit most fields
    Search account products
    account application statuses
    account application statuses
    Addresses;
  • Additional info;

  • Tax numbers;

  • Work;

  • Home;

  • Documents;

  • Files;

  • Relationships;

  • Risks;

  • Financial data;

  • Custom fields.

  • Addresses;
  • Additional info;

  • Tax numbers;

  • Legal entity identifier;

  • Additional contacts;

  • Files;

  • Relationships;

  • Risks;

  • Financial data;

  • Custom fields.

  • Person details
    Identification numbers
    Person details
    Registration numbers
    Change the status of a person

    To confirm the changes, click Save.

    PENDING

    The PENDING status indicates that the application processing is on hold until additional due diligence is complete. It is intermediary status before the account application gets ACCEPTED or REJECTED status.

    ACCEPTED

    The ACCEPTED status indicates the account opening due diligence has successfully completed and the process will proceed with the account opening.

    REJECTED

    The REJECTED status indicates the account opening due diligence has failed. It is the final status and terminates the account application's processing.

    PROCESSED

    The PROCESSED status indicates that the Tuum system has completed the account opening process. The application also includes the assigned account number by Tuum.

    ERROR

    The ERROR status indicates that the account application processing has encountered a technical error during the account opening process. You can manually retry the failed part of the process for failover.

    .

    Middle name

    Enter the middle name of the person. This is a free-text field.

    Surname *

    Enter the last name of the person. This is a free-text field.

    Residency country

    Select the country of residence.

    Tax residence

    Select the country of tax residence.

    Person groups

    Select a person group from the drop-down list. To add a new person group, see Person groups.

    E-mail

    Enter a valid e-mail address (e.g. [email protected]).

    Phone country code

    Select the country code.

    Phone number

    Enter the phone number.

    Gender

    Select the gender. Available options are:

    • Male;

    • Female;

    • Other.

    Number of dependent persons

    Enter the number of dependent persons.

    Create lookup codes

    Passport;

  • Residence permit.

  • Additional documents can be added by clicking Add .

    Expiry date

    Enter the document's expiry date.

    Format: DD.MM.YYYY

    File *

    Click the upload icon to upload the file.

    Create lookup codes
    To activate, inactivate or close a person, follow these steps:
    1. Search for the person whose status you want to change.

    2. Click the person's name to view their details.

    3. The person details page opens.

    For the next steps use the action button on the content sidebar, located on the right side of the content area.

    hashtag
    Activate person

    You must activate the person once it is in pending status after creation or reactivation.

    Click Activate on the content sidebar, located on the right side of the content area.

    The success notification stating Customer successfully activated is shown, and the person's status changes to green with the label Active.

    hashtag
    Change status reason

    To update the status reason, click Change status reason to open a modal where you must select a status code reason from a dropdown menu, and provide a comment. Click Submit to confirm the changes, or Cancel to close the modal without saving any changes.

    hashtag
    Inactivate person

    You must inactivate a person when you intend to close that person's record in the Tuum system.

    1. Click Inactivate on the content sidebar, located on the right side of the content area.

    1. The Close customer modal opens.

    1. Select the reason for inactivation and the inactivation date.

    2. Add a comment if needed.

    3. Click Submit to apply the changes.

    The person's record now shows a note with the inactivation date.

    hashtag
    Reactivate person

    You must reactivate a person when you intend to restore an inactivated person's record in the Tuum system.

    1. Click Reactivate on the content sidebar, located on the right side of the content area.

    1. The Reactivate person modal opens.

    1. Select the reason for reactivation and the reactivation date.

    2. Add a comment if needed.

    3. Click Submit to apply the changes.

    The success notification stating Person successfully reactivated is shown, and the person's status changes to ! with the label Pending.

    hashtag
    Forget person

    You must forget a person when you intend to permanently delete an inactivated person's record in the Tuum system.

    1. Click Forget on the content sidebar, located on the right side of the content area.

    1. The Forget person modal opens.

    1. Select the forget Reason and the Forget date.

    2. Add a comment if needed.

    3. Click Submit to apply the changes.

    A success notification appears, confirming that the person's data has been permanently deleted. The person's details page, with no data, is displayed.

    Person statusesPerson statuses

    Find the required account.

  • Open the account view page by clicking on the account Account number.

  • hashtag
    Savings account view page

    The Savings account view page has five sections:

    1. Header

    2. Account details

    3. Saving details

    hashtag
    Header section

    The header section of the Savings account view page starts with the title, followed by action buttons for savings account management and links for reviewing related activity.

    Three action buttons available in the header section allow you to perform specific actions:

    • View/add comments - allows viewing existing comments or adding new ones. See the View or add comments section for more details.

    • Block account - allows temporarily setting the savings account to blocked status. See the Block or unblock the savings account section for more details.

    • Close saving - allows closing the savings account. See the Close the savings account section for more details.

    circle-exclamation

    Close saving - is an irreversible action. Once a savings account is closed, it cannot be reopened.

    At the end of the header section on the Savings account view page, you can find three links that provide an overview of various savings account-related activities:

    • 4eye review processes - to view the savings account-related review processes.

    • Actions log - to view the savings account-related actions.

    • Account processes - to view the savings account-related processes.

    hashtag
    Account details section

    The Savings account details section provides a comprehensive overview of savings account-related parameters. It includes two parameters that you can modify:

    • Click Edit next to the Interest method assignment code parameter value to change the Interest method assignment code.

    • Click the Open modal link next to the Custom fields parameter to manage the savings account-related custom fields.

    hashtag
    Savings details section

    The Savings details section provides a clear summary of key information related to the savings account. This section is read-only and allows you to view essential details about the savings setup, including the savings plan, schedule, and progress. It helps you quickly understand the structure and current state of the savings without requiring any actions.

    hashtag
    Account numbers section

    The account numbers section lists all alternative account number sets for different use cases, such as domestic payment schemes. For standard account types (which include savings accounts), only alias account numbers can be added. You can add a new account number by clicking Add.

    hashtag
    Account balances section

    The account balance section lists account balances in different currencies. Each currency has the following balance items.

    • Balance indicates the gross amount available to the account holder.

    • Overdraft shows an amount permitted by the bank which can be overdrawn.

    • Reserved is an amount that still belongs to the account holder but has been suspended and reserved, for example, by a merchant.

    • Available is the net amount in the balance currency available to the account holder.

    Trading name

    Enter the registered trade name of the entity. This is a free-text field.

    Legal form

    Enter the legal form of the entity. For example, sole trader, partnership, limited company, etc.

    Intra org code

    Enter the unique internal organisation reference.

    Residency country

    Select the country of residence.

    Person groups

    Select a person group from the drop-down list.

    To add a new person group, see .

    E-mail

    Enter a valid e-mail address (e.g. [email protected]).

    Phone country code

    Select the country code.

    Phone number

    Enter the phone number.

    See the Person details section below as it appears when creating a legal person:

    Person type *

    Select the person type.

    Available options are:

    • Private (default);

    • Legal.

    Customer type

    Select the customer type.

    Available options are:

    • Customer (default);

    • Beneficiary.

    The available values can be defined on the PERSON.PERSON lookup page by selecting CUSTOMER_TYPE as the Lookup type. For more information, see .

    Name *

    Enter the name of the legal person. This is a free-text field.

    Default currency*

    List

    Select the default currency of the account. Available values consist of the currencies configured for your Tuum setup.

    Customer group*

    List

    Select a customer segmentation group. Available values consist of customer groups you have created with Tuum.

    Price list type*

    List

    Select an account price list type within the chosen customer group. Available values consist of price list types you have created with Tuum.

    Overdraft amount

    Number

    Non-editable field; It is available for internal accounts only.

    Account holder name*

    Text

    Enter the actual name of the account holder.

    Residency country code*

    List

    Select the residency country of the account holder.

    Tax residency country*

    List

    Select the account residency country.

    Interest method assignment code

    List

    Select the interest method assignment code. This parameter is generated when you create the account type interest. For more details, please refer to the .

    Account name

    Text

    Enter the name you would like to assign to the account.

    Account type*

    List

    Select the CURRENCY account type.

    Account Class

    List

    Select the account class.

    status and type of the person;

  • ID number, creation date, language, tenant code, and customer type;

  • contact information (phone, e-mail);

  • residency country, business area, counterparty sector code, and intra org code.

  • If a person is classified as a Politically Exposed Person (PEP), it will be indicated on the summary card as a dedicated notice.

    circle-info

    You can modify the parameters shown on the summary card in the respective section of the content area below.

    hashtag
    Content menu

    The left-side content menu features navigation categories for Tuum product items, providing quick access to person-related financial products. The categories include accounts, loans, deposits, cards, and other financial products. You can select a category and its sub-items, if applicable, to swiftly locate specific financial products related to that person.

    circle-info

    The available list of navigation items in it depends on the configuration of the Tuum business modules (e.g. accounts, loans, deposits, cards) for your organisation.

    hashtag
    Content sidebar

    The content sidebar, located on the right side of the content area, consists of two elements: action buttons at the top and content navigators below them.

    hashtag
    Action buttons

    The action buttons allow the user to perform essential activities with the person. The specific list of action buttons depends on the person's status. In this example, the user can inactivate the person's record or restrict access to it.

    circle-info

    For more information about the action buttons in the content sidebar, please refer to the Action buttons chapter in the BackOffice content page features.

    hashtag
    Section navigators

    The section navigators on the sidebar display a complete list of content sections on a person's details page.

    circle-info

    For more information about the content section navigators in the content sidebar, please refer to the Section navigators chapter in the BackOffice content page features.

    hashtag
    Content sections

    The purpose of the content section is to group similar data sets into distinct visual categories. To view the data in a particular section, ensure that its visibility is enabled. You can then access it by clicking on the corresponding section navigator in the content sidebar or by simply scrolling the page to that section.

    hashtag
    Person details section

    The person overview page includes a Details section, which is structured based on the type of person:

    • Private person: displays individual-specific sections such as Personal, Contact, and Work & home.

    • Legal person: displays entity-specific sections such as Personal, Contact, and Business.

    hashtag
    Other sections

    circle-info

    For more information on viewing data items located in other sections of the person's details page, please refer to the Page content section features chapter.

    In the account opening process, the creation of the account application is a preparatory stage before the account opening and consists of two steps.
    1. Creating an account application.

    2. Confirming an account application.

    Confirmation of the account application initiates the account opening process. Depending on the account setup type, the account will be assigned either an externally provided or internally generated account number.

    hashtag
    Create account application

    Follow the steps below to open a currency account using the account application.

    1. Open the person view page:

      • Go to Persons > Search.

      • Fill in search parameters > click the Search button.

      • Click the Identification number to access the person view page.

    2. Create an account application for a person:

      • From the person content menu, choose Account > Account applications.

      • Click the Create application button.

    3. Fill in the main .

    circle-info

    Selecting the correct combination of account type setup, service provider code, and account code parameters is crucial to opening the intended account.

    1. If necessary, you can add account owner limits (optional).

      • Click the Add Limits button to open the section with parameters.

      • Fill in the parameters for the account owner limits.

    1. If necessary, you can add representatives and their limits (optional).

      • Click the Add Representatives button to open the section with parameters.

      • Fill in the parameters for the representative and set their limits.

    1. Click Submit to complete the creation of the account application.

    circle-info

    You must confirm the account application to start the account opening process.

    hashtag
    Edit or cancel account application

    After clicking Submit, Tuum creates a draft account application with the status INSERTED. You can edit or cancel the draft application until you confirm it and start the account opening process.

    hashtag
    Edit account application

    Click Edit to change the account application details and click Save to preserve the changes.

    circle-info

    You must confirm the account application to start the account opening process.

    hashtag
    Cancel account application

    Click Cancel to cancel the account application.

    • Select the reason for the status change and add a comment, if necessary.

    • Click Yes to confirm the cancellation.

    circle-exclamation

    Cancelling an account application results in the irreversible termination of the account application process.

    From the content menu, select Related accounts.
  • On the Related accounts page, click the Saving accounts tab.

    1. Click on the account number to open the Savings account details page.

    hashtag
    Find servicing account from the savings account

    To find a servicing account from the savings account details page, follow these steps:

    1. From the content menu, select Related accounts.

    2. On the Related accounts page, click the Saving servicing account tab.

    1. Click on the currency account number to open the Servicing account details page.

    Change status of a person
    reorganise the order of table columns

    Account parameter rule parameters

    Parameter name
    Type
    Description

    Account type*

    List

    Select the account type:

    • CURRENCY,

    • INTERNAL,

    • VIRTUAL.

    Account holder type*

    List

    Select the person type:

    • Private,

    • Legal.

    Account class

    List

    Change user password

    There are two ways to change a user's password:

    1. The BackOffice admin can reset a user's password.

    2. The user can reset their password themselves.

    hashtag
    Change password - BackOffice admin

    To change a user's password as a BackOffice admin, go to:

    1. Administration > Access management > Users.

    2. In the list of the users, click Technical ID of the employee whose password you need to reset.

    1. On the User details page, scroll down to the Password section.

    2. Enter the New password and Confirm password.

    3. Click Change to save the changes.

    hashtag
    Change password - user

    The BackOffice user can reset their password in two ways:

    1. Using the when not logged in.

    2. Accessing their when logged in.

    hashtag
    Change password via forgotten password feature

    If the BackOffice user has forgotten their password, they can initiate a password reset via the login page.

    1. On the login page, click the Trouble signing in link.

    1. On the password reset page, enter your email address.

    2. Click Reset Password.

    An email with password reset instructions will be sent to the employee's registered email address. They should follow the instructions in the email to complete the password reset process.

    hashtag
    Change password via user profile page

    If a BackOffice user is logged in, they can change their password from the user profile page.

    1. Click the user profile icon in the top-right corner of any BackOffice page.

    1. Click Settings, which is opened in the same location, to navigate to the User details page.

    1. On the User details page, scroll down to the Password section.

    2. Enter the New password and Confirm password.

    3. Click Change to save the changes.

    Account parameter rule

    Account parameter rules allow restricting account attributes depending on the account type, person type, account class and jurisdiction country code. When creating a new account, the Tuum system selects a valid account parameter rule that is matching to the account attributes.

    hashtag
    Enable account parameter rule feature

    circle-info

    Enabling an account parameter rule feature is a one-time action. Once enabled, you can continue creating and managing the account parameter rules without the need to re-enable it.

    To use the account parameter rule, you must enable this feature:

    1. Administration > Settings > System property.

    2. From the content menu, choose account-api.

    3. From the list of rules, find the USE_ACCOUNT_PARAMETER_RULES code > click the sign to update the system property.

    hashtag
    Add new account parameter rule

    1. Accounts > Settings > Account parameter rule.

    2. On the account parameters page, click the Create rule button.

    3. Fill in the > Save.

    circle-info

    To ensure the account parameter rule applies to a new account, select account type, person type, account class, and jurisdiction country code when creating an account.

    hashtag
    Find account parameter rule

    Once a new account rule is added, it appears on the account parameter rules page:

    • Accounts > Settings > Account parameter rule.

    hashtag
    Update account parameter rule

    1. Accounts > Settings > Account parameter rule.

    2. Click the in front of the rule that you want to modify.

    3. Update the parameter rule > Save.

    circle-info

    You can modify the following rule parameters:

    • Currencies,

    • Residency countries,

    hashtag
    Disable account parameter rule

    1. Accounts > Settings > Account parameter rule.

    2. Click the cross sign in front of the rule that you want to disable.

    3. Select the invalidate from date > Invalidate.

    Financial data

    This list of parameters applies to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

    Field name
    Description

    Financial data type *

    Select the financial data type. Available options for a private person are:

    • Assets;

    • Expenses;

    Financial data value type *

    Select the financial data value type:

    • Currency;

    • Number;

    Period *

    Enter the duration of the period in months.

    See the Financial data section below:

    Person privileges

    chevron-rightTo addhashtag
    • ADD_PERSON

    • ADD_PERSON_FILE

    • ADD_PERSON_GROUP

    • ADD_PERSON_GROUP_TYPE

    • ADD_PERSON_LOG

    • ADD_FINANCIAL_DATA

    • ADD_LEGAL_ENTITY_IDENTITY

    • ADD_REPRESENTATIVE

    chevron-rightTo changehashtag
    • CHANGE_PERSON_ADDITIONAL_CONTACT

    • CHANGE_PERSON_ADDITIONAL_INFO

    chevron-rightTo createhashtag
    • CREATE_PERSON_ADDITIONAL_CONTACT

    • CREATE_PERSON_ADDRESS

    chevron-rightTo deletehashtag
    • DELETE_PERSON_ADDITIONAL_CONTACT

    • DELETE_PERSON_ADDRESS

    chevron-rightTo edit and searchhashtag
    • EDIT_PERSON

    • SEARCH_PERSON_FILES

    chevron-rightTo viewhashtag
    • VIEW_PERSON

    • VIEW_PERSON_BLOCK

    chevron-rightRisk privilegeshashtag
    • DELETE_RISK_LEVEL

    • DELETE_RISK_TYPE

    Edit active account product

    Editing an active account product means changing one or more of its parameters, such as the currency or class code.

    circle-exclamation

    After you make a change, the new parameter values apply only to accounts opened under this product from that point onward. Accounts opened before the change continue to use the parameter values that were in effect when they were created.

    In an active account product, editable sections are indicated by an edit icon. Click Edit to open a detailed view of the section, where you can modify the available parameters.

    To edit a section, follow these steps:

    Additional info - private

    This list of parameters applies only to the creation of a private person.

    Field name
    Description
    CHANGE_PERSON_ADDRESS
  • CHANGE_PERSON_DOCUMENT

  • CHANGE_PERSON_PERSONAL_INFO

  • CHANGE_PERSON_STATUS_CODE_REASON

  • CHANGE_LEGAL_ENTITY_IDENTITY

  • CREATE_PERSON_COMMENT
  • CREATE_PERSON_CUSTOM_FIELD

  • CREATE_PERSON_CUSTOM_FIELD_VALUE

  • CREATE_PERSON_DOCUMENT

  • CREATE_PERSON_LOOKUP

  • DELETE_PERSON_DOCUMENT
  • DELETE_PERSON_GROUP

  • DELETE_PERSON_GROUP_TYPE

  • DELETE_EXTERNAL_CONTRACTS

  • DELETE_FINANCIAL_DATA

  • DELETE_LEGAL_ENTITY_IDENTITY

  • EDIT_REPRESENTATIVE
  • FORGET_CUSTOMER

  • INACTIVATE_CUSTOMER

  • CLOSE_REPRESENTATIVE

  • VIEW_PERSON_COMMENT
  • VIEW_PERSON_CUSTOM_FIELD

  • VIEW_PERSON_CUSTOM_FIELD_VALUE

  • VIEW_PERSON_GROUP

  • VIEW_PERSON_GROUP_TYPE

  • VIEW_PERSON_LOGS

  • VIEW_PERSON_LOOKUP

  • VIEW_EXTERNAL_CONTRACTS

  • VIEW_FINANCIAL_DATA

  • VIEW_LEGAL_ENTITY_IDENTITY

  • VIEW_RISK_LEVEL
  • VIEW_RISK_TYPE

  • MANAGE_RISK_LEVEL

  • MANAGE_RISK_TYPE

  • Select the account class. If you want to use this parameter for the account parameter rule, make sure that the account class is configured before.

    Jurisdiction country*

    List

    Select the jurisdiction country. This parameter reflects branch jurisdiction country code. The jurisdiction parameter is defined on the account level.

    Currencies

    List

    Select the allowed currencies for the parameter rule.

    Residency countries

    List

    Select the residency countries. The residency countries parameter is defined on the account level.

    Tax residency countries

    List

    Select the tax residency countries. The tax residency parameter is defined on the account level.

    Method assignment codes

    List

    Select the interest method assignments. Note that the method assignment codes are a lookup parameter. If you have not configured the method assignment code values, refer to the following instructions.

    Customer groups

    List

    Select the customer groups.

    Note that the customer groups are a lookup parameter. If you have not configured the method assignment code values, refer to the following instructions.

    Tenant*

    Number/Text

    Enter the tenant name for which you are configuring the account parameter rule.

    BIC key

    Number/Text

    Enter the BIC key value.

    Numbering sequence key

    Number/Text

    Enter the Numbering sequence key value.

    Validity range from*

    Date

    Select the account parameter rule validity from date.

    Validity range to

    Date

    Select the account parameter rule validity to date.

    account interest section
    forgotten password feature
    user profile page
    Account numbers
    Account balances
    Create lookup codes
    Person groups
  • Change the system property value to Yes.

  • Tax residency countries,

  • Interest method assignments,

  • Customer groups,

  • Validity range from,

  • Validity range to.

  • parameter rule parameters
    account application details
    Income;
  • Investments.

  • Available options for a legal person are:

    • Assets;

    • Equity;

    • Expenses;

    • Income;

    • Investments;

    • Profit;

    • Raised capital;

    • Revenue.

    Additional financial data can be added by clicking Add .

    Currency range;
  • Number range.

  • Period from *

    Select the start date of the period range. Format: DD.MM.YYYY

    Period to

    Select the end date of the period range. Format: DD.MM.YYYY

    Currency *

    Select the currency code. Note: This field is visible only when the financial data value type is set to Currency or Currency range.

    Value from

    Enter the estimated lower value for the period. Note: This field is visible only when the financial data value type is set to Currency or Currency range.

    Value to

    Enter the estimated higher value for the period. Note: This field is visible only when the financial data value type is set to Currency or Currency range.

    Current period value

    Enter the financial value for the current period. Note: This field is visible only when the financial data value type is set to Currency or Number.

    Next period estimate value

    Enter the estimated financial value for the next period. Note: This field is visible only when the financial data value type is set to Currency or Number.

    Description

    Enter a description of the financial data.

  • Find the account product in question.

  • On the Account product details page, scroll to the relevant section and click Edit.

  • The sections you can edit are the following:

    • Details

    • Account type setup

    • Residency

    hashtag
    Details

    You can edit the product name, description, reporting product code, and the validity range. After making your changes, click Save.

    hashtag
    Account type setup

    You can enable or disable contractual overdrafts. After making your changes, click Save.

    hashtag
    Residency

    You can edit the allowed residency country codes and the allowed tax residency country codes. After making your changes, click Save.

    hashtag
    Balance currencies

    You can edit the list of allowed currencies and the default currency code. After making your changes, click Save.

    hashtag
    Class codes

    You can enable or disable all class codes, or select specific ones and set a default. After making your changes, click Save.

    hashtag
    Interest

    You can enable or disable all interest method assignment codes, or select specific ones and set a default. After making your changes, click Save.

    hashtag
    Fees

    You can edit the allowed and default price list customer groups selections. When a default price list customer group is selected, you can also choose a default price list type code. After making your changes, click Save.

    hashtag
    Account numbering

    You can edit or add the BIC key and select a numbering sequence key. After making your changes, click Save.

    Select the person's native language.

    Nationality

    Select the person's nationality.

    Education

    Select the level of education from the drop-down list. The available values can be defined on the PERSON.PERSON lookup page by selecting PERSON_EDUCATION as the Lookup type. For more information, see . Example values include:

    • Higher education;

    • Not available;

    Marital status

    Select the person's marital status. The available values can be defined on the PERSON.PERSON lookup page by selecting PERSON_MARITAL_STATUS as the Lookup type. For more information, see . Example values include:

    • Cohabitant;

    • Complicated;

    Web address

    Enter the person's web address.

    Intra org code

    Enter the intra org code.

    Intra org codes are used to identify different branches or entities within the same organisation operating on the platform.

    For example, if Bank A has branches in London and Berlin, each branch should have a unique intra org code to distinguish their records.

    Counterparty sector code

    Select the counterparty sector code. This parameter defines the financial sector to which the company belongs. The code is assigned by the relevant regulatory authority, such as the European Banking Authority (EBA) in the European Union. Available options are:

    • Central banks;

    • Credit institutions;

    PEP

    Indicates whether the person is a Politically Exposed Person (PEP), meaning they hold or have been entrusted with a prominent public position.

    PEP explanation

    Enter the reason why the person is considered a PEP.

    Note: This field is visible only when PEP is set to Yes.

    US resident

    Indicates whether the person is considered a resident of the United States.

    See the Additional info section below as it appears when creating a private person:

    Date of birth

    Select the person's date of birth.

    Format: DD.MM.YYYY

    Country of birth

    Select the country of birth.

    Place of birth

    Enter the place of birth.

    Language

    Addresses

    There are two types of address formats: unstructured and structured.

    • The unstructured address is a non-standardised and less detailed representation of the address.

    • The structured address is a more detailed representation of the address following the ISO 20022 standard guidelines.

    These parameter lists apply to both private and legal persons. Mandatory fields are marked with a red asterisk (*).

    hashtag
    Unstructured address

    Field name
    Description

    See the Unstructured address format below:

    hashtag
    Structured address

    Field name
    Description

    See the Structured address format below:

    Balance currencies
    Class codes
    Interest
    Fees
    Account numbering

    Primary;

  • Secondary;

  • Vocational school.

  • Divorced;

  • Married;

  • Single;

  • Widowed.

  • General governments;
  • Households;

  • Non-financial corporations;

  • Other financial corporations.

  • Create lookup codes
    Create lookup codes

    Enter the main part of the address.

    Address line 2

    Enter any additional address details.

    Postal code

    Enter the postal code.

    Move in date

    Select the date the person moved into the address.

    Format: DD.MM.YYYY

    Specify the floor number or level within the building.

    Apartment number

    Enter the apartment number, if applicable.

    Post box

    Enter the post office box number, if mail is received via a P.O. box.

    City / County *

    Enter the city or county of the address.

    District

    Enter the district or administrative area within the city or region.

    Town location name

    Enter a specific locality or neighbourhood within the town or city.

    Postal code

    Enter the postal code.

    Country *

    Select the country of the address.

    Department

    Enter the relevant department within the organisation, if applicable.

    Sub-department

    Enter the relevant sub-department, if applicable.

    Move in date

    Select the date the person moved into the address.

    Format: DD.MM.YYYY

    Address format

    Toggle between structured and unstructured address formats.

    Address type *

    The address type can be defined on the PERSON.ADDRESS lookup page by selecting PERSON_ADDRESS_TYPE or PERSON_LEGAL_ADDRESS_TYPE as the Lookup type. For more information, see Create lookup codes.

    • For a private person, the default address type is Residency address.

    • For a legal person, the default address type is Registration address.

    Additional addresses can be added by clicking Add .

    Country *

    Select the country of the address.

    State / Region

    Enter the state or region of the address.

    City / County *

    Enter the city or county of the address.

    Address format

    Toggle between structured and unstructured address formats.

    Address type *

    The address type can be defined on the PERSON.ADDRESS lookup page by selecting PERSON_ADDRESS_TYPE or PERSON_LEGAL_ADDRESS_TYPE as the Lookup type. For more information, see Create lookup codes.

    • For a private person, the default address type is Residency address.

    • For a legal person, the default address type is Registration address.

    Additional addresses can be added by clicking Add .

    Street name *

    Enter the name of the street.

    Building number *

    Enter the number of the building.

    Building name

    Enter the name of the building, if applicable.

    Address line 1 *

    Floor

    Account application parameters

    hashtag
    General info

    Parameter name
    Type
    Description

    Account type setup

    /service provider code

    /account type*

    List

    hashtag
    Account numbers

    Parameter name
    Type
    Description

    hashtag
    Account owner limits

    Parameter name
    Type
    Description
    circle-info

    The same parameters apply to setting account limits for representatives.

    hashtag
    Representative data

    Parameter name
    Type
    Description

    Account product parameters

    The following parameters are used when creating an account product. Mandatory fields are marked with a red asterisk (*).

    hashtag
    Details

    Field name
    Description

    List

    Select the financial institution id type:

    • BIC - a unique eight- or eleven-digit alphanumeric code identifying a specific bank or branch worldwide.

    • SORT_CODE - a unique six-digit numerical code identifying a specific bank or branch in the United Kingdom and Ireland.

    Country*

    List

    Select the account country from the list.

    Currency code*

    List

    Select the account currency from the list.

    Select your account setup type:

    • STANDARD/TUUM/CURRENCY,

    • EXTERNAL_VIRTUAL/LHV/CURRENCY,

    • EXTERNAL_VIRTUAL/BC/CURRENCY,

    • EXTERNAL_VIRTUAL/TUUM/CURRENCY,

    • EXTERNAL_VIRTUAL/CC/CURRENCY.

    Note: you will only see the options that are relevant to your setup.

    Jurisdiction country*

    List

    Select the account jurisdiction country.

    Account class

    List

    Select the account class.

    Account name

    Text

    Enter the client account name.

    Default currency*

    List

    Select the default currency from the list.

    Customer group*

    List

    Select a customer segmentation group. Available values consist of customer groups you have created with Tuum.

    Price list type*

    List

    Select an account price list type within the chosen customer group. Available values consist of price list types you have created with Tuum.

    Account holder name*

    Text

    Enter the actual name of the account holder.

    Residency country*

    List

    Select the residency country code.

    Tax residency country*

    List

    Select the tax residency country.

    Account number type*

    List

    Select from the available options:

    • IBAN - International Bank Account Number contains the account number, bank and branch information and country code.

    • BBAN - Basic Bank Account Number. It represents a country-specific bank account number.

    Account number*

    Number

    Enter the account number.

    Financial institution id*

    Text

    Enter the identification number of the financial institution.

    Add limit type*

    List

    Select the account limit type:

    • Daily,

    • Monthly.

    Currency code*

    List

    Select currency from the list.

    Amount*

    Number

    Enter the limit amount.

    SSN*

    List

    Select representative from the list.

    Account right code*

    List

    Select the account right code from the list:

    • All rights,

    • View rights,

    • Change rights.

    Financial institution id type*

    Jurisdiction country *

    Jurisdiction country where the bank operates and the product is valid.

    Banking mode *

    Banking mode under which this product operates.

    Available options are:

    • Conventional

    • Islamic

    Product code *

    Unique product code written with capital letters and underscores.

    Example: MY_FIRST_ACC_PRODUCT

    Product name *

    Product commercial name.

    Product description *

    Product internal description.

    Reporting product code *

    Reporting product code to which this product is linked. The reporting product code represents the category of a product or service used for management reporting purposes through the whole platform.

    Validity range from

    The start date from which the product becomes available for use in new account creation or product changes.

    Validity range to

    The end date after which the product is no longer available for selection. Once this date is reached, the product is deactivated; however, existing accounts using the product remain valid.

    hashtag
    Account type setup

    Field name
    Description

    Account type *

    Specifies the account type for which this product is valid.

    Account holder type *

    Specifies the type of account holder for which this product is valid.

    Allow contractual overdraft

    Indicates whether contractual overdrafts are allowed for accounts created under this product.

    Note: This field is displayed only when the account type is set to CURRENCY.

    Allow joint accounts

    Indicates whether multiple owners are allowed for accounts created under this product.

    Note: This field is displayed only when the account holder type is set to Private and account type is set to CURRENCY.

    Account type setup

    Defines the configuration specific to the account type for this product. If left empty, no account type–specific restrictions apply.

    Service provider

    Defines the account service provider code for this product. If left empty, no service provider–specific restrictions apply.

    hashtag
    Residency

    Field name
    Description

    Residency country codes

    List of allowed residency country codes for accounts created under this product. If left empty, all ISO country codes are permitted.

    Tax residency country codes

    List of allowed tax residency country codes for accounts created under this product. If left empty, all ISO country codes are permitted.

    hashtag
    Balance currencies

    Field name
    Description

    Allowed currencies

    List of currencies in which balances are allowed for accounts created under this product. If left empty, all currencies supported by the Account module are permitted.

    Note: Attempting to create a balance in a currency not on this list will result in an error.

    Default currency code

    Specifies the default currency code used when opening an account under this product via the UI. If provided, it must be included in the Allowed currencies list. If Allowed currencies is empty, the value must be one of the currencies supported by the Account module.

    Note: This field is not used for validation or defaulting during account creation.

    Auto-create allowed currency balances

    Indicates whether balances in all allowed currencies should be automatically created when a new account is opened under this product. If enabled, the system will initialise one balance per allowed currency at the time of account creation.

    hashtag
    Class codes

    Field name
    Description

    Allow all class codes

    Indicates whether all account type–related class codes are allowed for accounts created under this product. If enabled, both Class codes and Default class code must be left empty.

    Class codes

    Class codes allow deposits, overdrafts, fees, and other items to be mapped to GL accounts more specifically than the account type alone. This is the list of class codes allowed for accounts created under this product.

    If left empty:

    • When Allow all class codes is set to No, no class codes are allowed.

    • When Allow all class codes is set to Yes

    Default class code

    Specifies the default class code used when opening an account under this product via the UI. If provided, it must be included in the Class codes list.

    Note: This field is displayed only when the Allow all class codes toggle is set to No. This value is not used for validation or defaulting during account creation.

    Link to class codes

    The link provides access to the full list of Account class code rules and allows new class codes to be added if needed. To learn more, see .

    hashtag
    Interest

    circle-exclamation

    This section is visible when the banking mode is selected as CONVENTIONAL.

    Field name
    Description

    Allow all interest method assignment codes

    Indicates whether all interest method assignment codes valid for the given organisational unit, account type, person type, and currency are allowed for accounts created under this product. If enabled, both Allowed interest method assignment codes and Default interest method assignment code must be left empty.

    Allowed interest method assignment codes

    The list of interest method assignment codes allowed for accounts created under this product.

    • If left empty and Allow all interest method assignment codes is disabled, no interest will be calculated.

    • If left empty and Allow all interest method assignment codes is enabled, all applicable interest method assignment codes from the relevant account type interest methods will be allowed.

    Note: This field is displayed only when the Allow all interest method assignment codes

    Default interest method assignment code

    The default interest method assignment code used when opening an account under this product via the UI. If specified, it must also appear in the Allowed interest method assignment codes list.

    Note: This field is displayed only when the Allow all interest method assignment codes toggle is set to No. This field is not used for validation or defaulting during account creation.

    Link to interest methods

    The link provides access to the Account type interest methods and allows new interest methods to be added if needed. To learn more, see .

    hashtag
    Fees

    Field name
    Description

    Allowed price list customer groups

    The list of allowed price list customer group codes for accounts created under this product. If not specified, all customer group codes defined on the ACCOUNT.PRICELIST lookup page, with CUSTOMER_GROUP selected as the lookup type, are allowed.

    Default price list customer group

    The default price list customer group code used when opening an account under this product via the UI. If specified, it must be included in the Allowed price list customer groups list.

    Note: This field is not used for validation or defaulting during account creation.

    Default price list type code

    The default price list code used when opening an account under this product via the UI. It can be specified only if a Default price list customer group is provided, and must belong to one of the price lists under that group.

    Note: This field is not used for validation or defaulting during account creation.

    Link to customer groups

    The link provides access to the full list of Account price list lookup codes and allows new lookup codes to be added if needed. To learn more, see .

    Link to price list

    The link provides access to the full list of Fee price lists and allows new price lists to be added if needed. To learn more, see .

    hashtag
    Account numbering

    Field name
    Description

    BIC key

    Specifies the BIC to be assigned to accounts created under this product.

    Note: This field is optional and may be left empty.

    Numbering sequence key

    Specifies the numbering sequence to be used for accounts created under this product.

    Note: This field is optional and may be left empty.

    Link to BIC allocation rules

    The link provides access to the full list of BIC allocation rules and allows new rules to be added if needed.

    Link to numbering sequences

    The link provides access to the full list of Numbering sequences and allows new numbering sequences to be added if needed.

    hashtag
    Finance configuration

    Field name
    Description

    Link to GL accounts configuration

    The link provides access to the GL accounts setup for account component rules and allows new rules to be added if needed.

    Organisational unit *

    Organisational unit under which this product is defined.

    ABA_CODE - an ABA routing transit number (ABA RTN) is a unique nine-digit code identifying a financial institution within the United States.

  • BANK_CODE - a unique domestic numerical identifier for a specific bank, branch, or financial institution in most countries, excluding the United States, United Kingdom, and Ireland.

  • Note: The account number type IBAN allows you to select BIC, and the account number type BBAN allows you to select SORT_CODE, ABA_CODE or BANK_CODE.

    , all class codes are allowed.

    Note: This field is displayed only when the Allow all class codes toggle is set to No.

    toggle is set to
    No
    .
    Account class codes
    Account interest
    Account group lookup codes
    Account price list