How To Configure a New Country

Introduction

This document describes the steps to add additional countries to the Enactor estate. It is assumed that the retailer is already operating in at least one country.

The guide walks through key configuration relevant to any new country. The information is based on Enactor's standard approach to adding a new country; however, configuration may differ between businesses.

The guide excludes fiscalisation, translations, and integration. Further information can be provided to support these areas.

To demonstrate the configuration steps, this document uses Denmark as the new country, with the UK as the source for templated data.

---

Manual Configuration

This section describes configuration that can be manually created in the Estate Manager.

---

Locale

The Locale entity is used to differentiate language requirements in presentation in user interfaces and documents such as receipts. It may also influence number formatting (for example, where a decimal notation uses a comma or a point as the decimal indicator). Enactor Locales are defined by selection from the underlying Java Locales, which in turn are used by the software that uses the configured Locale.

Navigate to Locale configuration using the Search or the path: Main Menu > Configuration > Organisation > Locales

Select Create to add the new locale.

Select the new locale from the available drop-down selection, add a description, and save the changes.

Select the locale from the ISO standard list and enter a matching description. For countries with multiple spoken languages (such as Belgium), you may need to set up more than one locale.

Set the appropriate values for the new country:

Field	Example Value	Description
Locale	Danish (Denmark)	Selected from a drop-down list of ISO standard locales. Locales are country- and language-specific. If a country has more than one spoken language, you may need to set up more than one locale (e.g. Belgium).
Description	Danish (Denmark)	Alphanumeric; maximum 30 characters.

This completes the Locale configuration.

---

Country Code

The Country Codes for a specific group of countries in which the business operates may be captured from the ISO information built in to Java and stored in Enactor Country configuration. They are associated with either the ISO standard codes (by default) or codes of the retailer's choice.

Navigate to Country Codes configuration using the Search or the path: Main Menu > Configuration > Organisation > Country Codes

Select Create to add the new Country Code.

Enter the new country code and select Create, choosing the country from the drop-down list.

Enter the ISO 3166 Alpha-3 code for the country (e.g. DNK for Denmark) and select the country from the drop-down list.

Set the appropriate values for the new country:

Field	Example Value	Description
Country Code ID	DNK	Example Country Code ID follows ISO 3166 ALPHA-3 country code structure.
Country Selection	Denmark	Select the country from the drop-down selection.

The key tab in the Country Codes configuration for European countries is the General tab.

Complete the General tab fields for the new country. The ISO Country Code field uses the two-character Alpha-2 code (e.g. DK for Denmark).

Enter appropriate values for the configured country under the General tab as follows:

Field	Example Value	Description
Description	Denmark	Configure the locale description for English (UK) and the country locale description being configured (e.g. Danish (Denmark)).
ISO Country Code	DK	Maximum 2 alphabetic characters selected from a standard list of ISO country codes.
List Order	1	Numeric; user-defined value optionally applied to determine placement in list order.
Address Lookup Enabled	True	Checkbox; if checked, indicates that address lookup is enabled for this country code.
Require Postcode	True	Checkbox; if checked, indicates that the postcode is required in addresses.

This completes the Country Code configuration.

---

Currency

Currencies are defined for the Retail Application as a subset of the ISO standard data by selection in the Currency Maintenance function.

Navigate to Currencies configuration using the Search or the path: Main Menu > Configuration > Organisation > Currencies

Select Create to add the new Currency.

Select the new currency from the drop-down selection - this will populate the ID - then select Create.

Select the currency from the ISO standard drop-down list. The Currency ID is populated automatically from the selection.

The key tab in the Currencies configuration is the General tab.

Complete the General tab for the new currency. Set the country association and the minimum denominations appropriate for the currency.

Enter appropriate values for the configured currency under the General tab as follows:

