Setting

Description

Values / Defaults

Dependencies / Effects

UseProductAttributeForPurchasePackageSize

Specifies which product attribute from Multivers should be used to determine the purchase package size for an item.

String (Attribute Name) / Empty

Impacts item data synchronization. If set, the connector will look for this attribute on products.

ProductBaseCurrencySymbol

Defines the currency symbol for the base price of a product.

String (e.g., "€", "$") / Empty

Used during item and price synchronization to correctly represent monetary values.

UseCodeAsItemCategoriesDescription

If enabled, the category code will be used as the description for item categories.

Boolean (true/false) / false

Changes how item category information is displayed in App4Sales.

MultiLevelItemCategories

Defines a structure for creating hierarchical item categories based on item attributes.

String (e.g., "Brand;Group;Subgroup") / Empty

Affects item categorization. The connector will create a nested category structure based on the specified fields.

GroupMultiLevelItemCategories

When enabled, items are grouped under the multi-level categories created.

Boolean (true/false) / false

Works in conjunction with 'MultiLevelItemCategories'. Affects the catalog structure.

BasePriceListCodeForItemSalesPrice

The code for the base price list used for item sales prices. This is mandatory when retrieving action pricelists.

String (Pricelist Code) / Empty

Required for `RetrieveActionPriceLists`. Essential for price calculations.

BaseCurrencyCode

Specifies the default currency code for financial transactions.

String (e.g., "EUR", "USD") / Empty

Fundamental for all pricing and order-related operations.

AddDefaultFieldsToItemCategories

A comma-separated list of default item properties to be added as item categories.

String (comma-separated) / Empty

Allows for creating categories from standard item fields like 'Brand' or 'Season'.

ItemFieldsToSelectFromMultivers

A comma-separated list of specific item fields to retrieve from the Multivers API.

String (comma-separated) / Empty

Optimizes item sync by only requesting necessary data. Can cause missing data if a required field is omitted.

RetrieveMultipleCurrencyPricelists

Enables the retrieval of price lists for multiple currencies.

Boolean (true/false) / false

Affects price synchronization. When true, App4Sales will contain prices in different currencies as defined in Multivers.

AllowedDebtorCodes

A list of customer codes that are allowed to be synchronized.

String (comma-separated) / Empty

Filters which customers are imported from Multivers. If empty, all customers are synced.

SyncOnlyLowestAddressPriority

If enabled, only the customer address with the lowest priority number will be synchronized.

Boolean (true/false) / false

Restricts the number of addresses synced per customer.

DefaultAccountReference

Sets a default account reference for new customers created from App4Sales.

String / Empty

Used during the 'Create Customer' process.

OrgAddressAttributeIdForExternalAddressHash

The ID of the organization address attribute used for generating an external address hash.

String / Empty

Used to uniquely identify addresses.

UseDeliveryAddressBeforeInvoiceOnOrder

If enabled, a delivery address (ordered by priority) must be selected before the invoice address when placing an order.

Boolean (true/false) / false

Affects the address selection logic in the ordering process.

MaxParallelApiRequests

The maximum number of concurrent requests sent to the Multivers API.

Integer / 0 (no limit)

Throttles API calls to prevent rate-limiting or performance issues on the ERP side.

DefaultDeliveryConditionCode

Sets a default delivery condition for new customers.

String (Condition Code) / Empty

Applied when a new customer is created.

SyncOnlyItemsFromProductClassification

Filters the item sync to only include items belonging to a specific product classification.

String (Classification Code) / Empty

Restricts the catalog to a subset of items.

MaxItemsInQueryInClause

The maximum number of items to include in a single "IN" clause for API queries.

Integer / 100

Performance tuning for item-related queries.

ProductGroupCodeForItemSync

Filters the item sync to a specific product group code.

String (Group Code) / Empty

Restricts the synchronized catalog.

StockEventsCauseOfEventForToBeDelivered

The 'cause of event' code used to identify stock events for items that are 'to be delivered'.

String / Empty

Used in stock calculation to interpret future stock movements.

StockEventsCauseOfEventForToBeReceived

