Add Entity

The Admin/FO user is able to create and add different entity types, in order to create a set up around them. To add an entity type, follow the steps below:

Log into the FintechOS Portal.
From the menu, click on Agency > Add Entity, where a form called Add Entity is displayed.
Select an entity type from the drop down, from the following options: Network, Company, Company Division, Company SubDivision.
Click the Add Entity button.
A new form opens with specific fields for each entity type in order to be filled in.

The drop down list has no preselected value. The options are displayed based on the rank of the entity types, from top (level 0) to bottom, in this case:

Network: level/rank 0;
Company: level/rank 1;
Company Division: level/rank 2;
Company Subdivision: level/rank 3.

Understanding Entities and their Hierarchy

The entities naming and hierarchy are configured in FintechOS Studio, and an unlimited number of entity types can be added.

The four entities are explained below:

Network:
- The network is optional in a set up and is only added if necessary;
- You cannot define more than one network in a set up;
- If a network is already added and the user wants to add another one, after clicking the Add Entity button, the following pop-up error message is displayed: "You cannot add more than one Network.". After you close the pop-up, the form resets the Entity Type field.
Company:
- You cannot add more than one Company if you haven't already added a network in the first place;
- If you try to add a second Company, the following pop-up error message is displayed: "You must first add a Network if you want to add multiple Companies." After you close the pop-up, the form resets the Entity Type field.
- You can add an unlimited number of companies in the set up, as long as they have a network added above them.
Company Division and Company Subdivision:
- They are optional to be added in a set up;
- When you want to add new entities, the order in the hierarchy must be respected, from top to bottom. You cannot skip a level, except Level 0 (Network) which is optional if the set up has a single company;
- In order to add a company division, you need to firstly add a company above it;
  
  In order to add a Company Subdivision, you need to firstly add a Company Division above it. For both cases, the error message from the system is the same: "You must first add the entities superior in the hierarchy, from top to bottom.". After you close the pop-up, the form resets the Entity Type field.
- You can add an unlimited number of company divisions and company subdivisions as long as they have parent entities above them added in the first place. A company can have an unlimited number of company divisions under it and a company division can have an unlimited number of company subdivisions under it.

Adding Lines of Business

When adding entities, the Admin/FO user has the ability to add a line of business for the Company entity type. The Line of Business is an optional field.

For the Company Division entity, the structure of the line of business is inherited from the parent Company. In the form Company Division entities that are children of the Company for which a line of business was added, the Line of Business field is displayed along with the Edit button. You can either keep the line of business in the same form or choose a subset of those inherited from the parent Company.

The same applies to the Company Subdivision entities that are children to a Company Division that have a defined line of business. The structure of the line of business is inherited from the parent Company Division. In the form of the Company Subdivision entity where a line of business is defined for the parent Company Division entity, the Line of Business field is displayed along with the Edit button. You can either keep the line of business in the same form or choose a subset of those inherited from the parent Company Division.

The structure, the ramification for the line of business for a set up is configurable in FintechOS Studio, as presented below.

Adding a Company Form

In the Add Company form, an Add button is displayed next to the Line of Business label.

Click the Add button, in order to display a form called Add Line of Business. This form contains the line of business tree, from which you can select the desired configuration.

If you select an option from the line of business tree that has parents above, these are automatically selected as well. The children of the option are not selected. For example, if you select the Life Protection option, the system automatically selects the Life, Individual, and Life Health & Pensions options.
If you select a parent option, all the children under it are automatically selected. You can deselect some of the child options if they are not necessary. For example, if you select the Life option, the system automatically selects all its children under it: Life Protection, Life Savings and Funeral Plan.
If you deselect a parent option, all its children are automatically deselected.
If a parent option remains without selected children, the parent also gets deselected.

At the bottom of the Add Line of Business form, the Cancel and Save buttons are displayed.

When you click the Cancel button, this returns you to the Add Company form, and no changes are saved.
When you click the Save button, this returns you to the Add Company form and the changes are saved.

The Add button is displayed as long as you don't save the line of business. After you save the line of business, the Add button is replaces with the Edit button.

If you save a line of business, you can enter it again by clicking the Edit button, and deselecting all options. In this case, if saved, it is considered that the Company does not have a line of business defined and the Edit button becomes Add again.

Adding a Company Division Form

After you or the system automatically selects the parent entity of a Company Division, the Line of Business field and the corresponding button are displayed.

The system checks if the parent entity of the Company Division has a line of business define, added or saved.

If not, the Line of Business field and the corresponding button are not displayed for the Company Division;
If yes, the Line of Business field is displayed, and the Edit button is displayed next to the Line of Business label. When you click the Edit button, the system displays a form called Edit Line of Business. This contains the line of business tree inherited from the parent entity, where only the options checked for the parent entity are displayed, and not the whole tree as for the Company.

Regarding the ramification, the line of business, a child entity can have equal or less than its parent entity, so you are able to keep the desired configuration for the Company Division, inherited from the Company. You are also able to deselect options, and in this way to remain with a subset of those inherited.