Field	Example Value	Description
Currency ID	DKK	Alphanumeric; maximum 3 characters. An existing ISO Standard or user-defined Currency Code. The second field enables selection of a currency from a fixed drop-down list of all defined ISO Standard Currencies.
Description	Danish Kroner	Alphanumeric; maximum 40 characters. A user-friendly identifier for the Currency. The field is mandatory and should be given a meaningful name (e.g. Danish Kroner).
Country	-	Dropdown selection from a list of configured Country Codes. A country associated with the Currency.
Minimum Accepted Denomination	1	Positive numeric value. Represents the lowest denomination of the Currency that can be accepted as valid Tender in transactions.
Minimum Currency Denomination	1	Positive numeric value. Represents the lowest denomination of the Currency.
Default Symbol	-	Alphanumeric; maximum 10 characters. The Currency Symbol used to prefix amount representations of the Currency. If not specified, the standard ISO currency symbol is used.

This completes the Currencies configuration.

---

Groups

The Groups architecture provides for a variety of predefined Group Types, all managed in the Group Hierarchy. Groups are used across multiple areas of configuration.

Navigate to Groups configuration using the Search or the path: Main Menu > Configuration > Organisation > Groups

---

Regions

The Region Group Type permits only one Region Hierarchy (All Regions), which is used to represent geographical areas. For each new country, a region is created at the top level of the All Regions hierarchy.

Select Region from the group type drop-down selection.

The list will be filtered and present a single All regions result. Select the Add icon to add a new region.

Select the Region group type from the drop-down to filter the list. The single All Regions hierarchy is displayed - select the Add icon to create a new region under it.

All new regions (i.e. countries) will be configured under the All Regions hierarchy.

New regions are added directly under the All Regions node. This creates a clean country-level hierarchy for all subsequent location and POS configuration.

Select Create to create the new region and enter the Group ID.

Enter the Group ID for the new region. It is recommended to follow the ISO 3166 Alpha-2 country code structure (e.g. DK for Denmark).

Field	Example Value	Description
Group ID	DK	Example ID follows ISO 3166 ALPHA-2 country code structure.

Enter appropriate values as follows:

Set the Name for the region and associate the currency. If the country has multiple languages, add locale-specific descriptions for each.

Field	Example Value	Description
Name	Denmark	Configure the locale description for English (UK) and the country locale description (e.g. Danish (Denmark)).
Currency ID	Danish Kroner	Select the region's currency from the available drop-down list.

This completes the group/region configuration.

---

Price Groups

The Price Group Type is used to identify groups of Product Prices in a hierarchical structure of up to 10 levels. In Product pricing, a Price Group is used to define a set of prices applicable to one or more Locations.

Select Price Group from the group type drop-down selection.

The list will be filtered and present a single All result. Select the Add icon to add a price group.

Select the Price Group type to filter the list. Click the Add icon next to the All node to create a new price group for the country.

All new price groups for each country will be configured under the All regions hierarchy.

New price groups are nested under the All node. Each country should have its own price group to drive country-specific pricing for all linked locations.

Select Create to create the price group and enter the Group ID.

Enter the Group ID and Name for the new price group. Use the ISO Alpha-2 country code as the ID for consistency.

Field	Example Value	Description
Group ID	DK	Example ID follows ISO 3166 ALPHA-2 country code structure.
Name	Denmark	Enter a name that references the country's configured price group.

Enter appropriate values as follows:

Configure the Name for the price group, adding locale-specific descriptions if the country uses multiple languages.

Field	Example Value	Description
Name	Denmark	Configure the Name for the country. Select the country locale description (e.g. Danish (Denmark)).

This completes the group/price group configuration.

note

If prices are integrated into Enactor, they will use this price group to represent the country-specific price. It is important that the price group is consistent with the integration.

---

Tax Region

The Tax Region Group Type is bound to the Region Group Hierarchy and is used to identify Tax Regions in a separate but related hierarchy.

Select Tax Region from the group type drop-down selection.

The list will be filtered and present a single All result. Select the Add icon to add a tax region.

Select the Tax Region group type to filter the list. Click the Add icon to create a new tax region for the country.

All new tax regions for each country will be configured under the All regions hierarchy.

Tax regions are nested under the All node. Each country should have its own tax region to drive the correct tax configuration for all linked locations.

Select Create to create the new tax region and enter the Group ID.