The 'cause of event' code used to identify stock events for items that are 'to be received'.

String / Empty

Used in stock calculation to interpret future inbound stock.

ShowNextQuantityStock

If enabled, the 'Next Quantity' stock field is added to the stock result.

Boolean (true/false) / false

Enriches the stock information available in App4Sales.

GetNextDeliveryDateFromRequestProductStocks

Determines the 'Next Delivery Date' from the product stock information instead of stock events.

Boolean (true/false) / false

Changes the source for the next available date, potentially providing a more accurate date from the ERP.

ShowBlockedStock

If enabled, blocked stock quantities are included in the stock information.

Boolean (true/false) / false

Provides more detailed insight into stock availability.

ShowAvailableStockBasedOnComponents

Calculates available stock based on the stock of component parts (for bill-of-materials items).

Boolean (true/false) / false

Used for complex/manufactured products to show calculated stock.

UseAvailableStockFromME

Loads the "available stock" figure directly from Multivers Extended.

Boolean (true/false) / false

If false, available stock might be calculated based on other stock fields.

UseUnitRelationsForPurchasePackageSize

Uses unit relations (e.g., box, pallet) to determine the purchase package size, based on the item's packing unit.

Boolean (true/false) / false

Affects how purchase quantities are handled.

CurrencyToRetrieveDefaultPrice

Specifies the currency for the default sales price. Leave empty if no currencies are set up on default prices.

String (Currency Code) / Empty

Ensures the correct default price is retrieved in multi-currency environments.

GetExtraDescriptionAsFreeField

If enabled, the translated extra description of an item is shown in the item details as a free field.

Boolean (true/false) / false

Makes additional item information visible in the app.

MaxBatchSize

Sets the maximum batch size for API requests.

Integer / 1000

Controls the number of records processed in a single API call to manage memory and prevent timeouts.

RetrieveActionPriceLists

Enables the retrieval of promotion prices, which are displayed as "from/to" prices.

Boolean (true/false) / false

Requires 'BasePriceListCodeForItemSalesPrice' to be set. Shows temporary discounts or sales prices.

OnlySendCustomDiscount

If enabled, only manually added discounts will be sent in orders.

Boolean (true/false) / false

Prevents standard or automated discounts from being included in the order sent to Multivers.

ShowOnlyActualDeliveryDates

Filters stock events to show only actual delivery dates, hiding other stock movements.

Boolean (true/false) / false

Simplifies the delivery date information shown to the user.

SetDeliveryAddressAsOneOff

If enabled, the delivery address for an order is marked as a one-off address and is not saved to the customer.

Boolean (true/false) / false

Prevents temporary shipping addresses from cluttering customer data.

RetrievePastOrderLinesAsFreeFieldForCustomer

When opening item details with a customer selected, this retrieves that customer's past order lines for that item.

Boolean (true/false) / false

Provides sales history to the user directly on the item card.

OrderStatusForNewOrders

Sets the status for new orders sent to Multivers.

String / "O"

Controls the initial state of an order in the ERP.

SyncOnlyItemsWithAttributeValue

Filters the item sync to only include items with a specific attribute name and value.

String (Format: `AttributeName=AttributeValue;...`) / Empty

Allows for very specific filtering of the item catalog based on one or more attributes.

OrderInvoiceHistoryInYears

The number of years of order and invoice history to retrieve.

Integer / 1

Controls how far back the connector looks for historical order/invoice data.

CategoryCodeToRetrieveAsCustomerClassification

The organization classification code to use as the customer's classification (category code).

String / Empty

Maps an ERP classification to the App4Sales customer category.

ItemStatusFieldName

The name of the field that contains the item's status.

String / Empty

Used to determine if an item is active or inactive based on a specific field in Multivers.

DontSendItemDescriptionToOrderlineNote

If enabled, the item's description will not be added to the order line note.

Boolean (true/false) / false

Prevents redundant information from being sent in the order data.

NeverSetDeliveryDateOnOrderlines

If enabled, the delivery date will never be filled in on order lines.

Boolean (true/false) / false

