Integration /visma-net-erp/help/integration section The implementation of an ERP system is a complex process. 2026-02-19T17:09:06+01:00 # Integration The implementation of an ERP system is a complex process. The implementation of an ERP system is a complex process. During implementation, your organisation may migrate data from legacy apps to eliminate manual entry. Some companies continue to use legacy apps, even during or after implementation. Visma Net's distributed design allows assembling apps from various suppliers to match business needs. Specialised country-specific software, like VAT reporting and payroll, requires regular updates for compliance. Data synchronisation is crucial to maintain consistency between source and target. ## Best practices for importing data Before you import data into your live system, take the following necessary precautions: 1. Create a snapshot of your system with all the data available. This snapshot will help you restore the data if anything goes wrong with the import. 1. Validate the scenario. Before you start importing real data, which sometimes has hundreds or thousands of records, prepare a test file that contains no more than 10 records and import from that file first. 1. Perform the operation when the users are inactive or less active, for example, overnight. If the import was performed successfully but you imported the wrong data, you can modify the same scenario that was used for import to remove the imported data from the system. ## Data providers If you need to transfer data between an external application and Visma Net, you have to convert the data in an external format to or from the data in the format of Visma Net. The tool you use to perform such conversions in Visma Net is a **data provider**. A configured data provider, which has information about the source of external data and the structure of the data, performs data transfers between the external application or external file and Visma Net. You create data providers in the [Data providers](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. To create a provider, you specify its name and type, the access parameters to the source, and the data schema. You can find more information on data providers in [Data providers](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/). ## Import scenarios To import data from an external system or file to Visma Net, you need to map the external data fields to the fields of an Visma Net window. To define such mapping in Visma Net, you use **import scenarios**. An import scenario specifies the sequence of actions to be performed by Visma Net to import data from an external source. You can create an import scenario in one of the following ways: + **Standard way**: First you create a data provider, and then you add a new import scenario and map the data. + **Simplified way**: You upload the file, map window elements to external data, and then import the data. The data provider and the standard import scenario are added automatically. [Simplified scenarios for data import](/visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import/). For more information, see: ## Export scenarios **Export scenarios** are used primarily to export data from Visma Net to an external data source, such as a file or SQL table. You can also use export scenarios to update records in the system. For example, you can use export scenarios to mark records in the system once they have been exported to exclude them from future exports. As another example: Suppose you want to update existing records or mass-execute some action on them. If you have the list of particular record IDs that you want to update, it is easier to compose an import scenario and update the records by processing the list of IDs. If you have no list of IDs, you can compose an export scenario to select and update the needed records by the specified condition. For more information on export scenarios, see: [Configuring export scenarios](/visma-net-erp/to-be-deleted/help/integration/configuring-export-scenarios/configuring-export-scenarios/). ## Easy data conversion Each of the built-in data providers, which are reusable and require no additional custom code, recognises the data structure of the file or application and efficiently converts data from the particular external format into the internal format of Visma Net; it also efficiently converts internal data into the particular external format. Nevertheless, you may need to convert the data during import or export to formats specific to the particular system or perform other necessary data transformation. To do this, you can create formulas with the help of the easy-to-use formula editor. For details, see the following topics: + [Formulas in the mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/formulas-in-the-mapping/) + [Functions](/visma-net-erp/help/integration/configuring-scenario-mapping/functions/) + [Operators](/visma-net-erp/help/integration/configuring-scenario-mapping/operators/) Preparing data for import and export by using scenarios /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios section Before you import data to or export data from Visma Net, you must define to the Visma Net system the format of the data in the external system or file. 2026-02-19T17:09:06+01:00 # Preparing data for import and export by using scenarios Before you import data to or export data from Visma Net, you must define to the Visma Net system the format of the data in the external system or file. Before you import data to or export data from Visma Net, you must define to the Visma Net system the format of the data in the external system or file. For this purpose, you use data providers in the system. In this chapter, you will find detailed information on data providers and will learn how to create data providers for the external data. Preparing data for import and export by using scenarios /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/preparing-data-for-import-and-export-by-using-scenarios page Before you import data to or export data from Visma Net, you must define to the Visma Net system the format of the data in the external system or file. 2026-02-19T17:09:06+01:00 # Preparing data for import and export by using scenarios Before you import data to or export data from Visma Net, you must define to the Visma Net system the format of the data in the external system or file. Before you import data to or export data from Visma Net, you must define to the Visma Net system the format of the data in the external system or file. For this purpose, you use data providers in the system. In this chapter, you will find detailed information on data providers and will learn how to create data providers for the external data.

Related pages

Concepts

Tasks

About import and export scenarios /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/about-import-and-export-scenarios page To upload data to and from Visma Net, you can use import scenarios and export scenarios, which define the data import and data export instructions, respectively, for the system. 2026-02-19T17:09:06+01:00 # About import and export scenarios To upload data to and from Visma Net, you can use import scenarios and export scenarios, which define the data import and data export instructions, respectively, for the system. To upload data to and from Visma Net, you can use **import scenarios**and**export scenarios**, which define the data import and data export instructions, respectively, for the system. An import or export scenario is a sequence of actions to be executed for a data record as if the record is being manipulated by user through an Visma Net window. When you enter data into the system manually, you perform a sequence of actions. You open the needed data entry window and start entering data. To add a new record, you use the UI elements one by one or you type text, select values from combo boxes, clear or select check boxes, and click buttons. In the corresponding scenario, you compose exactly the same sequence of actions, you specify a command for each user action in the window. Just as you cannot perform multiple actions simultaneously in the window, the scenario executes commands successively. To construct the scenario, you reflect the actions you make in the window in the sequence of commands for the scenario. Because in these scenarios you either save data to an external system or file, or upload data from an external system or file to Visma Net, you must define in Visma Net the format of the external system or file. For this purpose, you set up a **data provider** in the system. A data provider is an entity that defines the structure of the external data source; Visma Net then uses the data provider to transfer data from and to the external system or file. Therefore, to use an integration scenario, you have to define the data provider and the needed import or export scenario. An integration scenario works as if the data is being manually processed in a Visma Net window. ## Manual input and integration scenarios input When you are creating an integration scenario, you first create the needed data provider, which defines the type and schema of the data source. For example: The type can be an Excel file, and the schema of an Excel data source consists of the names of spreadsheets that should be used for data import or export and the list of columns on the spreadsheets. If the external data source has changed (for example, if a new column has been added to an Excel spreadsheet), you have to update the data provider in Visma Net to be able to use the new column in scenarios for which the data provider is specified. After you have prepared the data provider, the second step is to define the scenario, including the scenario mapping. You can construct a scenario for any data entry window. In the scenario, you use internal fields, which are the fields of Visma Net, and external fields, which are defined in the specified data provider. In the scenario, you map internal fields to external fields and specify commands. An integration scenario is specific to the Visma Net window and the external data schema. After the scenario is ready, you can run the import or export for the scenario to get the result. You can also schedule scenarios to be run, so that you can import and export data on a regular basis.

Related pages

Tasks

About data providers /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/about-data-providers page You create data providers in the Data providers (SM206015) window. 2026-02-19T17:09:06+01:00 # About data providers You create data providers in the Data providers (SM206015) window. For more information: [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/). You create data providers in the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. To create a provider, you specify its name and type, the access parameters to the source, and the data schema. ## Data provider types Excel spreadsheets or files in CSV format are generally used for data exchange between different ERP products, because most ERP products support exporting and importing data in these formats. Besides using files in an external format as a data source, you can import data from or export data to an external application directly. For example: You can connect to a Microsoft SQL Server and download data from it or upload data to it. Visma Net provides a number of built-in types of data providers through which the application can efficiently import data from external files or third-party software to Visma Net, or export data from Visma Net to external destinations. These types of data providers, which you use when you configure a provider on the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window, are listed below: + File providers that you use to access data in external files: + **CSV provider** ( `PX.DataSync.CSVSYProvider` ): For import from and export to files in CSV format + **Excel provider** ( `PX.DataSync.ExcelSYProvider` ): For import from and export to Excel spreadsheets + **XML provider** ( `PX.DataSync.XMLSYProvider` ): For import from and export to files in XML format + Providers that are preconfigured for importing data from and exporting data to external systems: + **Salesforce provider** ( `PX.DataSync.SFSYProvider` ): For import from and export to SalesForce CRM by using the Simple Object Access Protocol (SOAP). + **MS SQL provider** ( `PX.DataSync.MSSqlSYProvider` ): For import from and export to Microsoft SQL Server. + **HubSpot provider** ( `PX.DataSync.HubSpot.HSSYProvider` ): For exporting leads to HubSpot for nurturing and importing leads to Visma Net for processing. + Providers for exporting payment data to external payment systems: + **ACH provider** ( `PX.DataSync.ACHProvider` ): For exporting data for processing in the Automated Clearing House (ACH) system. + **Giro Payment provider** ( `PX.DataSync.Banks.GIROPaymentProvider` ): For exporting data for processing in giro-based payment systems. To import data from other sources, you need to create a custom data provider by using the API provided by Visma Net. ## Provider parameters To define a particular data source to be used for import or export, you define the parameters of the data provider in the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. The set of parameters depends on the data provider type, as described below: + **Parameters of file providers:** File providers generally have a simple set of parameters that specify the file properties necessary for accessing data in the file. Each of the file providers has the **FileName** parameter, which specifies the path to the file that should be used for data import or export. The path to the file is set automatically after you have uploaded an external file to the provider. The **FileName** parameter displays the path to the uploaded file in the internal format: `Data Providers ()\`, where `` and `` are replaced with the corresponding values. Other parameters of a file provider depend on the provider type. You should specify these parameters so the system can correctly open the file and process the contents of the file. + **Parameters of providers that connect to external data systems:** For providers that connect to external data systems, such as SalesForce or MS SQL provider, you specify a set of parameters for connecting Visma Net to the external system. Each of these providers has a parameter that you use to specify the location of the remote resource. This parameter is either the URL of a remote service or the path to a local server. Other parameters are specific to each provider type. These parameters are necessary for authentication on the remote resource. ## External data schema Data that you are going to transfer between an external data source and Visma Net usually has a table structure. That is, the data includes a number of data records, and each record has a list of parameters specified. You specify the structure of an external data source for a data provider by defining the external data schema or you specify the objects and fields of the data source. The object is usually the whole data source or a part of the data source that corresponds to a complete data table. For example: For an Excel file, objects correspond to spreadsheets. For the source objects that should be used for import or export, you should select the **Active** check box in the **Source objects** table on the **Schema** tab of the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. Source fields are defined by the list of attributes that are specified for each record. For an Excel file, source fields correspond to columns on a spreadsheet. For each field you want to use the field in a scenario, you should select the **Active** check box in the **Source fields** table on the **Schema** tab of the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. ## Data provider creation You create data providers in the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. The process of creating a data provider consists of the following general steps: 1. **Reviewing the structure of external data** Before you create the data provider, you review the external source to identify the needed provider type and the external data schema. If you are going to import data to Visma Net, you review the source data to determine the needed provider type, to check that the data meets the requirements, and to see the external data schema. If you are going to export data from Visma Net, you review the data schema in the target file or application to which you want to export the Visma Net data, or create a file to hold the data to be exported and provide field names matching the intended use of the data. 1. **Creating a provider and setting its type** In the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window, you create the data provider. You specify the name of the provider, which usually describes the data you will transfer by using this provider. You also select the needed type of the provider. You can use built-in provider types or develop a custom data provider type. 1. **Specifying the provider parameters** On the **Parameters** tab of the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window, you specify the particular data source. You attach a file or specify the location of the remote source. You also specify the source-dependent parameters, if necessary. 1. **Filling in the source objects and fields of the provider** On the **Schema** tab of the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window, you fill in objects and fields from the attached file or remote resource to the data provider. After that, the data provider is ready and can be edited as needed. For a file provider, you can upload the new version of an attached file and then update source objects and fields. For a provider connected to a remote system, you can reload the data schema from the server if you make any changes.

Related pages

Tasks

Create a CSV data provider /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/create-a-csv-data-provider section You use the Data providers - reference information window to create a data provider that defines the structure of external data for Visma Net during data import or data export. 2026-02-19T17:09:06+01:00 # Create a CSV data provider You use the Data providers - reference information window to create a data provider that defines the structure of external data for Visma Net during data import or data export. For more information: [Data providers - reference information](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/). This procedure describes how to create a data provider that works with the records in a CSV file. 1. Review the file for which you need to create the data provider to identify the needed provider parameters (the delimiter that is used in the file and file encoding) and external data schema. 1. Go to the [Data providers - reference information](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. 1. Create a provider and specify the following settings: + **Name**: The name of the provider. It usually describes the data you will transfer by using this provider, such as Import/Export Customers + **Data Type**: **CSV Provider** (PX.DataSync.CSVSYProvider) 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). The system requires you to save the provider before you upload the file. 1. Drag and drop the file to the window, and refresh the window in your browser. The file is uploaded to the window. As an alternative to this step, to upload the source file to the window, in the title bar, click **Files**. In the **Files** dialog box that opens, click **Browse** to locate the source file. Select the file, and click **Open**. In the dialog box, click **Upload** to upload the file to the website; then close the dialog box. 1. On the **Parameters** tab, do the following to set the parameters of the data provider: + Check that the value of the **FileName** parameter is correct; it was filled in automatically when you uploaded the file. + As the value of the **Encoding** parameter, specify the encoding of the source file by selecting the proper encoding value from the drop-down list in the **Value** column of the table. + As the value of the **Delimiter** parameter, specify the delimiter that is used in the CSV file. 1. Open the **Schema** tab. In the **Source objects** area, select the **Active** check box for the only available object of the CSV provider to make the object available in integration scenarios. If you don't see an object on the **Source objects** area, click **Fill schema objects** in the toolbar of the **Source objects** area. 1. In the toolbar of the **Source fields** area, click **Fill schema fields**. The system displays the field names available in the file in this area. Make sure the **Active** check box is selected for all the fields of the file for which data will be imported or exported. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). You have created a CSV data provider that you can use in an import or export scenario.

Related pages

Concepts

Windows

Create an Excel data provider /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/create-an-excel-data-provider section You use the Data providers (SM206015) window to create a data provider that defines the structure of external data for Visma Net during data import or data export. 2026-02-19T17:09:06+01:00 # Create an Excel data provider You use the Data providers (SM206015) window to create a data provider that defines the structure of external data for Visma Net during data import or data export. For more information: [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/). You use the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window to create a data provider that defines the structure of external data for Visma Net during data import or data export. This procedure describes how to create a data provider that works with the records in an Excel file. ## Create an Excel data provider 1. Review the data file for which you need to create the data provider to identify the external data schema. Open the file and review the available columns. Make sure that you understand how the names of the columns match the contents. 1. Go to the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. 1. Create a provider with the following settings: + **Name**: The name of the provider, which usually describes the data you will transfer by using this provider, such as Import/Export AR Invoices. + **Data type**: **Excel provider** (PX.DataSync.ExcelSYProvider The list of provider parameters becomes available on the **Parameters** tab, which contains one parameter: **FileName**. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). The system requires that you save the provider before you upload a file. 1. Drag and drop the file to the form, and refresh the window in your browser. The file is uploaded to the window. As an alternative to this step, to upload the source file to the window, in the title bar, click **Files**. In the **Files** dialog box that opens, click **Browse** to locate the source file. Select the file, and click **Open**. In the dialog box, click **Upload** to upload the file to the website; then close the dialog box. The **FileName** parameter is set to the name of the file that you have uploaded. 1. On the toolbar of the **Source objects** area of the **Schema** tab, select the **Active** check box for the needed object (which corresponds to a spreadsheet) to make the object available in integration scenarios. 1. On the toolbar of the **Source fields** area, click **Fill schema fields**. The system displays the fields available in the source file in this area. Make sure the **Active** check box is selected for all the columns of the file for which data will be imported or exported. 1. Repeat the previous two steps for all the objects (spreadsheets) and fields (columns) that you want to use for data import and export. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). You have created an Excel data provider that you can use in an import or export scenario.

Related pages

Concepts

Windows

Create a Microsoft SQL data provider /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/create-a-microsoft-sql-data-provider section You use the Data providers (SM206015) window to create a data provider that defines the structure of external data for Visma Net during data import or data export. 2026-02-19T17:09:06+01:00 # Create a Microsoft SQL data provider You use the Data providers (SM206015) window to create a data provider that defines the structure of external data for Visma Net during data import or data export. For more information: [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/). You use the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window to create a data provider that defines the structure of external data for Visma Net during data import or data export. This procedure describes how to create a Microsoft SQL data provider that is used to transfer data between Visma Net and a table of a Microsoft SQL Server database. 1. Review the columns of the database table for which you need to create the data provider to identify the external data schema. 1. Go to the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. 1. Create a provider, and specify the following settings for it: 1. **Name**: The name of the provider, which usually describes the data you will transfer by using this provider. 1. **Data Type**: **MS SQL Provider**. 1. On the **Parameters** tab, do the following: 1. As the value of the **Server** parameter, specify one of the following: + The name of the computer where the Microsoft SQL Server instance is installed if you use the default instance of Microsoft SQL Server. + The name of the computer and the name of the Microsoft SQL Server instance if you use a named instance. 1. Specify the database name as the value of the **Database** parameter. 1. Specify the login and password for accessing the SQL Server instance and the type of authentication that is used by the SQL Server instance (either **SQL** or **Windows** ). 1. On the toolbar in the **Source objects** area of the **Schema** tab, click **Fill schema objects**. The system connects to the database, pulls the list of tables and views from it, and populates the **Source objects** tab with the schema objects that correspond to tables and views. If you don't see **Fill schema objects** in the toolbar, click ![Images-How_to_Create_a_Provider_for_Data_Import_SM_20_60_15Icon_FillIn](/media/visma-net-erp/Images-How_to_Create_a_Provider_for_Data_Import_SM_20_60_15Icon_FillIn.jpg), to display any buttons that do not fit on the toolbar. 1. Select the **Active** check box for the needed object. In the toolbar of the **Source fields** area, click **Fill schema fields**. The system displays the column headers available in the source database table. Make sure the **Active** check box is selected for all needed fields. 1. Repeat the previous step for all objects (SQL tables and views) that you want to import data to and export data from. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). You have created a Microsoft SQL data provider that you can use in an import or export scenario.

Related pages

Concepts

Windows

