# Organization and contract configuration

**URL:** <https://community.novulo.com/t/organization-and-contract-configuration/791>\
**Category:** Insurance\
**Tags:** implementation, insurance, functional-config\
**Created:** [August 13, 2025, 10:05am UTC](https://community.novulo.com/t/organization-and-contract-configuration/791 "2025-08-13T10:05:54Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Jurg](https://yyz2.discourse-cdn.com/flex008/user_avatar/community.novulo.com/jurg/32/1670_2.png) [@Jurg](https://community.novulo.com/u/Jurg)\
**Post date:** [August 13, 2025, 10:05am UTC](https://community.novulo.com/t/organization-and-contract-configuration/791/1 "2025-08-13T10:05:54Z")

</div>

> This work instruction is part of the guide [Setting up your insurance solution](https://community.novulo.com/t/setting-up-your-insurance-solution/582).

# Insurance market

In the insurance market, different parties can be involved in the flow of premium payments and commissions. Although a customer may experience the process as straightforward, the underlying financial routes can vary significantly depending on the agreements between Insurance Company, Managing General Agent/Proxy, Insurance Agent and/or Broker.

For example, a customer may arrange their insurance through an proxy, yet the actual premium is still collected directly by the insurer. In other cases, the insurance agent collects the premium themselves and settles it with the insurer, who then compensates the intermediary through commissions.

In short:

- The **Insurance Company** (Verzekeraar) is the risk carrier. They are the entity that underwrite and bear the financial risk of the insurance policies. They design products, manage reserves, and ensure regulatory compliance.
- An **Managing General Agent** (MGA) or **Proxy** (Volmachtbedrijf) can act as a delegated authority between an insurer and agent or client. The insurer grants a mandate (volmacht) to a MGA to underwrite price, issue policies and handle claims on behalf of the insurer.
- An **Insurance Agent** (Tussenpersoon) are customer-facing intermediaries who advise, sell and service insurance products, typically representing one or more MGA’s or insurance companies.
- A **Broker** (makelaarskantoor) is typically a specialist intermediary working on complex or corporate risks, often not bound to a single insurance company. They represent a client, not the insurer. They negotiate bespoke policies and terms across multiple insurers, sometimes internationally.

Across the market, these variations lead to five commonly occurring money-flow patterns. Each pattern determines **who collects money** , **who receives it first** , and **how commission and remuneration move between parties**. Understanding these flows is crucial for configuring your processes in Novulo correctly.

Let’s outline five common variants so you can recognise and configure accordingly. Note that other variants are possible and in practice.

digraph { rankdir=LR; graph [splines=polyline, fontname="Arial"]; node [shape=box, margin=0.25, style=filled, fontname="Arial", fontsize="20", peripheries="0"]; edge [fontname="Arial", color="#555555"]; subgraph cluster\_s5 { style=filled; fillcolor="#f3f3f3" peripheries=0; s5\_v [label="Client", fillcolor="#92bfb1"]; s5\_t [label="Agent", fillcolor="#8d80ad"]; s5\_m [label="MGA", fillcolor="#e3655b"]; s5\_i [label="Insurer", fillcolor="#f8b23a"]; s5\_v -\> s5\_t [label="Premium", penwidth=3]; s5\_t -\> s5\_m [label="Premium settlement", penwidth=3]; s5\_m -\> s5\_i [label="Premium settlement", penwidth=3]; s5\_i -\> s5\_m [label="MGA remuneration", penwidth=1]; s5\_i -\> s5\_m [label="Commission (for intermediary)", penwidth=1]; s5\_m -\> s5\_t [label="Commission", penwidth=1]; } subgraph cluster\_s4 { style=filled; fillcolor="#f3f3f3" peripheries=0; s4\_v [label="Client", fillcolor="#92bfb1"]; s4\_m [label="MGA", fillcolor="#e3655b"]; s4\_i [label="Insurer", fillcolor="#f8b23a"]; s4\_t [label="Agent", fillcolor="#8d80ad"]; s4\_v -\> s4\_m [label="Premium", penwidth=3]; s4\_m -\> s4\_i [label="Premium settlement", penwidth=3]; s4\_i -\> s4\_m [label="MGA remuneration", penwidth=1]; s4\_i -\> s4\_m [label="Commission (for intermediary)", penwidth=1]; s4\_m -\> s4\_t [label="Commission", penwidth=1]; } subgraph cluster\_s3 { style=filled; fillcolor="#f3f3f3" peripheries=0; s3\_v [label="Client", fillcolor="#92bfb1"]; s3\_t [label="Agent", fillcolor="#8d80ad"]; s3\_i [label="Insurer", fillcolor="#f8b23a"]; s3\_v -\> s3\_t [label="Premium", penwidth=3]; s3\_t -\> s3\_i [label="Premium settlement", penwidth=3]; s3\_i -\> s3\_t [label="Commission", penwidth=1]; } subgraph cluster\_s2 { style=filled; fillcolor="#f3f3f3" peripheries=0; s2\_v [label="Client", fillcolor="#92bfb1"]; s2\_i [label="Insurer", fillcolor="#f8b23a"]; s2\_t [label="Agent", fillcolor="#8d80ad"]; s2\_v -\> s2\_i [label="Premium", penwidth=3]; s2\_i -\> s2\_t [label="Commission", penwidth=1]; } subgraph cluster\_s1 { style=filled; fillcolor="#f3f3f3" peripheries=0; s1\_v [label="Client", fillcolor="#92bfb1"]; s1\_i [label="Insurer", fillcolor="#f8b23a"]; s1\_v -\> s1\_i [label="Premium", penwidth=3]; } }

Now that you better understand the variant, let’s look into what is needed to come to a contract between two or more parties. You will need to configure your **organisation** , create the **commission product** , and set up a **contract**.

# Configure your organisation

In Novulo, we manage **contacts** , which can be either organizations or persons. Each installation of Novulo is **multi-tenant** , meaning you can configure multiple organizations that “own” the application. In Novulo, we refer to these as **My Organization**.

A properly installed new application comes with a pre-configured My Organization you can edit.

1. Click on ‘Contacts’ under Management.
2. Add the column ‘Is my organization’.
3. Here you will either see:
  - multiple entries (e.g., one for an insurer, one for an agent and one for a MGA/proxy) imported from a dataset
  - no organizations at all

## From a dataset

1. Open the contact you want to edit.
2. Fill in the **NAW (Name, Address, City)** details.
3. Under ‘More’ add ‘Management settings’ .
4. Make sure ‘My organization’ is checked under ‘Organization settings’.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/a/a1183f068875c62903f549164ca35a0aaece9d31.png)
5. Optionally, upload a **logo**.
6. Add a **bank account** for financial operations (a placeholder is included in the dataset). You can manage bank accounts under ‘More’ \> ‘Bank accounts’.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/c/cd58a38f0c0166fbfa78f648f5ddc95c6de31f34.png)
  - Provide a **Creditor ID** if you plan to process direct debits.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/e/e1552a95e036a7c0d3325f62246d8a5603ea789b.png)