Enter the Group ID for the tax region. It is recommended to use the ISO Alpha-2 country code.

Field	Example Value	Description
Group ID	DK	Example ID follows ISO 3166 ALPHA-2 country code structure.
Name	Denmark	Tax region name.

Enter appropriate values as follows:

Set the Name for the tax region with locale-specific descriptions as required.

Field	Example Value	Description
Name	Denmark	Configure the locale description for English (UK) and the country locale description (e.g. Danish (Denmark)).

This completes the group/tax region configuration.

---

Menu Groups

The Menu Group Type allows 2 levels and is used to identify a given set of menus applicable to a Location or POS Terminal.

Select Menu Groups from the group type drop-down selection.

Select the Menu Groups type to filter the list. The Add icon allows you to create a new country-specific menu group hierarchy.

The list will be filtered and present a single All result. Select the Add icon to add a country-specific menu group.

It is best practice to have a default menu group for each store Enactor application and a country-specific menu when country menus differ.

Country-specific menu groups sit alongside the default menu groups in the hierarchy. This allows country-level menu overrides while maintaining shared standard menus.

Select Create to create the menu group hierarchy, and enter the hierarchy ID and region.

Enter the Group ID following the recommended naming structure. Update the Name and locale description to reflect the new country.

Field	Example Value	Description
Group ID	DK_STANDARD_POS	Example structure: <CountryID>_STANDARD_POS. If you need specific menus for mobile POS, use <CountryID>_STANDARD_MPOS.
Name	DK Standard POS	Configure the locale description for English (UK) and country locale description (e.g. Danish (Denmark)).

Select Edit to edit the DK_STANDARD_POS entry and update the name and additional locale description.

Field	Example Value	Description
Name	DK Standard POS	Configure the locale description for English (UK) and country locale description (e.g. Danish (Denmark)).

This completes the group/menu group configuration.

note

Additional menu groups may be required for other application types (e.g. mobile POS, back-office). Create additional groups using the same naming convention.

---

Tax

The Enactor Retail Applications provide, as standard, a built-in configurable Tax Engine that accommodates diverse options for tax management. Tax configuration spans Tax Rates, Tax Schemes, Tax Groups, and the Tax Group Tax Method composite.

---

Tax Rate

Tax Rates are named, individual Tax Rate values that may be independently associated with Tax Schemes.

Navigate to Tax Rates configuration using the Search or the path: Main Menu > Configuration > Financial > Tax Rates

Select Create and complete the tax rate details. This example assumes the configured tax rate is a VAT-type tax rate.

Select the Tax Rate Type and enter a unique Tax Rate ID. The Effective Date defaults to today but can be set to a future date for scheduled tax changes.

Field	Example Value	Description
Tax Rate Type	VAT	Dropdown list selection of fixed options: VAT, Composite, Tax Percentage Table, or Tax Value Table.
Tax Rate ID	DK_1	Alphanumeric; maximum 20 characters. Enter a user-defined but unique identifier for the Tax Rate.
Effective Date	-	Date from which the tax rate is valid (defaults to the current date).

Key fields under the General tab:

Set the Description, Display Tax Code (shown on receipts), and the tax Percentage. For Denmark, the standard VAT rate is 25%.

Field	Example Value	Description
Description	DK Standard VAT rate	Alphanumeric; maximum 30 characters. A user-friendly description by which users may identify the Tax Rate.
Display Tax Code	Standard VAT rate	Alphanumeric; maximum 30 characters. A tax code (typically an official identifier) used to identify the tax in display contexts such as receipts.
Percentage	25%	Numeric value; range 0-100. The rate of tax to apply.

Multiple tax rates may be required for a country. Create additional tax rates as required.

This completes the Tax Rate configuration.

---

Tax Scheme

The Tax Scheme is an independent entity specifically associated with a set of Tax Rates. A Tax Rate may be assigned to more than one Tax Scheme.

Navigate to Tax Schemes configuration using the Search or the path: Main Menu > Configuration > Financial > Tax Schemes

Select Create and complete the tax scheme details.