Modify a file data provider /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/modify-a-file-data-provider section You can use the Data providers (SM206015) window to modify existing data providers. 2026-02-19T17:09:06+01:00 # Modify a file data provider You can use the Data providers (SM206015) window to modify existing data providers. For more information: [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/). If the data source has changed, for example, if you have added a column to the Excel file, you have to update the data provider. To update the data provider, you have to replace the file attached to the provider in the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window and update the provider schema. 1. Go to the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. 1. Select the provider that you want to modify, and in the window title bar, click **Files**. 1. In the **Files** dialog box, click **Edit** to the right of the file name. Clicking **Edit** opens the [File maintenance (SM202510)](/visma-net-erp/help/management/management-windows/file-maintenance-sm202510/) window, which displays the details of the file attachment. 1. In the toolbar, click **Check out** to make the file unavailable to other users for editing while you are updating it. You may skip this step if no other users can work with this file simultaneously. 1. Click **Get latest version** in the toolbar, and download the file. Open the file and modify it. Save the edited version to your computer. You do not necessarily have to download the file first; you can just upload a new version and skip this step. 1. In the window toolbar of the [File maintenance (SM202510)](/visma-net-erp/help/management/management-windows/file-maintenance-sm202510/) window, click **Upload new version** to open the **File upload** dialog box, and upload the edited version of the file into the system. If you checked the file out, select the **Check in** check box to make the file available for editing to other users. On the **Versions** tab, notice the list of available file versions (see the screenshot below). If necessary, you could download or restore the needed file version. To download a file version, select the needed version and click **View selected version** in the table toolbar. Then you can upload the file as a new version. To delete a file version, click **Delete row** in the table toolbar. 1. Close the [File maintenance (SM202510)](/visma-net-erp/help/management/management-windows/file-maintenance-sm202510/) window and the **Files** dialog box to resume work in the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. 1. On the **Schema** tab, on the toolbar of the **Source fields** area, click **Fill schema objects**. The system updates the list of available objects. Make sure the **Active** check box is selected for all objects that you need to use for data import or data export. 1. For each active source object, select the object on the **Source fields** area and click **Fill schema fields** in the toolbar of the **Source fields** area. The system updates the list of available fields. Make sure the **Active** check box is selected for all fields that you need to use for data import or data export. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png).

Related pages

Concepts

Windows

Link a file data provider to an existing file /visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/link-a-file-data-provider-to-an-existing-file section The file that should be used for creating the data provider may be already uploaded to Visma Net. 2026-02-19T17:09:06+01:00 # Link a file data provider to an existing file The file that should be used for creating the data provider may be already uploaded to Visma Net. The file that should be used for creating the data provider may be already uploaded to Visma Net. In this case, you perform the steps described below. You use the [Search in files (SM202520)](/visma-net-erp/help/management/management-windows/search-in-files-sm202520/) window to get the link of the file you need to link to a file provider. You then use the [Data providers](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window to create a provider and specify the copied link on that window. 1. Go to the [Search in files (SM202520)](/visma-net-erp/help/management/management-windows/search-in-files-sm202520/) window. 1. In the **File name contains** field, type the name of the file that you need to link to a file provider and press Enter. The table in the lower right area contains the list of files matching the specified criteria. 1. For the needed file that appeared in the search results, click **Get file link**, and copy the internal link to the file from the **Attached file link** dialog box. 1. Go to the [Data providers](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. 1. Create a data provider, and specify its name and type in the **Name** and **Data type** fields. 1. On the **Parameters** tab, set the **FileName** parameter value to the copied link. 1. On the **Schema** tab in the **Source objects** area, click **Fill schema objects**. The source objects appear on the tab. Select the **Active** check box for the needed object. In the **Source fields** area, click **Fill schema fields**. The fields have been retrieved from the file and appear on the tab. Make sure all fields are active. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). You have created a file provider and linked it to a file that was uploaded to the system earlier. This provider can be used for importing or exporting records.

Related pages

Concepts

Windows

