Skip to main content

VismaNET - Connector settings

VismaNET - Connector Settings This document details the connector-specific settings for the VismaNET connector. These settings control va...

Updated over a week ago

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.

Did this answer your question?