> ## 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 company sync

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

Company sync synchronizes companies between SuperOffice and Visma Net. It's available in all CRM Suites.

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

Go to **Settings and maintenance** > **Fields** > **Company** > **Add** and create the following fields. Set all fields to **Read only**.

> [!NOTE]
>
> Use the exact **Prog IDs** as specified. DataBridge and the CRMScripts rely on these identifiers to read and write the correct fields.

| # | Field name | Type | Prog ID |
| - | - | - | - |
| 1 | Linked to ERP | Checkbox | `COMPANYLINKEDTOERP` |
| 2 | ERP Cust. Number | Number | `COMPANYERPCUSTOMERNUMBER` |
| 3 | Account Reference | Short text | `COMPANYACCOUNTREFERENCE` |
| 4 | Credit limit | Decimal | `COMPANYCREDITLIMIT` |
| 5 | Payment Terms | Short text | `COMPANYPAYMENTTERMS` |
| 6 | Last Sync Date | Date | `COMPANYLASTSYNCDATE` |
| 7 | Currency | Short text | `COMPANYCURRENCY` |
| 8 | Balance | Decimal | `COMPANYBALANCE` |
| 9 | Sales this period | Decimal | `COMPANYSALESPERIOD` |
| 10 | Sales this year | Decimal | `COMPANYSALESYEAR` |
| 11 | Unreleased Balance | Decimal | `COMPANYUNRELEASEDBALANCE` |

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

> [!TIP]
>
> Note the SuperOffice **template variables** generated for field #2 (ERP Cust. Number). You'll need that later.

## 2. Create the company selection

DataBridge uses this selection as its "field template" for the integrations.

1. Return to SuperOffice CRM: click the **Main menu** () and select **SuperOffice CRM**.
2. Click **New** > **Selection** to [create a selection][7].
3. Select **Find Company**.
4. [Add a criterion][5] with **Company name** as the field, **Is not** as the operator, and a single space character as the value.
5. Run the search and confirm that at least one result appears. An empty selection may cause DataBridge to fail when the integration runs.
6. Save as a **dynamic selection** with the name **DB – Template: Companies**.

![Find Company with criteria Company name Is not (space) -screenshot][img1]

## 3. Add the Company CRMScript

The CRMScript allows users to manually push a company from SuperOffice to Visma Net.

1. Download and unzip *crmscripts-visma-net.zip* from the [Downloads][1] section in Requirements.

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

3. Open the **Company to Visma Net** *.txt* file and paste the content into the [script editor][8].

4. 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) |

5. Save the script.

## 4. Create the Company card screen layouts

Create two screen layouts in SuperOffice: one for standard users (read-only ERP data) and one for admin users (with action button).

### Standard layout

1. Go to **Settings and maintenance** > **Screen designer** > **Company**.
2. [Create a new layout][6] for all users.
3. Add a new tab with the label **ERP (Visma Net)**.
4. Add a panel **Visma Net Key Figures** and add all 11 ERP user-defined fields.
5. Save and publish the layout.

![Company card: standard layout with ERP (Visma Net) tab and Key Figures panel -screenshot][img2]

### Admin layout

1. Create a second layout for users with edit rights.
2. Add a new tab **ERP (Visma Net)** with two columns.
3. In the first column, add a **button** executing the **Company to Visma Net** CRMScript, labeled **Create Company in Visma Net**.
4. In the second column, add a **URL link** to the corresponding Visma Net customer screen.
5. Add the ERP fields below the button area.
6. Save and publish the layout.

![Company card: admin layout with Visma Net Actions panel showing Create Company 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 company sync integrations

Download and unzip *databridge-integrations-visma-net.zip* from the [Downloads][1] section in Requirements.

> [!NOTE]
>
> Warnings can appear during import (yellow background). The warning that not all required fields are configured is expected, and you can continue the import. For any other warning, read the message and follow its instructions before you continue.

![Expected warning: not all required fields are configured, existing entities can still be updated -screenshot][img6]

### Integration 1: Visma Net Customer Sync (Button)

This integration is triggered manually when a user clicks **Create Company in Visma Net**.

1. In DataBridge, import the corresponding *.ndb* file.

2. Connect to Visma Net when prompted and authorize the connection.

   ![DataBridge authorization dialog: authorize access to Visma.net Financials -screenshot][img4]

3. In the **Source** tab, select the **DB – Template: Companies** selection as the data source.

4. In the **Data** tab, update the values in the transformations **Visma - Customer Class** and **Visma - Tax Zones**.

5. Check that the values in all other transformations match the SuperOffice and Visma Net setup.

6. If you created the **SuperOffice Number** attribute in [Set up Visma Net][4], check that the field mapping includes **EXTNUMBER**, so that the SuperOffice company number is written to the customer in Visma Net.

7. 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 2: Visma Net Customer Sync (Hourly)

This integration runs automatically every hour to pull updated customer data from Visma Net into SuperOffice.

1. Import the *.ndb* file.
2. Connect to Visma Net.
3. After saving, **disable the integration immediately** to prevent it from running before setup is complete. You'll enable it in [Verify and finalize][2].

![DataBridge integration: Disabled toggle -screenshot][img5]

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

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

## Next step

Continue with [Set up contact sync][3].

[1]: https://docs.superoffice.com/integrations/connect-erp/visma-net/requirements.md#downloads

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

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

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

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

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

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

[8]: 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-companies.png

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

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

[img4]: https://docs.superoffice.com/media/loc/en/integrations/connect-erp/databridge-authorize.png

[img5]: https://docs.superoffice.com/media/loc/en/integrations/connect-erp/databridge-disabled-toggle.png

[img6]: https://docs.superoffice.com/media/loc/en/integrations/connect-erp/databridge-import-warning.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)