Configuring import scenarios /visma-net-erp/help/integration/configuring-import-scenarios section You create import scenarios in the Manage import scenarios (SM206025) window. 2026-02-19T17:09:06+01:00 # Configuring import scenarios You create import scenarios in the Manage import scenarios (SM206025) window. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). To create an import scenario, you should specify its name, the Visma Net window that should be used for importing data, the data provider that defines the structure of the imported data, and the data provider object. You should also configure the mapping of the scenario. Import scenario creation /visma-net-erp/help/integration/configuring-import-scenarios/import-scenario-creation page You create import scenarios in the Manage import scenarios (SM206025) window. 2026-02-19T17:09:06+01:00 # Import scenario creation You create import scenarios in the Manage import scenarios (SM206025) window. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). The creation of the import scenario consists of the following general steps: ## 1. Analysing the sequence of actions in the window Before you start creating an import scenario in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, you should create a data provider, as described in [About data providers](/visma-net-erp/help/integration/preparing-data-for-import-and-export-by-using-scenarios/about-data-providers/), and learn how a data record is entered in the target Visma Net window. When reviewing the Visma Net window for which you will compose the import scenario, pay attention to the required fields in the window. All these fields must be filled in when you create a new record. Some fields in the window can get default values, which can also be used during import. For example: You can configure customer classes before you import customer records so that when these records are imported, the system gets most of settings from the customer class specified for the customer. You can provide the values of the fields that have default values during import and override these default values. Make sure all required data fields either are included in the imported data or are filled with default values. Before you start creating a scenario, we strongly recommend that you manually enter one record of the imported data or a test record. (During import, you can exclude this record from processing to avoid duplication of records in the system). Pay attention to the sequence of actions you perform: the order in which you specify values in the fields in the window and the actions you perform for the entered record, such as adding a new row and saving your changes. ## 2. Specifying scenario parameters The parameters of an import scenario define the name of the scenario, the Visma Net window to which data will be imported, and the data provider and source object, which together specify the data source. You can also set other import scenario parameters that define the mode of import and the properties of the data being imported. ## 3. Creating mapping of the scenario Mapping is the process of creating one-way relations between the fields of an external data source and the fields of a Visma Net window. To provide mapping for a particular field in a Visma Net window, you perform the following steps on the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window: 1. Add a row for the field you want to map. 1. In the **Target object** column, specify the Visma Net object that includes the target field. An object represents a group of fields in a Visma Net window, such as the top part or a detail tab. 1. In the **Field/action name** column, select the appropriate internal field or action. An internal field is a field of the Visma Net object selected in the **Target object** column. 1. In the **Source field/value** column, select the matching external field, internal field, or combination of internal and external fields, functions, and constants. An external field is a field of the object from the data provider specified in the scenario. When you are mapping fields, you should first map the key fields: the fields that the system uses to distinguish records that belong to different documents. For example: In the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window, there are two key fields: **Type** and **Reference no**. You should map these fields before you map the other fields, because you fill in these fields first on the window when you manually enter an invoice. After you have mapped key fields, you should map other fields in the order in which you would fill them in, in the window. You can deactivate some rows of the scenario mapping by clearing the **Active** check box for corresponding rows. This will exclude the corresponding instruction from the scenario mapping, and this instruction will not be executed during the import process. At the end of the mapping of the scenario that imports or updates data in the system, to save the imported record to the database, you have to insert a row with the **<Action: Save>** action. ## 4. Configuring source and target restrictions To import only some records from the data source or update only the records that satisfy some condition, you can configure source and target restrictions for an import scenario in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. You can find detailed descriptions and examples of the use of source and target restrictions in the following topics: + [Source restrictions in import scenarios](/visma-net-erp/help/integration/configuring-import-scenarios/source-restrictions-in-import-scenarios/) + [Target restrictions in import scenarios](/visma-net-erp/help/integration/configuring-import-scenarios/target-restrictions-in-import-scenarios/) After these steps have been performed, the scenario is ready, and you can use it for data processing. Import scenario parameters /visma-net-erp/help/integration/configuring-import-scenarios/import-scenario-parameters page When you begin creating an import scenario by using the Manage import scenarios (SM206025) window, you specify the following required parameters: 2026-02-19T17:09:06+01:00 # Import scenario parameters When you begin creating an import scenario by using the Manage import scenarios (SM206025) window, you specify the following required parameters: For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). Name : In this field, you specify a name that reflects the functionality of the import scenario. You have to use unique names between import and export scenarios. Window name : In this field you select the Visma Net window that should be used for data import. Provider : and **Provider object**: In these fields, you select one of the previously created data providers and its object that should be used for data import. If you select a file data provider, Visma Net automatically attaches to the scenario in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window the file used for file data provider creation. This file is shared between the data provider and the import scenario that uses it for data import or it is attached to both the [Data providers - reference information](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window for the provider and the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window for the scenario. You can view and modify the attached file in the [File maintenance (SM202510)](/visma-net-erp/help/management/management-windows/file-maintenance-sm202510/) window; to open the window, while you are viewing the import scenario, click **Files** in the title bar. After you specify the required parameters, you can set the following optional parameters: + **Sync type**: By default, the **Full** sync type is selected in this field, which means that all data available in the source is imported. Selecting a different option is useful if you use the same scenario regularly for importing only some of the data from the source. For example: If after the initial import you need to periodically upload new data records that have appeared in the source. If the data is imported from a file data source, you can set the scenario to import the data only if a new version of the source file is provided before import. To do this, set **Sync type** to **Incremental - All records** or **Incremental - New only**; both options provide the same result. In this case, if you upload a new version of the source file by using the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window before import, the data from the source file is imported to the system. If no new version of the file is provided, no data is imported. + **Format locale**: For Visma Net to recognise the format of imported dates, numbers, and other country-specific data correctly, you should specify the appropriate locale in this field. By default, Visma Net uses the invariant locale, which is similar to the English (United States) locale. The newly created scenario has the **Active** check box selected by default. This check box must be selected so that you can use the scenario for processing records in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. Target objects and fields in import scenarios /visma-net-erp/help/integration/configuring-import-scenarios/target-objects-and-fields-in-import-scenarios page When you are performing mapping on the Mapping tab of the Manage import scenarios (SM206025) window, you have to select the target object and field. 2026-02-19T17:09:06+01:00 # Target objects and fields in import scenarios When you are performing mapping on the Mapping tab of the Manage import scenarios (SM206025) window, you have to select the target object and field. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). ## The target objects and fields In the **Target object**column, you have to select the object of the Visma Net window into which you want to insert the value. The object names that appear in this drop-down field are the names of the UI elements that you see in the window. Custom UI elements that you add to the system by means of customisation are also available for mapping in the same way as the original ones. For example, to be able to select the **Statement cycle ID** field that is located in the **Financial settings** group on the **General info** tab of the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, you would select `General info -> Financial settings` as the target object for mapping. Each field or action on a Visma Net window (such as a text box, combo box, table column, or button) is associated with a particular target object and becomes available for selection in the **Field/action name** column once you select the target object in the **Target object** column. The field name has the same name as the corresponding field in the window, such as `Statement cycle ID`. If you are not sure that you have selected the field name correctly, you can check it as follows: 1. On the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, add the **Native field/Action name** column to the mapping table. (You can change the list of columns that are displayed in the mapping table in the **Columns configuration** dialog box, which opens if you click the header icon of the first column in the mapping table.) In the **Native field/Action name** column, you can see the internal name of the target field. 1. In the title bar of the target Visma Net window, click **Customisation** **>** **Inspect element** and click the target element in the window. In the **Element properties** dialog box, which opens, check that the value of the **Data field** element is equal to the value in the **Native field/Action name** column in the mapping table in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. Multiple objects support the functionality of each Visma Net window: a summary object, detail objects, and related objects. These types of objects are described in the following sections. ## The summary object The summary object is the main object in the window; it contains the keys that identify the record in the system. You can use the fields of the summary object to do the following: + Set the values of the corresponding fields in the window. + Search for a record in the system. That is, you can create custom keys from these fields to search for a particular record. For example: You can find a needed customer record in the system by using the value of the **Customer name** field in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window. + Filter imported records by these fields by using target restrictions. For example: You can select for processing only the customer records that have the **Inactive** status in the **Status** field in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window. Generally, you can identify the fields that belong to the summary object in the window as the fields of the top part of the window. More precisely, these are the data fields of the data access class (DAC) underlying the summary object. To use the summary object in scenario mapping, select the first object in the **Target object** drop-down field on the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. For example: The summary object in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window is `Customer summary`. It includes the key **Customer no.** field. The summary object in the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window is `Invoice summary`. It includes two key fields: **Type** and **Reference no**. ## The detail objects Detail objects correspond to the tabs that include lists of detail records. The fields of a detail object correspond to the columns of the detail tab. You can use the fields of the detail object to do the following: + Set the values of corresponding fields of a detail line. + Search for a detail line in the document. That is, you can create custom keys from these fields to search for a particular detail line in the document. For example: In the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window, you can find a needed detail line of a sales invoice by using the value in the **Transaction descr.** column. To use the detail object in the scenario mapping, in the **Target object** column in the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, select the object with the same name as the name of the detail tab. For example, [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window has the **Contacts** tab, shown in the following screenshot, which includes a list of contacts. The corresponding detail object has the `Contacts` name. In the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window, the `Document details` object contains a list of invoice lines. ## The related objects Related objects support the functionality of other tabs and groups of fields in the window. You can use the fields of these objects only to set the values of the corresponding fields in the window. You cannot use the fields of these objects to search for records by using customer keys or to filter imported records by using target restrictions. For example: In the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, you cannot search for the needed customer record by using the value of the **Email** field of the **Main contact** group of the **General info** tab as a custom key, and you cannot filter records by using the **Country** field of the **Main address** group of the **General settings** tab by using target restrictions. To use a related object in the scenario mapping, in the **Target object** column in the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, select the object with the name of corresponding tab or group of fields in the window. The related objects that correspond to tabs in the window have the names of the tabs. The related objects that correspond to groups of fields in the window have names in one of the following formats: `Summary name -> Group of fields name` or `Tab name -> Group of fields name`. For example, in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, the **Main contact** and **Main address** groups of elements on the **General settings** tab are represented by related objects. These objects are listed in the **Target object** column as `General info -> Main contact` and `General info -> Main address`. Source fields in import scenarios /visma-net-erp/help/integration/configuring-import-scenarios/source-fields-in-import-scenarios page When you are performing mapping on the Mapping tab of the Manage import scenarios (SM206025) window, you have to select in the Source field / value column the source field from which the system takes the value to be inserted into the target field. 2026-02-19T17:09:06+01:00 # Source fields in import scenarios When you are performing mapping on the Mapping tab of the Manage import scenarios (SM206025) window, you have to select in the Source field / value column the source field from which the system takes the value to be inserted into the target field. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). You can use the following as source fields: + The fields defined in the data provider + The fields of a Visma Net window, from which we can take the value that already exists in the system or the default value + Any combination of the fields defined in the data provider, the fields of a Visma Net window, constants, and functions ## Relationships between source fields and target objects and fields Source data includes a set of master records, such as customer account records. Each master record has a set of fields that are mapped to the fields of the summary object and related objects. For customer accounts, these fields can include **Customer number** and **Email**. There may be only one value of such field for each summary object or related object. A master record can have a set of detail lines that are mapped to the fields of detail objects. For example, a customer account can have multiple contact details. There may be many detail lines for each detail object. Therefore, for these detail lines to be imported to Visma Net, external data should include the identifier of the master record for each detail line. That is, each detail line should have the key fields of the summary object specified. For example, suppose that you have a customer account with two contact details. In this case, the external data that you are going to import to Visma Net should include two records, one record with the customer number and contact information for each contact detail. Such records should include a key field that the system uses to distinguish lines that belong to different records. Source restrictions in import scenarios /visma-net-erp/help/integration/configuring-import-scenarios/source-restrictions-in-import-scenarios page You can use source restrictions to filter the data that you want to extract from the source for processing by the import scenario. 2026-02-19T17:09:06+01:00 # Source restrictions in import scenarios You can use source restrictions to filter the data that you want to extract from the source for processing by the import scenario. You can use source restrictions to filter the data that you want to extract from the source for processing by the import scenario. For example: Some customer number values in the source have **CUST** prefixes. You can specify a source restriction that selects only the records from the source that have the **CUST** prefix in the customer number field. To configure restrictions on the data that will be extracted from the source during the import, you specify conditions for the fields of the source file on the **Source restrictions** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. If you specify source restrictions, when the system prepares records for import, it selects only the records that conform to the specified condition or conditions from the source and imports only these records. For example, suppose that you want to import only the customer records that have the **CUST** prefix in the customer number. In this case, you can add the condition to the source restrictions that the external customer number field should start with the **CUST** prefix. The system will import only the records for which the customer number has the specified prefix. Target restrictions in import scenarios /visma-net-erp/help/integration/configuring-import-scenarios/target-restrictions-in-import-scenarios page You can specify target restrictions that apply to records after they have been processed by the import scenario. 2026-02-19T17:09:06+01:00 # Target restrictions in import scenarios You can specify target restrictions that apply to records after they have been processed by the import scenario. You can specify target restrictions that apply to records after they have been processed by the import scenario. For example: Suppose that you have imported customer records to Visma Net and then manually changed the status of some of these records to **Inactive** in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, and now you want to update only imported customer records that have the **Inactive** status. Because you do not have the status in the source file, you cannot use source restrictions to select needed records. You can, however, specify a target restriction that makes the system save the results of import for only the records that have **Inactive** status in the window. To configure restrictions that apply to records after they have been processed by the import scenario, you specify conditions for the target fields on the **Target restrictions** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. If you have specified target restrictions, after a record is imported, the system checks the conditions for the imported record. If a record meets the conditions, the system saves the result of processing the record during import. If a record violates the target restrictions, the resulting record is not saved; by default, the system stops processing records and displays an error. To make the system skip errors for the records that do not meet the restrictions and proceed with processing other records, you should set the system to not break on an incorrect target. In this case, the system will continue to process subsequent records after an error has occurred for a record. For example, suppose that you want to delete customer records that have an **Inactive** status in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window. To do this, you can add to the target restrictions the condition that the imported customer records should have the **Inactive** status. During import, the system will check whether each imported record has the **Inactive** status, and delete the record only if it has this status. To determine target restrictions, you can use only the fields of the summary object. For example: In the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, you can filter records by the **Customer number**, **Customer name**, and **Status** fields. You cannot use columns of **Select** dialog boxes, fields of related objects, and fields of detail objects to filter records. For example: For this window, you can filter customer records neither by the value of the **Country** field of the **Main contact** group on the **General settings** tab, nor by the **Country** column of the Selector dialog box of the **Customer no.** field. Enable manual override of number series during import /visma-net-erp/help/integration/configuring-import-scenarios/enable-manual-override-of-number-series-during-import section Import is normally run from the Import by scenario (SM206036) window. 2026-02-19T17:09:06+01:00 # Enable manual override of number series during import Import is normally run from the Import by scenario (SM206036) window. For more information: [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/). If you need to do a manual override of the number series during the import, you can enable this by following the steps below. 1. Go to the [Enable/disable functionalities (CS100000)](/visma-net-erp/help/common-settings/enable-or-disable-functionalites/enable-disable-functionalities-cs100000/) window. 1. Select the **Allow manual numbering on imports** check box. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). 1. Go to the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. 1. Select the **Override number series upon import** check box. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). Configuring export scenarios /visma-net-erp/help/integration/configuring-export-scenarios section You create export scenarios in the Manage export scenarios (SM207025) window. 2026-02-19T17:09:06+01:00 # Configuring export scenarios You create export scenarios in the Manage export scenarios (SM207025) window. For more information: [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). To create an export scenario, you specify its name, the Visma Net window to be used for export, the data provider that defines the structure of the target data, and the data provider object; you also configure scenario mapping. After you have created an export scenario, you can export data by using this scenario. You export data in the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window. Export scenario creation /visma-net-erp/help/integration/configuring-export-scenarios/export-scenario-creation page You create export scenarios in the window. 2026-02-19T17:09:06+01:00 # Export scenario creation You create export scenarios in the window. The creation of the export scenario consists of the following general steps: 1. **Analysing the sequence of actions in the window for data export** Before you start creating an export scenario in the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window, you create a data provider and learn how to retrieve the needed data records from the corresponding Visma Net window. If needed, you could use the same data provider for import and export of data in the same format. However, a data provider and the scenarios that use this provider share the same external data source. Therefore, if you do not want to confuse the input and output data sources, you should create separate data providers for importing and exporting data. Before you start creating a scenario, we strongly recommend that you try to retrieve the records of the exported data manually. Pay attention to the sequence of actions you perform: the order in which you specify values in the fields in the window, and the actions you perform. 1. **Specifying scenario parameters** You specify the following parameters of an export scenario: the name of the scenario, the Visma Net window that should be used for export, and the data provider and the object, which together specify the target data source. You can also specify other export scenario parameters that define the mode of export and the properties of the data resulting from the export. 1. **Creating scenario mapping** Mapping is the process of creating one-way relations between the fields of the Visma Net window and the fields of the external data source. To provide mapping for a particular field on an Visma Net window, you perform the following steps on the **Mapping** tab of the [Schedule export scenarios (SM207035)](/visma-net-erp/help/integration/integration-windows/schedule-export-scenarios-sm207035/) window: 1. In the **Source object** field, you specify the Visma Net object that includes the source field. An object represents a group of fields on an Visma Net window, such as a top part or a detail tab. (These are the same objects that are used in import scenario mapping.) 1. In the **Field/Action Name** column, you select the appropriate internal field or action. An internal field is a field of the Visma Net object selected in the **Source Object** field. 1. In the **Target field/value** column, you select the matching external field or type a formula the system will use to determine the value. An external field is a field of the object from the data provider specified in the scenario. You first map the key fields that identify the records you want to export. After you have mapped the key fields, you should map the other needed fields. You can deactivate some steps of a scenario by clearing the **Active** check box for the corresponding rows. 1. **Configuring source restrictions** To export only some records from the Visma Net database, you can configure source restrictions for an export scenario in the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window. After these steps have been performed, the scenario is ready and can be used for data processing. Export scenario parameters /visma-net-erp/help/integration/configuring-export-scenarios/export-scenario-parameters page When you create an export scenario in the Manage export scenarios (SM207025) window, you first specify the following required parameters: 2026-02-19T17:09:06+01:00 # Export scenario parameters When you create an export scenario in the Manage export scenarios (SM207025) window, you first specify the following required parameters: For more information: [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). Name : In this field, you specify a name for the export scenario that reflects its functionality. You have to use unique names between import and export scenarios. (That is, you cannot use the same name for both an import scenario and an export scenario.) Window name : In this field, you select the Visma Net window from which you want to export data. Provider : and **Provider object**: In these fields, you select one of the existing data providers and its object that should be used for data export. If you select a file data provider, Visma Net automatically attaches to the scenario in the [Schedule export scenarios (SM207035)](/visma-net-erp/help/integration/integration-windows/schedule-export-scenarios-sm207035/) window the file used for file data provider creation. This file is shared between the data provider and the export scenario that uses it for data export (that is, it is attached to both the [Data providers - reference information](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window for the provider and the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window for the scenario). You can view and modify the attached file by using the [File maintenance (SM202510)](/visma-net-erp/help/management/management-windows/file-maintenance-sm202510/) window. To open the window, while you are viewing the export scenario, click **Files** on the title bar. Then you can specify the following optional parameters: + **Sync type**: By default, the **Full** option is selected, causing all records to be exported. Selecting a different option is useful when you use the same scenario for exporting data regularly. For example: After the initial export, you may periodically need to export new or changed data records in Visma Net to the external system or file. You can select from two options that provide incremental export. To export only the records for which data has changed in the Visma Net database since the previous export took place, select the **Incremental - all records** sync type. To import only new records in the Visma Net database, select the **Incremental - new only** sync type. + **Format locale**: For Visma Net to export dates, numbers, and other country-specific data in the needed format, you should specify the locale in the **Format locale** field. By default, Visma Net uses the invariant locale. The newly created scenario has the **Active** check box selected, which indicates that the scenario can be used for processing. Source restrictions in export scenarios /visma-net-erp/help/integration/configuring-export-scenarios/source-restrictions-in-export-scenarios page You use source restrictions in an export scenario for the data available in the Visma Net database. 2026-02-19T17:09:06+01:00 # Source restrictions in export scenarios You use source restrictions in an export scenario for the data available in the Visma Net database. You use source restrictions in an export scenario for the data available in the Visma Net database. For example: You can configure the system to export only the records that have a particular status. To specify restrictions on the data being exported, you specify conditions for the Visma Net fields on the **Source restrictions** tab of the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window. In this case, when it prepares records for export, the system selects only the records that meet the specified condition (or conditions) and imports only these records. For example, suppose that you want to export from the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window only the customer records that have **Active** status. In this case, you can add to the source restrictions the condition that the **Status** field should be equal to **Active**. During the preparation process (when you click **Prepare** in the [Schedule import scenarios (SM206035)](/visma-net-erp/help/integration/integration-windows/schedule-import-scenarios-sm206035/) window and the system prepares the data for export), the system processes the records that match the source restrictions of the scenario and prepares only the records with the **Active** status. In source restrictions, you can use only the fields of the summary object or detail objects of the window from which you are exporting data. You cannot use columns of **Select** dialog boxes and fields of related objects to filter records or detail lines. Configuring scenario mapping /visma-net-erp/help/integration/configuring-scenario-mapping section You perform the mapping of an import scenario on the Mapping tab of the Manage import scenarios (SM206025) window, and you perform the mapping of an export scenario on the Mapping tab of the Manage export scenarios (SM207025) window. 2026-02-19T17:09:06+01:00 # Configuring scenario mapping You perform the mapping of an import scenario on the Mapping tab of the Manage import scenarios (SM206025) window, and you perform the mapping of an export scenario on the Mapping tab of the Manage export scenarios (SM207025) window. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/), [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). You use similar principles when configuring the mapping of either type of scenario. In this chapter, you can find the main ideas that apply to scenario mapping. Most of the ideas are described in examples of import scenarios. However, you can configure the mapping of an export scenario similarly. The topics of this chapter also describe information that is specific to mappings of export scenarios. Configuring scenario mapping /visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping page You perform the mapping of an import scenario on the Mapping tab of the Manage import scenarios (SM206025) window, and you perform the mapping of an export scenario on the Mapping tab of the Manage export scenarios (SM207025) window. 2026-02-19T17:09:06+01:00 # Configuring scenario mapping You perform the mapping of an import scenario on the Mapping tab of the Manage import scenarios (SM206025) window, and you perform the mapping of an export scenario on the Mapping tab of the Manage export scenarios (SM207025) window. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/), [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). You perform the mapping of an import scenario on the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, and you perform the mapping of an export scenario on the **Mapping** tab of the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window. You use similar principles when configuring the mapping of either type of scenario. In this chapter, you can find the main ideas that apply to scenario mapping. Most of the ideas are described in examples of import scenarios. However, you can configure the mapping of an export scenario similarly. The topics of this chapter also describe information that is specific to mappings of export scenarios. General recommendations and limitations of data import /visma-net-erp/help/integration/configuring-scenario-mapping/general-recommendations-and-limitations-of-data-import page In this topic, you will find general recommendations for data import, including its limitations. 2026-02-19T17:09:06+01:00 # General recommendations and limitations of data import In this topic, you will find general recommendations for data import, including its limitations. ## General recommendations for importing accounts and subaccounts When you import accounts and subaccounts to Visma Net, consider the following general recommendations: + In your new Visma Net implementation, the chart of accounts may differ from the chart of accounts in the legacy application from which you are going to import the data. When the company switches to newer software, the length of the account identifier is usually extended to include more characters; in many cases, several zeros are added in the middle of or at the end of the account identifier. In such a simple case, consider inserting these additional characters during the import process by using a formula. + In Visma Net, subaccount identifiers are segmented, but the separator characters are not part of the subaccount identifier as it is saved in the database. If subaccount identifiers in the external file have segments separated by a character, use a formula such as the following to remove this character from the external data during import. `replace([Sales Subaccount],'-','')` + If you import subaccounts from your subsidiary or parent company, consider the differences in their segment structures. You may need to add a segment when you are importing from a subsidiary or remove a segment when you're importing from a parent company. ## General recommendations for importing supplier and customer data Here are some general recommendations for importing supplier and customer data to Visma Net: + In Visma Net, supplier and customer numbers may be segmented. You can create a formula to insert any missing segments into the imported IDs. + If the external file contains fields with supplier or customer data that is not tracked in Visma Net in built-in fields, you can create and use attributes to store this supplier or customer data in Visma Net. Attributes are created for supplier or customer classes, and then can be entered and tracked for individual suppliers and customers. + If customer and supplier records have numerical IDs in the source and you want to retain these IDs in the new implementation, perform the following steps: + In the [Segment keys (CS202000)](/visma-net-erp/help/common-settings/common-settings-windows/segment-keys-cs202000/) window, configure the **SUPPLIER** and **CUSTOMER** segmented keys as alphanumeric one-segment keys. + Import the records with their IDs unchanged. + In the [Number series (CS201010)](/visma-net-erp/help/common-settings/common-settings-windows/number-series-cs201010/) window, assign appropriate numbering sequences to the **SUPPLIER** and **CUSTOMER** segmented keys with the appropriately adjusted last-used numbers (equal to the largest number used in the imported data for suppliers and customers, respectively) to assign numeric IDs to new customers and suppliers. When a Visma Net user creates a new supplier or customer account in the standard way in the [Suppliers (AP303000)](/visma-net-erp/help/supplier-ledger/supplier-ledger-windows/suppliers-ap303000/) or [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, some fields are populated automatically with the values provided by the default supplier or customer class or the supplier or customer class the user has selected instead. To use the functionality of classes while you are importing supplier or customer data, before import, analyse the source data and create as many classes as there are groups of customers or suppliers in the source (or source file) that would need accounts, subaccounts, and other common information you can specify among the class settings. When you create classes, take one of the following approaches: + If one group of settings can fit all customers or suppliers, use just one default class. To use default values from the default supplier or customer class, you don't even need to do anything specific, such as mapping the **Supplier class** field or **Customer class** field to any data. + To use default values from a particular class, in the **Field/action name** field of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, you can assign the class to the **Supplier class** field (when you are importing supplier records) or to the **Customer class** field (when you are importing customer records) directly as a literal or assign a class conditionally, by using appropriate formulas that are based on customer or supplier properties. Filling in the class ID field requires a commit to the database and a window refresh. ## General recommendations for importing documents and batches When you are importing batches, supplier ledger documents, or customer ledger documents, consider the following recommendations regarding the mapping: + **Batch or document IDs**: By default, Visma Net automatically generates identifiers for general ledger batches and supplier ledger and customer ledger documents. For example: When importing batches to the [Journal transactions (GL301000)](/visma-net-erp/help/general-ledger/general-ledger-windows/journal-transactions-gl301000/) window, even if you map the **Batch number** field to an external field holding batch IDs, when the record is saved, the original batch ID will be overwritten by an automatically generated ID. If you plan to update the imported batches later, you will not be able to recognise the imported records by their new IDs. To make updating of the imported records possible, you need to save the original ID to another field to be able to recognise the previously imported records. You can use the **Description** field for this purpose. As an alternative to this approach, you can configure manual numbering of batches or documents in the [Number series (CS201010)](/visma-net-erp/help/common-settings/common-settings-windows/number-series-cs201010/) window, import them with their IDs defined in the source, and then configure the system to use auto-numbering again. + **Batch control totals**: When importing batches to the [Journal transactions (GL301000)](/visma-net-erp/help/general-ledger/general-ledger-windows/journal-transactions-gl301000/) window, if you are mapping the **Control total** field, take into account whether the **Validate batch control totals on entry** check box is selected in the [General ledger preferences (GL102000)](/visma-net-erp/help/general-ledger/general-ledger-windows/general-ledger-preferences-gl102000/) window. If it is selected and you map the **Control total** field to the source field, during data import until all batch entries are imported, the system will display the error, indicating that the control total does not match the credit total or debit total. In this case, in the Import scenarios window, select the **Ignore error** check box for the row that maps the **Control total** field to force the system to ignore such errors during the import process. + **Document amounts**: When importing documents to the, if you are mapping the **Amount** field, take into account whether the **Validate document totals on entry** check box is selected in the [Supplier ledger preferences (AP101000)](/visma-net-erp/help/supplier-ledger/supplier-ledger-windows/supplier-ledger-preferences-ap101000/) or [Customer ledger preferences (AR101000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customer-ledger-preferences-ar101000/) window. If it is selected and you map the **Amount** field to the source field, during data import until all document details are imported, the system will display the error, indicating that the document is out of balance. In this case, in the Import scenarios window, select the **Ignore error** check box for the row that maps the **Amount** field to force the system to ignore such errors during the import process. + **Mapping Statuses**: The possible batch and document statuses in the source may be different from those in Visma Net. To manage this discrepancy, you might want to exclude the **Status** field of the applicable window from mapping. In this case, the imported batch or document will get one of the following statuses: + **On hold**, if the **Hold batches on entry** check box is selected in the [General ledger preferences (GL102000)](/visma-net-erp/help/general-ledger/general-ledger-windows/general-ledger-preferences-gl102000/) window or the **Hold documents on entry** selected is selected in the [Customer ledger preferences (AR101000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customer-ledger-preferences-ar101000/) or [Supplier ledger preferences (AP101000)](/visma-net-erp/help/supplier-ledger/supplier-ledger-windows/supplier-ledger-preferences-ap101000/) window + **Open**, if the **Hold batches on entry** or **Hold documents on entry** check box is not selected in the appropriate window ## General recommendations for importing attributes Attributes in Visma Net make it possible for users to specify additional properties (those not already defined in the applicable Visma Net window) of entities, such as stock items and customers. The list of attributes is specified for an entity class, so that entities assigned to different classes may have different sets of attributes. To import data with attributes, you have to create a scenario for each class if the applicable classes have different sets of attributes. In the mapping of the scenario created to import entities of a particular class in the [Schedule import scenarios (SM206035)](/visma-net-erp/help/integration/integration-windows/schedule-import-scenarios-sm206035/) window, you should specify the name of the attribute as the source field for the **Attribute** target field and the value of this attribute as the source field for the **Value** target field. ## Limitations of data import By using import scenarios, you can perform the same commands in the window as you do during manual input, with the following exception: + For the [Purchase invoices (AP301000)](/visma-net-erp/help/supplier-ledger/supplier-ledger-windows/purchase-invoices-ap301000/) window, `` (which corresponds to the **Auto apply** button on the **Applications** tab) does not work because Visma Net does not load applications during data import. Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Types of target fields in import scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/types-of-target-fields-in-import-scenarios page You perform mapping of an import scenario in the Mapping tab of the Manage import scenarios (SM206025) window. 2026-02-19T17:09:06+01:00 # Types of target fields in import scenarios You perform mapping of an import scenario in the Mapping tab of the Manage import scenarios (SM206025) window. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). You perform mapping of an import scenario in the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. For each target field on an Visma Net window, you need to know the type of the target field and be sure the source field values have the appropriate format for the type, so that the system can insert the value of the field correctly. The type of the target field, which depends in the type of UI element that represents it in the window to which you are importing data, might be a field of several types, a date picker, a check box, a drop-down list, a radio button, or an action or menu in the toolbar. Also, the target field might be on a dialog box or pop-up panel rather than in the window itself. In most cases, it is clear which format of the value you need for the mapping. However, if you are not sure which format of the value you need, you can create one record manually in Visma Net, specify the needed value of a field of this record, compose an export scenario, and export the value of this field. Make sure the export scenario has output the value in the appropriate format. ## Fields with text The target field in the Visma Net window may be afield into which a user types text. For example: The **Email** field in the **General settings** tab of the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window is a field in which the user types an e-mail address. A field can have a mask, which is denoted by the (_) symbol. If the field has a mask, you cannot insert the underscore symbol (_) because this symbol is reserved for masked input in the system. If the field has no mask, you can insert any characters into the field, including any letters and symbols. The length of the string that you insert into a field should not exceed the maximum length of the underlying target element. (To check the maximum length, find the maximum string that can be manually inserted into the field in the window.) For some fields, you can type text in multiple languages. To import the values of a text box in multiple languages, you should specify a string in JSON format that contains values in the needed languages. ## Fields with currency amount The target field in the Visma Net window may be a field that holds a currency amount. For example: The **Amount** field in the top part of the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window is a field with a currency amount. You have to provide currency amounts in the format that you specified for the import scenario in the **Format locale** field in the top part of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. For example: If you specified the English (United States) locale for a import scenario, you have to provide amounts where the decimal part is separated by a decimal point: **12.34**. By default, Visma Net imports currency amounts with a decimal precision of 2, which is specified in the **Decimal precision** field in the [Branches (CS102000)](/visma-net-erp/help/organisation-structure/organisation-structure-windows/branches-cs102000/) window. When you import the currency amounts of supplier ledger or customer ledger documents, make sure that the sum of imported lines is equal the imported document total, taking into account the rounding accuracy as follows: + The decimal precision of line amounts must be equal to the decimal precision of document total. + The decimal precision of all amounts must be less than or equal to the decimal precision that is specified in Visma Net. For example: If the decimal precision in Visma Net is 2 and you import an amount with a decimal precision of 3, such as **10.345**, the imported value will be rounded by arithmetical rules to **10.35**. If you import data from an Excel file, you can use the **Round(x,y)** function to round the amounts, and then you can copy the values to a column from which you will import data. ## Fields with a key value The target field in the Visma Net window may be a field that holds a key value. Two examples of key fields are **Customer no.** in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, and **Reference no.** in the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window. The way you specify the value for key fields depends on your goal and the auto-numbering settings of the records that you are importing. ## Date picker The target field in the Visma Net window may be a date picker that is used to select the date. For example: The **Date** element in the top part of the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window is a date picker. You have to provide date values in the format that you specified for the import scenario in the **Format locale** field in the top part of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. For example: If you specified the English (United States) locale for the import scenario, you have to provide dates in the format **DD/MM/YYYY**. Thus, September 1, 2014 will be **01/09/2014**. ## Check box The target field in the Visma Net window may be a check box the user can select or clear. For example: The **Hold** element in the top part of the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window is a check box. To select a check box, map the corresponding target field to the value **True**. To clear a check box, map the target field to the value **False**. ## Drop-down list The target field in the Visma Net window may be a drop-down list from which the user selects an option. For example: The **Type** element in the top part of the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window is a drop-down list. To insert a value into a drop-down list, you have to specify the value as it is displayed in the list. For example: In the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window, you can insert the value **Invoice** into the **Type** field. ## Radio buttons The target field in the Visma Net window may be a group of radio buttons. For example: A group of radio buttons is in the **Additional processing** group of the **Settings for Supplier ledger** tab of the [Payment methods (CA204000)](/visma-net-erp/help/cash-management/cash-management-windows/payment-methods-ca204000/) window. In the system, a group of radio buttons is treated as one field, which can have as the values the names of the radio buttons. Therefore, to select a radio button by using an import scenario, you should select the name of the group that contains the radio button in the **Field / action name** column of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, and specify the name of the radio button in the **Source field / value** column. ## Buttons and menu items in the toolbar The action in the Visma Net window may be a button or menu item in the toolbar. For example: The **Release** button is on the toolbar of the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window. To reflect a user clicking a button in the scenario mapping, you have to insert the corresponding action in the proper position in the mapping, and you don't have to map the action to any value. ## Dialog box The target field may be on a dialog box invoked by a user action on the Visma Net window. Dialog boxes usually appear in a window to request confirmation from the user. For example: When you update the **Customer class** value in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window for an existing customer, the system displays a **Warning** dialog box. ## Pop-up panel The target field may be on a pop-up panel invoked by a user action in the Visma Net window. For example: The **Add sales order** pop-up panel appears when the user clicks **Add order** on the **Document details** tab of the [Shipments - reference information](/visma-net-erp/help/sales/sales-windows/shipments-so302000/) window. In a similar way as you specify values for fields in windows and invoke actions, you can specify values and click buttons in pop-up panels that users can invoke. Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Fields with commit in import and export scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/fields-with-commit-in-import-and-export-scenarios page There are two types of fields in Visma Net windows: fields with commit, and fields without commit. 2026-02-19T17:09:06+01:00 # Fields with commit in import and export scenarios There are two types of fields in Visma Net windows: fields with commit, and fields without commit. There are two types of fields in Visma Net windows: fields with commit, and fields without commit. A commit is an action initiated by the window that, when triggered, sends the data to the server. On the server, the commit causes all data in the window to be updated, including the insertion of default values and the recalculation of appropriate fields in the window. A commit is a costly operation that causes the browser to make requests to the server and takes server time. As such, a commit is invoked for only a limited number of fields: mainly the key fields and the fields on which the other fields depend. On the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window or the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window, if you select a field for which the system performs a commit, the system automatically selects the **Commit** check box. If the **Commit** check box is cleared on this tab, the field is filled in with data, but no update of the window is invoked. If the **Commit** check box is selected, after the field is filled in, the commit is invoked on the server and the window is updated. For example: When you select a customer in the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window, the system assigns values to fields related to customer settings, such as the customer terms, due date, and cash discount date. When you create an import scenario for this window, for fields such as **Customer**, the system automatically selects the **Commit** check box on the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. In most cases, when you compose the mapping of an import or export scenario, you can use the **Commit** check boxes as they are set by default. However, you may need to force the system to invoke a commit to the server, for example, when you need to commit the value of one field before entering another field value, or to indicate the beginning and the end of a record if you enter records without specifying the key field value. In such cases, you should manually select the **Commit** check box for the field or action. Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Service commands in Import and export scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/service-commands-in-import-and-export-scenarios page For key fields and the first field that has a commit among the fields of a detail table, the system adds service commands on the Mapping tab of the scenario you are creating in the Manage import scenarios (SM206025) window or the Manage export scenarios (SM207025) window. 2026-02-19T17:09:06+01:00 # Service commands in Import and export scenarios For key fields and the first field that has a commit among the fields of a detail table, the system adds service commands on the Mapping tab of the scenario you are creating in the Manage import scenarios (SM206025) window or the Manage export scenarios (SM207025) window. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/), [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). For key fields and the first field that has a commit among the fields of a detail table, the system adds **service commands** on the **Mapping** tab of the scenario you are creating in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window or the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window. Service commands are commands that invoke hidden actions in the system, such as searching for the record by the key field, refreshing the window, and adding a new line to the detail table. The system automatically adds service commands to the scenario immediately before the commands that invoke them. For example: Suppose that in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, you are mapping the **Type** field of the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window. The system automatically inserts a set of service commands before the mapping of the **Type** field: The `` and `` commands invoke search by the key fields, and the `` command restores the default settings for the selected document type. In the table toolbar of the **Mapping** tab of the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window or the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, by default, the **Show all commands** option is selected in the drop-down list, which means that you can view the service commands that the system automatically adds to the import scenario. You can replace service commands with your own commands to change the default behaviour of the system. For example: If you map the first field that has a commit among the fields of a detail table, the system adds the `=-1` service command. That means that a new row is added for each new detail line. You can specify the needed line number in the `` command to modify the value of the previously imported detail line. Line numbering starts with 0. If you search for a detail line by a custom key, you have to delete the instruction that sets the `` to -1 from the mapping so that the system does not add a new detail line but instead searches for a detail line. Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Pop-up dialog boxes in import scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/pop-up-dialog-boxes-in-import-scenarios page When you update specific fields in some windows under certain circumstances, the system displays pop-up dialog boxes where you need to specify an answer (by clicking a button) to a question in order to proceed. 2026-02-19T17:09:06+01:00 # Pop-up dialog boxes in import scenarios When you update specific fields in some windows under certain circumstances, the system displays pop-up dialog boxes where you need to specify an answer (by clicking a button) to a question in order to proceed. When you update specific fields in some windows under certain circumstances, the system displays pop-up dialog boxes where you need to specify an answer (by clicking a button) to a question in order to proceed. For example, when you update the **Customer class** value in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window for an existing customer, the system displays a **Warning** dialog box with the text **Please confirm if you want to update current customer settings with the customer class defaults. Otherwise, original settings will be preserved.** and the **Yes** and **No** buttons. You should click **Yes** to proceed with changing the customer class. When you are specifying mapping for an import scenario, when you need to specify an answer to a question that would appear in a pop-up dialog box if the data was being entered manually, you should use a dialog answer command (which has the `` name) of the Summary object. You should insert this command directly before you map the field that causes the appearance of the dialog box. For the dialog answer, you should select the proper answer from the options available in the **Source field/value** drop-down list on the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. The system selects the **Commit** check box for the dialog answer command automatically. In most cases, you can select the summary object as the target object of the dialog answer command, because the dialog answer is shared between all objects of an Visma Net window. You may need to select another object as the target object of the dialog answer command, if you need to overwrite the answer that is specified by the dialog answer command of the Summary object. Below are the settings in the two rows you would enter on the **Mapping** tab to update the customer class of an existing customer record. The first row contains the instruction to click **Yes** in the confirmation dialog box. |**Target object**|**Field/action name**|**Source field/value**| |---|---|---| |**Customer summary**|**<Dialog answer>**|**='Yes'**| |**General settings -> Financial settings**|**Customer class**|**CUSTOMER CLASS**| **Parent topic:** [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Actions in import scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/actions-in-import-scenarios page As you perform mapping for an import scenario in the Manage import scenarios (SM206025) window, when you need to reflect a button being clicked in a window (such as Save, Delete, or Release to perform one of these actions on a document), you should use the corresponding action. 2026-02-19T17:09:06+01:00 # Actions in import scenarios As you perform mapping for an import scenario in the Manage import scenarios (SM206025) window, when you need to reflect a button being clicked in a window (such as Save, Delete, or Release to perform one of these actions on a document), you should use the corresponding action. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/). As you perform mapping for an import scenario in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, when you need to reflect a button being clicked in a window (such as **Save**, **Delete**, or **Release** to perform one of these actions on a document), you should use the corresponding action. Actions are available for all buttons in a window. In import scenario mapping, to use an action, you always have to select the summary object as the target object. No matter where the button that corresponds to the action appears in the window (on the top part, the toolbar of a tab, or a pop-up panel), all actions use the summary object as the target object. Action names have the `Action:` prefix and are surrounded with angle brackets, for example, `` or ``. For an action, you should not select any external field in the **Source field/value** column of the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. Key fields and search in import scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/key-fields-and-search-in-import-scenarios page In the mapping of an import scenario, you have to map the key fields first, mapping the target key fields in the system to the source key fields. 2026-02-19T17:09:06+01:00 # Key fields and search in import scenarios In the mapping of an import scenario, you have to map the key fields first, mapping the target key fields in the system to the source key fields. In the mapping of an import scenario, you have to map the key fields first, mapping the target key fields in the system to the source key fields. The system uses the following keys: **Customer number** for customers in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window, and **Type** and **Reference no.** for documents in multiple windows, such as the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window. The order of key fields is important for mapping, so you should follow the order of key fields as they are displayed in Visma Net windows. In particular, for documents, you have to assign first the **Type** field and then the **Reference no.** field. ## Auto-numbering of records You can import records with their key values from the source, and the records will have the same key values in the system and the source. For example: Suppose you are importing records to the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window. If you have the customer **CUST000001** in the Excel file, you can import this customer to the system so that the customer record will have the same ID: **CUST000001**. Later, you can update customer records by mapping the Excel column with the ID to the **Customer number** field in the system. As an alternative to importing records with their key values from the source, you can import records and have the system automatically assign IDs. For example, you can import the customer records so that after the import, the customer will have an automatically assigned ID in the system that was not in the Excel file, such as **C000000001**. You can import master records with automatically assigned IDs in several ways, which are described below: + You can enable auto-numbering of records in the system and map the key fields to unique identifiers of records in the source. + If there is just one line for each unique record in the data source, you can enable auto-numbering of records in the system and import each line from the source file as an unique record in the system with an automatically assigned ID. With this way of mapping, you do not map key fields in the import scenario and add the <Action: Insert> instruction at the beginning of the mapping. + You can map the key field to a formula that produces unique identifiers for each imported record in the needed format. Auto-numbering of master records is configured in the corresponding segmented keys in the [Segment keys (CS202000)](/visma-net-erp/help/common-settings/common-settings-windows/segment-keys-cs202000/) window. Documents are usually automatically assigned a reference number in the system. During the initial implementation, you can disable auto-numbering of documents in the system, import the documents with their IDs, and then turn on auto-numbering starting from the last imported ID. Auto-numbering of documents is configured in the numbering sequences that are specified for the corresponding document types in workspace preferences. For example: The **ARINVOICE** sequence is specified for the auto-numbering of invoices in the [Customer ledger preferences (AR101000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customer-ledger-preferences-ar101000/) window. You can update records imported with automatically generated IDs by searching for them in the system by using their unique fields available the source. For example: You can identify customers by email addresses or phone numbers in the Excel file. To search for a record, you have to declare a custom key or use a column of a **Select** dialog box. Both of these methods are described below. ## Custom key To specify a custom key, you have to define the key by using the `@@` notation; directly after the notation, assign the custom key field a value. On the **Mapping** tab of the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, you should select the **Commit** check box for this field to make the system update the form after the key is specified. Below is an example of the settings for a mapping instruction that declares the **Customer name** as the custom key for customer records you are importing to the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window. In this example, we suppose that the Excel file doesn't contain the customer number, and you are using the **CUSTOMER NAME**value from the Excel file to find the customer record in the system. > ### Custom key mapping > > |**Target object**|**Field/action name**|**Native Field / Action Name**|**Commit**|**Source Field / Value**| > |---|---|---|---|---| > |**Customer summary**|@@AcctName|@@AcctName||=[BAccount.AcctName]| > |**Customer summary**|**Customer name**|AcctName|Selected|**CUSTOMER NAME**| You can specify custom keys to search for a record or a detail line. You can use the fields of the summary object and the detail objects, but not the fields of related objects, as custom key fields. For example: You can find the needed customer record in the system by using the **Customer name** field of the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window as the custom key, but you cannot find the record by using the **Email** field of the **Main contact** group of the **General settings** tab as the custom key. ## Selector column Selector columns in an Visma Net window appear when a user clicks the magnifier icon of a key field of the form to bring up the **Select** dialog box. When you are performing mapping for an import scenario, you can use any selector columns that are available in the window for the key field. To use a selector column for a search in an import scenario, you have to map the selector column to the matching external field. Selector column names start with the key field name, followed by `->` and then the name of the selector column in the window, such as `Customer ID -> Email`. For example: The instruction with the following settings maps the **Email** selector column of the **Customer number** field in the [Customers (AR303000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/customers-ar303000/) window to the EMAIL field available in the source. > ### Selector command mapping > > |**Target object**|**Field/action name**|**Source field/value**| > |---|---|---| > |**Customer summary**|**Customer ID -> E-mail**|**E-MAIL**| Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Export of all records: use of every /visma-net-erp/help/integration/configuring-scenario-mapping/export-of-all-records-use-of-every page If you want to export every record of a specific type, on the Mapping tab of the Manage export scenarios (SM207025) window, you map the key field to the =Every system action. 2026-02-19T17:09:06+01:00 # Export of all records: use of every If you want to export every record of a specific type, on the Mapping tab of the Manage export scenarios (SM207025) window, you map the key field to the =Every system action. For more information: [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). If you want to export every record of a specific type, on the **Mapping** tab of the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window, you map the key field to the `=Every` system action. (The **Commit** check box is selected automatically for this field.) This action ensures that every record of the specific type will be processed during export. For example: If you want to export all customer records available in the system, you should map the **Customer no.** field to `=Every`. The **Commit** check box is selected automatically for this field. If you need the value of the **Customer no.** field in the output destination, you should also map this field to the appropriate external field. The example below shows the mapping that makes the system export all customer records available in the system and export the **Customer no.** field to the target **CUSTOMER ID** field. > ## Usage of the = Every instruction > > |**Source object**|**Field/action name**|**Target field/value**| > |---|---|---| > |**Customer summary**|**Customer ID**|**=Every**| > |**Customer summary**|**Customer ID**|**CUSTOMER ID**| Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Data modification during export: use of commit and actions /visma-net-erp/help/integration/configuring-scenario-mapping/data-modification-during-export-use-of-commit-and-actions page You can change the values of some fields or apply an action to a record during export. 2026-02-19T17:09:06+01:00 # Data modification during export: use of commit and actions You can change the values of some fields or apply an action to a record during export. You can change the values of some fields or apply an action to a record during export. For example: You can change a description field of a record or delete a record as you are exporting it. ## Changing the value of a field If you need to change the values of some fields during export, you must perform a commit of these fields to the server. That is, on the **Mapping** tab of the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window, you must select the **Commit** check box for each internal field whose data is modified. If you change the values of some fields during export, you also need to insert the `` command at the end of the scenario to save the changes to Visma Net. If you specified specific field values on the form during export only in order to select the data for exporting, however, you don't need to insert the `` command at the end of the scenario. If you configured the scenario to change the values of some fields in Visma Net, the system prepares the specified records in the source and tries to apply modifications to them during the preparation process. (If modification of the specified field is not allowed in the system, the field remains unchanged.) Then the system exports all prepared records to the external system. For example, suppose that you create a scenario that exports customer ledger invoices from the window and adds the string **Exported on 05.10.2020** to their descriptions in Visma Net. As a result of the processing of this scenario, all invoices are exported, and only the invoices with the **Balanced** and **On hold** statuses are modified. Modification of documents with other statuses is not allowed in the system, so these documents are exported without any change to their descriptions in Visma Net. ## Applying an action As you perform mapping for an export scenario, when you need to reflect the clicking of a button in a window, you should use the corresponding action. You can use the same actions in export scenarios as in import scenarios. If you are going to delete records or apply another action to records by using an export scenario, you have to specify precise source restrictions that select only those records that can be processed; otherwise, no records will be processed. For example: Suppose that you want to delete customer ledger invoices that have **X** as the value of the **Project** element in the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window. To select only invoices that can be deleted, in the source restrictions of the export scenario, you have to specify not only the condition **Project = X** but also the condition **Status = On hold or Status = Balanced**. If you do not specify filtering by status and there are invoices with the **Open** status in the system, no records will be deleted. Multi-language fields in import and export scenarios /visma-net-erp/help/integration/configuring-scenario-mapping/multi-language-fields-in-import-and-export-scenarios page For some text boxes in Visma Net windows, users can type values in multiple languages if multiple locales are configured in Visma Net. 2026-02-19T17:09:06+01:00 # Multi-language fields in import and export scenarios For some text boxes in Visma Net windows, users can type values in multiple languages if multiple locales are configured in Visma Net. For some text boxes in Visma Net windows, users can type values in multiple languages if multiple locales are configured in Visma Net. For example: If your Visma Net instance has English and French locales activated and multilingual user input configured, you can specify the value of the **Description** field in the [Stock items (IN202500)](/visma-net-erp/help/inventory/inventory-windows/stock-items-in202500/) window in English and French. ## Import of localised field values As you perform mapping for an import scenario in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, when you need to import localised values of a field, you map this field to a source field that contains a string in JSON format with the localised values. In this string, you use the two-letter ISO code of the language with which the value should be associated. In the example that is mentioned at the beginning of the topic, if you need to import the values in English and French to the **Description** element of stock item records in the [Stock items (IN202500)](/visma-net-erp/help/inventory/inventory-windows/stock-items-in202500/) window, you map the **Description** field to a source field that contains data in the following format: `[{en:English description},{fr:French description}]`. The mapping example below presumes that the **DescriptionsInJSONFormat** source field contains a string in JSON format. > ### Import of localised field values > > |**Target object**|**Field/action name**|**Source field/value**| > |---|---|---| > |**Stock item summary**|**Description**|**DescriptionsInJSONFormat**| In the JSON-formatted string, you should specify the actual values of the field in all languages that are configured for multilingual user input. If you specify the values of the field in particular languages, the values of the field in other languages configured for multilingual user input become empty. For example: Suppose that in your instance of Visma Net, multi-language fields can have values in English and French. If you pass the value of a field in the following format `[{en:English description}]`, the French value of the field becomes empty. If a source field that you map to a multi-language field contains plain text, this text is saved as the value of the field in the current language of Visma Net (that is, the language that you selected on the login page of Visma Net ). ## Export of localised field values Each text field that supports multiple input languages has a corresponding field with the suffix **Translations** in its native name. This corresponding field contains all localised values of the text field. For example: The **Description** field in the [Stock items (IN202500)](/visma-net-erp/help/inventory/inventory-windows/stock-items-in202500/) window corresponds to the field with native name **Descr**. The **Descr** field has the **DescrTranslations** corresponding field, which contains the localised descriptions of a stock item. If you want to export localised values of a text field, on the **Mapping** tab of the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window, you map the needed **Translations** field, which contains localised values, to a target field. The **Translations** fields are not available in the list of fields in the **Field/action name** column on the **Mapping** tab; you should type the needed name manually. For example: Suppose that you need to export the localised values of the **Description** element of the [Stock items (IN202500)](/visma-net-erp/help/inventory/inventory-windows/stock-items-in202500/) window. You should find out the native name of the **Description** field, which is **Descr**, and map the **DescrTranslations** field to the target field, as shown in the following mapping example. To find out the native name of a field, in the title bar of the target Visma Net window, click **Customisation** - **Inspect element**, and then click the target element in the window. In the **Element properties** dialog box, which opens, find the value of the **Data field** element, which is the native name of the field. > ### Export of localised field values > > |Source object|Field/Action Name|Target field/value| > |---|---|---| > |**Stock Item Summary**|**DescrTranslations**|**DESCRIPTION**| As a result of the export of localised field values, the target field contains a string in JSON format with the available localised values of the field. The language to which the value belongs is identified by the two-letter ISO code of the language. For example: Suppose that the **Description** element of the [Stock items (IN202500)](/visma-net-erp/help/inventory/inventory-windows/stock-items-in202500/) window has value **Item** in English and **Pièce** in French. In this case, the target field contains the following string: `[{en:Item},{fr:Pièce}]`. Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Formulas in the mapping /visma-net-erp/help/integration/configuring-scenario-mapping/formulas-in-the-mapping page If you need to convert data into a different format during data import or export, you can map an internal field to a formula. 2026-02-19T17:09:06+01:00 # Formulas in the mapping If you need to convert data into a different format during data import or export, you can map an internal field to a formula. If you need to convert data into a different format during data import or export, you can map an internal field to a formula. You can define formulas by using the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) or [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window. ## Components of a formula A formula can include the following components: + **Digital and text literals**: Literals are constants within the formula that you don't want to be modified: + Type digital literals as they are, such as 2, 8.25, or 13.84. + Enclose text literals within single quotation marks, for example, 'DEF_CLASS' and 'FOB'. + **Operators**: The following types of operators are available: + Arithmetic operators take numerical values and return a numerical value. + Logical operators evaluate one or two Boolean expressions and return a Boolean result. + Comparison operators compare two expressions and return a Boolean value that represents the result. + **Functions**: Functions, which perform specific tasks and return results, include the following types: + Text functions perform operations on text strings. + Math functions perform calculations. + Conversion functions convert data from one type to another. + Date/time functions perform functions related to the date, the time, or both. + **Fields**: External or internal fields (elements) can be used in a formula as operands or function arguments. ## Assigning a formula To assign a formula to a field, do the following in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) or [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window: 1. Click the pen icon in the field where you want to insert a formula. This invokes the Formula editor dialog box, which can be used to create the formula you want. 1. Click any of the types in the Component types area (on the upper left of the dialog box) to open the list of related components in the right area. 1. Double-click a component from the list of components. Note that all components are added to the right of the formula text. 1. Repeat Steps 2–3 to add all the needed components. 1. In the Formula text area (at the bottom of the dialog box), manually edit the text to construct a correct formula: Move the function argument or arguments within a function's parentheses, correctly arrange operands and operations, and add any needed brackets to ensure the proper order of operations. 1. Click **Validate** to check the syntax of the formula and make necessary corrections if required. 1. Click **OK** to save the formula. Once it's inserted, a formula is preceded by an equal sign (=). ## Formulas in export scenarios When you map the data in Visma Net to the external fields, you will usually need field-to-field mapping. In some cases, however, you may need to add values from multiple internal fields to export the resulting value to an external one, to extract only a part of the internal field's value, or to perform another transformation or conversion for the data to be exported. If you map an internal field to a formula instead of an external field, the resulting value will be assigned back to the Visma Net field. This functionality can be used, for example, to set criteria on inquiry forms to export only filtered data or to mark exported records as exported. ## Formulas in import scenarios When you map Visma Net fields to the external data, you will usually need field-to-field mapping. For some fields, however, you may need to add values from multiple external fields to an internal one, to extract only a part of the external field's value, or to perform another transformation or conversion. As you map an Visma Net field to the external data, the system checks the functionality of the mapped field and automatically adds, if necessary, a line that contains the system action (hidden by default) required for the field, such as a refresh of the window or a commit to the database. ## Formula examples Here are some examples illustrating the use of formulas: + This formula is used for assigning a literal: `ClassID ='Imported suppliers'`. + This formula assigns a concatenated string: `SupplierID = 'X'+[SupplierID]`. + This formula is used for assigning a value to a check box: `IsAddressSameAsMain = true`. + If the internal field is required, it's important to check that the field value is not blank. To do this, use the `Iif(str, truestatement, falsestatement)` function, as in the following example: `CountryID =iif(trim[Country]='','US',[Country])`. Then the internal field will get the `US` value if the external field is blank. + If the customer numbers from the source cannot be used in your implementation, create new IDs for them. For example: In the demo data, customer and supplier IDs are short versions (up to 15 characters) of their names converted to uppercase. To do this, remove any spaces from the name by using the `trim(arg)` function, convert it to uppercase with the `UCase(arg)` function, and remove any characters in excess of 10 by using the `Left(arg)` function: `Customer ID =Left( trim(UCase([Name])),10)`. Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/)

