Profit - Connector Settings
This document details the connector-specific settings for the Profit ERP system. These settings control various aspects of data synchronization, pricing, stock management, order processing, and authentication behavior between App4Sales and Profit. Application Administrators and Implementation Consultants can use these settings to tailor the connector's functionality to specific business requirements without direct code modifications.
Settings are primarily configured through the App4Sales portal UI. Once configured, they are applied at runtime, influencing how data is exchanged and processed between App4Sales and Profit.
Setting | Description | Values / Defaults | Dependencies / Effects |
Token | Authentication token required to connect to the Profit API. This is a mandatory setting. | String (GUID or similar) | Required for all communication with Profit. |
Store | Specifies the Profit store identifier. This is a mandatory setting. | String | Identifies the specific store within Profit for data operations. |
Rest Environment Code | Set environmentCode for the restcall of the subjectconnector or deliverydates. This is a mandatory setting. | String | Used for specific API calls related to delivery dates or subject connectors. |
Filter For Customer Dash Board Field Id | Identifies a field to use for filtering data displayed on the customer dashboard. | String | |
Report Id | Specifies the ID of a report to be used by the connector. | String | |
Vat Liable Code | Code used to identify VAT liable entities in Profit. | String | |
Not Vat Liable Code | Code used to identify entities not liable for VAT in Profit. | String | |
Dossier Item Number | Specifies the item number for dossier items. | String | |
Dossier Item Type | Defines the type for dossier items. | String | |
Dossier Item Connected | Indicates if dossier items are connected. | String | |
Warehouse At Sales | Enables or disables warehouse-related functionalities at the point of sale. | Boolean (True/False) | |
Set Orderline Property On Instruction | When enabled, order line properties are set based on instructions. | Boolean (True/False) | |
Sales Forecast In History | Includes sales forecasts in the order history. | Boolean (True/False) | |
Order History Backoffice | Enables order history visibility in the back office. | Boolean (True/False) | |
Sales No Order History For Customer | When enabled, prevents displaying order history for customers in sales. | Boolean (True/False) | |
Price | General setting related to pricing. Specific behavior depends on other pricing settings. | String | |
Order Number History | Specifies the order number for historical records. | String | |
Send Price On Combined Items | Send the price on combined items to the backoffice. | Boolean (True/False) | Affects how pricing for combined items is transmitted to Profit. |
Set Price On Offert On Item Type Artikel | Send the price on an item for quotations to the backoffice. | Boolean (True/False) | Controls whether item prices on quotations are sent to Profit. |
Use Item Dimensions | Enables the use of item dimensions. | Boolean (True/False) | If enabled, item dimensions will be utilized for product variations. |
Item Dimension Name | Sets the name for a single item dimension, as it cannot be edited in AFAS. | String | Only relevant if 'Use Item Dimensions' is enabled. |
Flip Item Dimension | Flips the values of a single item dimension. | Boolean (True/False) | Only relevant if 'Use Item Dimensions' is enabled. |
Flip Item With 2 Dimensions | Flips the values of an item with two dimensions. | Boolean (True/False) | Only relevant if 'Use Item Dimensions' is enabled and items have two dimensions. |
Price List Number 1 | Identifier for price list number 1. | String | |
Price List Number 2 | Identifier for price list number 2. | String | |
Price List Number 3 | Identifier for price list number 3. | String | |
Price List Number 4 | Identifier for price list number 4. | String | |
Disable Item Unit When Sending An Order | Disables the item unit when an order is sent to Profit. | Boolean (True/False) | |
Invoice Reference Text | Text to be used as a reference on invoices. | String | |
Assign Item Price To An Item | Assigns a specific price to an item. | Boolean (True/False) | |
Get Price Lists | Enables retrieval of price lists from Profit. | Boolean (True/False) | |
Get Stock Period | Enables retrieval of stock period information from Profit. | Boolean (True/False) | |
Get All Addresses | Retrieves all addresses associated with a customer from Profit. | Boolean (True/False) | |
Default Price List For Action Price | Specifies the default price list to use for action prices. | String | |
App4Sales Price To Profit | Set the price on an item for orders to the backoffice. | Boolean (True/False) | Controls whether the App4Sales price for an item on an order is sent to Profit. |
Use Get Connector For Second Administration | Use another getconnectors in profit because they are using two App4Sales administrations and they are using one profit administration. | Boolean (True/False) | Enables an alternative get connector setup for specific multi-administration Profit environments. |
Prefix Free Field Connector And Item Classes | Prefix for free field connectors and item classes. | String | |
Send No User With New Customer Note | When enabled, no user information is sent along with new customer notes to Profit. | Boolean (True/False) | |
Send Note Type To Profit | When enabled, the note type is sent to Profit. | Boolean (True/False) | |
Use Date As Delivery Date | Uses the current date as the delivery date. | Boolean (True/False) | |
Get Multiple Account Managers | Enables the retrieval of multiple account managers from Profit. | Boolean (True/False) | |
Get Stock Period As Last Available Stock | Interprets the stock period as the last available stock. | Boolean (True/False) | |
Set Discount Allowed Based On Price Lists | Determines if discounts are allowed based on the configured price lists. | Boolean (True/False) | |
Use Sales Rep Default Price List For Create Customer | Uses the sales representative's default price list when creating a new customer. | Boolean (True/False) | |
Is Consumer Value | Value used to identify a consumer. | String | |
Order Info Label | Set label for order info. | String | Custom label for order information displayed in App4Sales. |
Set Purchase Package Size | Set default purchase package size. | Integer | Defines the standard size for purchase packages when creating orders. |
Exclude Pictures | Exclude pictures from sync. | Boolean (True/False) | Prevents product pictures from being synchronized with Profit. |
Get Price Lists For Item Dimensions | Enables the retrieval of price lists specifically for item dimensions. | Boolean (True/False) | Only relevant if 'Use Item Dimensions' is enabled. |
Item Dimension Free Fields And Classes | Enables item dimension free fields and classes. | Boolean (True/False) | |
Vat Percentage For Vatliable Group 2 | Set Vatpercentage for vatliable group 2. | Integer | Defines the VAT percentage for VAT liable group 2. |
Order Is Not Available For Deliver | Order is not available for deliver. | Boolean (True/False) | When enabled, indicates that an order is not yet available for delivery. |
Order Pre Payment | Order pre payment (default 50% of total amount). | Boolean (True/False) | Enables prepayment for orders, typically 50% of the total amount. |
Set Order Type Code | Set the ordertype to profit based on a code. | Boolean (True/False) | If enabled, the order type in Profit is set based on a specified code from App4Sales. |
Set Order Notes On Free Field | Set ordernotes on free field. | Boolean (True/False) | Allows order notes from App4Sales to be stored in a free field in Profit. |
Set Instruction On Order Line | Enables setting instructions on the order line. | Boolean (True/False) | |
Set Default Delivery Date | Sets a default delivery date for orders. | Boolean (True/False) | |
Manual Payment | Enables manual payment processing. | Boolean (True/False) | |
Set Customer Fixed Item Filter | Set customer item fixed filter automatically. | Boolean (True/False) | Automatically applies a fixed item filter for customers. |
Set Assortment On Parent Level | Set assortment on item matrix parent. | Boolean (True/False) | When enabled, assortment settings are applied at the parent level of an item matrix. |
Administration Number | The administration number to use. | Integer. Default: -1 | Specifies the administration number within Profit. A value of -1 typically means no specific administration is set or it defaults to the primary one. |
Price List Based On Currency Code | Set pricelists based on currency code. | Boolean (True/False) | Enables the selection of price lists based on the currency code. |
Send Manager To Profit As Manager | Send customer manager as manager for create customer. | Boolean (True/False) | When creating a new customer, the App4Sales customer manager is sent to Profit as a manager. |
Send Manager To Profit As User | Send customer manager as user for create customer. | Boolean (True/False) | When creating a new customer, the App4Sales customer manager is sent to Profit as a user. |
Send Order Line Discount | Send order line discount to backoffice. | Boolean (True/False) | Enables sending discounts applied to order lines to Profit. |
Round Order Price To Num Digits | Round orderprices to # of fractional digits. | Integer | Specifies the number of fractional digits to round order prices to before sending to Profit. |
Send Transsmart Code | Send transsmart code with an order. | Boolean (True/False) | Includes the Transsmart code when sending an order to Profit. |
Get All Stock Values From Profit | Get all stock values. | Boolean (True/False) | Retrieves all available stock values from Profit, not just the default. |
Use Matrix Translations | Uses matrix translations. | Boolean (True/False) | |
Use Back Order Quantity | Use order line quantity also as backorder quantity. | Boolean (True/False) | When enabled, the quantity specified on an order line is also considered the backorder quantity. |
Vat Liable Code For EU Countries | Set vatliable code for EU countries. | String | Specifies the VAT liable code specifically for transactions with EU countries. |
Add Our Reference To Reference | Add ourreference to reference. | Boolean (True/False) | Includes the "our reference" field in the general reference when sending data to Profit. |
Create Price Lists On Discountgroups | Create pricelists on discountgroups. | Boolean (True/False) | Enables the creation of price lists based on discount groups defined in Profit. |
Multiple Pictures | Sync multiple pictures. | Boolean (True/False) | Allows the synchronization of multiple pictures per item. |
Multiple Pictures Batch | Multiple picture batch based on 'sync multiple pictures'. | Integer | Defines the batch size for synchronizing multiple pictures, relevant if 'Sync multiple pictures' is enabled. |
Use Batching | Use batching for all requests. (Prevent 'Out of string space' error). | Boolean (True/False) | Enables batch processing for all requests to prevent "Out of string space" errors, especially with large data sets. |
Batch Size | Batch size to use when batching is enabled (default 10000). | Integer. Default: 10000 | Specifies the number of records to process in each batch when batching is enabled. |
Create Delivery Note For P4S | Create a delivery note in Profit only for Portal4Sales. | Boolean (True/False) | When enabled, delivery notes are created in Profit exclusively for orders originating from Portal4Sales. |
Vat Percentage For Vatliable Group 1 | Set Vatpercentage for vatliable group 1. | Integer | Defines the VAT percentage for VAT liable group 1. |
Send User On Order | Send username to profit on an order. | Boolean (True/False) | Includes the username with order information sent to Profit. |
Use Financial Manager As Customer Manager | Use financial manager as customer manager. | Boolean (True/False) | Designates the financial manager in Profit as the customer manager in App4Sales. |
Delivery Note Process Order Status | Delivery note process order status (1-7). | String (Numeric range 1-7) | Sets the order status in Profit that triggers the processing of a delivery note. |
Always Send Zero Price To Profit | Always send 0 price to profit. | Boolean (True/False) | Ensures that if an item has no price, a value of 0 is explicitly sent to Profit. |
Change Unit And Quantity To Profit | Change the unit and quantity to profit based on the purchasepackagesize. | String | Adjusts the unit and quantity sent to Profit, typically based on the configured purchase package size. |
Send Language Code For New Customer | Send language code when creating a new customer (Languages need to be mapped correctly). | Boolean (True/False) | Includes the customer's language code when creating new customers in Profit, requiring correct language mapping. |
Create Alternative Address | Create alternative address (of an order) on the customer. | Boolean (True/False) | When enabled, an alternative address specified on an order is also created as a customer address in Profit. |
Send Discount On Combined Items | Send discount on combined items to the backoffice. | Boolean (True/False) | Enables sending discounts applied to combined items to Profit. |
Send Discount On Items | Send discount on an item to the backoffice. | Boolean (True/False) | Enables sending discounts applied to individual items to Profit. |
Do Not Search City At Postal Code | Turn off searchfunction 'search city at postalcode'. | Boolean (True/False) | Disables the automatic city search functionality based on postal code. |
Sync Next Delivery Date | Sync next delivery date during items sync. | Boolean (True/False) | Includes the next delivery date in the item synchronization process. |
Property Name For Item Next Delivery Date | Profit property name for item next delivery date. | String | Specifies the property name in Profit that holds the item's next delivery date. |
Remove Prices For Action Items | Remove prices for action items, fill default price as action price. | Boolean (True/False) | Removes existing prices for action items and populates the default price as their action price. |
Use Date As Delivery Date On Custom Field | Use date as delivery date on custom field (ID: U7EB26DF9495587AB934DB910D2CBA9CB). | Boolean (True/False) | Uses the specified date as the delivery date and stores it in a custom field in Profit (identified by the provided ID). |
Use Date As Order Date | Use selected date as order date. | Boolean (True/False) | Uses the date selected in App4Sales as the order date when creating an order in Profit. |
Default Warehouse For Delivery Note | Default warehouse code to use for delivery notes. | String | Specifies the default warehouse code to be used when generating delivery notes in Profit. |
Send Ordertype Value To Backoffice To Sales Channel | Send the order type value to backoffice to the sales channel (SaCh) in Afas. | Boolean (True/False) | Sends the order type value from App4Sales to the sales channel (SaCh) in AFAS (Profit's parent company) for backoffice processing. |
Domain Specifics
Authentication
The Token and Store settings are critical for establishing and maintaining a secure connection with the Profit ERP system. Without valid credentials, no data synchronization or operations can be performed.
Catalog
Settings such as Use Item Dimensions, Item Dimension Name, and Exclude Pictures directly influence how product catalogs and their associated data (like dimensions and images) are managed and synchronized between App4Sales and Profit.
Order Processing
A significant number of settings are dedicated to order processing, including Send Price On Combined Items, Set Price On Offert On Item Type Artikel, App4Sales Price To Profit, Set Purchase Package Size, Set Order Type Code, Send Order Line Discount, and various delivery date related settings. These control the financial and logistical details of orders as they are sent to Profit.
Stock Management
Settings like Get Stock Period, Get Stock Period As Last Available Stock, and GetAllStockValuesFromProfit control how App4Sales retrieves and interprets stock information from Profit.
Customer Management
Settings such as Send No User With New Customer Note, Send Manager To Profit As Manager, Send Manager To Profit As User, and Send Language Code For New Customer dictate how customer-related information and new customer creations are handled in Profit.