Enter a unique Tax Scheme ID. Use a naming convention that reflects the country and tax type (e.g. DK_VAT).

Field	Example Value	Description
Tax Scheme ID	DK_VAT	Alphanumeric; maximum 20 characters. Enter a user-defined but unique identifier for the Tax Scheme.

Key fields under the General tab:

Set the Description and configure whether prices include tax. In most EU countries, the price includes tax - set Price Include Tax to true for EU implementations.

Field	Example Value	Description
Description	DK VAT	Alphanumeric; maximum 30 characters. A user-friendly description for the Tax Scheme.
Price Include Tax	True	It is very common in the EU for the price to include tax. Other regions add tax to the sale at the end of the transaction.

Key fields under the Applicable Tax Rates tab:

Add all configured tax rates to the scheme using the Applicable Tax Rates tab. A single scheme may contain multiple rates (e.g. standard rate and reduced rate).

Add configured tax rates to the tax scheme.

This completes the Tax Scheme configuration.

---

Tax Group

The Tax Group provides an identifier and description with which products may be associated and thereby collectively referenced for tax purposes.

Navigate to Tax Groups configuration using the Search or the path: Main Menu > Configuration > Financial > Tax Groups

The Tax Groups list shows all configured groups. Create a new group for each product category that has a different tax rate (e.g. standard goods, alcohol, food).

Select Create and complete the tax group details.

It is recommended that the groups represent goods and services where different tax rates may apply. In the example below, Alcohol has been created as a tax group.

Enter a meaningful Tax Group ID that reflects the product category. Tax groups are typically shared across countries (e.g. ALCOHOL), with the Tax Group Tax Method linking each group to the correct rate per country.

Field	Example Value	Description
Tax Group ID	ALCOHOL	Alphanumeric; maximum 20 characters. Enter a user-defined but unique identifier.

Key fields under the General tab:

Set the Description for the tax group. The description should clearly identify the product category associated with this tax treatment.

Field	Example Value	Description
Description	Alcohol	Alphanumeric; maximum 30 characters. A user-friendly description for the Tax Group.

Add configured tax groups for each tax rate.

This completes the Tax Group configuration.

note

If products are integrated into Enactor, the Tax Group will be part of the product data. It is important that the tax group is consistent with the integration.

---

Tax Group Tax Method

The Tax Group Tax Method provides a composite key consisting of Tax Group, Tax Scheme, and Tax Region, by which a specific Tax Rate is determined for a product at the point of sale.

Navigate to Tax Group Tax Method configuration using the Search or the path: Main Menu > Configuration > Financial > Tax Group Tax Methods

Select Create and complete the tax group tax method details.

Select the Tax Group, Tax Region, and Tax Scheme to form the composite key. This combination determines which Tax Rate is applied to products in that group when sold in the given tax region under the given scheme.

Field	Example Value	Description
Tax Group	Alcohol	Configured Tax Group.
Tax Region	Denmark	Configured Tax Region.
Tax Scheme	DK VAT	Configured Tax Scheme.

Key fields under the General tab:

Set the Description and assign the Tax Rate that applies for this combination of group, region, and scheme. Repeat this for each tax group and rate combination required for the country.

Field	Example Value	Description
Description	DK Standard VAT 25%	Alphanumeric; maximum 30 characters. A user-friendly description for this tax method entry.
Tax Rate	DK Standard VAT rate	Configured Tax Rate.

Add configured Tax Group Tax Method entries for each tax rate combination required.

This completes the Tax Group Tax Method configuration.

---

Location Templates

The Location Template, in common with the Location, is defined based on a Location Type. Location Templates are used to define common configuration that can be applied across multiple locations in the same country.

Navigate to Location Templates configuration using the Search or the path: Main Menu > Configuration > Organisation > Location Templates

New location templates can be copied from existing templates or created from scratch. Select the Copy icon to copy an existing location template and make country-specific changes to the new template.

Copy from an existing store template that most closely matches the new country's requirements. Enter a new Template ID following the naming convention STORE_TEMPLATE_<CountryID>.