7. Set up **industrial classifications** if relevant.

Configure multiple organizations to set up contracts.

> **Tip:** In a single-organization setup, remove unused ‘My Organizations’ to avoid clutter.

## Without a dataset

1. Click the plus icon to add an organization.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/optimized/2X/4/42a138eb308ed35da70a73358d34ca9ecba543c3_2_517x20.png)
2. Fill in the **NAW (Name, Address, City)** details.
3. Under ‘More’ add ‘Management settings’ .
4. Fill out the details and make to check ‘My organization’ under ‘Organization settings’.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/a/a1183f068875c62903f549164ca35a0aaece9d31.png)
5. Optionally, upload a **logo**.
6. Add a **bank account** for financial operations (a placeholder is included in the dataset).  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/c/cd58a38f0c0166fbfa78f648f5ddc95c6de31f34.png)
7. Provide a **Creditor ID** if you plan to process direct debits.
8. Set up **industrial classifications** if relevant.
9. Click save.

> **Tip:** \> Accurate financial details ensure smooth processing of invoices and direct debits.

## Register Employees

To ensure proper access control and auditing register the employees of ‘My organization’.

1. Go to ‘Employees’ under ‘HR’.
2. Click on ‘Add employee’.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/optimized/2X/d/d1173cd1148b9855452c80f8e4fcc2faa6f22e49_2_517x17.png)
3. Set **Is employer of** to the correct organization.
4. Select an existing person or click **Add new person**.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/a/aad635b2271936dd91242f99b4914ee357ac2b6e.png)
5. Fill in employee details (start date, end date, email, etc.).
6. Link the employee to a **Rights profile** to grant required permissions.

> **Why:** \> Linking employees ensures traceability and correct styling, permissions, and authorizations.

# Create the **“commission”** product

1. Go to **Products** and create a product with:
  - **Artikelnummer** : `PProv`
  - **Type** : Service
  - **Productgroep** : Fees
  - **Eenheid** : Policy
  - **Verkoopartikel** : No _(leave unchecked)_
  - **Fee type** : Renewal commission
  - **Belastingbepaling** : Insurance tax
  - **Boekingsschema** : Renewal commission  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/6/63f4f6cad587ef923604299746696d48f3090375.png)

> form more details on product setup, review [SUIV product](https://community.novulo.com/t/underwriting-agency-mga-product-configuration/585) and [Custom product](https://community.novulo.com/t/1-product-setup-custom-product-functional-configuration-insurance-solution/790) setup.

## Add a contract group

1. Under ‘Application management’ go to ‘Settings’.
2. Search for product ‘Contract groups’.
3. Click on the plus icon to add a new Contract product group.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/e/e0a68fdd041a1e1ab45f5f1965def651f985a295.png)
4. Set the description and click ‘Save’.
5. Link the products that you want to include.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/5/53c87eaebe19fce9052fd531aa39d78cfa89eb89.png)
6. Link the sales items that you want to include.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/f/fb7dbe2ecdb246b5e026e4ce80112a4207164bbe.png)
7. Under ‘More’ add the ‘Used in contract lines’ to verify the product group is used in the specified contract. When you are starting a new contract group this line should be empty.

> **Note:** Contract groups are used for contract, product groups are used in product and sales channels and product assortments are used for …

# Configure a contract between an agent, insurer, proxy and other relationship

When you have configured your **organisation** , created a **product** and added **relations** , it is time to set up a **contract**. To create a new contract:

1. Go to ‘Contracts’ under ‘Management’.
2. Select or add the contact you want configure.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/optimized/2X/2/203130afc6c40d629943e4029e3fe507e976666e_2_517x19.png)
3. Select the ‘Template’ Insurance.
4. Add a description, period and in available a contract document.
5. Click save.
6. Add at least two stakeholders that are involved in this contract.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/4/42382bfb148a45eb947e12e7c1f689a958454008.png)
7. Add ‘Contract lines’  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/2/20f45c2716b58b210cbe8407860d38506fbc245e.png)
8. Fill out all details needed. Make sure to:
  - Select the ‘Contract group’ with the products that are involved in this contract.
  - Define a fixed or calculated price under the ‘Compensation’ panel.
  - Define an invoice template.  
 ![image](https://canada1.discourse-cdn.com/flex008/uploads/novulo/original/2X/c/c0428add176c18ca16a10026be4d5df37d2d7d7c.png)

9. Under the tile ‘Products’ you will find an overview of the included products in this contract line.