System Preferences

Configure the tenant and system according to your needs.

You can use Management Dashboard -> Settings -> System Preferences for setting up rules and configuring your tenant.

Setting	Description	Possible values	Default value
AI
openAiApiToken	To start using AI when working with Emporix, you have to use an OpenAI token to establish the connection between the two systems. To configure the connection you either need an active account on OpenAI Platform, or you can use a token provided directly by Emporix. If you have your own OpenAI account, add the API token (API Key) from it as an Open AI API token. When the token is configured, you can start using AI. If you don't provide your own OpenAI token, the Emporix one is used with the following limits: 3 mln input tokens and 1 mln output tokens. If you reach the limit, you have to provide your own OpenAI token to use the feature again. Emporix uses the gpt-4o-mini model by default. If you want to use your own OpenAI account with a different AI model please contact us at [e-mail] to negotiate the model and usage. To check the available AI models, see the OpenAI - Models documentation.
Coupons
maxNumberOfCouponsPerCart	Set a rule for the number of coupons that can be used per cart. You can configure the maximum number of coupons with the value field. If the field is empty, the default value is 1 which means only 1 coupon can be added to the cart.	any number	1
couponPermanentDelete	Set your preferences for deleting coupons. If you don't set the property or set it to false, the delete operation only flags a coupon as deleted. You can't create or import a coupon with the same ID (code). If you want the behavior to remove a coupon permanently from the database, set the property to true. It is then possible to create or import a coupon with the same ID (code).	true/false	false
enableCouponCodeCaseSensitivity	Decide if your coupon codes should be saved both in lower and upper case or not. If you set the preference to true, the coupons can be saved in both formats. By default, the coupon code is saved in upper case only.	true/false	false
Approvals
approval.default_expiryDays	Set the expiry date for an approval. If the property is empty, the default value is used.	any number	10
signUp.enableAccountCreationEmailConfirmation	Enable email notifications about new accounts as by default, the newly created customers do not receive any welcome emails after their accounts are created. To enable the welcome emails, set the value to true.	true/false	false
customer.passwordreset.redirecturl	Register the URL of the page for resetting the password of the customer.
Cart
cartItemValidationSkipEffectiveAmount	With default setup, during adding an item to cart, it is mandatory to provide values to the following price fields: priceID effectiveAmount originalAmount currency You can set the effectiveAmount as optional, if you don't need it during this operation in your use case. If you set the value to true, a value of effectiveAmount property is not required to add an item to a cart. For more information about adding items to cart, see API Reference.	true/false	false
cartItemValidationSkipOriginalAmount	With default setup, during adding an item to cart, it is mandatory to provide values to the following price fields: priceID effectiveAmount originalAmount currency You can set the originalAmount as optional, if you don't need it during this operation in your use case. If you set the value to true, a value of originalAmount property is not required to add an item to a cart. For more information about adding items to cart, see API Reference.	true/false	false
cartItemValidationSkipCurrency	With default setup, during adding an item to cart, it is mandatory to provide values to the following price fields: priceID effectiveAmount originalAmount currency You can set the currency as optional, if you don't need it during this operation in your use case. If you set the value to true, a value of currency property is not required to add an item to a cart. For more information about adding items to cart, see API Reference.	true/false	false
cartItemValidationSkipExistingItemsValidationOnAddToCart	Enable skipping validation for items that already exist in the cart when a new item is added. This setting improves performance for carts with multiple items. For more information about adding items to cart, see API Reference.	true/false	false
enableExternalPrices	Enable the external sourcing of prices or products at a cart level. By setting the setting to true, you can use a dedicated application for complex price calculation or product management to communicate with the Cart Service and overwrite the pricing information for a specific cart. For more information about external pricing and products, see the External Pricing and Products documentation.	true/false	false
Index
indexing_siteAwareFieldsStrategy	Choose the appropriate indexing strategy to index site-aware properties, such as price and availability. Specifically, if you have multiple sites in the system, you can choose if you want to have a single index or create individual indices separately for each site. MERGE strategy creates a single index with site-aware properties mapped as sitePrices and siteAvailabilities. The properties are maps where a key is a site code and a value is a price or availability object respectively. SPLIT strategy creates separate indices for each site. This approach provides more flexibility but also may impact performance when the number of indices is high.	MERGE/ SPLIT	MERGE
Order
enableOrderAddressPropagation	Decide whether the address provided by a customer upon submitting an order is automatically added and saved as the customer address.	true/false	true