VismaNET - Connector Settings
This document details the connector-specific settings for the VismaNET connector. These settings control various aspects of data synchronization, order processing, and authentication, allowing administrators to tailor the connector's behavior without direct code modification.
Connector settings are typically configured through the App4Sales portal UI and are applied at runtime, influencing how the connector interacts with the Visma.net ERP system.
Setting | Description | Values / Defaults | Dependencies / Effects |
VismaNet Tenant Id | Unique identifier for your Visma.net tenant. | String | Required for connecting to Visma.net. This property is encrypted. |
Visma NeXtGen api tenant Id | Unique identifier for your Visma NeXtGen API tenant. | String | This property is encrypted. |
Company name in Visma.net | The exact name of the company as configured in Visma.net. | String | Required for identifying the correct company within Visma.net. |
Default VAT country code (if different from administration country code) | Specifies the default VAT country code to be used if it differs from the administration's country code. | String | |
Default sales unit on order | Sets the default unit of measure for sales orders. | String | |
Warehouses (separated by ;) | A semicolon-separated list of warehouses to be considered by the connector. | Semicolon-separated string of warehouse codes | |
Warehouse for A4S orders | Specifies the warehouse to be used specifically for App4Sales orders. | String | |
Warehouse for P4S orders | Specifies the warehouse to be used specifically for P4S (presumably App4Picking) orders. | String | |
Tax zone for VAT liability | Defines the tax zone to be applied for VAT liable transactions. | String | |
Tax zone for not VAT liability | Defines the tax zone to be applied for non-VAT liable transactions. | String | |
Default currency for new customers | Sets the default currency for newly created customers. | String (e.g., EUR, USD) | |
Customer class for new customers | Assigns a default customer class to new customers. | String | |
Get order history from backoffice | When enabled, the connector retrieves order history directly from the backoffice system. | Boolean (Default: False) | |
Order history max. number of months shown | Determines the maximum number of months for which order history will be displayed. | Integer (Default: 0) | Only applicable if 'Get order history from backoffice' is enabled. |
Synchronize detailed stock information | When enabled, the connector will synchronize detailed stock information, including warehouse locations and quantities. | Boolean (Default: False) | |
Attribute ID for purchase package size | Specifies the attribute ID in Visma.net that corresponds to the purchase package size of an item. | String | |
Create orders on hold | When enabled, all new orders created through the connector will be placed on hold in Visma.net. | Boolean (Default: False) | |
Save orderline instruction as reasonCode | If enabled, order line instructions from App4Sales will be mapped to the 'reasonCode' field in Visma.net. | Boolean (Default: False) | |
Don't sync ERP attachments | When enabled, attachments from the ERP system will not be synchronized to App4Sales. | Boolean (Default: False) | |
Set default vat id for items to determine percentages | Specifies a default VAT ID for items, used to determine applicable VAT percentages. | String | |
Send no price and discount to visma.net | If enabled, pricing and discount information will not be sent from App4Sales to Visma.net during order creation. | Boolean (Default: False) | |
Synchronize every location as seperate customers | When enabled, each distinct location associated with a customer will be synchronized as a separate customer record in App4Sales. | Boolean (Default: False) | |
Warehouse locations to be excluded from stock (; separated) | A semicolon-separated list of warehouse locations whose stock should be excluded from synchronization. | Semicolon-separated string of warehouse location codes | Only applicable if 'Synchronize detailed stock information' is enabled. |
Use Units of Measure for Purchase Package Size | Specifies the field to be used for Units of Measure related to purchase package size. | String | |
Custom item field for the item status | Defines the custom item field in Visma.net that holds the item's status. | String | |
Use v1 endpoint for item live stock call | When enabled, the connector will use the V1 API endpoint for retrieving live stock information for items. | Boolean (Default: False) | |
Discount type, the choices are 'Customer discount', 'Item group discount' or 'Customer and item group discount' | Determines the type of discount to be applied. | String (Choices: 'Customer discount', 'Item group discount', 'Customer and item group discount') | |
Use Price Class Id For Discount | When enabled, the price class ID will be used for discount calculations. | Boolean (Default: False) | |
Use Campagne Discounts | When enabled, campaign-specific discounts will be applied. | Boolean (Default: False) | |
Send your reference on the order to the Customer Order field | If enabled, the 'Your Reference' field from App4Sales orders will be mapped to the 'Customer Order' field in Visma.net. | Boolean (Default: False) | |
Only use attribute description for item categories | When enabled, only the attribute description will be used for item categories. | Boolean (Default: False) |
Domain Specifics
Authentication
The connector utilizes encrypted properties for sensitive authentication details such as Tenant IDs and API tokens to ensure secure communication with Visma.net.
Order Processing
Settings related to order processing allow for fine-grained control over how orders are created and updated in Visma.net, including options for placing orders on hold, handling discounts, and managing VAT information.
Stock Management
Detailed stock synchronization can be enabled, and specific warehouse locations can be excluded from stock updates, providing flexibility in how inventory is managed between App4Sales and Visma.net.