Related pages

Concepts

Operators /visma-net-erp/help/integration/configuring-scenario-mapping/operators page Operators are used in formulas that you create in the Formula editor dialog box, which is called from the Manage import scenarios (SM206025) or Manage export scenarios (SM207025) windows. 2026-02-19T17:09:06+01:00 # Operators Operators are used in formulas that you create in the Formula editor dialog box, which is called from the Manage import scenarios (SM206025) or Manage export scenarios (SM207025) windows. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/), [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). To add operators to the formula, you can enter them directly in the Formula text area of the dialog box or select them from the list of formula components available within the dialog box. (Select an operator type to view the list of operators of the type, and then select an operator.) To specify the operands for operators, you can type them in the Formula text area or select them from the list of external or internal fields provided within the Formula editor dialog box. This article describes and provides examples of the operators you can use in formulas, broken down by operator type. ## Overview of operators There are two types of operators: unary and binary. Unary operators are applicable to only one operand, while binary operators require two operands. In general, expressions are evaluated from left to right with the following order of precedence: + Logical operators: `Not`, `And`, `Or` + Comparison operators: =, <>,, <=, >= + Arithmetic operators: -, \*, /, `Mod`, +, - ## Arithmetic operators Arithmetic operators, which are listed below, take numerical values as their operands and return a single numerical value.
Operator Description and example