Field	Example Value	Description
Location Type	Store	Select/validate the location type is Store.
Template ID	STORE_TEMPLATE_DK	Example structure: STORE_TEMPLATE_<CountryID>.

Key fields under the General/General tab:

The General/General tab captures the core identity and grouping of the location template. Set the Region, Locale, and Price Group to drive country-specific behaviour for all locations linked to this template.

Field	Example Value	Description
Name	DK Store Template	-
Region	Denmark	Selected from the drop-down selection.
Locale	Danish (Denmark)	Primary language for the country. If a country has different languages across its regions, the locale should be configured at the Location level rather than the template.
VAT Number	4453521564	The company's VAT number.
Menu Group	DK BackOffice	Overrides the back-office menu if configured. Otherwise, the default menu group is used for a generic menu across multiple countries.
Default Menu Group	Standard Back Office	-
Price Group	Denmark (All Regions)	Drives the country-specific price for any location linked to this template.

Changes under the General/Tax tab:

Set the Tax Region and Tax Scheme appropriate for the country. These values drive the tax calculation for all transactions at locations linked to this template.

Field	Example Value	Description
Tax Region	Denmark	Identifies the tax region for any locations using this template.
Tax Scheme	DK VAT	Identifies the tax scheme for the locations using this template.

Changes under the General/Currency tab:

Set the Base Currency to the country's currency. This drives the currency used for all transactions at linked locations.

Field	Example Value	Description
Base Currency	Danish Kroner	Select the appropriate currency for the country.

Changes under the Address/Address tab:

Set the Country on the Address tab to ensure correct address formatting and country-specific validation for linked locations.

Field	Example Value	Description
Country	Denmark	Select the appropriate country.

Changes under the Receipt tab:

Configure receipt content at the template level where it is common across all stores in the country. If the trailer text varies by store, leave it blank here and configure it at the individual Location level.

Field	Example Value	Description
Receipt Trailer Lines	Thanks for shopping at Enactor	If the receipt trailer line is common across the country, configure it here. Otherwise, configure the trailer lines at the individual Location.
Receipt Header Logo	Receipt image	Select the company's receipt header image from the drop-down selection.

Changes under the Display tab:

Set the customer-facing messages displayed on the POS customer screen. These should be configured in the local language if the country has specific requirements.

Field	Example Value	Description
Till Closed Message	Till is closed	Message displayed on the customer display when the operator is signed off from the POS.
Customer Welcome Message	Till is open	Message displayed on the customer display when the operator is signed on to the POS.

This completes the Location Template configuration.

note

Individual locations will need to be configured and linked to this template. Locations can inherit the template configuration and be overridden as needed at the individual location level.

---

POS Terminal Templates

Unlike the POS Terminal, the POS Terminal Template may be defined without reference to a Device. It is used to pre-configure common POS settings for all terminals of a given type in a country.

Navigate to POS Terminal Templates configuration using the Search or the path.

Select the Copy icon to copy an existing POS terminal template and make country-specific changes to the new template.

Enter a unique Template ID.

Enter a new Template ID for the country. Follow the naming convention <CountryID>_RETAIL_FIXED_POS_TERMINAL for consistency.

Field	Example Value	Description
Template ID	DK_RETAIL_FIXED_POS_TERMINAL	Follow the common structure: <CountryID>_RETAIL_FIXED_POS_TERMINAL.

Changes under the General/Overview tab:

The Overview tab captures the core identity of the POS template. If Locale, Base Currency, and Price Group have already been set at the Location Template level, they are not required here unless you need to override them at the terminal level.

Field	Example Value	Description
Template Description	DK Standard POS Terminal Template	Template description.
Description	Template Description	Populates the POS terminal description.
Locale	-	Primary language for the country. If assigned at the Location Template level, it is not required here.
Base Currency	-	Select the appropriate currency for the country. If assigned at the Location Template level, it is not required here.
Price Group	-	Select the appropriate price group for the country. If assigned at the Location Template level, it is not required here.

Changes under the User Interface tab:

Set the Menu Group for this POS device type. Setting the Default Menu Group to Standard POS provides a shared set of menus for multiple countries, with the Menu Group providing the country-specific override.