Prevents sending line-level delivery dates, relying on a header-level date instead.

UseSalesContracts

Enables the use of sales contracts when creating a sales order.

Boolean (true/false) / false

Activates sales contract functionality during order creation. Several `SalesContract...` settings depend on this.

SalesContractType

The type of sales contract to be used.

String / Empty

Dependent on `UseSalesContracts`.

SalesContractDeliveryConditionCode

The delivery condition code for the sales contract.

String / Empty

Dependent on `UseSalesContracts`.

SalesContractOrderType

The order type for the sales contract.

String / Empty

Dependent on `UseSalesContracts`.

IncludeSalesContractsToOrdersHistory

If enabled, sales contracts will be included in the order history.

Boolean (true/false) / false

Makes contract information visible alongside regular orders.

GetAvailableStockForSales

Retrieves the "available for sales" stock from the API and includes it in the full stock string.

Boolean (true/false) / false

Provides a specific stock figure intended for sales purposes.

DefaultStockProblemValue

A default value to use when a stock problem is encountered.

String / Empty

Error handling for stock retrieval.

SkipInactiveCustomersDuringSync

If enabled, customers marked as inactive in Multivers will be skipped during synchronization.

Boolean (true/false) / false

Keeps the customer list in App4Sales clean by excluding non-active customers.

ItemCodeIncludesUnitCode

Indicates that the item code from Multivers includes the unit code.

Boolean (true/false) / false

The connector may attempt to parse the unit from the item code if this is enabled.

SyncTierPrices

Enables the synchronization of tier prices (quantity-based discounts).

Boolean (true/false) / false

Also known as volume pricing or quantity discounts.

DontUpdateDuplicateAddress

If enabled, the connector will not update customer addresses if it detects them as duplicates.

Boolean (true/false) / false

Prevents overwriting of existing address data that is deemed identical.

CustomerDiscountProductGroupCode

A product group code used for customer-specific discounts to prevent an overflow of prices.

String / Empty

Helps manage complex customer discount scenarios by linking them to a product group.

SetStafflePricesBasedOnActivePriceLists

Calculates staffle (tiered) prices based on the active price lists.

Boolean (true/false) / false

Alternative way to calculate tiered pricing.

DontSendOrderLineDiscountsToMultivers

If enabled, order and quotation line discounts are not sent to Multivers.

Boolean (true/false) / false

The ERP is expected to calculate all discounts.

DivideSalesPriceByPricePer

If enabled, the sales price is divided by the 'price per' quantity.

Boolean (true/false) / false

Used when the price is specified for a certain quantity (e.g., price per 100).

SendCustomPriceAsSalesPriceOnOrderLine

If a custom price is used, this setting sends it as the main sales price on the order line.

Boolean (true/false) / false

Ensures manually entered prices are correctly passed to the ERP.

OutsideDeliveriesAllowedForNewSalesContracts

If enabled, new sales contracts will have the 'Outside deliveries allowed' field enabled.

Boolean (true/false) / false

Dependent on `UseSalesContracts`.

AddNewSalesContractLinesToLatestContract

If a customer already has a valid sales contract, new lines are added to that contract instead of creating a new one.

Boolean (true/false) / false

Dependent on `UseSalesContracts`.

UseOrderDateAsContractDate

Uses the order date as the contract date for new sales contracts.

Boolean (true/false) / false

Dependent on `UseSalesContracts`.

UseOrderDateAsStartDate

Uses the order date as the start date for new sales contracts.

Boolean (true/false) / false

Dependent on `UseSalesContracts`.

UseOrderDateAsEndDate

Uses the order date as the end date for new sales contracts.

Boolean (true/false) / false

Dependent on `UseSalesContracts`.

SendOrderNoteInOrderInstructions

If enabled, the order-level notes are sent in the order instructions field.

Boolean (true/false) / false

Changes where order notes are mapped in the data sent to Multivers.

UseAlternateReference

Combines multiple fields (Default Reference, Reference, Description1, Your Reference) to form the order reference.

Boolean (true/false) / false

Creates a composite reference field for the order.