Adds the two operands and returns the result. If at least one operand is a string, this operator returns a concatenated string.

Example: =[Amount]+[VAT amount]

In this example, the [Amount] and [VAT amount] values are used as operands.

Subtracts the second operand from the first.

Example: =[Amount]-[Cash discount]

In this example, the [Amount] and [Cash discount] values act as operands.

Multiplies the two operands.

Example: =[Chargeable amount]*0.03

In this example, the [Chargeable Amount] value and the number 0.03 serve as operands.

/

Yields the quotient of the operands, which is the first operand divided by the second.

Example: =[Amount]/[Rate reciprocal]

In this example, the [Amount] and [Rate reciprocal] values are the first and second operands.

Mod (Modulus)

Divides the first integer operand by the second integer operand and returns the remainder, rounded to the nearest integer.

Example: =[Volume] Mod [Conversion factor]

In this example, the [Volume] and [Conversion factor] values are used as operands.

## Logical operators Logical operators evaluate one or two Boolean expressions and return a Boolean result (`True` or `False`). Because these operators evaluate only Boolean expressions, you must use elements whose only values are `True` and `False` (typically check boxes and radio buttons). The logical operators are listed below.
Operator Description and example
And

Performs logical conjunction on two Boolean expressions: returns True if and only if both expressions evaluate to True; in other cases, returns False.

Example: =[Hold] And [Validate control totals on entry]

In this example, the [Hold] and [Validate control totals on entry] check boxes are used as operands.

Or

Performs logical disjunction on two Boolean expressions: returns True if at least one expression evaluates to True; returns False if neither expression evaluates to True.

Example: =[Hold] Or [Validate control totals on entry] In this example, the [Hold] and [Validate control totals on entry] check boxes act as operands.

Not

Performs logical negation on a Boolean expression: returns True if and only if the operand is False. Logical negation is an unary operator.

Example: =Not [Hold documents on entry]

In this example, the [Hold documents on entry] check box is used as the single operand.

## Comparison operators Comparison operators compare two expressions and return a Boolean value (`True` or `False`) that represents the result of the comparison. This group of operators includes the following operators.
Operator Description and example
=

Returns True if operands are equal.

Example: =([Credit total] = [Control total])

In this example, the [Credit total] and [Control total] values are used as operands.

<>

Returns True if operands are not equal.

Example: =([Credit total] <> [Debit total])

In this example, the [Credit total] and [Debit total] values act as operands.

<

Returns True if the first operand is less than the second one.

Example: =([DocDate] < [DueDate])

In this example, the [DocDate] and [DueDate] values act as operands.

>

Returns True if the first operand is greater than the second one.

Example: =([CrLmt] > 1000])

In this example, the [CrLmt] value is used as the first operand, and the number 1000 acts as the second operand.

<=

Returns True if the first operand is less than or equal to the second operand.

Example: =(([DueDate]-[CashDiscountDate]) <= [LeadTime])

In this example, [DueDate] - [CashDiscountDate] is the first operand, and the [LeadTime] value is used as the second operand.

>=

Returns True if the first operand is greater than or equal to the second operand.

Example: =([Balance] => [Amount])

In this example, the [Balance] and [Amount] values are used as operands.

## Other operators This miscellaneous group of operators includes the following operators and constants.
Operator Description and example
In

An operator that returns True if the second operand (a string) contains the first operand (which is also a string).

Example: =('Inc.' In [Supplier name])

In this example, the [Supplier name] value is used as an operand, and the formula returns True if the name of the supplier contains Inc.

True

A binary constant used as an operand in logical expressions.

Example: =True

False

A binary constant used as an operand in logical expressions.

Example: =False

Null

A special value used as an operand in logical expressions; designates an undefined value.

Example: =Null

Parent topic: [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/) Related reference Formula editor dialog box [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/)

Related pages

Concepts

Functions /visma-net-erp/help/integration/configuring-scenario-mapping/functions page Functions are used in formulas that you create on the Formula editor dialog box, which you can invoke from the Manage import scenarios (SM206025) or Manage export scenarios (SM207025) windows. 2026-02-19T17:09:06+01:00 # Functions Functions are used in formulas that you create on the Formula editor dialog box, which you can invoke from the Manage import scenarios (SM206025) or Manage export scenarios (SM207025) windows. For more information: [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/), [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/). To add functions to a formula, you can type them in the Formula text area of the dialog box or select them from the list of formula components available within the dialog box. (Select a function type to view the list of functions of the type, and then select a function.) This topic describes and provides examples of the functions you can use in formulas, broken down by type. ## Conversion functions The available conversion functions, which are used to convert data from one data type to another, are listed below.
Function Description and example
CBool(x)

Converts the expression used as the function argument into a Boolean expression. Returns False if the Boolean value is zero; otherwise, returns True.

