Multivers - Connector Settings
This document describes the connector-specific settings for the Multivers connector. These settings allow administrators to configure how data is synchronized and how orders are sent to Multivers. The settings are managed in the App4Sales CMS.
Authentication
These settings are required to connect to the Multivers API.
Setting | Description | Values / Defaults | Dependencies / Effects |
Environment | Specifies the Multivers environment to connect to. | String (e.g., "MVO000000"). | This is a required field for establishing a connection to the correct Multivers database. |
Username multivers | The username for authenticating with the Multivers portal. | String. | Required for authentication. |
Password multivers | The password for authenticating with the Multivers portal. | String (will be encrypted). | Required for authentication. |
Catalog
Items
Setting | Description | Values / Defaults | Dependencies / Effects |
Insert items based on free field | Specifies the free field that is used as a condition to insert items. If the field is filled, the connector will check the value of that field. | String (e.g., "VRIJVELD1"). | Works in conjunction with "Insert items based on free field value". |
Insert items based on free field value | Specifies the value for the free field defined in "Insert items based on free field". If the value matches, the item is inserted. | String (e.g., "APP4SALES"). | Depends on "Insert items based on free field". |
Use item sort field on free field | Uses a free field to define the sort order of items in App4Sales. | String (e.g., "VRIJVELD2"). | Changes the default item sort order. |
Include outlet items in sync | If enabled, the item synchronization will include outlet items. | Boolean (true/false). Defaults to false. | Expands the scope of the item synchronization to include items marked as outlet items. |
Only sync 'publish on web' items | If enabled, only items flagged as 'publish on web' in Multivers will be synchronized. | Boolean (true/false). Defaults to false. | Filters the item synchronization to a smaller subset. |
Synchronize assembly items | If enabled, assembly items (Bill of Materials) are included in the item synchronization. | Boolean (true/false). Defaults to false. | Adds composite items to the catalog in App4Sales. |
Ean code from custom item field | Specifies the custom item field from which to retrieve the EAN code (barcode). | String (field name). | Overrides the default mapping for the EAN code. |
Purchase package size from custom item field | Specifies the custom item field from which to retrieve the purchase package size. | String (field name). | Overrides the default mapping for the purchase package size. |
Images
Setting | Description | Values / Defaults | Dependencies / Effects |
Url to images | The URL or path where item images are located. | String (URL path, e.g., "https://example.com/images/"). | Used when "Get images from Url" is enabled. |
Get images from Url | If enabled, the connector will fetch item images from the URL specified in "Url to images". The expected image name is the item code. | Boolean (true/false). Defaults to false. | Requires "Url to images" to be set. |
Prices & Discounts
Setting | Description | Values / Defaults | Dependencies / Effects |
Discount Account Id | The account ID used for booking discounts in Multivers. | String (Account ID). | Affects how discounts on orders are recorded in the financial administration. |
Price List 1 (= freefield~pricelistcode) | Defines the ID for Price List 1, which corresponds to the `pricelistcode` free field in Multivers. | String (Price List ID). | Maps an App4Sales price list to a Multivers price list. |
Price List 2 (= freefield~pricelistcode) | Defines the ID for Price List 2. | String (Price List ID). | See Price List 1. |
Price List 3 (= freefield~pricelistcode) | Defines the ID for Price List 3. | String (Price List ID). | See Price List 1. |
Price List 4 (= freefield~pricelistcode) | Defines the ID for Price List 4. | String (Price List ID). | See Price List 1. |
Stock
Setting | Description | Values / Defaults | Dependencies / Effects |
Warehouse: use sales rep login name as Id | If enabled, the sales representative's login name is used as the warehouse ID for stock lookups. | Boolean (true/false). Defaults to false. | Mutually exclusive with "Warehouse: default Id". This will show sales rep-specific stock levels. |
Warehouse: default Id | Specifies a default warehouse ID to be used for all stock lookups. | String (Warehouse ID). | Used if "Warehouse: use sales rep login name as Id" is disabled. |
Free stock from free field | Specifies the free field from which to retrieve the free-to-sell stock quantity. | String (field name). | Overrides the default mapping for stock levels. |
Filter stock by Warehouse (code) | Filters the stock synchronization to only include stock from the specified warehouse code. | String (Warehouse code). | Limits the stock information synced to App4Sales for all users. |
Customers
Setting | Description | Values / Defaults | Dependencies / Effects |
Include prospects in customer sync | If enabled, the customer synchronization will include prospects from Multivers. | Boolean (true/false). Defaults to false. | Expands the scope of the customer sync. |
Custom relation card | If enabled, a custom relation card is used. The implementation details are specific to the customer's setup. | Boolean (true/false). Defaults to false. | Requires custom implementation work to function. |
Customer classification from custom customer field | Specifies the custom customer field from which to retrieve the customer classification (e.g., for categorizing customers). | String (field name). | Changes the source for customer classification data. |
Orders & Invoices
Order Processing
Setting | Description | Values / Defaults | Dependencies / Effects |
Task action origin (default: ALG) | Specifies the origin for task actions when creating orders. | String. Defaults to "ALG". | Affects how task actions related to orders are logged or sourced in Multivers. |
Quantity to deliver is ordered quantity | If enabled, the quantity to deliver on an order line will be set to the ordered quantity, ignoring any backorder logic. | Boolean (true/false). Defaults to false. | Affects order fulfillment logic in Multivers. |
Use original item price when sending an order | If enabled, the original item price from Multivers is used when sending an order, ignoring any price calculations or discounts applied in App4Sales. | Boolean (true/false). Defaults to false. | Ensures prices on new orders match the ERP's base prices. |
Use sales rep name instead of username | If enabled, the sales representative's full name is used instead of their username when sending an order. | Boolean (true/false). Defaults to false. | Affects how the sales representative is identified on the order in Multivers. |
Send order note | If enabled, a note will be sent with the order. | Boolean (true/false). Defaults to false. | Requires "Order note type" and "Order note origin" to be configured. |
Order note type | Defines the type of the order note (e.g., "MEMO"). | String. | Used when "Send order note" is enabled. |
Order note origin | Defines the origin of the order note (e.g., "APP"). | String. | Used when "Send order note" is enabled. |
Send contactperson at a order | If enabled, the contact person's details are sent with the order. | Boolean (true/false). Defaults to false. | Adds contact details to the order in Multivers. |
Description field 3 for contactperson Id | If enabled, the description field 3 is used to store the contact person ID. | Boolean (true/false). Defaults to false. | Changes where the contact person ID is sourced from on the order. |
Send orderline instruction as new orderline | If enabled, an instruction added to an order line in App4Sales is sent as a separate, non-stock order line to Multivers. | Boolean (true/false). Defaults to false. | Changes how order line comments are represented in Multivers. |
Remove orderLines to Multivers when package size > 1 and quantity is 1 | If enabled, order lines with a quantity of 1 are not sent to Multivers if the item's package size is greater than 1. | Boolean (true/false). Defaults to false. | Prevents orders for single units when the item is sold in packages. |
'Processed by' on an order | Specifies a static value for the 'Processed by' field on an order sent to Multivers. | String. | Sets a fixed value to identify the order source. |
Discounts
Setting | Description | Values / Defaults | Dependencies / Effects |
Don't send discount to backoffice | If enabled, no discount information (either line or total) will be sent to Multivers. | Boolean (true/false). Defaults to false. | This setting overrides all other discount calculations and settings. |
Discount is fraction (not a %) | If enabled, the discount is treated as a fractional value (e.g., 0.1 for 10%) instead of a percentage. Otherwise, it is treated as a percentage. | Boolean (true/false). Defaults to false. | Affects how discount values from App4Sales are interpreted by the connector. |
Send the calculated discount to backoffice | If enabled, the final discount calculated in App4Sales is sent to the backoffice. | Boolean (true/false). Defaults to false. | Can be overridden by "Don't send discount to backoffice". |
Addresses
Setting | Description | Values / Defaults | Dependencies / Effects |
Address lines have normal order | When enabled, address line 1 from App4Sales is mapped to address line 1 in the backoffice. If disabled, the mapping might be different (e.g., swapped). | Boolean (true/false). Defaults to false. | Affects how shipping and billing addresses are sent to Multivers. |
Set delivery address on order | If enabled, the delivery address from App4Sales is set on the order in Multivers. | Boolean (true/false). Defaults to false. | Ensures the shipping address is explicitly included in the order data. |
Set customer name on delivery address | If enabled, the customer's name is included in the delivery address details. | Boolean (true/false). Defaults to false. | Affects the formatting of the delivery address. Depends on "Set delivery address on order" being enabled. |
Only send delivery address to backoffice | If enabled, only the delivery address is sent to Multivers; other address types (like billing) are omitted. | Boolean (true/false). Defaults to false. | Affects address data sent with orders or customer updates, simplifying the address information. |
Swap delivery address lines for multivers confirmation | If enabled, delivery address lines are swapped when generating the Multivers confirmation document. | Boolean (true/false). Defaults to false. | Affects address formatting specifically for confirmation reports, not the order data itself. |
VAT
Setting | Description | Values / Defaults | Dependencies / Effects |
Send Vat scenario for countries outside EU | If enabled, a specific VAT scenario is applied for orders where the delivery country is outside the European Union. | Boolean (true/false). Defaults to false. | Affects VAT calculation for international orders. |
Send VATLiable = 'No' as 'Shifted' to backoffice | If enabled, an order marked with `VATLiable = 'No'` in App4Sales is translated to a 'Shifted' VAT type in Multivers. | Boolean (true/false). Defaults to false. | Affects how VAT-exempt or reverse-charged orders are recorded in Multivers. |
History
Setting | Description | Values / Defaults | Dependencies / Effects |
Show all orders | If enabled, all historical orders are shown in App4Sales, potentially ignoring user-specific filters. | Boolean (true/false). Defaults to false. | Affects order history visibility for sales reps. |
Show only backorder lines in App4Sales | If enabled, only lines from historical orders that are on backorder will be displayed in App4Sales. | Boolean (true/false). Defaults to false. | Filters the order history to focus only on outstanding items. |
Show orders from backoffice | If enabled, order history is retrieved from the backoffice (Multivers). | Boolean (true/false). Defaults to false. | This is the master switch for enabling order history synchronization. |
Maximum days to retrieve order and invoice history for | The maximum number of past days for which to retrieve order and invoice history. This is limited to a maximum of 3 years (1095 days). | Integer. | Limits the amount of historical data synced to App4Sales, which can improve performance. |