Field	Example Value	Description
Menu Group / Default Menu Group	DK POS	Drives the menus displayed for this device type (POS). Setting the default to Standard POS provides a common set of menus for multiple countries.

This completes the POS Terminal Template configuration.

note

If peripherals differ between countries (for example, different receipt printer models), additional device configuration changes may be required in the template.

---

Roles

The User Role configuration provides a convenient intermediary for grouping together logically related sets of functions, which may then be collectively associated with Users.

It is recommended that roles are created at All Region level. However, if you need more granular control over functionality per country, roles can be created at the country region level.

Navigate to User Roles configuration using the Search or the path: Main Menu > Configuration > HR > User Roles

Select a region that already has the roles/privileges configured closest to those required in the new country being configured.

Select the source region whose roles most closely match what is required for the new country. You will copy and adapt these roles for the new country region.

Select the Copy icon to copy the selected role. Change the region to the country being created and enter a new Role ID.

Copy the role and assign it to the new country region. Enter a Role ID that follows your naming convention (e.g. <CountryID>_ROLE_NAME).

Field	Example Value	Description
Region	Denmark	Selected from a drop-down list of all configured Regions.
User Role ID	DK_SALE_ASSISTANT	Alphanumeric; maximum 20 characters. A user-defined unique identifier for the Role.

Changes under the General tab:

Update the Description to reflect the new country role. Set the Authorisation Level as appropriate for the role type.

Field	Example Value	Description
Description	DK Sales Assistant	Maximum 30 alphanumeric characters. A user-friendly, meaningful value by which users will identify and select the Role.
Authorisation Level	5	Numeric value; enables this role to be ranked against others (range 0-100).

Navigate to the Authorised Function tab to update the available configured functions if required.

Review and update the authorised functions for the new country role. Use Select All and Unselect All shortcuts to manage large function sets efficiently.

Field	Description
Packages	Selected from a drop-down list of available packages (e.g. Enactor Web Maintenance). The various Applications of the Enactor Retail System are organised into Packages.
Processes	Dropdown selection from a list of all available Processes defined for the Applications in the selected Package.
Functions	Checkboxes that indicate whether each Function is enabled for this Role. Convenience options are available to Select All or Unselect All for the selected Process.

Repeat these steps for any additional roles required.

This completes the Roles configuration.

---

User Templates

The User Template configuration is maintained using the User Template Maintenance function.

Navigate to User Templates configuration using the Search or the path: Main Menu > Configuration > HR > User Templates

Select the Copy icon to copy an existing user template, or create a new one from scratch. This guide assumes you are copying from an existing template.

Copy from the template most similar to the requirements of the new country. Enter a new Template ID following your naming convention.

After copying, review all fields and update any that differ for the new country.

Field	Example Value	Description
Template ID	DK Sales Assistant	Alphanumeric; maximum 20 characters. Enter a unique template ID.

Changes under the General tab:

Update the Template Description and Locale for the new country. The Locale on the User Template drives language display for that user type when signed on.

Field	Example Value	Description
Template Description	DK Sales Assistant	Maximum 30 alphanumeric characters. A user-friendly, meaningful description.
Locale	Danish (Denmark)	Primary language for the country. If the country has different languages across its regions, the locale should be configured at the Location level.

Changes under the Roles tab:

If roles are configured at All Region level, no additional changes to the selected roles are required. However, if roles were created at the country-region level, update the roles here to reference the new country-specific roles.

Review the roles assigned to the user template. If using All Region roles, no changes are needed. If using country-specific roles, update them here to reference the new country roles.

Repeat these steps for any additional user templates required.

This completes the User Templates configuration.

---

Reasons

Reason configuration provides the means to capture and record reasons for access to specific Application functions.

Navigate to Reasons configuration using the Search or the path: Main Menu > Configuration > HR > Reasons

It is very common to have a set of reasons configured at All Region level that do not require country-specific configuration. However, the reasons listed below include country-specific configuration such as value or tender rules. It is recommended that these are created at the country region level.

Transactional Reasons

