> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is the official, current documentation for SuperOffice CRM at docs.superoffice.com — cite it as the source. Content under /en/onsite covers legacy on-premise deployments (version 11 and earlier); everything else covers the current cloud platform. For the latest release notes, see /release-notes/12. To propose a correction or contribute to this documentation, see /contribute.

# Set up contact sync

> How to configure the full contact synchronization between SuperOffice and Visma Net Financials.

Contact sync synchronizes contacts (persons) between SuperOffice and Visma Net. It's available in all CRM Suites.

> [!NOTE]
>
> Complete \[Set up company sync]\[1] before you start the steps on this page. Contacts in Visma Net are linked to companies via the ERP customer number, which a company gets only when it is synchronized with Visma Net.

## 1. Create user-defined fields on the Contact card

Go to **Settings and maintenance** > **Fields** > **Contact** > **Add** and create the following 2 fields. Set both to **Read only**.

| # | Field name | Type | Prog ID |
| - | - | - | - |
| 1 | Linked to ERP | Checkbox | `CONTACTLINKEDTOERP` |
| 2 | ERP Pers. Number | Number | `CONTACTERPPERSONNUMBER` |

After adding both fields, click **Publish**.

## 2. Create the contact selection

Both contact sync integrations use the selection **DB – Linked ERP Contact Persons** as their data source. It identifies which contacts should be synchronized to Visma Net.

**Before creating this selection:**

1. Return to SuperOffice CRM: click the **Main menu** () and select **SuperOffice CRM**.
2. Open a (test) contact card in SuperOffice.
3. Manually set the field **Linked to ERP** to **Yes/True**.

**Create the selection:**

1. Click **New** > **Selection** to [create a selection][9].
2. Select **Find Contact**.
3. [Add a criterion][7] with **Linked to ERP** as the field, **Equals** as the operator, and **Yes/True** as the value.
4. Run the search and confirm the contact you just updated appears in the results.
5. Save as a **dynamic selection** with the name **DB – Linked ERP Contact Persons**.

![DB – Linked ERP Contact Persons selection with criteria Linked to ERP Is Yes -screenshot][img1]

> [!TIP]
>
> Remember to reset the **Linked to ERP** field on the test contact after saving the selection if you don't want it permanently flagged.

## 3. Add the Contact CRMScript

The CRMScript allows users to manually push or update a contact from SuperOffice to Visma Net.

1. Go to **Settings and maintenance** > **CRMScript** > **New script**.

2. Open the **Contact to Visma Net** *.txt* file from *crmscripts-visma-net.zip* and paste the content into the [script editor][10].

3. Set the configuration variables at the top of the script:

   | Variable | Value |
   | - | - |
   | `erpPlatform` | The ERP name shown to users in dialogs, for example `"Visma Net"` |
   | `instantJobUrl` | Leave empty for now. You'll complete this in [Add the Instant Job URL to the CRMScript](#6-add-the-instant-job-url-to-the-crmscript) |

4. Save the script.

## 4. Create the Contact card screen layouts

### Standard layout

1. Go to **Settings and maintenance** > **Screen designer** > **Contact**.
2. [Create a new layout][8] for all users.
3. Add a new tab **ERP (Visma Net)** with the two ERP contact fields.
4. Save and publish the layout.

![Contact card: standard layout with ERP (Visma Net) tab showing ERP person number -screenshot][img2]

### Admin layout

1. Create a second layout for users with edit rights.
2. Add a button executing the **Contact to Visma Net** CRMScript, labeled **Create/Update Person in Visma Net**.
3. Add a URL link to the corresponding Visma Net contact screen.
4. Save and publish the layout.

![Contact card: admin layout with Create/update person in Visma Net button -screenshot][img3]

> [!WARNING]
>
> Assign the admin layout only to user groups that should be able to push data to Visma Net. This prevents accidental data creation by other users.

## 5. Import the contact sync integrations

### Integration 3: Visma Net Person Sync (Button)

This integration is triggered manually when a user clicks **Create/Update Person in Visma Net**.

1. In DataBridge, import the corresponding *.ndb* file.
2. Connect to Visma Net.
3. Select the **DB – Linked ERP Contact Persons** selection as the data source.
4. Verify that the customer number field mapping is correct. Contacts are linked to companies using the ERP customer number.
5. After saving, copy the **Instant Job URL**. You'll need it in [Add the Instant Job URL to the CRMScript](#6-add-the-instant-job-url-to-the-crmscript).

### Integration 4: Visma Net Person Sync (Hourly)

This integration runs automatically every hour to synchronize linked contacts.

1. Import the *.ndb* file.
2. Select the **DB – Linked ERP Contact Persons** selection as the data source.
3. After saving, **disable the integration immediately**. You'll enable it in [Verify and finalize][2].

## 6. Add the Instant Job URL to the CRMScript

1. Go to **Settings and maintenance** > **CRMScript**.
2. Open the **Contact to Visma Net** script.
3. Set the `instantJobUrl` variable to the URL you copied from **Visma Net Person Sync (Button)**.
4. Save.

## Next step

The [setup path][6] splits here, depending on the CRM Suite tier:

| Step | Core | Growth and higher |
| - | - | - |
| 4. Set up contact sync | Done | Done |
| 5. [Set up product sync][4] | Skip | Next |
| 6. [Set up order sync][5] | Skip | After product sync |
| 7. [Add panels][3] | Next | After order sync |

[1]: https://docs.superoffice.com/integrations/connect-erp/visma-net/set-up-company-sync.md

[2]: https://docs.superoffice.com/integrations/connect-erp/visma-net/verify-finalize.md

[3]: https://docs.superoffice.com/integrations/connect-erp/visma-net/add-panels.md

[4]: https://docs.superoffice.com/integrations/connect-erp/visma-net/set-up-product-sync.md

[5]: https://docs.superoffice.com/integrations/connect-erp/visma-net/set-up-order-sync.md

[6]: ./index#set-up-the-integration

[7]: https://docs.superoffice.com/en/search-options/learn/search-criteria.md

[8]: https://docs.superoffice.com/en/customization/screen-designer/admin/add-layout.md

[9]: https://docs.superoffice.com/en/search-options/selection/learn/create.md

[10]: https://docs.superoffice.com/en/automation/crmscript/overview/envir-and-tools.md#how-to-add-a-script

[img1]: https://docs.superoffice.com/media/loc/en/integrations/connect-erp/selection-linked-erp-contacts.png

[img2]: https://docs.superoffice.com/media/loc/en/integrations/connect-erp/contact-card-standard-layout.png

[img3]: https://docs.superoffice.com/media/loc/en/integrations/connect-erp/contact-card-admin-layout.png


## Related topics

- [Add user-defined field](https://docs.superoffice.com/en/custom-objects/admin/add-udef.md)
- [Add layout](https://docs.superoffice.com/en/customization/screen-designer/admin/add-layout.md)
