Monitor - Connector Settings
The Monitor connector uses a variety of settings to control how data is synchronized between App4Sales and the Monitor ERP system. These settings allow for customization of order processing, item data handling, and FTP connection security. The settings are configured in the App4Sales CMS and are applied at runtime by the connector.
Settings Table
Setting | Description | Values / Defaults | Dependencies / Effects |
Order Prefix | Sets a prefix for order numbers. | String. Default: empty. | This prefix is added to the beginning of every order number sent to the backoffice. |
Send original price with discount | Controls how prices and discounts are sent for order lines. | Boolean (true/false). Default: false. | When enabled (true), the original item price and the calculated discount are sent as separate fields. When disabled (false), only the final, discounted price is sent. This should be enabled if Monitor is configured to calculate discounts itself. |
Only update new pictures | When enabled, the connector will only process new item pictures. | Boolean (true/false). Default: false. | Enabling this marks all existing pictures as up-to-date, which can speed up the item update process by skipping images that have already been processed. |
Order history from backoffice | If enabled, the connector will fetch order history directly from the FTP server instead of the App4Sales database. | Boolean (true/false). Default: false. | Requires the FTP server to have order history files in a specific XML format in the 'OrderHistory' and 'ExportedOrders' folders. |
Replace 'our reference' with sales rep username | Replaces the 'Our Reference' field in an order with the username of the sales representative who created the order. | Boolean (true/false). Default: false. | This setting is mutually exclusive with "Replace 'our reference' with sales rep name". If both are enabled, the sales rep name will be used. |
Replace 'our reference' with sales rep name | Replaces the 'Our Reference' field in an order with the full name of the sales representative. | Boolean (true/false). Default: false. | If the sales rep's name is not found, their username will be used as a fallback. |
Put order numbers before order notes | Prepends the order number to the order notes. | Boolean (true/false). Default: false. | If the order has no notes, the notes field will be populated with just the order number. |
Remove spaces around item codes | Trims leading and trailing whitespace from item codes. | Boolean (true/false). Default: false. | This setting is not directly used in the provided code snippets for Monitor, but is inherited from FtpXml. Its effect depends on where `TrimItemCode` is used in the base connector logic. |
Merge instruction and description on the order | Appends the instruction text to the item description for each order line. | Boolean (true/false). Default: false. | The instruction is added to the description with a " - " separator. |
Only import items for pricelist (1-4) | Filters item imports based on whether they have a price in a specific pricelist. | Integer (1, 2, 3, or 4). Default: 0 (no filtering). | For example, if set to 2, only items with a price in 'pricelist 2' will be imported. |
Calculate total discount for orderline | Calculates the total discount percentage for an order line based on its original price and final price. | Boolean (true/false). Default: false. | The calculated discount is stored in the `Discount` field of the order line. This is useful for backoffice systems that require a discount percentage. |
Ftp folder containing stock information | Specifies the folder on the FTP server where stock information files are located. | String (folder path). Default: empty. | When an item's stock is requested, the connector will look for a file named '[itemcode].xml' in this folder. |
Don't send discount to backoffice | If enabled, the discount is included in the price and the discount field is set to 0. | Boolean (true/false). Default: false. | This is for backoffice systems that do not have a separate field for discounts. The price is recalculated to be the pre-discount price. |
Encrypt FTP data using TLS | Enables explicit FTP over TLS (FTPS). | Boolean (true/false). Default: false. | Use this for secure FTP connections. This is mutually exclusive with SSL. |
Encrypt FTP data using SSL | Enables implicit FTP over SSL (FTPS). | Boolean (true/false). Default: false. | Use this for secure FTP connections. This is mutually exclusive with TLS. |
Remove the eExact root-tag from the XML | Controls whether the ` ` root element is included in the generated order XML. | Boolean (true/false). Default: false. | This should be enabled if the receiving system does not expect this root tag. |
Authentication
The FTP connection details (host, username, password) are configured in the administration settings. The connector supports both standard FTP and secure FTP (SFTP), with options for TLS and SSL encryption for FTPS.
Order Processing
Several settings allow for customization of how orders are sent to Monitor. This includes prefixing order numbers, controlling how prices and discounts are represented, and modifying order references and notes.
Item and Stock Management
The connector can be configured to filter which items are imported based on price lists, and to fetch real-time stock information from a specified FTP folder.