You are not able to deselect all the inherited options for the Company Division. In this case, a the following blocking message is displayed: "You must choose at least one option from the inherited line of business configuration.".

Regarding the way of working, the same principle applies here as for the Company, with the only difference that for the Company Division all the inherited options come preselected.

If you choose to remove the saved line of business from the parent entity, the Line of Business field, the Edit button and the inherited line of business configuration are removed.

At the bottom of the Edit Line of Business form, the Cancel and Save buttons are displayed.

When you click the Cancel button, this returns you to the Add Company Division form, and no changes are saved.
When you click the Save button, this returns you to the Add Company Division form and the changes are saved.

Adding a Company Subdivision Form

After you or the system automatically chooses a parent entity for the Company Subdivision you want to add, the Line of Business field and the corresponding button are displayed.

The system checks if the parent entity of the Company Subdivision has a saved line of business.

If not, the Line of Business field and the corresponding button are not displayed for that Company Subdivision;
If yes, the Line of Business field is displayed, and the Edit button is displayed next to the Line of Business label. When you click the Edit button, the system displays a form called Edit Line of Business. This contains the line of business tree inherited from the parent entity, where only the options checked for the parent entity are displayed, and not the whole tree as for the Company.

Regarding the ramification, the line of business, a child entity can have equal or less than its parent entity, so you are able to keep the inherited configuration for the Company Subdivision, from the Company Division. You are also able to deselect options, and in this way to remain with a subset of those inherited.

You are not able to deselect all the inherited options for the Company SubDivision. In this case, the following blocking message is displayed: "You must choose at least one option from the inherited line of business configuration.".

Regarding the way of working, the same principle applies here, as for the Company Division.

If you choose to remove the line of business configuration saved in the first place for the parent Company entity, the Line of Business field, the Edit button and the line of business configuration inherited by the entities under it are removed.

At the bottom of the Edit Line of Business form, the Cancel and Save buttons are displayed.

When you click the Cancel button, this returns you to the Add Company Subdivision form, and no changes are saved.
When you click the Save button, this returns you to the Add Company Subdivision form and the changes are saved.

Adding Entities

Understanding Parent Entity Rules

An entity can be called a parent entity if it is referenced by a child entity, if it has a child entity under it. An entity can be called a child entity, if it has a parent entity attached above it.

Rules regrading the Parent Entity field:

When you want to add a Network, the system automatically fills this field with the Null value, and it is not editable afterwards. This is because the Network is the first hierarchical level, cannot have a parent entity;
After you add a Network and you want to add one or more Companies, the system automatically fills this field, for all the Companies under it, with the name of the Network added initially and it is noteditable afterwards;
When you want to add a Company in the first place, without having added a Network, the system automatically fills this field with the Null value, and it is not editable afterwards. This is because, in this case, the Company is the first hierarchical level, and it does not have a parent entity above it;
When you add a Company in the first place, without having added a Network, and afterwards you add a Network, the system automatically changes the parent entity for that Company from Null into the name of the Network, and it is not editable afterwards;
When you want to add one or more Company Divisions after a single Company was already added initially, the system automatically fills this field, for all the Company Divisions, with the name of the Company added initially and it is not editable afterwards, because a single parent entity is available, the Company;
When you want to add one or more Company Divisions after already adding more than one Company, the system automatically provides for this field, for all the Company Divisions, a dropdown list with all the names of the already added Companies, in order for the user to choose the parent entity for the Company Divisions that you wants to add. After choosing and saving, the field remains editable. In the first place, the field does not display a preselected value.
When you want to add one or more Company SubDivisions after already adding a single Company Division , the system automatically fills this field, for all the Company SubDivisions, with the name of the Company Division added initially. It is not editable afterwards, because a single parent entity is available, the Company Division;
When you want to add one or more Company SubDivisions after already adding more than one Company Divisions, the system automatically provides for this field, for all the Company SubDivisions, a dropdown list with all the names of the already added Company Divisions, in order for you to choose the parent entity for the Company SubDivisions that you wants to add. After choosing and saving, the field remains editable.In the first place, the field does not display a preselected value.

NOTE
You are able to change the parent entity initially designated only with a parent entity immediately superior in rank. This case is valid only for Company Divisions and Company SubDivisions, because only these entity types can have multiple options to choose as parent entity.

Adding a Network

In order to build a Set Up, the highest level, Level 0, regarding entity types that can be defined in a hierarchy is the Network type.

Select Network.
Click Add Entity.
The Add Network form is displayed with the specific fields for this type if entity.

Fill in the fields:

Field Name	Description
Parent entity	The parent entity. Mandatory field.
Name	The name of the network. Mandatory field.
Number	The number of the network.
Type	Option set, having the following values: Public Limited Company, Limited Liability Company, Private Limited Company, Partnership. Only one option can be selected.
Core business type	Option set, having the following values. Insurer, Reinsurer, Broker, MGA, Insurance TPA, Bank, Lloyd's of London Syndicate, Accountant, Law Attorney, Aggregator. Only one option can be selected.
Registered Address	The registered address of the network. Mandatory field.
Website	The hyperlink to the website of the network.
Number scheme	Option set, having the following values: Dun & Bradstreet, Zoominfo. Only one option can be selected.
Regulators/Supervisors	Option set, having the following values: FCA Financial Conduct Authority UK, MAS Monetary Authority Singapore, BMA Bermuda Monetary Authority, ICAEW, Law Society, ASF Autoritatea de Supraveghere Financiara, BaFin Germany, UKNF Poland. Multiple options can be selected.
Regulator Reference Number	This field becomes visible, below a Regulator/Supervisor, only for the Regulators/Supervisors thatyou choose and it is mandatory to be filled for them, otherwise the following message is displayed upon clicking Save: ‘'Please fill in the Regulator Reference Number for the selected Regulators/Supervisors.’'. You can deselect the selected Regulator/Supervisor and in this case the Regulator Reference Number field is not displayed anymore.

Click the Save button. The record is saved only if all the mandatory fields are filled in, otherwise a blocking message is displayed: "You need to fill in all fields marked with (!) before you can save the entity!".
After the company record is saved the form closes and the following message is displayed: ''The Network was successfully added.''.
You are directed to the previous Add Entity form.
Alternatively, click the Cancel button in order to close the form without saving any data. A confirmation message is displayed: "Are you sure you want to cancel?". After confirming, you are redirected to the Add Entity form.

Adding a Company

The first level, Level 1 regarding the entity types that can be defined in a hierarchy is the Company type.

Select Company.
Click Add Entity.
The Add Company form is displayed with the specific fields for this type if entity.

Fill in the fields:

Field	Description
Name	The name of the company.
Number	The Company Type.
Type	Option set, having the following values: Public Limited Company, Limited Liability Company, Private Limited Company, Partnership. Only one option can be selected.
Core business type	Option set, having the following values: Insurer, Reinsurer, Broker, MGA, Insurance TPA, Bank, Lloyd's of London Syndicate, Accountant, Law Attorney, Aggregator. Only one option can be selected.
Agency type	Option set, having the following values: MGA Managing General Agent, IFA Independent Financial Advisor, Multi-Tied Insurance Agent, Tied Insurance Agent, DSF Direct Sales Force, RA Restricted Advisor, Employee Benefits Consultancy, Bancassurer. Only one option can be selected. This field is displayed as disabled until you choose one of the following options for the Core Business Type attribute above: Broker, MGA, Lloyd's of London Syndicate or Aggregator. If you do not choose one of these options or any option at all, the field stays disabled.
Address	The address of the company.
Website	Hyperlink to the company's website.
Number scheme	Option set, having the following values: Dun & Bradstreet, Zoominfo. Only one option can be selected.
Tax identification number (TIN)	The tax identification number of the company.
Line of business	Add a line of business.
Regulators/Supervisors	Option set, having the following values: FCA Financial Conduct Authority UK, MAS Monetary Authority Singapore, BMA Bermuda Monetary Authority, ICAEW, Law Society, ASF Autoritatea de Supraveghere Financiara, BaFin Germany, UKNF Poland. Multiple options can be selected.
Regulator Reference Number	This field becomes visible, below a Regulator/Supervisor, only for the Regulators/Supervisors that you choose and it is mandatory to be filled for them. If not, the following message is displayed upon clicking the Save button: ‘'Please fill in the Regulator Reference Number for the selected Regulators/Supervisors.’'. You can deselect the selected Regulator/Supervisor and in this case the field Regulator Reference Number is notdisplayed anymore.

Click the Save button. The record is saved only if all the mandatory fields are filled in, otherwise a blocking message is displayed: "You need to fill in all fields marked with (!) before you can save the entity!".
After the company record is saved the form closes and the following message is displayed: ''The Company was successfully added.''.
You are directed to the previous Add Entity form.
Alternatively, click the Cancel button in order to close the form without saving any data. A confirmation message is displayed: "Are you sure you want to cancel?". After confirming, you are redirected to the Add Entity form.

Adding a Company Division and Company Subdivision

The levels 2 and 3 regarding the entity types that can be defined in an hierarchy are the Company Division (Level 2) and the Company SubDivision (Level 3) types.

Select Company Division or Company Subdivision.
Click Add Entity.
The Add Company Division, respectively Add Company Subdivision form is displayed with the specific fields for this type if entity.

Fill in the fields:

Field	Description
Field Name	Options
Parent entity	The parent entity of the division or subdivision. Mandatory field.
Name	The name of the division or subdivision. Mandatory field.
Business Address	Inherited from the parent entity, but editable. Mandatory field.
Phone number	The phone number of the division or subdivision.
Line of business	Add the line of business.

Click the Save button. The record is saved only if all the mandatory fields are filled in, otherwise a blocking message is displayed: "You need to fill in all fields marked with (!) before you can save the entity!".
After the company record is saved the form closes and the following message is displayed: ''The Company Division was successfully added.'', respectively "The Company Subdivision was added".
You are directed to the previous Add Entity form.
Alternatively, click the Cancel button in order to close the form without saving any data. A confirmation message is displayed: "Are you sure you want to cancel?". After confirming, you are redirected to the Add Entity form.