Profit - Connector Settings

This document details the configurable settings for the Profit connector. These settings control various aspects of data synchronization, order processing, and general behavior when integrating App4Sales with Profit ERP systems. Administrators and implementation consultants can use these settings to tailor the connector's functionality to specific business requirements.

Connector settings are typically managed through the App4Sales portal UI. These values are stored and applied at runtime, influencing how the connector interacts with the Profit ERP system. Changes to these settings are applied immediately upon saving in the portal.

Setting	Description	Values / Defaults	Dependencies / Effects
Token	Token	string	Required setting.
Store	Store	string	Required setting.
Set environmentCode for the restcall of the subjectconnector or deliverydates	Set environmentCode for the restcall of the subjectconnector or deliverydates	string	Required setting.
Filter For Customer Dash Board Field Id	Filter For Customer Dash Board Field Id	string
Report Id	Report Id	string
Vat Liable Code	Vat Liable Code	string
Not Vat Liable Code	Not Vat Liable Code	string
Dossier Item Number	Dossier Item Number	string
Dossier Item Type	Dossier Item Type	string
Dossier Item Connected	Dossier Item Connected	string
Warehouse At Sales	Warehouse At Sales	bool
Set Orderline Property On Instruction	Set Orderline Property On Instruction	bool
Sales Forecast In History	Sales Forecast In History	bool
Order History Backoffice	Order History Backoffice	bool
Sales No Order History For Customer	Sales No Order History For Customer	bool
Price	Price	string
Order Number History	Order Number History	string
Send the price on combined items to the backoffice	Send the price on combined items to the backoffice	bool
Send the price on an item for quotations to the backoffice	Send the price on an item for quotations to the backoffice	bool
Use Item Dimensions	Use Item Dimensions	bool
Item Dimension Name	Set the name for 1 itemdimension because this one could not be edited in afas	string
Flip Item Dimension	Flip Item Dimension	bool
Flip Item With 2 Dimensions	Flip Item With 2 Dimensions	bool
Price List Number 1	Price List Number 1	string
Price List Number 2	Price List Number 2	string
Price List Number 3	Price List Number 3	string
Price List Number 4	Price List Number 4	string
Disable Item Unit When Sending An Order	Disable Item Unit When Sending An Order	bool
Invoice Reference Text	Invoice Reference Text	string
Assign Item Price To An Item	Assign Item Price To An Item	bool
Get Price Lists	Get Price Lists	bool
Get Stock Period	Get Stock Period	bool
Get All Addresses	Get All Addresses	bool
Default Price List For Action Price	Default Price List For Action Price	string
Set the price on an item for orders to the backoffice	Set the price on an item for orders to the backoffice	bool
Use another getconnectors in profit because they are using two App4Sales administrations and they are using one profit administration	Use another getconnectors in profit because they are using two App4Sales administrations and they are using one profit administration	bool
Prefix Free Field Connector And Item Classes	Prefix Free Field Connector And Item Classes	string
Send No User With New Customer Note	Send No User With New Customer Note	bool
Send Note Type To Profit	Send Note Type To Profit	bool
Use Date As Delivery Date	Use Date As Delivery Date	bool
Get Multiple Account Managers	Get Multiple Account Managers	bool
Get Stock Period As Last Available Stock	Get Stock Period As Last Available Stock	bool
Set Discount Allowed Based On Price Lists	Set Discount Allowed Based On Price Lists	bool
Use Sales Rep Default Price List For Create Customer	Use Sales Rep Default Price List For Create Customer	bool
Is Consumer Value	Is Consumer Value	string
Set label for order info	Set label for order info	string
Set default purchase package size	Set default purchase package size	int
Exclude pictures from sync	Exclude pictures from sync	bool
Get Price Lists For Item Dimensions	Get Price Lists For Item Dimensions	bool
Item Dimension Free Fields And Classes	Item Dimension Free Fields And Classes	bool
Set Vatpercentage for vatliable group 2	Set Vatpercentage for vatliable group 2	int
Order is not available for deliver	Order is not available for deliver	bool
Order pre payment (default 50% of total amount)	Order pre payment (default 50% of total amount)	bool
Set the ordertype to profit based on a code	Set the ordertype to profit based on a code	bool
Set ordernotes on free field	Set ordernotes on free field	bool
Set Instruction On Order Line	Set Instruction On Order Line	bool
Set Default Delivery Date	Set Default Delivery Date	bool
Manual Payment	Manual Payment	bool
Set customer item fixed filter automatically	Set customer item fixed filter automatically	bool
Set assortment on item matrix parent	Set assortment on item matrix parent	bool
Administration Number	Administration Number	int, Default: -1	Default: -1
Set pricelists based on currency code	Set pricelists based on currency code	bool
Send customer manager as manager for create customer	Send customer manager as manager for create customer	bool
Send customer manager as user for create customer	Send customer manager as user for create customer	bool
Send order line discount to backoffice	Send order line discount to backoffice	bool
Round orderprices to # of fractional digits	Round orderprices to # of fractional digits	int
Send transsmart code with an order	Send transsmart code with an order	bool
Get all stock values	Get all stock values	bool
Use Matrix Translations	Use Matrix Translations	bool
Use order line quantity also as backorder quantity	Use order line quantity also as backorder quantity	bool
Set vatliable code for EU countries	Set vatliable code for EU countries	string
Add ourreference to reference	Add ourreference to reference	bool
Create pricelists on discountgroups	Create pricelists on discountgroups	bool
Sync multiple pictures	Sync multiple pictures	bool
Multiple picture batch based on 'sync multiple pictures'	Multiple picture batch based on 'sync multiple pictures'	int
Use batching for all requests. (Prevent 'Out of string space' error)	Use batching for all requests. (Prevent 'Out of string space' error)	bool
Batch size to use when batching is enabled (default 10000)	Batch size to use when batching is enabled (default 10000)	int, Default: 10000	Default: 10000
Create a delivery note in Profit only for Portal4Sales	Create a delivery note in Profit only for Portal4Sales	bool
Set Vatpercentage for vatliable group 1	Set Vatpercentage for vatliable group 1	int
Send username to profit on an order	Send username to profit on an order	bool
Use financial manager as customer manager	Use financial manager as customer manager	bool
Delivery note process order status (1-7)	Delivery note process order status (1-7)	string
Always send 0 price to profit	Always send 0 price to profit	bool
Change the unit and quantity to profit based on the purchasepackagesize	Change the unit and quantity to profit based on the purchasepackagesize	string
Send language code when creating a new customer (Languages need to be mapped correctly)	Send language code when creating a new customer (Languages need to be mapped correctly)	bool
Create alternative address (of an order) on the customer	Create alternative address (of an order) on the customer	bool
Send discount on combined items to the backoffice	Send discount on combined items to the backoffice	bool
Send discount on an item to the backoffice	Send discount on an item to the backoffice	bool
Turn off searchfunction 'search city at postalcode'	Turn off searchfunction 'search city at postalcode'	bool
Sync next delivery date during items sync	Sync next delivery date during items sync	bool
Profit property name for item next delivery date	Profit property name for item next delivery date	string
Remove prices for action items, fill default price as action price	Remove prices for action items, fill default price as action price	bool
Use date as delivery date on custom field (ID: U7EB26DF9495587AB934DB910D2CBA9CB)	Use date as delivery date on custom field (ID: U7EB26DF9495587AB934DB910D2CBA9CB)	bool
Use selected date as order date	Use selected date as order date	bool
Default warehouse code to use for delivery notes	Default warehouse code to use for delivery notes	string
Send the order type value to backoffice to the sales channel (SaCh) in Afas	Send the order type value to backoffice to the sales channel (SaCh) in Afas	bool