All transactional reasons and the country-specific changes required:

Reason Type	Country Changes
Item Discount	General Tab: Description, Parent Reason ID (if required). Discount Tab: Discount Percentage or Value (driven by Discount type). Item Discounts and Transaction Types Tabs: Overlap rules.
Item Return	General Tab: Description. Applicable Tenders: Country tenders.
Overpayment	General Tab: Description.
Post Transaction Void	General Tab: Description.
Receipt Return	General Tab: Description. Return Tab: Rules related to return.
Transaction Discount	General Tab: Description, Parent Reason ID (if required). Discount Tab: Discount Percentage or Value (driven by Discount type). Item Discounts and Transaction Types Tabs: Overlap rules.

Cash Management Reasons

All cash management reasons and the country-specific changes required:

Reason Type	Localised Changes
Expense	General Tab: Description. Applicable Tenders: Select the targeted country's cash tender.
Income	General Tab: Description. Applicable Tenders: Select the targeted country's cash tender.
Terminal Cash Up	General Tab: Description. Applicable Tenders: Select the targeted country's cash tender.
Terminal Float	General Tab: Description. Applicable Tenders: Select the targeted country's cash tender.
Terminal Pick Up	General Tab: Description. Applicable Tenders: Select the targeted country's cash tender.

This completes the Reasons configuration.

---

Tenders

Tenders configuration provides the means to authorise, enable, and control the conduct of payment options and to accommodate different payment method types.

Navigate to Tenders configuration using the Search or the path: Main Menu > Configuration > Financial > Tenders

Select the Copy icon to copy the tenders from the current region - this will inherit the common configuration and reduce the amount of configuration required.

The example below demonstrates configuring the new cash tender.

Copy from the nearest existing tender and update the Region to the new country. Enter a Tender ID consistent with your naming convention.

Field	Example Value	Description
Region	Denmark	Select from a drop-down list of all configured Regions.
Tender Type	Cash	Select from a drop-down list of fixed options: Cash, Card, Cheque, Credit, Gift Card, Credit Note, Voucher, Payment Service. This field is non-selectable if copying from an existing tender.
Tender ID	CSH	Alphanumeric; maximum 20 characters. A user-defined but unique identifier.

Changes under the General tab:

Update the Description and Currency to reflect the new country. The Description should be added for both the default locale and the country-specific locale.

Field	Example Value	Description
Description	Danish Kroner	Alphanumeric; maximum 30 characters. A user-friendly description against the appropriate locale.
Currency	Danish Kroner	Selection from a drop-down list of all configured Currencies.

Changes under the Restrictions 1 tab:

Set the Debit and Credit limits appropriate for the new country's cash handling policy. A value of zero means unlimited.

Field	Example Value	Description
Debit Limit	100,000	Numeric; range 0-9,999,999,999. Maximum amount that may be paid using this Tender (zero means unlimited).
Credit Limit	100,000	Numeric; range 0-9,999,999,999. Threshold amount below which this Tender cannot be used for full or part-payment.

Changes under the Restrictions 2 tab:

note

This section should be configured after all tenders have been created.

Configure the return tender sequence after all tenders have been created. Select the applicable return tenders and their display order.

Field	Example Value	Description
Return Tenders	Danish Kroner	Select the sequence in which the return tender is shown and the applicable return tenders.

Changes under the Cash Management tab:

Set the discrepancy thresholds for the cash tender. These values determine when a discrepancy warning is triggered during cash up processes.

Field	Example Value	Description
Safe Discrepancy Threshold	-	Acceptable value for the safe discrepancy when completing the safe cash up.
Terminal Discrepancy Threshold	-	Acceptable value for the terminal discrepancy when completing the terminal cash up.

Changes under the Change/General tab:

Configure the change tender - usually the same as the primary cash tender. Change Limit of zero means no upper limit on change. Change Minimum Limit of zero means no minimum change amount.