UseDiscountProductGroupDebtorDiscountsFallback

Uses discounts from product groups as a fallback during live price calls.

Boolean (true/false) / false

Provides a fallback mechanism for price calculations.

HomeCountry

The home country code, used for determining the correct VAT scenario.

String (Country Code) / Empty

Required for VAT calculations. Works with `VatScenarioCode...` settings.

VatScenarioCodeHomeCountry

The VAT scenario code to use for transactions within the home country.

String / Empty

Dependent on `HomeCountry`.

VatScenarioCodeEU

The VAT scenario code for transactions within the EU (but outside the home country).

String / Empty

Dependent on `HomeCountry`.

VatScenarioCodeOutsideEU

The VAT scenario code for transactions outside of the EU.

String / Empty

Dependent on `HomeCountry`.

OnlyPickAddressesWithNonEmptyAttributeCode

Ensures that the `AttributeCode` on delivery addresses has a value when sending order lines.

Boolean (true/false) / false

May be mandatory for some administrations to correctly process delivery addresses.

PutCustomerDiscountOnOrderlineDuringSendOrder

Applies the overall customer discount directly to each order line when sending an order.

Boolean (true/false) / false

Changes how discounts are represented in the order data sent to Multivers.

SetDeliveryLineOnOrderLines

If enabled, the delivery line information is sent on the order lines.

Boolean (true/false) / false

Includes delivery details at the line level.

OrganisationCategoryGroupIdForPortal4SalesItemStock

The category group ID used for item stock.

String / Empty

Used to filter or categorize stock information.

TeleComUsedTypeTelephone

The 'used type' for telephone numbers in telecom records.

String / Empty

Defines how telephone numbers are categorized (e.g., 'Work', 'Mobile').

TeleComUsedTypeEmail

The 'used type' for email addresses in telecom records.

String / Empty

Defines how email addresses are categorized (e.g., 'Work', 'Private').

UseInstructionLineAsDeliveryDate

If enabled, the instruction line is used as the delivery date.

Boolean (true/false) / false

Provides an alternative source for the delivery date on orders.

DisabledCustomersPrefix

A prefix added to the name of disabled customers to easily identify them.

String / Empty

Helps manage customer visibility in App4Sales.

InsertCustomerTemplate

A template to use when inserting new customers.

String / Empty

Defines default values or structure for new customer creation.

Warehouse

Specifies the warehouse to be used for stock and orders.

String (Warehouse ID) / Empty

Filters stock and other data to a specific warehouse. Can be critical if multiple warehouses are used.

AdminId

The administration ID for the Multivers company.

String / Empty

Required. The connector cannot function without this setting.

StockIndicatorBasedOnEvents

If enabled, the stock indicator (e.g., in stock, out of stock) is based on stock events.

Boolean (true/false) / false

Changes how the visual stock indicator is calculated. If false, it may be based on a simple quantity check.

UseActualStockAsShelfStock

Maps the 'actual stock' from Multivers to the 'shelf stock' field in App4Sales.

Boolean (true/false) / false

Determines which stock value is used for the shelf stock display.

UseDiscountOnCustomerPrice

Applies discounts on top of customer-specific prices.

Boolean (true/false) / false

If disabled, discounts might only apply to the base price, not special customer prices.

DefaultReference

A default reference to be used for sales orders.

String / Empty

Populates the order reference field if no other reference is provided.

DefaultDiscountItem

The item code to use for representing an overall discount on an order.

String (Item Code) / Empty

Used when sending order-level discounts as a separate line item.

AddressesPriorityCodeToSync

Only synchronizes addresses that have a specific priority code.

Integer / null

Filters addresses based on their priority.

SubstractReservedStockFromToBeDelivered

Subtracts reserved stock from the 'to be delivered' quantity.

Boolean (true/false) / false

Adjusts future stock calculations.

FilterOrderLinesStatusZAndQuantity0

If enabled, order lines with status 'Z' and quantity '0' are filtered out.

Boolean (true/false) / false

Cleans up historical order data by removing zero-quantity lines with a specific status.