Special Logic & Filters

The Profit connector incorporates several dynamic behaviors and filters:

**Required Settings**: Settings marked as 'Required setting' must have a value provided for the connector to function correctly, typically related to authentication or core ERP identifiers.
**Batching**: Settings like 'Use batching' and 'Batch size' control how large data sets (e.g., pictures, items) are processed to prevent timeouts or memory issues, especially in environments with large data volumes.
**Conditional Data Flow**: Many settings enable or disable specific data flows or transformations, such as sending item prices, managing multiple administrations, or altering how customer data is processed based on flags like 'Send language code for new customer'.
**Default Values**: Several settings provide default values (e.g., `AdministrationNumber = -1`, `BatchSize = 10000`) that are used if no explicit configuration is provided.

Domain Specifics

Authentication

The `Token` and `Store` settings are crucial for authenticating the connector with the Profit ERP system. These credentials must be obtained from your Profit environment and configured securely.

Catalog & Item Management

Settings related to item dimensions, price lists, and picture synchronization (e.g., 'Use item dimensions', 'Get price lists', 'Multiple pictures') enable detailed control over how product information is exchanged between App4Sales and Profit. This includes handling complex item structures and pricing rules.

Order Processing

A significant number of settings influence order creation and updates, covering aspects like pricing (e.g., 'App4Sales price to Profit', 'Send order line discount'), delivery dates, and handling of special order types or notes. This allows for precise mapping of App4Sales orders to Profit's sales order process.

Customer Management

Settings such as 'Send language code for new customer' and 'Send customer manager as manager for create customer' impact how customer records are managed and synchronized, ensuring consistency in customer data and relationships between systems.

Related Settings & Prerequisites

Optimal configuration of the Profit connector may depend on other system-wide settings or specific configurations within your Profit ERP. Ensure that API access is granted for the provided credentials and that any required Profit 'getconnectors' or UDFs (User-Defined Fields) are properly set up if referenced by specific connector settings.

Known Limitations

No specific limitations have been explicitly identified in the code for this version. However, performance may vary depending on the volume of data and the responsiveness of the Profit ERP API. Always test configuration changes in a non-production environment first.

Afas - Connector settings