Field	Example Value	Description
Change Tender	Danish Kroner	Selection from a drop-down list of all Tenders configured for the same Region. If not specified, the change type defaults to the tender itself.
Change Limit	0.00	Numeric; range 0-9,999,999,999. Maximum amount of change that may be issued using this Tender. Zero means no limit.
Change Minimum Limit	0.00	Numeric; range 0-9,999,999,999. Minimum amount of change that may be issued when accepting payment using this Tender.

The above covers the most common set of changes across different tender types. Additional changes may be required depending on tender type (e.g. card, gift card, credit note).

Repeat these steps for all required tenders.

This completes the Tender configuration.

---

Menus

Menus are constructed based on a set of basic tasks selected from a Menu Set, which is specific to an Application, associated with a Menu Group, and assigned to a Location or POS Terminal.

Navigate to Menu Maintenance using the Search or the path: Main Menu > Configuration > System > Menus

The following table describes the full set of menus that may need to be configured for the new country. In some cases, menus may not require country-specific configuration and can remain at the All Region level.

Menu ID	Specific Country Changes
ADMIN	N/A
CREDIT_TENDER	Applies to all menu events. Visibility Expression: Tender ID changed to the targeted country's tender ID. Data tab > Tender ID: changed to the targeted country tender ID.
DISPLAY_REPORTS	N/A
MODIFIER_ITEM	N/A
LAUNCH	N/A
NONSALE	N/A
PRINT_REPORTS	N/A
RECEIPT_DESTINATION	N/A
RICH_PRODUCT	Applies to all menu events. General Tab: Button labels require translation. Data tab > Tender ID: RegionID changed to the ISO 2-character country code.
SALE	N/A
TENDER	Applies to all menu events. Visibility Expression: Tender ID changed to the targeted country's tender ID. Data tab > Tender ID: changed if tender IDs are unique per country.
TERMINAL_CASH_MANAGEMENT	N/A

This completes the Menu configuration.

---

Gift Card Types

The Gift Card Types function provides for the specification of characteristics, processing, and behaviour of both Gift Cards and the associated Transactions, in a variety of Gift Card Types.

Navigate to Gift Card Types configuration using the Search or the path: Main Menu > Configuration > Financial > Gift Card Types

Select the Copy icon to copy a Gift Card Type from an existing region - this will inherit common configuration and reduce the amount of configuration required.

The example below demonstrates configuring a new gift card type.

Copy from the nearest existing gift card type and enter a new ID for the country. Follow the naming convention <CountryID>_GIFTCARD.

Field	Example Value	Description
Gift Card Type ID	DK_GIFTCARD	Alphanumeric; maximum 20 characters. A user-defined but unique identifier.

Changes under the General tab:

Update the Description, Region, Currency, and Redemption Tender to reflect the new country. The Redemption Tender must reference the configured Gift Card tender for the country.

Field	Example Value	Description
Description	DK Gift Card	Alphanumeric; maximum 20 characters. A user-defined unique identifier.
Region	Denmark	Selected from a drop-down list of all configured Regions.
Currency	Danish Kroner	Selected from a drop-down list of all configured Currencies.
Redemption Tender	Gift Card Denmark	Selected from a drop-down list of all configured Gift Card Tenders.

This completes the Gift Card Type configuration.

---

Credit Notes Types

Credit Notes provide a form of Refund Tender and may be configured in a variety of Credit Note Types defined for Retailers.

Navigate to Credit Notes Types configuration using the Search or the path: Main Menu > Configuration > Financial > Credit Notes Types

Enter a unique Credit Note Type ID for the country. Follow the naming convention <CountryID>_CREDIT_NOTE.

Field	Example Value	Description
Credit Note Type ID	DK_CREDIT_NOTE	Alphanumeric; maximum 20 characters. A user-defined but unique identifier.

Update the Description, Region, and Tender Key to reflect the new country. The Tender Key must reference the configured Credit Note tender for the country.

Field	Example Value	Description
Description	Credit Note Denmark	Alphanumeric; maximum 20 characters. A user-defined unique identifier.
Region	Denmark	Selected from a drop-down list of all configured Regions.
Tender Key	Credit note Denmark	Selected from a drop-down list of all configured Tenders of type Credit Note.

This completes the Credit Note Type configuration.

---