Muis - Connector Settings
The Muis connector settings allow administrators to configure how App4Sales interacts with the Muis ERP system. These settings control various aspects of data synchronization, including items, customers, orders, and more. Proper configuration of these settings is crucial for ensuring that data is transferred correctly and that the connector functions as expected.
The settings are managed within the App4Sales admin portal for a specific Muis administration. They are applied at runtime by the connector during data synchronization and order processing. Changes to these settings can affect which data is retrieved from Muis, how it is mapped to App4Sales fields, and how orders are sent back to the ERP.
Setting | Description | Values / Defaults | Dependencies / Effects |
Environment code | The specific Muis environment to connect to. | String. Example: | This is a required field for establishing a connection to the Muis API. |
Session timeout in minutes | Specifies how long an API session remains active before timing out. | Integer. | Helps manage connection resources and security. A new login will be required after the timeout. |
Always login before connector commands | Forces the connector to perform a new login for every command executed. | Boolean (true/false). Default: false. | Enable this if you encounter frequent session timeouts or connection issues. It may slightly decrease performance due to login overhead. |
Itemgroup description (default: Artikelgroep) | Defines the name for item groups. | String. Default: "Artikelgroep". | Used when displaying and mapping item groups from Muis. |
Don't sync itemgroups | If enabled, the connector will not synchronize item groups. | Boolean (true/false). Default: false. | Useful if item groups are not used or managed externally. |
Don't sync items marked as blocked for webshop | Excludes items that are flagged as blocked for webshop use in Muis from the synchronization. | Boolean (true/false). Default: false. | Allows for filtering out items that should not be visible in App4Sales. |
Don't send price to backoffice | Prevents the connector from sending item prices back to Muis when creating an order. | Boolean (true/false). Default: false. | Enable this if prices are always determined by the ERP and should not be overwritten by App4Sales. |
Muis order method | The default method to be used for creating orders in Muis. | String. | This value must correspond to a valid order method configured in the Muis environment. |
Muis shipping method | The default shipping method for orders sent to Muis. | String. | This value must correspond to a valid shipping method in Muis. |
Collection description (default: Artikelcollectie) | Defines the name for item collections. | String. Default: "Artikelcollectie". | Used for displaying and mapping item collections. |
Don't sync item collections | If enabled, item collections will not be synchronized. | Boolean (true/false). Default: false. | Use if item collections are not relevant for App4Sales. |
Item freefield names (comma separated - empty values are skipped) | A comma-separated list of Muis free field names to be synchronized as item properties. | String. | Allows custom fields from Muis to be available in App4Sales. Empty entries in the list are ignored. |
Free field names to use as item classes (comma separated - empty values are skipped) | Specifies which of the free fields should be treated as item classes (for categorization). | String. | Depends on the fields defined in `ItemFreeFieldNames`. Used to create filterable categories in App4Sales. |
Server culture setting | Sets the culture for formatting data like dates and numbers. | String (e.g., "nl-NL", "en-US"). Default: "nl-NL". | Ensures that data is parsed and displayed correctly according to regional standards. |
Pagesize for picture synchronization (default: 50) | The number of pictures to retrieve in a single batch during synchronization. | Integer. Default: 50. | Helps manage memory and API load during image sync. Adjust if timeouts or performance issues occur. |
Default delivery condition for orders | Sets a default delivery condition for new orders sent to Muis. | String. | Must match a valid delivery condition in Muis. |
Retrieve order history from backoffice | Enables the synchronization of historical orders from Muis to App4Sales. | Boolean (true/false). Default: false. | Allows users to view past orders within App4Sales. |
VatLiableCode | The code used in Muis to indicate that a customer is liable for VAT. | String. | Used during customer and order synchronization to set the correct VAT status. |
NotVatLiableCode | The code used in Muis to indicate that a customer is not liable for VAT. | String. | Used during customer and order synchronization to set the correct VAT status. |
Muis order method for Portal4Sales | A specific order method to be used for orders originating from Portal4Sales. | String. | If set, this overrides the default `MuisOrderMethod` for Portal4Sales orders. |
Use alternative purchase package size (suggested sales size) | If enabled, the connector uses an alternative field for the package size of an item, often representing a suggested sales quantity. | Boolean (true/false). Default: false. | Affects how item quantities and package sizes are displayed and handled. |
Item freefield to use as sort field (1 - 10) | Specifies which free field (by number) should be used to define a custom sort order for items. | Integer (1-10). | Requires `SortOrderByFreeSortField` to be enabled. Allows for custom item sorting in catalogs. |
Sort order by free sort field | When enabled, items are sorted based on the value in the free field specified by `FreeFieldAsSortField`. | Boolean (true/false). Default: false. | This setting enables the custom sorting logic defined by `FreeFieldAsSortField`. |
Hide the quotation history from the relation card | If enabled, quotation history will not be displayed on the customer card in App4Sales. | Boolean (true/false). Default: false. | Useful for simplifying the customer view if quotations are not relevant. |
Authentication
Authentication with the Muis API is handled via an environment code. A session is established which is kept alive for a configurable duration (Session timeout in minutes). For unstable connections, the Always login before connector commands setting can be enabled to ensure each command is executed within a fresh session, at a minor performance cost.
Catalog and Item Management
The connector allows for detailed control over the item catalog. Item groups and collections can be ignored entirely using the Don't sync itemgroups and Don't sync item collections settings, respectively. Items can be filtered from synchronization based on a "blocked for webshop" flag in Muis by enabling Don't sync items marked as blocked for webshop. Custom data can be added to items using free fields, specified via Item freefield names, and these can be repurposed as item classes for filtering using Free fields for item classes. Sorting can be customized by using one of the free fields as a sort index, which is controlled by the Item freefield to use as sort field and Sort order by free sort field settings.
Order Processing
When sending orders to Muis, the connector uses a default Muis order method and Muis shipping method. A separate order method can be defined for orders from Portal4Sales with the Muis order method for Portal4Sales setting. You can prevent App4Sales from dictating the price on an order by enabling Don't send price to backoffice. A Default delivery condition for orders can also be specified.