FtpXml - Connector Settings
This document details the configurable settings for the FtpXml connector, which facilitate the integration between external systems and the App4Sales platform. These settings allow administrators and implementation consultants to customize data synchronization, order processing, and other behaviors without direct code modifications. Understanding these settings is crucial for proper configuration and troubleshooting.
Connector settings are stored and managed through the App4Sales portal UI and are applied at runtime to control the connector's operational logic.
Setting | Description | Values / Defaults | Dependencies / Effects |
Only update new pictures | When enabled, the connector will only synchronize new product images, ignoring existing ones. This can speed up synchronization for product catalogs with stable image sets. | Boolean (True/False) | Affects item synchronization and image update processes. |
Order history from backoffice | If enabled, the connector retrieves order history information directly from the backoffice system, ensuring that App4Sales has access to comprehensive historical order data. | Boolean (True/False) | Impacts the availability and source of historical order data within App4Sales. |
Replace 'our reference' with sales rep username | When activated, the 'our reference' field in orders or related documents will be automatically populated with the username of the sales representative who placed the order. | Boolean (True/False) | Modifies the 'our reference' field in outgoing order data. Mutually exclusive with 'Replace 'our reference' with sales rep name'. |
Replace 'our reference' with sales rep name | When activated, the 'our reference' field in orders or related documents will be automatically populated with the full name of the sales representative who placed the order. | Boolean (True/False) | Modifies the 'our reference' field in outgoing order data. Mutually exclusive with 'Replace 'our reference' with sales rep username'. |
Put order numbers before order notes | This setting determines the formatting of order notes. If enabled, the order number will be prepended to the order notes. | Boolean (True/False) | Affects the display and structure of order notes. |
Remove spaces around item codes | If enabled, the connector will automatically trim any leading or trailing whitespace from item codes during data import or processing, ensuring clean and consistent item identifiers. | Boolean (True/False) | Ensures data quality and consistency for item codes. |
Merge instruction and description on the order | When enabled, the instruction and description fields related to an order will be combined into a single field during processing or export. | Boolean (True/False) | Affects how order instructions and descriptions are handled and presented. |
Only import items for pricelist (1-4) | This setting allows filtering item imports based on their associated pricelist. Only items linked to pricelists within the specified range (1 to 4) will be imported. | Integer (1-4) | Filters the items that are imported into App4Sales. Incorrect values may lead to missing items. |
Calculate total discount for orderline | If enabled, the connector will calculate and apply the total discount at the order line level, rather than at the order header level. | Boolean (True/False) | Affects discount calculation logic for orders. |
Ftp folder containing stock information | Specifies the exact folder path on the FTP server where stock information files are located. The connector will look for stock data within this directory. | String (e.g., "stock/") | Required for successful stock data synchronization. Ensure the path is correct and accessible. |
Don't send discount to backoffice | When enabled, discount information will not be transmitted to the backoffice system during order synchronization. | Boolean (True/False) | Controls whether discount data is included in data sent to the backoffice. |
Encrypt FTP data using TLS | Enables Transport Layer Security (TLS) for encrypting data transferred via FTP, enhancing data security during synchronization. | Boolean (True/False) | Requires the FTP server to support TLS. Conflicts with 'Encrypt FTP data using SSL'. |
Encrypt FTP data using SSL | Enables Secure Sockets Layer (SSL) for encrypting data transferred via FTP, enhancing data security during synchronization. | Boolean (True/False) | Requires the FTP server to support SSL. Conflicts with 'Encrypt FTP data using TLS'. SSL is an older protocol; TLS is generally preferred. |
Remove the eExact root-tag from the XML | If enabled, the top-level 'eExact' root tag will be omitted from the generated XML output, which may be required for compatibility with certain receiving systems. | Boolean (True/False) | Modifies the structure of the XML output. Enable only if explicitly required by the integrated system. |
Security
The FtpXml connector supports encrypted data transfer via either TLS or SSL. It is highly recommended to enable one of these options to protect sensitive data during synchronization with the FTP server.
Order Processing
Settings related to how order details are processed, including how 'our reference' fields are populated and how order notes are formatted.
Catalog
Settings influencing the import and management of product catalog data, such as image updates and item code handling.
Stock Management
Configuration for locating and synchronizing stock information from the FTP server.