Example: =CBool([CashDiscountAmount]

Here [CashDiscountAmount] is used as the function argument.

CDate(x)

Converts the expression used as the function argument into a value of the Date type. The argument should be a valid date expression according to the locale selected for the import or export scenario.

Example: =CDate('24/12/2011')

Here a string is used as the function argument.

CStr(x)

Converts the expression used as the function argument into a string. If the argument is Null, the function returns a run-time error; otherwise, it returns a string.

Example: ='(' +CStr([AreaCode])+')'+CStr([Phone])

Here [AreaCode] and [Phone] are used in the function argument.

CDbl(x)

Converts the expression defined in the function argument into a value of the Double type.

Example: =CDbl(1.0/[ExchangeRate])

Here [ExchangeRate] is used in the function argument.

CSng(x)

Converts the expression used as the function argument into a value of the Single type. If the expression has a value outside the acceptable range for the Single type, this function returns an error.

Example: =CSng([CashDiscountAmount]/[DocAmount])

Here [CashDiscountAmount] and [DocAmount] are used in the function argument.

CDec(x)

Converts the expression used as the function argument into a value of the Decimal type.

Example: =CDec([DocAmount]*0.015)

Here [DocAmount] is used in the function argument.

CInt(x)

Converts the expression used as the function argument into a value of the Integer type.

Example: =CInt('2012')-Year([DocDate])

Here [DocDate] is used in the function argument.

CShort(x)

Converts a numeric value to a value of the Short type.

Example: =CShort([CashDiscountAmount])

Here [CashDiscountAmount] is used as the function argument.

CLong(x)

Converts a numeric value to a value of the Long type.

Example: =CLong([CashDiscountAmount])

Here [CashDiscountAmount] is used as the function argument.

## Text functions Text functions are used to perform operations on text strings. The group of text functions includes the functions described below.
Function Description and example
LTrim(string)

Removes all leading spaces or parsing characters from the specified string, or all leading zero bytes (0) from the specified binary expression.

Example: =LTrim(CStr([Phone]))

Here [Phone] is used as the function argument.

RTrim(string)

Removes all trailing spaces or parsing characters from the specified character expression, or all trailing zero (0) bytes from the specified binary expression.

Example: =RTrim(CStr([AreaCode]))

Here [AreaCode] is used as the function argument.

Trim(string)

Removes all leading and trailing spaces or parsing characters from the specified character expression, or all trailing zero (0) bytes from the specified binary expression.

Example: =Iif(Trim([Country])

Here [Country] is used in the function argument.

Format(format, argument(s))

Replaces the format item in a specified formatting string ( format ) with the text equivalent of the arguments ( arguments ).

Example: =Format('Currency:........ {0:C}; Account:........ {1:N}', [Currency], [AccountBalance])

Here [Currency] and [AccountBalance] are used in the function argument; 0 and 1 are the specifiers indicating where the arguments will be inserted, C is the currency format specifier, and N is the number format specifier.

UCase(string)

Returns a string that has been converted to uppercase. The string argument can be any valid string expression. If string contains Null, Null is returned.

Example: =UCase([CustomerName])

Here [CustomerName] is used as the function argument.

LCase(string)

Returns a string that has been converted to lowercase. The string argument can be any valid string expression. If string contains Null, Null is returned.

Example: =LCase(CStr([CustomerID])

Here [CustomerID] is used in the function argument.

InStr(string, findString)

Returns the position of the first occurrence of one string ( findString ) within another ( string ).

Example: =InStr([CustomerName], 'Inc')

Here [CustomerName] is used in the function argument.

InStrRev(string, findString)

Returns the position of the last occurrence of one string ( findString ) within another ( string ).

Example: =InStrRev([CustomerName], 'Inc')

Here [CustomerName] is used in the function argument.

Len(string)

Returns an integer containing either the number of characters in the string or the nominal number of bytes required to store a variable.

Example: =Len([CustomerName])

Here [CustomerName] is used as the function argument.

Left(string, length)

Returns a string containing the specified number of characters from the left side of a string. If string contains Null, Null is returned.

Example: =Left(Trim([VendorName]), 10)

Here [VendorName] is used in the function argument.

Right(string, length)

Returns a string containing a specified number of characters from the right side of a string. If string contains Null, Null is returned.

Example: =Right(CustomerName, 3)

Here [CustomerName] is used in the function argument.

Replace(string, oldValue, newValue)

Returns a string in which the specified substring ( oldValue ) has been replaced with another substring ( newValue ).

Example: =Replace([Description], 'rur', 'eur')

Here [Description] is used in the function argument.

PadLeft(string, width, paddingChar)

Right-aligns the characters in a specified string (string), padding with the specified character (paddingChar) on the left up to the specified total width (width). If the actual length of the string is less than the specified width, returns the original string.

Example: =PadLeft(CStr(Phone), 12, '_')

Here [Phone] is used in the function argument. If the actual length of the string is less than the specified width, returns the original string.

PadRight(string, width, paddingChar)

Left-aligns the characters in a specified string ( string ), padding with the specified character ( paddingChar ) on the right up to the specified total width ( width ).

Example: =PadRight(CStr([City]), 25, '_')

Here [City] is used in the function argument. If the actual length of the string is less than the specified width, returns the original string.

## Math functions Mathematical functions, which are listed and described below, perform calculations, usually based on input values provided as arguments, and return numeric values.
Function Description and example
Abs(x)

Returns the absolute value of the number.

Example: =Abs([TotalDebit]-[TotalCredit])

Here [TotalDebit] and [TotalCredit] are used in the function argument.

Floor(x)

Returns the largest integer that is not greater than the argument.

Example: =Floor([Price]/([Cost])

Here [Price] and [Cost] are used in the function argument.

Ceiling(x)

Returns the smallest integer that is not less than the argument.

Example: =Ceiling([Price]/[Cost])

Here [Cost] and [Price] are used in the function argument.

Round(x, decimals)

Returns a numeric expression, rounded to the specified precision ( decimals ).

Example: =Round(([Price]-[Cost])/[Cost], 2)

Here [Cost] and [Price] are used in a function argument, and 2 is the number of decimal places.

Min(x, y)

Returns the smaller of the two values.

Example: =Min([Price],[Cost])

Here [Cost] and [Price] are used in the function argument.

Max(x, y)

Returns the greater of the two values.

Example: =Max({StandardCost],[AvrCost])

Here [StandardCost] and [AvrCost] are used in the function argument.

Pow(x, power)

Computes the value of x raised to the specified power ( power ).

Example: =Pow(([Markup], 2))

Here [Markup] is used in the function argument; the function returns the mark-up value squared (or to the second power).

## Date/time functions The date/time functions, described below, perform operations on system-generated values and return values of the following types: string, numeric, or **Date/time**.
Function Description and example
Now()

Returns the current date and time according to the system date and time on the local computer.

Example: =Now()

Today()

Returns the current date according to the system date and time on the local computer.

Example: =Today()

NowUTC()

Returns the current date and time according to the user’s time zone.

The system gets the user’s time zone from the following sources, which are ordered by the priority from the highest to the lowest:

  1. User’s preferences specified in the User profile (SP203010) window.
  2. The employee calendar specified in the Work calendar (CS209000) window and selected for the user’s employee in the Employees (EP203000) window.

Example: =NowUTC()

TodayUTC()

Returns the current date according to the user’s time zone.

The system gets the user’s time zone from the following sources, which are ordered by the priority from the highest to the lowest:

  1. User’s preferences specified in the User profile (SP203010) window.

  2. The employee calendar specified

1. The employee calendar specified in the Work calendar (CS209000) window and selected for the user's employee in the Employees (EP203000) window.

Example: =TodayUTC()

DateAdd(dt, int, nbr)

Returns a new date calculated by adding the specified number ( nbr ) of time intervals ( int ) to the date ( dt ). The int argument specifies the type of time interval and is one of the following options:

yyyy
A number ( nbr ) of years will be added to the specified date ( dt ).
m
A number ( nbr ) of months will be added to the specified date ( dt ).
y
Same as d; see below.
d
A number ( nbr ) of days will be added to the specified date ( dt ).
h
A number ( nbr ) of hours will be added to the specified date ( dt ).
n
A number ( nbr ) of minutes will be added to the specified date ( dt ).
s
A number ( nbr ) of seconds will be added to the specified date ( dt ).

Examples:

  • =DateAdd([StartPeriod], 'm', 12)
  • =DateAdd([CashDiscountDate], 'd', -2)

In these examples, [CashDiscountDate] and [StartPeriods] are used in the function arguments.

Year(date)

Returns the year, as an integer, extracted from the specified date ( date ).

Example: =Year([StartPeriod])

Here [StartPeriod] is used as the function argument.

Month(date)

Returns the month, as an integer, extracted from the specified date ( date ).

Example: =Month([StartPeriod])

Here [StartPeriod] is used as the function argument.

Day(date)

Returns the day (as an integer) extracted from the specified date ( date ).

Example: =Iif(Day([DueDate]-[LeadTime])=0, True, False

Here [DueDate] and [LeadTime] are used in the function argument.

DayOfWeek(date)

Returns the day of the week associated with the specified date ( date ) as an integer.

Example: =DayOfWeek([StartPeriod])

Here [StartPeriod] is used as the function argument.

DayOfYear(date)

Returns the day of the year calculated for the specified date ( date ).

Example: =DayOfYear([StartPeriod])

Here [StartPeriod] is used as the function argument.

Minute(date)

Returns the number of minutes extracted from the specified date ( date ).

Example: =Minute([StartPeriod])

Here [StartPeriod] is used as the function argument.

Second(date)

Returns the seconds extracted from the specified date ( date ) as an integer.

Example: =Second([StartPeriod])

Here [StartPeriod] is used as the function argument.

## Other functions This miscellaneous group of functions includes the following functions.
Function Description and Example
IIf(expression, truePart, falsePart)

Returns one of two values, depending on the evaluation of the expression: If the expression evaluates to True, the function returns the truePart value; otherwise, it returns the falsePart value.

Example: =IIf(([CurrencyID]='', 'USD', [CurrencyID])

Here [CurrencyID] is used in the function argument.

Switch( expression_1, value_1, expression_2, value_2,…)

Returns the value value_n that corresponds to the first expression expression_n that evaluates to True. expression_1, expression_2, and so on are Boolean expressions.

Example: =Switch(([DocAmount]<100), 'small', (([DocAmount]>=100)And([DocAmount]<500)), 'medium',(([DocAmount]>=500)And([DocAmount]<1000)),'large')

Here [DocAmount] is used in the function argument.

IsNull(value, nullValue)

Replaces NULL with the specified replacement value. The value argument is to be checked for NULL.

Example: =IsNull([CustomerID],'NULL value') Here, [CustomerID] is used in the function argument.

Sum(from, to) Is not applicable to formulas used by the Integration forms.
Provider.CalculateHash(string)

Calculates the hash string for the specified string.

Example: =Provider.CalculateHash([CUSTOMER ID] + [INVOICE REF NBR] + [LINE NBR])

In this example, the hash string is calculated for the string that contains concatenated values of the [CUSTOMER ID], [INVOICE REF NBR], and [LINE NBR] fields.

Provider.CalculateHashCode(string)

Calculates the hash code (which is an Integer value) for the specified string.

Example: =Provider.CalculateHash([CUSTOMER ID] + [INVOICE REF NBR] + [LINE NBR])

In this example, the hash code is calculated for the string that contains concatenated values of the [CUSTOMER ID], [INVOICE REF NBR], and [LINE NBR] fields.

**Parent topic:** [Configuring scenario mapping](/visma-net-erp/help/integration/configuring-scenario-mapping/configuring-scenario-mapping/)
Importing and exporting records by using scenarios /visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios section After you have created an integration scenario, you can use it to transfer data between Visma Net and the external system or file. 2026-02-19T17:09:06+01:00 # Importing and exporting records by using scenarios After you have created an integration scenario, you can use it to transfer data between Visma Net and the external system or file. You import records in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window by using the import scenario you have created. Similarly, you export records in the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window by using the export scenario you have created. In this chapter, you can find a description of standard data import, simplified data import, and data export. Data import /visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/data-import page After you have created an import scenario, you should test it on one record. 2026-02-19T17:09:06+01:00 # Data import After you have created an import scenario, you should test it on one record. After you have created an import scenario, you should test it on one record. If the scenario is not working as you expected, the first way to troubleshoot the scenario is to reproduce the mapping instructions manually on the window to which you want to import the data. In most cases, this troubleshooting step helps you quickly identify the reason why the scenario is not working, so that you can fix the scenario and continue. After you have tested an import scenario, you can use it to import data in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. To import external data to Visma Net by using a scenario that has already been created, you should perform the steps, which are described in this topic. ## 1. Selecting an import scenario In the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window, you first select the name of the scenario that has been created for data import. You can select a scenario from only the scenarios that work with windows in which you can enter data. If you do not have the access rights to enter data in the window, you cannot use a scenario that imports data to this window either. If you do not have access rights to a particular window, you will not see any scenarios for this window listed among the other scenarios. You can view the access rights to particular windows in the [Access rights by window (SM201020)](/visma-net-erp/help/access-management/user-security/user-security-windows/access-rights-by-window-sm201020/) window. ## 2. Uploading a new file version If you are not using a file for importing data, skip this step. If you are importing data from a file, decide whether you need to upload a new version of the file. The file that is used for data import is attached to the window; you can click **Files** in the title bar to view the file. This file is attached to each of the following windows: [Data providers](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/), [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/), and [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/). If you need to use a new version of the file when importing data, you can upload the new file to the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window by clicking **Upload file version** in the window toolbar. The schema of the uploaded file must match the schema defined in the data provider and used in the import scenario. If you have changed the file structure, you have to update the data provider and the import scenario, and only then can you use the new file to import the data. If there is no file attached to the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window, you have to upload the file either by dragging the file to the window or by using the **Files** menu. Do not use the **Upload file version** button to upload the file. After the file is uploaded to the window, you can update the version of the file by clicking **Upload file version**. ## 3. Preparing the data for import You prepare records by uploading them in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. To prepare the data for import, you click the **Prepare** button in the window toolbar. The data is displayed on the **Prepared data** tab; no data is yet imported into the system. ## 4. Importing the prepared data To import data to the system, you click the **Import** button in the window toolbar of the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. The system tries to import the records with the **Active** check box selected one by one. After a record has been successfully processed, the system selects the **Processed** check box for this record. If an error occurs during the processing of a record, the process stops on the record that caused the error. ## 5. Correcting any errors If an error occurred during the import process, you have to review the error; you then do one of the following: correct the record that caused the error, or exclude the wrong record from import, or modify the import scenario. Then you have to run the import process again to process the remaining records. If you need to correct only a small number of records, you can correct them directly on the **Prepare data** tab, click **Save**, and click **Import** again. You can exclude an incorrect record by clearing the **Active** check box, saving your changes, and clicking **Import** again. If you need to correct a large number of records or all records, you can correct the records in the source, upload a new file version if you are importing data from a file, and prepare and import the data again. If you need to correct the import scenario itself, make changes to the scenario in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, and prepare and import the data again in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. You can clear the history of scenario execution and clear the prepared data by clicking **Roll back** on the **History** tab of the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. The **Roll back** action doesn't reverse records that have already been imported. ## Summary of data import After you have imported data, open the destination window and make sure that the imported records appear among the records. Simplified scenarios for data import /visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import page With simplified scenarios, you skip the step of creating the data provider before you create the import scenario. 2026-02-19T17:09:06+01:00 # Simplified scenarios for data import With simplified scenarios, you skip the step of creating the data provider before you create the import scenario. With simplified scenarios, you skip the step of creating the data provider before you create the import scenario. You compose the mapping directly in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window and then you immediately run the import procedure in the window. Simplified scenarios are appropriate for one-time import, such as during data migration. For data migration, you can prepare all data in the source file in the format needed for import and use a straightforward mapping of the source fields to the target fields. If you need to compose a complex scenario which might involve using custom keys, searching for records, and modifying service commands, you have to use regular import scenarios that you compose by creating the data provider and then defining the mapping in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. To import data by using a simplified scenario, you have to complete the following steps: 1. **Upload the file** You first upload the file with data that you want to import to the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. You can upload an Excel, a CSV, or an XML file. The following criteria should be met for the source files for a simplified scenario: + Only the data from the first sheet of an Excel file is imported. + A CSV file should use a comma (,) as the delimiter and have US-ASCII encoding. These default parameters are used for data provider creation. + An XML file should have US-ASCII encoding and a tree structure. These default parameters are used for data provider creation. 1. **Specify the parameters of the import scenario** Also in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, you specify the Visma Net window to which you want to import data. The system suggests the scenario name depending on the selected window, but you can change the name. The system automatically detects the type of the data provider based on the extension of the uploaded file. When you click **Save**, the system automatically creates an import scenario (with default parameters and the specified name) and a data provider of the specified type for the simplified import procedure. 1. **Configure mapping** You configure mapping between the fields of the external file and the fields of the Visma Net window on the **Mapping** tab of the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. You should select the source field and the corresponding target object and field. You use the same target objects and fields that are used in regular import scenarios that you create in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. However, in simplified scenarios, you cannot use service commands and actions. You should select the **Key** check box for the fields that should be used as key fields to distinguish records that belong to different documents. You can use as keys only the fields that are mapped to the fields of the summary object. You can map the fields of the source file in any order. After you have saved the mapping, the system places the fields in the correct order and creates the import scenario mapping. The system adds all actions (including ``) and service commands to the import scenario automatically. 1. **Prepare and import data** After you have specified the scenario mapping, you can prepare and import data in the same way as you do with regular import scenarios. Simplified scenarios are not available for editing in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window, and you cannot edit the data provider that was automatically created for the simplified import scenario. If the simplified scenario is not working, you should convert the simplified scenario to a regular scenario by clicking **Convert to manual scenario** in the [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) window. Data export /visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/data-export page You use the Export by scenario (SM207036) window for data export. 2026-02-19T17:09:06+01:00 # Data export You use the Export by scenario (SM207036) window for data export. For more information: [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/). To export data from Visma Net to an external source, you perform the steps, which are described in this topic. ## 1. Select an export scenario In the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window, you select the name of the scenario created for data export. ## 2. Prepare the data for export You prepare records by uploading them in the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window. The system performs all modifications defined by the scenario and uploads the modified data in the window. To prepare the data for export, you click the **Prepare** button in the window toolbar. You can view the data on the **Prepared data** tab of this window. ## 3. Export prepared data To run the export process, you should click **Export** in the window toolbar of the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window. The system tries to export the records that have the **Active** check box selected. ## 4. Correct any errors Make sure each record has the check box in the **Processed** column on the **Prepared data** tab of the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window selected, which means that this record has been successfully exported. The result of export may include errors, which are indicated by the icon on the window toolbar. ## 5. Download the results of the export If you are exporting data to a file, during export, the system creates a new version of the file attached to the [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) window. This file has the same structure as the file that was used for data provider creation. You can download the result of export by clicking the **Get latest version** button in the window toolbar. Internal data is exported to the external data source in a table window. That means that the values of the fields of detail objects are translated to multiple rows of this table. The number of rows is equal to the number of detail lines of the source record. Each of these rows has the values of the fields of the summary object and related objects specified. For example, suppose that in the [Sales invoices (AR301000)](/visma-net-erp/help/customer-ledger/customer-ledger-windows/sales-invoices-ar301000/) window, a sales invoice has three detail lines. If you export this invoice with the detail lines, the data prepared for export will include three records for this invoice, one record for each detail line. These records will include identical values of the fields of the invoice summary, such as type and reference number, and different values of the detail line fields. Download your company’s attachments /visma-net-erp/help/integration/download-your-company-s-attachments section As a financial administrator in Visma Net, you can use the Download attachments (SM508090) window to download attachments on customer, supplier, journal, and cash transactions. 2026-02-19T17:09:06+01:00 # Download your company’s attachments As a financial administrator in Visma Net, you can use the Download attachments (SM508090) window to download attachments on customer, supplier, journal, and cash transactions. For more information: [Download attachments (SM508090)](/visma-net-erp/help/integration/integration-windows/download-attachments-sm508090/). To be able to start the downloading process, you first need to create a new archive job by following the steps below. 1. Go to the [Download attachments (SM508090)](/visma-net-erp/help/integration/integration-windows/download-attachments-sm508090/) window. 1. Click ![icon-add](/media/visma-net-erp/icon-add.png). 1. Enter an **Archive ID** for the archive. 1. In the **Description** field, add a name for the archive. 1. In the **Document type** field, select the transaction document type you want to download attachments for. 1. In the **From period** and **To period** fields, specify the start and end period you want to download attachments for. 1. Click ![icon-save](/media/visma-net-erp/icon-save.png). **Result**: the **Generate Archive** button in the toolbar is activated. 1. Click the **Generate Archive** button. **Result**: the system will start collecting the files and creating a zip file. If there are many attachments to download, the process can take some time. You can leave the window and continue with other tasks in Visma Net, and return later and check the status by clicking the **Update status** button in the toolbar. 1. When the process is completed, the generated archives will be available on the **Available zip archives** tab. The system automatically splits the archive into one or more zip files when many attachments are large files. Integration windows /visma-net-erp/help/integration/integration-windows section 2026-02-19T17:09:06+01:00 # Integration windows Integration windows - overview /visma-net-erp/help/integration/integration-windows/integration-windows-overview page On the menu of Visma Net, the windows are grouped into workspace items on the left hand side of the window. 2026-02-19T17:09:06+01:00 # Integration windows - overview On the menu of Visma Net, the windows are grouped into workspace items on the left hand side of the window. On the menu of Visma Net, the windows are grouped into workspace items on the left hand side of the window. Each item contains a workspace with tiles and categories. ## Transactions [Import by scenario (SM206036)](/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/) [Export by scenario (SM207036)](/visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036/) ## Registers [Data providers - reference information](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) [Company template (CS10300S)](/visma-net-erp/help/management/management-windows/company-template-cs10300s/) ## Processes [Schedule import scenarios (SM206035)](/visma-net-erp/help/integration/integration-windows/schedule-import-scenarios-sm206035/) [Schedule export scenarios (SM207035)](/visma-net-erp/help/integration/integration-windows/schedule-export-scenarios-sm207035/) [Import customised reports and inquiries (CS10302S)](/visma-net-erp/help/common-settings/common-settings-windows/import-updates-from-templates-cs10302s/) [Publish customised reports and inquiries (CS10301S)](/visma-net-erp/help/common-settings/common-settings-windows/publish-customised-reports-and-inquiries-cs10301s/) [Download attachments (SM508090)](/visma-net-erp/help/integration/integration-windows/download-attachments-sm508090/) Data providers (SM206015) /visma-net-erp/help/integration/integration-windows/data-providers-sm206015 section You use this window to create a provider for data import or data export; you can also use the form to view the details of existing providers. 2026-02-19T17:09:06+01:00 # Data providers (SM206015) You use this window to create a provider for data import or data export; you can also use the form to view the details of existing providers. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. You use this window to create a provider for data import or data export; you can also use the form to view the details of existing providers. You can configure providers to work with files in CSV, Excel, and XML format and with different external systems. If you have exported to XML a file data provider that has a file attached to the window (by using the **Clipboard** - **Export to XML** standard button on the form toolbar), when you import the data of the provider (by using **Clipboard** - **Import from XML** ), you need to attach the file to the data provider manually. ## The window toolbar
Button Description
Get file link Opens the Attached file link dialog box, where you can get a link to the file attached to the provider.
The dialog box, called when you click **Get file link** on the toolbar, has the following elements:
Element Description
Link The internal link to the file that is attached to the provider.
Close (button) Closes the dialog box.
## The top part You use this area to identify the provider. You can specify the name and details for a new provider, or you can select an existing provider and view its information.
Element Description
Name The name of the provider, which usually describes the data you will transfer by using this provider. You can use an alphanumeric string of up to 100 characters.
Provider type

The type of provider, such as the following:

  • File providers that you use to access data in external files:

    • CSV provider ( PX.DataSync.CSVSYProvider ): For import from and export to files in CSV format
    • Excel provider ( PX.DataSync.ExcelSYProvider ): For import from and export to Excel spreadsheets
    • XML provider ( PX.DataSync.XMLSYProvider ): For import from and export to files in XML format
  • Providers that are preconfigured for importing data from and exporting data to external systems:

    • Salesforce provider ( PX.DataSync.SFSYProvider ): For import from and export to SalesForce CRM by using the Simple Object Access Protocol (SOAP)
    • MS SQL provider ( PX.DataSync.MSSqlSYProvider ): For import from and export to Microsoft SQL Server
    • HubSpot provider ( PX.DataSync.HubSpot.HSSYProvider ): For exporting leads to HubSpot for nurturing and importing leads to Visma Net for processing
  • Providers for exporting payment data to external payment systems:

    • ACH provider ( PX.DataSync.ACHProvider ): For exporting data for processing in the Automated Clearing House (ACH) system
    • Giro payment provider ( PX.DataSync.Banks.GIROPaymentProvider ): For exporting data for processing in giro-based payment systems
Active A check box that indicates (if selected) that this provider is active and will be available for selection in the Visma Net windows related to data import.
## The Parameters tab The **Parameters** tab provides the list of parameters (in a tabular format) specific for the selected provider type. For a new provider, fill in the columns.
Button Description
Reload parameters Reloads the default values of the parameters specific to the provider type.
Column Description
Name

The name of the parameter, which is specific to the provider type.

A CSV provider uses the following parameters:

  • The FileName parameter, which is standard for file providers, specifies the name of the file that should be used for data import or data export. The path to the file is set automatically after you have uploaded an external file to the provider.
  • The Encoding parameter specifies the encoding of the source file. You can select the proper encoding value from the drop-down list in the Value column of the table on the Parameters tab. By default, the value of the parameter is set to US-ASCII.
  • The Delimiter parameter specifies the delimiter that is used in the CSV file. You can use as a delimiter any printable character. By default, a comma (,) is used as the delimiter.
  • The QuoteAll parameter makes the provider enclose all values from the source file in double quotes. By default, the system does not enclose source values in double quotes.

An Excel provider uses the following parameters:

  • The FileName parameter, which is standard for file providers, specifies the name of the file that should be used for data import or data export.

An XML provider uses the following parameters:

  • The FileName parameter, which is standard for file providers, specifies the name of the file that should be used for data import or data export.

  • The Encoding parameter specifies the encoding of the source file. You can select the proper encoding value from the drop-down list in the Value column of the table on the Parameters tab. By default, the value of the parameter is set to US-ASCII.

  • The Format parameter specifies the format of the XML file. There are two options:

    • Tree: The source file has a tree structure; that is, the values of the source fields are placed in tags of the source XML file. This is the default option.
    • Flat: The source file has a flat structure; that is, the values of the source fields are placed in attributes of tags in the source XML file.

A Microsoft SQL provider uses the following parameters:

  • Server: Specifies the location of the Microsoft SQL Server instance. This is a required parameter. You set the parameter to the server name for a default instance of Microsoft SQL Server (for example MyServer ), and to the server name and instance name for a named instance of Microsoft SQL Server (for example, Myserver\MyInstance). If a default instance of Microsoft SQL Server is installed on the same computer where Visma Net is installed, you can set the value of the parameter to (local).

  • Database: Specifies the name of the database on the server. This is a required parameter.

  • Login: Specifies the login for accessing the Microsoft SQL Server database. This is a required parameter.

  • Password: Specifies the password for accessing the Microsoft SQL Server database. This is a required parameter.

  • LastModifiedDateColumn: Specifies the column of the database table or view that contains the date when the record was most recently modified. This parameter is necessary only if you want Visma Net to use the synchronisation type of an import scenario based on the Microsoft SQL provider. For details on the synchronisation types, see the description of the Sync type field in the Manage import scenarios (SM206025) topic.

  • CreatedDateColumn: Specifies the column of the database table or view that contains the date when the record was created. This parameter is necessary only if you want Visma Net to use the synchronisation type of an import scenario based on the Microsoft SQL provider. For details on the synchronization types, see the description of the Sync type field in the Manage import scenarios (SM206025) topic.

  • Authentication: Defines the authentication type to be used to connect to the database server. There are two options:

    • SQL: Visma Net connects through SQL Server authentication. The account you specify should have sufficient rights for making changes to the database. This authentication type is used by default.
    • Windows: Visma Net connects through a Windows user account with the login and password you provide. Windows authentication works only for a local Microsoft SQL Server or when both application and database servers are members of the same Windows domain.
Description The description of the parameter.
Value The value of the parameter to be used by the provider.
## The Schema tab On this tab, you can view and manually correct, if needed, the schema of the data used in the specified external data source (file or application). For a new provider, you can extract the schema from the data source in accordance with the provider type. If you uploaded a new version of the file for an existing provider, refresh the data schema by filling in schema lines again. This tab includes two panes: The **Source objects** area contains the table with the list of objects of the data source, and the **Source fields** area contains the table with the list of fields for the object selected in the left area. ### The Source objects area
Button Description
Fill schema objects Fills in the objects from the data source in accordance with the provider type. If you don’t see this button on the toolbar, click the Images-How_to_Create_a_Provider_for_Data_Import_SM_20_60_15Icon_FillIn icon, which displays actions that do not fit on the toolbar.
Edit command

Opens the Object command editor dialog bo x, where you can type the commands for the selected table line.

Click Close to save the command and close the dialog box.

This button is used for only SQL data providers.

Column Description
Active A check box that indicates (if selected) that the object should be used for import or export. By default, the check box is not selected.
Object The name of the object in the source, such as a worksheet in an Excel spreadsheet.
Command

The command to be executed for the object during data preparation.

For example: You can apply SQL commands to source objects to apply restrictions on the imported records, select particular records from the source database table, or join data from several tables into one object in the data provider.

This column is used for only SQL data providers.

### The Source fields area
Button Description
Fill schema fields Fills in the fields from the selected data source object in accordance with the provider type.
Edit command

Opens the Object command editor dialog box, where you can type the commands for the selected table line.

Click Close to save the command and close the dialog box.

This button is used for only SQL data providers.

Toggle activation Reverses the value in the Active column in the selected line and updates the rest of the lines with this value.
Column Description
Active A check box that indicates (if selected) that the field can be used in an import or export scenario.
Field The name of the field of the object in the external data source.
Key

A check box that indicates (if selected) that the field contains the key to the data set of the object.

Currently this column is not used by data providers.

Description The description of the field.
Data type

The type of data in the field, which can be one of the following options: String, DateTime, Double, Decimal, Boolean, or Int32.

For SQL data providers, the value of this field is filled in automatically from the corresponding property of the columns of SQL tables. For other provider types, you do not need to set the value in this column.

Data length

The length of the data in the field.

For SQL data providers, the value of this field is filled in automatically from the corresponding property of the columns of SQL tables. For other provider types, you do not need to set the value in this column.

Command

The action to be performed on the field data during data preparation. For example: You can replace the value of a field with some calculated value, or change the value of a field depending on some condition.

This column is only used for SQL data providers.

Parent topic: [Integration windows - overview](/visma-net-erp/help/integration/integration-windows/integration-windows-overview/)

Related pages

Concepts

Tasks

Export by scenario (SM207036) /visma-net-erp/help/integration/integration-windows/export-by-scenario-sm207036 page You can use this window to select an export scenario and prepare the data, export it, or roll back the changes in accordance with the selected scenario. 2026-02-19T17:09:06+01:00 # Export by scenario (SM207036) You can use this window to select an export scenario and prepare the data, export it, or roll back the changes in accordance with the selected scenario. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. In the window, you can review the prepared data if the export has failed and view the history of processing for the scenario. You can create scenarios for export by using the [Manage export scenarios (SM207025)](/visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025/) window. Export is performed to the file uploaded to the Visma Net website or to the third-party application specified in the export provider. ## The window toolbar
Button Description
Prepare and export Prepares and exports the data.
Prepare Prepares the data for export by uploading it in the window. The system performs all modifications defined by the scenario at this step and uploads the modified data in the window. You can view the data in the Prepared data tab of the window.
Export Exports the prepared data. The system tries to export the records that have the Active check box selected.
Upload file version Opens the Upload new revision dialog box, which lets you update an already uploaded file.
Get latest version Downloads the latest file attached to the selected scenario. If you export data to a file, during export, the system creates a new version of the file attached to the window.
## The top part In this area, you can select an export scenario and view information about the selected scenario.
Element Description
Name The name of the export scenario. Select the scenario you want to work with, and you can view information about it.
Window name A read-only field showing the name of the Visma Net window whose functionality is used to perform data export.
Status

A read-only field showing the status of the selected scenario, which is automatically assigned during the processing and can be one of the following options:

New
Indicates that this scenario is either new and has not been used for data preparation or that the history of processing for this scenario has been rolled back.
Prepared
Indicates that the data has been prepared in accordance with the scenario.
Partially processed
Means that the data for the scenario has been processed only partially.
Processed
Indicates that the data for the scenario has been processed completely.
Number of records A read-only field that displays the number of records prepared or exported to the target file or application.
## The Prepared data tab On this tab, you can review the data prepared for export and view any errors that have occurred. The actual list displays the processed data, with as many columns as there are external fields mapped to the internal data.
Button Description
Toggle activation Reverses the value in the Active column in the selected line, and updates the rest of the lines with this value.
Clear activation until error Clears the check boxes in the Active column for the lines before the line with an error. If there are no errors, clears all the check boxes in the Active column.
Toggle processing Reverses the value in the Processed column in the selected line, and updates the rest of the lines with this value.
Clear error Clears the error messages in the Error column.
Column Description
Number The number of the record in the list of records for export.
Active A check box that indicates (if selected) that this record is active and will be exported.
Processed A check box that indicates (if selected) that the information in the row was exported.
Error The error message, if an error occurred for this row.
## The History tab On this tab, you can view the history of processing for the selected scenario.
Button Description
Roll back Rolls back the changes in the export history and removes the prepared data.
Column Description
Status date The date when the status of the data had changed as a result of processing being performed.
Status The status of the data as a result of the processing being performed.
Number of records The number of records processed.
Version The version of the exported file. If export was successful, the system creates a new version.
## The Details tab On this tab, you can view additional information about the selected scenario.
Element Description
Provider A read-only field that displays the data provider that is used in the export scenario. To view the details about the provider, click the button to the right of the field to open the Data providers (SM206015) window.
Sync type

A read-only field that shows the type of synchronization for the selected scenario, which can be one of the following options:

Full
Performs export of all the data in accordance with the scenario.
Incremental: all records
Performs partial export, including only the data (mentioned in the scenario) that has changed in the Visma Net records.
Incremental: new only
Performs partial export, including only those records that have appeared in the Visma Net database since the previous export took place.
Prepared on A read-only field displaying the date when the data was prepared or the export was performed.
Completed on A read-only field that shows the date and time when the export was completed.
Element Description
Sitemap location The location of the scenario on the sitemap. Select the location if you want to add the scenario to the sitemap.
Sitemap title The title of the scenario on the site map. Provide the title if you want to add the scenario to the site map.
Element Description
Skip headers

A check box that you select to not export the titles of the elements in the window.

You specify this option for a particular execution of a scenario. That is, the selected value is discarded after each execution of the scenario or each refresh of the page.

Parent topic: [Integration windows - overview](/visma-net-erp/help/integration/integration-windows/integration-windows-overview/)
File synchronisation (SM202530) /visma-net-erp/help/integration/integration-windows/file-synchronisation-sm202530 page 2026-02-19T17:09:06+01:00 # File synchronisation (SM202530) This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. ## The window toolbar
Button Description
Process file Initiates the synchronization of the selected files.
Process all files Initiates the synchronization of all listed files.
Schedules

In the drop-down list you have the following options:

  • Add Once a schedule is added to this window, the following options are also available:

This opens the Automation schedules (SM205020) window as a pop-up. Here you can create and add automation schedules. For more information, see: Schedule processing.

  • History
  • Delete
  • Delete all
  • View
## The top part You can use this area to specify search criteria that might help you find the file you want to locate.
Element Description
Operation The operation to be performed for the files you want to synchronize. You can select one of the following options: Import file or Export file.
## The table
Column Description
Selected A check box that you select to include the file in processing if you click Process file.
Name The name of the file to be synchronised.
Synchronisation type The type of synchronisation to be performed for the file.
Path The path to the file to be synchronised.
Synchronise folder content A check box that indicates (if selected) that the file will be synchronized with the folder.
Last import date The date when an import operation was last performed.
Last export date The date when an export operation was last performed.
Created by The name of the user who has created the file.
Manage export scenarios (SM207025) /visma-net-erp/help/integration/integration-windows/manage-export-scenarios-sm207025 section You use this window to create export scenarios. 2026-02-19T17:09:06+01:00 # Manage export scenarios (SM207025) You use this window to create export scenarios. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. You can perform data export as a one-time activity or periodically if you have configured synchronisation between Visma Net and the third-party software. You create an export scenario for a specific provider. You can create and view providers for export by using the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. Generally, a scenario includes the mapping between the data in Visma Net (source data) and the fields in an external file or a third-party source (target data), as well as any restrictions on the source data. For more information, see: [Configuring export scenarios](/visma-net-erp/to-be-deleted/help/integration/configuring-export-scenarios/configuring-export-scenarios/). ## The window toolbar
Button Description
View window Navigates to the window selected in the Window name field.
## The top part You use the elements in this area to create a new scenario for one-time export or periodic synchronisation, or to select an existing scenario for editing.
Element Description
Name The name of the scenario, which may be an alphanumeric string of up to 50 characters.
Active A check box that indicates (if selected) that this scenario is active and can be used for data export.
Window name The name of the Visma Net window whose functionality will be used to perform data export. You can select the window name by finding its workspace, finding its section, and selecting the applicable window.
Export mapped fields only

A check box that indicates (if selected) that only the fields that are mapped in the export scenario should appear in the output of data export; other fields of the data provider are skipped during export. If the check box is cleared, the fields of the data provider that are not mapped in the export scenario are exported and have null values.

We recommend that you select this check box when you are exporting data to external systems, such as HubSpot, to avoid the system rewriting of the fields that are not mapped in the scenario with null values during data export.

Provider The data provider that should be used for data export.
Provider object The object of the specified data provider. Only active provider objects are available for selection.
Sync type

The type of synchronisation for the selected scenario, which can be one of the following options:

Full
Select this option to perform export of all the data in accordance with the scenario.
Incremental - all records
Select this option to perform partial export, including only the data (mentioned in the scenario) that has changed in the Visma Net records.
Incremental - new only
Select this option to perform partial export, including only those records that have appeared in the Visma Net database since the previous export took place.
Format locale The locale whose date format (and other locale-specific formats)will be used for the data to be exported.
Inverse mapping ID The scenario that can be used for import of the same data if data synchronisation between Visma Net and the third-party software is configured.
## The Mapping tab You use this tab to map the data in the Visma Net window (in any section of windows except for **Reports** ) to the target fields in the external file or third-party application.
Button Description
Insert Inserts a new table row above the selected row.
Unlabelled field with display options

Displays the window controls according to the selected option, which is one of the following: Show all commands or Hide service commands.

By default, the Show all commands option is selected, which indicates that all commands (including service commands) are displayed.

Up Moves the selected row up the list.
Down Moves the selected row down the list.
Insert from… Gives you the ability to insert a part of another scenario; invokes the Choose scenario to insert steps from dialog box.
### The Choose scenario to insert steps from dialog box In this dialog box, you can select another scenario to insert its mapping lines into the current scenario. This operation inserts all lines of the selected scenario. Once the lines are inserted, you can make inactive or delete any lines you don't want to keep. This dialog box has the following elements.
Element Description
Mapping The scenario whose mapping lines you want to insert.
OK (button) Closes the dialog box and inserts the lines from the selected scenario.
Cancel (button) Closes the dialog box without performing insertion.
Column Description
Active A check box that indicates (if selected) that this step of the scenario is active during data export.
Source object The name of the functional object of the graph the Visma Net window is based on. (The functional object can be the top part,the Details area, or any of the tabs or dialog boxes.)
Field/action name The name of the field or action of the functional object selected as the Source object. Click the icon-arrowdown icon to select a field or action, or click the icon-edit icon to open the Formula editor dialog box and create a formula.
Commit A check box that indicates (if selected) that when this field ora ction is filled in, a commit to the database is required.
Target field/value

The external field (in the target file) to hold the value to be exported. Click the icon-arrowdown icon to select from the available external fields.

Click the icon-edit icon to create a formula if you want to assign its resulting value back to the internal field specified as the Field/action name.

Ignore error A check box that indicates (if selected) that the system should ignore errors when processing the data for this field.
## The Source restrictions tab You can use this tab to set up restrictions for the data to be exported.
Column Description
Active A check box that, if selected, indicates that the restriction is active.
Brackets The opening bracket or brackets for composing a logical expression with multiple conditions.
Field name The field whose value the condition will be applied to.
Condition

The logical operation to apply to the value of the selected field. The following options are available:

Equals
Returns True if the field value is equal to the value specified in the Value field.
Does not equal
Returns True if the field value is not equal to the value specified in the Value field.
Is greater than
Returns True if the field value is greater than the value specified in the Value field.
Is greater than or equal to
Returns True if the field value is greater than or equal to the value specified in the Value field.
Is less than
Returns True if the field value is less than the value specified in the Value field.
Is less than or equal to
Returns True if the field value is less than or equal to the value specified in the Value field.
Is between
Returns True if the field value is between the values specified for Value and Value 2.
Contains
Returns True if the field value(string) contains the value specified in the Value field.
Ends with
Returns True if the field value ends with the character or string specified in the Value field.
Starts with
Returns True if the field value begins with the character or string specified in the Value field.
Is null
Returns True if the field value is null.
Is not null
Returns True if the field value is not null.
Does not contain
Returns True if the field value (string) does not contain the value specified in the Value field.
Is relative A check box that indicates (if selected) that the field value represents the number of days with respect to the current business date.
Value The first value of the condition, which will be compared with the value of the chosen field. Most of the conditions require only one value, while Is between requires two values.
Value 2 The second value of the condition, if required by the selected condition.
Brackets The closing bracket or brackets for composing a logical expression with multiple conditions.
Operator A logical operator to be used between the logical conditions enclosed in brackets.
Schedule export scenarios (SM207035) /visma-net-erp/help/integration/integration-windows/schedule-export-scenarios-sm207035 page You can use this window to prepare data for export and to export the data for the export scenarios that you select. 2026-02-19T17:09:06+01:00 # Schedule export scenarios (SM207035) You can use this window to prepare data for export and to export the data for the export scenarios that you select. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. Also, you can view any errors that have occurred during the process and fix them in the scenarios. You can roll back the prepared data and the history of processing, if needed. ## The window toolbar
Button Description
Process Performs the operation that you selected (in the Operation field) for the selected scenarios.
Process all Performs the operation that you selected for all scenarios in the list.
## The top part In this area, you can select an operation to be executed.
Element Description
Operation

The operation to be performed for the scenario or scenarios selected in the Scenarios area. Select one of the following options:

Prepare and export
Prepares and exports the data in one step.
Prepare
Only prepares the data for export (without exporting it); select this option if the data may require manual editing.
Export
Exports the already-prepared data.
Roll back
Rolls back the data prepared for export or removes the prepared data from the Prepared data dialog box and the latest record from the history of scenario processing in the Mapping history dialog box.
Skip headers A check box that you select to not export the titles of the elements in the window.
## The table The table of scenarios in this area includes the scenarios with the appropriate status for the operation (selected in the Parameters area) to be performed. You can select one export scenario or multiple scenarios for processing.
Button Description
History Opens the Mapping history dialog box, which displays the history of operations for the selected scenario.
Prepared data Opens the Prepared data dialog box, which displays the prepared data for the selected scenario.
Column Description
Name The name of the scenario.
Window name A read-only field showing the screen ID of the Visma Net window used by the scenario.
Provider A read-only field showing the provider used for export.
Sync type The type of synchronisation for the export scenario, which is one of the following options: Full; Incremental - all records; or Incremental - new only.
Status The status of the scenario, which can be one of the following options: Prepared, Exported, or Partially processed.
Number of records The number of records that have been processed.
Prepared on The date and time when the data was prepared.
Completed on The date and time when the data export was completed.
### The Mapping history dialog box Here, you can view the history of data export for the selected scenario. The table in the dialog box has the following columns
Column Description
Status date The date when the status last changed.
Status The status of the data, which is one of the following options: Prepared, Exported, or Partially processed.
Number of records The number of records that have been processed.
Version The date and time stamp of the version of the exported file.
### The Prepared data dialog box On the **Prepared data** dialog box, you can view the prepared data with errors indicated. The dialog box includes the toolbar and the data organised into columns that depend on the mapping of the data exported. The list below describes only the three columns that have information about processing. The table in the dialog box has the following columns.
Column Description
Active A check box that indicates (if selected) that the data is active and will be exported.
Processed A check box that indicates (if selected) that the data in the row was processed.
Error The error message, if an error has occurred for the data in this row.
Close (button) Saves the selections and closes the dialog box.
Parent topic: [Integration windows - overview](/visma-net-erp/help/integration/integration-windows/integration-windows-overview/)
Schedule import scenarios (SM206035) /visma-net-erp/help/integration/integration-windows/schedule-import-scenarios-sm206035 page In this window, you can prepare data for import and import the data for multiple import scenarios. 2026-02-19T17:09:06+01:00 # Schedule import scenarios (SM206035) In this window, you can prepare data for import and import the data for multiple import scenarios. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. In this window, you can prepare data for import and import the data for multiple import scenarios. Also, you can roll back the prepared data (or history or processing) if needed. You can perform data import for the selected import scenarios that were created in the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. ## The window toolbar
Button Description
Process Performs the operation you selected (in the Operation field) for the selected scenarios.
Process all Performs the operation you selected for all scenarios in the list.
## The top part By using the elements in this area, you can select the operation to be executed and the processing options.
Element Description
Operation

The operation to be performed for the scenarios selected in the table. The following options are available:

Prepare and import
Select this operation to prepare and import the data in one step.
Prepare
Select this operation to only prepare (but not import) the data for import if the data may require manual editing.
Import
Select this operation to only import (but not prepare) the already-prepared data.
Roll-back
Select this operation to roll back the data prepared for import or remove the prepared data from the Prepared data dialog box and remove the latest record from the history of scenario processing in the History dialog box.
Break on error A check box that indicates (if selected) that the processing will be cancelled if an error occurs.
Break on incorrect target A check box that indicates (if selected) that the system will stop processing records at the first error that occurs for a record that violates the target restrictions.
Validate data (no saving)

A check box that indicates (if selected) that only data validation will be performed.

The scenario processing emulates data import and is cancelled if an error occurs.

If you want to save the imported data after successful validation, select the Save if data is valid check box.

Save if data is valid

A check box that indicates (if selected) that the data should be saved if it is valid.

Clear the check box if you don’t want to save the data after import validation.

This option is available only when you select the Validate data (no saving) check box to switch to import validation mode.

Skip headers A check box that you select to not export the titles of the elements in the window.
## The table The table contains the list of scenarios with the appropriate status for the operation (selected in the Parameters area) to be performed. You can select one scenario or multiple scenarios for processing.
Button Description
History Opens the History dialog box, which displays the history of operations for the selected scenario.
Prepared data Opens the Prepared data dialog box, which displays the prepared data for the selected scenario.
Column Description
Name The name of the scenario.
Screen name A read-only field showing the screen name of the Visma Net window used by the scenario.
Provider A read-only field showing the provider used for import.
Sync type The type of synchronisation for the import scenario, which is one of the following options: Full; incremental - all records; or Incremental - new only.
Status The status of the scenario, which can be one of the following options: Prepared, Imported, or Partially processed.
Number of records The number of records in the external source.
Prepared on The date and time when the data was prepared.
Completed on The date and time when the import was completed.
### The History dialog box In the **History** dialog box, you can view the history of data import for the selected scenario. The dialog box has the following columns:
Column Description
Status date The date when the status last changed.
Status

The status of the scenario, as automatically assigned during the processing. The status can be one of the following options:

Prepared
Indicates that the data has been prepared in accordance with the scenario
Partially processed
Indicates that the data for the scenario has been imported only partially
Imported
Indicates that the data for the scenario has been imported completely
Number of records The number of records processed.
Version The date and time stamp of the version of the source file.
### The Prepared data dialog box Here, you can view the prepared data, with any errors indicated. This dialog box includes the toolbar and the data organised into columns that are specific to the data being imported. The list below describes only the three columns that have information about processing. The table in the dialog box has the following columns:
Column Description
Active A check box that, if selected, indicates that the data should be processed.
Processed A check box that, if selected, indicates that the data in the row was processed.
Error The error message, if an error has occurred for the data in this row.
Close (button) Saves the selections and closes the dialog box.
Import by scenario (SM206036) /visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036 section In this window, you can select an import scenario and prepare and import the data in accordance with the selected scenario. 2026-02-19T17:09:06+01:00 # Import by scenario (SM206036) In this window, you can select an import scenario and prepare and import the data in accordance with the selected scenario. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. You create scenarios for import by using the [Manage import scenarios (SM206025)](/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/) window. Alternatively, you can use this form to import data directly from a file, such as an Excel spreadsheet. In this case, upload the file, set up the mapping, and then prepare and import the data. For more information, see: [Simplified scenarios for data import](/visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import/). ## The window toolbar
Button Description
icon-add

Gives you the ability to add a new simplified import scenario.

Clicking this button first opens the Select file for import dialog box, where you can select the file whose data you want to import, and then opens the Provide new scenario properties dialog box, where you select the window to be used for data import, name the scenario, and select the data provider type.

Prepare and import Prepares the data and imports it.
Prepare Prepares the data for import.
Import Imports the prepared data.
Upload file version Opens the Upload new revision dialog box that you can use to update an already uploaded file.
Get file Downloads the latest file attached to the selected scenario.
View screen Displays the Visma Net window to which you are importing data with the error occurred during data import. The button is only available if there was an error during data import.
### The Provide new scenario properties dialog box In this dialog box, you can select the window to be used for importing data, enter the scenario name, and change the data provider.
Element Description
Window name

Required. The Visma Net form to be used for importing data from the uploaded file.

You select the window name by finding its workspace, finding its section, and selecting the applicable form in the site tree.

Scenario name

Required. The name of the new simplified import scenario.

The system generates the name automatically, based on the title of the form you selected in the Window name field. If required, you can change the name.

Provider type Required. The provider type, which is defined automatically based on the file type.
OK Creates a new simplified scenario for data import and closes the dialog box.
Close Closes the dialog box without creating a new simplified scenario for data import.
## The top part In this area, you can select an existing import scenario and view information about the scenario.
Element Description
Name The name of the scenario that should be used for data import.
Window name A read-only element showing the name of the Visma Net window whose functionality will be used to perform import.
Status

A read-only element that shows the status of the selected scenario, which is automatically assigned during the processing and can be one of the following options:

New
Indicates either that this scenario is new and has not been used for data preparation or that the history of processing for this scenario has been rolled back.
Prepared
Indicates that the data has been prepared in accordance with the scenario.
Partially processed
Indicates that the data for the scenario has been imported only partially.
Processed
Indicates that the data for the scenario has been imported completely.
Number of records A read-only element that displays the number of records in the external source.
Simple scenario A read-only check box that, if selected, indicates that the selected scenario is a simplified import scenario. For more information, see: Simplified scenarios for data import.
Discard previous result

A check box that you select to prepare and import data regardless of the status and the results of the previous import.

Generally, you should select this check box if you are scheduling the processing of the selected scenario and you expect errors during the import that do not affect the performance of the scenario.

For example: The system returns an error for a line when it is trying to import a line that has been imported in the previous cycle. If you select the check box, the system can run the scenario on a schedule, thus importing the new lines. If you clear the check box, the system won’t be able to run the scenario on schedule if the previous processing of the scenario returned errors.

For more information about scheduling, see: About scheduled processing.

## The Prepared data tab On this tab, you can review the data prepared for import and any errors that have occurred. The actual list displays the processed data, with as many columns as there are internal fields mapped to the external data.
Button Description
Toggle activation Reverses the value in the Active column in the selected line and updates the rest of the lines with this value.
Clear activation till error Clears the check boxes in the Active column for the lines before the line with an error. If there are no errors, clears all the check boxes in the Active column.
Toggle processing Reverses the value in the Processed column in the selected line and updates the rest of the lines with this value.
Clear error Clears the error messages in the Error column.
Column Description
Number The number of the record in the list of records for import.
Active A check box that indicates (if selected) that the record is active and will be imported.
Processed A check box that indicates (if selected) that the information in the row was processed.
Error The error message, if an error has occurred for this row.
## The Mapping tab You use this tab, which appears only when you create or open a simplified data import, to map the data from the external source to the fields of the specified data entry window in Visma Net for automatic import. For more details on simplified import scenarios, see: [Simplified scenarios for data import](/visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import/).
Button Description
Refresh from file Refreshes the data schema for an existing provider after you have uploaded a new version of the file.
Column Description
Active A check box that indicates (if selected) that this field or action is active during import.
Source field/value An external field (in the source file) whose value should be imported into the specified internal field, or an expression to be executed on import to generate the value for an internal field. Click the Images-SM_20_60_25_SM_20_60_25Icon_DropDownList icon to select from the list of available fields, or click the Images-SM_20_60_25_SM_20_60_25Icon_CreateNewObject icon to open the Formula editor dialog box and create a formula.
Key A check box you select to mark the key fields in the uploaded file.
Target object The name of the functional object of the graph that the Visma Net window is based on. (The functional object can be the top part, the details area, or any of the tabs or dialog boxes available for the window.)
Field name The name of the field or action of the functional object selected in the Target object column. Click the field to display the list of available values.
## The History tab You use this tab to view the history of processing for the selected scenario. A history record is inserted in the table after the import operation is completed. Therefore, if an application server restarts during processing of an import scenario (for example, if the session was timed out), no history record is inserted in the table.
Button Description
Roll back Clears the history of scenario execution and clears the prepared data. Clicking Roll back doesn’t reverse records that have already been imported.
Column Description
Status date The date when the status of the data had changed as a result of the processing being performed.
Status The status of the data as a result of processing being performed.
Number of records The number of records processed.
Version The version of the uploaded external file.
Description The description of the operation.
## The Details tab On this tab, you can view additional information about the selected scenario. ### The Information section
Element Description
Provider

A read-only box that displays the data provider of the selected import scenario.

To view the details of the provider, click the button to the right of the field to open the Data providers (SM206015) window.

Sync type

A read-only box that shows the type of synchronisation for the selected scenario, which can be one of the following options:

Full
Performs export of all the data in accordance with the scenario.
Incremental: all records
Performs partial export, including only the data (mentioned in the scenario) that has changed in the Visma Net records.
Incremental: new only
Performs partial export, including only those records that have appeared in the Visma Net database since the previous export took place.
Prepared on A read-only box displaying the date when the data was prepared or the export was performed.
Completed on A read-only box that shows the date and time when the export was completed.
### The Site map section
Element Description
Site map location The location of the scenario on the site map. Select the location if you want to add the scenario to the site map.
Site map title The title of the scenario on the site map. Provide the title if you want to add the scenario to the site map.
### The Options section
Element Description
Break on error

A check box that indicates (if selected) that the processing will be cancelled if an error occurs.

You specify this option for a particular execution of a scenario. That is, the selected value is discarded after each execution of the scenario or each refresh of the page.

This check box affects the order in which the records are imported. For example: Suppose that you are importing documents with auto-numbering of documents, and each line of the source contains one document.

If you clear the Break on error check box, all correct documents will be imported first, and then you will review all errors at once and import the corrected records. The order in which the reference numbers are assigned to the imported documents will be different than in the situation if you import documents one by one and stop after each error.

If the order of record processing is not important, you can clear the Break on error check box.

Break on incorrect target

A check box that indicates (if selected) that the system will stop processing records at the first error that occurs for a record that violates the target restrictions.

You specify this option for a particular execution of a scenario. That is, the selected value is discarded after each execution of the scenario or each refresh of the page.

Validate data (no saving)

A check box you select to validate the selected import scenario. The scenario processing emulates data import and is cancelled if an error occurs. If you want to save the imported data after successful validation, select the Save if data is valid check box.

You specify this option for a particular execution of a scenario. That is, the selected value is discarded after each execution of the scenario or each refresh of the page.

Save if data is valid

A check box you select to save the data if the import validation is successful. Clear the check box if you don’t want to save the data after import validation.

This option is available only when you select the Validate data (no saving) check box to switch to import validation mode.

You specify this option for a particular execution of a scenario. That is, the selected value is discarded after each execution of the scenario or each refresh of the page.

Skip headers

A check box that you select to not import the titles of the elements in the window.

You specify this option for a particular execution of a scenario. That is, the selected value is discarded after each execution of the scenario or each refresh of the page.

Parent topic: [Integration windows - overview](/visma-net-erp/help/integration/integration-windows/integration-windows-overview/)
Manage import scenarios (SM206025) /visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025 section You use this window to create an import scenario. 2026-02-19T17:09:06+01:00 # Manage import scenarios (SM206025) You use this window to create an import scenario. This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. You can perform data import as a one-time activity or periodically if you have configured synchronisation between Visma Net and the third-party software. An import scenario is created for a specific provider. You can create and view providers for import by using the [Data providers (SM206015)](/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/) window. Generally, a scenario includes the mapping between the data in the external data source and the data in Visma Net, as well as any restrictions on the source and target data. ## The window toolbar
Button Description
View screen Navigates to the window selected in the Screen name field.
## The top part In this area, you can create a new import scenario or select an existing one for editing.
Element Description
Name The name of the scenario, which may be an alphanumeric string of up to 50 characters.
Active A check box that indicates (if selected) that this scenario is active and can be used for data import.
Screen name

The name of the Visma Net window whose functionality will be used to perform data import.

You can select the screen name by finding its workspace, finding its section, and selecting the applicable form.

Provider The data provider that should be used for data import.
Provider object The object of the specified data provider. Only active provider objects are available for selection.
Sync type

The type of synchronisation for the import scenario, which can be one of the following options:

Full
Select this option to perform import of all the data available in the source.
Incremental - all records
Select this option to perform partial import, including only the data in each record that has changed in the source.
Incremental - new only
Select this option to perform partial import, including only records that have appeared in the source since the previous import took place.

If the data is imported from a file data source, the Incremental - all records and Incremental - new only options provide the same result: Selecting either of these options makes the system import the data only if a new version of the source file is provided before import.

Format locale The locale used in the source field to format date, time, and other locale-specific information.
Inverse mapping ID The scenario that can be used for export of the same data if data synchronisation between Visma Net and the third-party software is configured.
## The Mapping tab You use this tab to map the data from the external source to the fields of the specified data entry form in Visma Net for automatic import or synchronisation.
Button Description
Insert Inserts a new table row above the selected row.
Unlabelled field with display options

Displays the Visma Net form controls according to the selected option, which is one of the following: Show all commands or Hide service commands.

By default, the Show all commands option is selected, which indicates that all commands (including service commands) are displayed.

Up Moves the selected row up the list.
Down Moves the selected row down the list.
Insert from Makes it possible to insert a part of another scenario; invokes the Choose scenario to insert steps from dialog box.
### The Choose scenario to insert steps from dialog box In this dialog box, you can select another scenario to insert its mapping lines into the scenario currently under modification. This operation inserts all lines of the selected scenario. Once the lines are inserted, you can make inactive or delete any lines you don't want to keep. The dialog box has the following elements:
Element Description
Mapping The scenario whose mapping lines you want to insert.
OK (button) Closes the dialog box and inserts the lines from the selected scenario.
Cancel (button) Closes the dialog box without performing insertion.
Column Description
Active A check box that indicates (if selected) that this step of the scenario is active during data import.
Target object The name of the functional object of the graph the Visma Net window is based on. (The functional object can be the top part, the details area, or any of the tabs or dialog boxes available for the form.)
Field/action name The name of the field or action of the functional object selected in the Target object column. Click the field to display the list of available values.
Commit A check box that indicates (if selected) that when this field is filled in, a commit to the database is required. The check box is automatically selected when it is required by the functionality of the field.
Source field/value An external field (in the source file) whose value should be imported into the specified internal field, or an expression to be executed on import to generate the value for the internal field. Click the Images-SM_20_60_25_SM_20_60_25Icon_DropDownList icon to select from the list of available fields, or click the Images-SM_20_60_25_SM_20_60_25Icon_CreateNewObject icon to open the Formula editor dialog box and create a formula.
Ignore error A check box that indicates (if selected) that the system should ignore errors when the data for this field is imported.
## The Source restrictions tab On this tab, you can set up restrictions to filter the data that you want to extract from the source for processing by the import scenario. For example,some customer ID values in the source have **CUST** prefixes.You canspecify a source restriction that selects the only the records from the source that have the **CUST** prefix in the customer ID field. The table toolbar includes only standard buttons.
Column Description
Active A check box that indicates (if selected) that the restriction is active.
Brackets The opening bracket or brackets for composing a logical expression with multiple conditions.
Field Name The field whose value the condition will be applied to.
Condition

The logical operation to apply to the value of the selected field; in some cases, the operation entails comparing it to the values specified for Value and Value 2.The following options are available:

Equals
Returns True if the field value is equal to the value specified in the Value field.
Does not equal
Returns True if the field value is not equal to the value specified in the Value field.
Is greater than
Returns True if the field value is greater than the value specified in the Value field.
Is greater than or equal to
Returns True if the field value is greater than or equal to the value specified in the Value field.
Is less than
Returns True if the field value is less than the value specified in the Value field.
Is less than or equal to
Returns True if the field value is less than or equal to the value specified in the Value field.
Is between
Returns True if the field value is between the values specified for Value and Value 2.
Contains
Returns True if the field value (string) contains the value specified in the Value field.
Ends with
Returns True if the field value ends with the character or string specified in the Value field.
Starts with
Returns True if the field value begins with the character or string specified in the Value field.
Is null
Returns True if the field value is null.
Is not null
Returns True if the field value is not null.
Does not contain
Returns True if the field value (string) does not contain the value specified in the Value field.
Is relative A check box that indicates (if selected) that the field value represents the number of days with respect to the current business date.
Value The first value of the condition, which will be compared with the value of the selected field. Most of the conditions require only one value, while Is between requires two values.
Value 2 The second value of the condition, if required by the selected condition.
Brackets The closing bracket or brackets for composing a logical expression with multiple conditions.
Operator The logical operator to be used between the logical conditions enclosed in brackets.
## The Target restrictions tab You can use this tab to set up restrictions that are applied to records after they have been processed by the import scenario. For example: Suppose you have imported customer records to Visma Net and then manually changed the status of some of these records to **Inactive**,and now you want to update only those imported customer records that have **Inactive** status. Because you do not have the status in the source file, you cannot use source restrictions to select needed records. You can specify a target restriction that makes the system save the results of import for only the records that have **Inactive** status in Visma Net.
Column Description
Active A check box that indicates (if selected) that the restriction is active.
Brackets The opening bracket or brackets for composing a logical expression with multiple conditions.
Field name The field whose value the condition will be applied to.
Condition

The logical operation to apply to the value of the selected field; in some cases, the operation entails comparing it to the values specified for Value and Value 2.

Typically, the following options are available: Equals, Does not equal, Is greater than, Is greater *than or equal to*, Is less than, Is less than or *equal to*, Is between, Contains, Ends *with*, Starts with, Is null, Is not *null*.

Is relative A check box that indicates (if selected) that the field value represents the number of days with respect to the current business date.
Value

The first value of the condition, which will be compared with the value of the selected field.

Most of the conditions require only one value, while Is between requires two values.

Value 2 The second value of the condition, if required by the selected condition.
Brackets The closing bracket or brackets for composing a logical expression with multiple conditions.
Operator The logical operator to be used between the logical conditions enclosed in brackets.
Download attachments (SM508090) /visma-net-erp/help/integration/integration-windows/download-attachments-sm508090 page You use this window to download attachments on 2026-02-19T17:09:06+01:00 # Download attachments (SM508090) You use this window to download attachments on This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes. > [!NOTE] > This window is only available for users assigned with the Financial administrator role. + customer, + supplier, + journal, and + cash transactions. We recommend that you create one archive per financial year. If your company has many attachments, this process will take some time. Visma Net allows you to leave the window and continue to work with your other tasks in Visma Net. You can return to this window at any time, to see if the process has been completed and your archive is ready to be downloaded. ## Search line in list window If you are in the list window, the first line in the table is a search line. Each column has a search field which you can click to search for or filter on specific values and narrow down the displayed table rows. You can search and filter in as many columns as you need to, to only display the results you want to view. There are two types of search fields: + White: here you can type a specific search term to display results in this column containing this exact value. If you search on several (partial) words, you can separate them by a space or **%** and get different results: + space: the result contains the words in any order, + **%**: the result contains the words in the specific order, and the **%** functions as a wildcard as well. + Grey: you can click this to open the column filter pop-up window where you can filter the results for this column. ## What to do from this window + [Download your company’s attachments](/visma-net-erp/help/integration/download-your-company-s-attachments/) ## The window toolbar
Button Description
Generate archives Creates one or more archives with your company’s attachments.
Update status Checks and updates the archive status.
Information box Gives information about how the archive is generated.
## The Available zip archives tab
Element Description
Download (button) Downloads the selected archive.
File name

An automatically created file name showing the company ID and From/To period for the included attachments.

Example:

Company: 123456

Document type:

AR - Customer transactions,

AP - Supplier transactions,

GL- General ledger transactions, or

CA - Cash transactions

From period: 202301

To period: 202312

File size (KB) Total file size of the archive.
Expires on The date when the archive will no longer be available for download.
Created on The date when the archive was created.
Created by user The name of the user who created the archive.
Last downloaded on The date when the zip file was last downloaded by a user.
Downloaded by user The name of the user who downloaded the archive.
## The History tab
Element Description
Download (button) Downloads the selected archive.
File name

An automatically created file name showing the company ID and From/To period for the included attachments.

Example:

Company: 123456

Document type:

AR - Customer transactions,

AP - Supplier transactions,

GL- General ledger transactions, or

CA - Cash transactions

From period: 202301

To period: 202312

File size (KB) Total file size of the archive.
Expires on The date when the archive will no longer be available for download.
Created on The date when the archive was created.
Created by user The name of the user who created the archive.
Last downloaded on The date when the zip file was last downloaded by a user.
Downloaded by user The name of the user who downloaded the archive.