Receipt Customisation

Introduction

The purpose of this guide is to show how to configure Receipts to allow you to set up and customise a variety of Receipts to meet your organisations' needs. This guide introduces all the basics in understanding the Receipt Maintenance and the various terminologies that are associated with it, and then walks through on the different customisations that can be made to the receipts that are available for customisation in the Receipt Maintenance.

Overview

This guide will cover the configuration for the following:

• Receipts Configuration - Provides all the basics required in understanding the Receipt Maintenance, its terminologies and how a basic customisation can be done to a Receipt and printed in a physical printer.

• Customisations to Receipts - Provides a step-by-step guide on the various range of customisations that can be made to the different Receipts that are available for customisation in the Receipt Maintenance.

Receipts Configuration

This section covers all the basics that are required to understand the Receipt Maintenance and start making receipt customisations. The areas that are covered in this section are accessing the receipt maintenance, creating a new receipt, getting started with the new receipt by making a basic customisation to it and finally understanding the various terminologies of the Receipt Maintenance.

Accessing Receipt Maintenance

If a user needs to access Receipt Maintenance, they will need the appropriate privileges for their user account. However, Receipt Maintenance has a larger number of privileges than other maintenance applications, so it is important to ensure that the correct privileges have been enabled for your users.

To enable these privileges, follow the steps below:

Navigate to User Role Maintenance using the Search or the path

In the User Role Maintenance, select the Edit icon of the User that you wish to enable the privilege for.

Navigate to the Authorised Functions tab of that selected User and change the filter of the Application Package as Receipt Maintenance as follows:

This would list out all the privileges that are needed in order to be able to access all the Standard Receipts functions as follow:

Package	Process	Function ID	Function Name
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.View	View
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.Run	Run
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.Edit	Edit
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.New	New
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.Remove	Remove
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.List	List
Receipt Maintenance	Receipt Maintenance	enactor.receiptMaintenance.Export	Export
Receipt Maintenance	Receipt Maintenance	enactor.pageDefinitionDetailMaintenance.Remove	enactor.pageDefinitionDetailMaintenance.Remove

Make sure that your User has the required privileges enabled by ticking on the necessary functions that are listed or if you want to enable all privileges, just click on Enable All Displayed Functions and click on Save.

For these changes to apply, sign out and back into the Estate Manager.

Now you will be able to access the Receipt Maintenance and carry out all Receipt related functions.

Create a new Receipt

The Receipt Maintenance is used to create new Receipts. To create a new Receipt follow the steps below:

Navigate to Receipt Maintenance using the Search or the path

Select New Receipt Document on the Receipt Maintenance page.

This will open the New Receipt screen where the following 3 fields must be defined for this new Receipt:

Configuration	Description
Type	Select the Receipt Type from the Type drop-down. This is the page definition type that the custom receipt will be linked to. This is necessary for the custom receipt to be discoverable by other maintenance applications.
Receipt Document ID	Enter a unique Receipt Document ID for the new Receipt. This is the unique id of the receipt. It will be used as part of the generated filename for the custom receipt. It will also be used as part of the page definition detail automatically generated for the custom receipt. The ID can be alphanumeric and contain a maximum of 20 characters and will be used to uniquely identify this new Receipt. Use of a systematic and business-specific naming convention is recommended here.
Original Receipt Document	Select an Original Receipt Document from the Original Receipt Document drop-down. This is a drop-down of the available system receipts. This is automatically restricted based Type that was selected above. The values displayed are the filenames of the receipts. The file name of the selected system receipt will be used for generating the filename of your custom receipt. The Original Receipt Document selected here will decide the width of the custom receipt that is you are going to create, since this will inherit its layout from the selected system receipt, as well as any future changes to that system receipt.

We will create a new Receipt with the Type Standard Receipt and the Original Receipt Document as StandardReceiptTemplate44, which would give us a 44-columns width Receipt as follows:

Note: The create button will not appear until a type has been selected. Also note that, if system receipts under the Original Receipt Document dropdown are not available for the Type that is selected, then you will not be able to create a custom receipt in Receipt Maintenance.

Once Create is clicked, you will be navigated to the Edit Receipt page for your new Receipt. This receipt will match the layout for the system receipt and therefore look identical until customisations are made. In order to use the new custom receipt, you will need to enter a name. The input for this field is presented in the initial view of the receipt.

Note: It is recommended that you save the receipt once you have entered a name. It is easier to back out of changes if you can simply exit the page. By saving now, you avoid having to recreate the receipt while making the initial changes.

The Edit Receipt Maintenance, for the newly created Receipt, is presented with the 2 key tabs namely; Receipt Sections and Receipt Columns.

Edit Receipt - Receipt Sections

The Receipt Sections Tab contains the list of each section that the Receipt consists of. Eg: Receipt Header Section, Receipt Body Section, Receipt Footer Section.

Using this, customisations can be made separately for each section of the Receipt.

This tab is also where the preview of the Receipt can be set up and viewed.

Customisations to Receipt Sections and Previewing of the Receipt will be further explained later in this guide.

Edit Receipt - Receipt Columns

The Receipt Columns Tab contains the list of all configured columns that the Receipt can make use of in each of its sections.

Eg: Address Details, Item Detail, Amount, Item Value.

Each of these columns can be edited by clicking on the edit sign. New columns can also be created by clicking on Create at the end of this table.

Customisations to Receipt Columns will be further explained later in this guide.

Getting Started with Receipts

This section allows you to get started with making proper use of the Receipts Maintenance and covers the basics on:

• How a customisation can be made to a new Receipt.

• Previewing the customised Receipt in the Receipt Maintenance.

• Getting the customised Receipt printed using a physical printer in the POS.

To make the customisations, we will use the Enactor Standard Receipt 44, which is the following 44-column Standard Receipt that was created in the previous section:

The customisation is to hide the currency symbols of each merchandise item in the receipt that is printed.

Making the First Customisation

Receipts display the currency symbols of the item values by default. To hide the currency symbols, we should first navigate to the exact element that displays the currency symbol for the item value in the Receipt.

First, navigate to the Receipt Maintenance and click on the Edit icon of the Receipt that was created.

In the Edit Receipt page, we need to make the customisation to the Receipt Body Section, hence click on the Edit icon of the Receipt Body Section as follows:

This would list down the Elements used in this Receipt Body Section. From this section, we need to navigate to the Element which displays the current item value of the Receipt. Following is the path where this element exists:
Basket Items List > Merchandise Item > Merchandise Standard Item Details > Value

It can be noticed that there is an element called Item Value here, which is what displays the value of each item in the Receipt, which also includes the currency symbol.

First, we need to isolate the currency symbol and item value as 2 elements.

1 - Disable the current "Item Value" element and select the following 2 elements from the dropdown and click + Add:

• Sales Item Value Currency

• Sales Item Value

If you now check the preview of the receipt, you will notice that adding these 2 elements have had the same effect as the Value element that was disabled.

Note: Previewing of the Receipt is covered in the next sub-section.

Next, the currency symbol is to be hidden.

2 - Disable the "Sales Item Value Currency" element as follows:

Now click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

Once these changes have been made, we should navigate to the root of the Receipt to save all changes.

For this click on the Pos/Print/StandardReceiptTemplate44_EN_StandardReceipt44 in the Navigation Bar that is found right below the Save button as follows:

A Confirm Navigation popup would appear showing the changes that have been made and make sure to click Save and Continue, which would save the changes in these sections.

Finally, click on the Save button to successfully save the Receipt and now you are ready to try out the customised Receipt.

Previewing the Customised Receipt

Using the Receipt Maintenance, we will be able to preview the changes made to the Receipt. For this go back to the Edit Receipts page of the Enactor Standard Receipt 44, and click on the ">" icon of the Receipt Preview field as follows:

This would provide the following options to select a transaction to use for Receipt Preview as follows:

Select Retail Transaction Archive which would navigate you to the Retail Transaction Archive of the Estate Manager. Using this select a transaction suitable to be used as the Receipt Preview.

Alternatively, Upload Transaction can also be used to directly upload the transaction XML for use as the Receipt Preview.

Next, in the Edit Receipt Preview page, Enter a suitable description for this Receipt Preview as follows:

Once you click Save, you can now notice there is a new Show Preview icon that appears along with > icon in the Receipt Preview field.

Click on the Show Preview of the Receipt Preview field, which would bring up the Receipt Preview.

Following are examples of the Receipt Previews before and after the currency symbol customisation is made:

This way you can clearly notice that the customisation made to disable the currency symbol has been successfully made, and only the value of each Merchandise Item is now displayed in the Receipt.

Note: This Receipt Preview can also be used to easily navigate to the appropriate elements of the Receipt, for which customisations can be made. This is further explained in the "Managing Previews" section.

Printing the Receipt on a Physical Printer

Now that we have made and previewed a customisation to a receipt, we are ready to use this customised Receipt on a physical printer.

To set this customised Receipt as your Primary Receipt, navigate to the POS Terminal Maintenance using the Search or the path:

Click on the Edit icon of the POS Terminal that the Primary Receipt is to be changed.
Go to the tab Printing > General and in the drop-down for Primary Receipt select Enactor Standard Receipt 44 as follows:

Click Save and finally broadcast the following entities to your device:

• Page Definition

• Page Definition Detail

• POS Terminal

After the broadcast has been sent successfully, make sure to restart your POS terminal. Finally, carry out a complete transaction in your POS and you will be able to notice the receipts printed as follows:

The value for the Merchandise Item is now displayed without the currency symbol and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Receipt Terminology

This section covers in detail the terminology of the various functions available in the Receipt Maintenance such as the unique navigation bar, receipt columns and receipt preview functions.

Understanding the Navigation Bar

Receipts are structurally complex during configuration and to help with this the Receipt Maintenance uses multiple pages to help you drill down to the part of the receipt that you wish to change. To prevent the user from getting lost during this, a navigation bar is provided.

The navigation bar basically lists the locations that have been visited and how far into the sections of this particular receipt you currently are.

Following are the 3 navigation item formatting and what they each depict:

• Bold: This is the current entry in the navigation bar.

• Underlined: This is the previous entry in the navigation that can be navigated directly to.

• *: This shows that the current or previous entry in the navigation bar has been modified and has unsaved changes.

Note: The most important navigation item in the navigation bar is the root of the receipt, i.e., the first navigation item that follows "Receipt >" in the navigation bar. The importance is that this is the only place in the navigation bar that allows you to save all the changes to the database.

Understanding Receipt Previews

To understand how changes have affected a receipt, it is useful to preview the effect they will have on a transaction. This can be done using the Receipt Preview option available in the Receipt Maintenance. This allows you to select transactions that you can view while editing. As each change is made the Receipt Preview will be updated to reflect that, allowing you to immediately determine if that change is right for you.

The basics of creating a preview was covered in the previous "Previewing the Customised Receipt" section. This section is about how these previews can be managed and how we can use this preview to navigate across the different elements in the Receipt. Once a preview has been created and the Show Preview icon is clicked the following Receipt Preview popup appears:

The following table details the 3 tabs of the Receipt Preview popup:

Configuration	Description
Receipt Preview	This shows the rendered receipt with all the current changes made for this receipt in the Receipt maintenance.
Transaction XML	This shows the transaction XML that is used to show the Receipt Preview.
Manage Previews	This contains all the options required to manage all the previews that are linked with this receipt.

Note: The rendered receipt in the Receipt Preview tab is updated whenever a change is made and can be viewed immediately.

Receipt Preview Tab

The Receipt Preview tab displays the current rendered receipt with all the changes made for this receipt. You can also use this to select an element on the receipt to view more information on the different elements of the receipt. This can be done by either clicking on the appropriate element on the receipt, or by selecting the element from the available dropdown list of the elements.

When the Sale header is clicked or Sale Header Line is selected from the dropdown, the following information is displayed:

The Rendered Path sub-tab will display path to the selected element, based on the order the renderer reached this particular output. Some parts of the path are navigable. Simply clicking on the Sale Header would navigate you to the Sale Header element as follows:

Similarly, any element on the Receipt Preview can be selected and easily navigated to, in order to make the required customisations.

Also, in the Receipt Preview tab Rendered Path sub-tab the following is depicted:

1 - The element that you have selected to be rendered is highlighted in the receipt in light blue.

2 - The elements that can be navigated to are indicated with underlined texts. In the above example, Receipt Header Section and Sale Header Line can be clicked and navigated into. The SaleHeaderLine, Header and Sale Header Line elements can be found within the Sale Header element.

The Rendered Content sub-tab's section will display the Message Value and Message Translation details related to the selected element of the Receipt Preview as follows:

Manage Previews Tab

The Manage Previews tab manages a list of previews for a receipt. Whenever a preview is chosen it will be added to the list.

The following can be done to each receipt preview that is in this list:

• Previews that are no longer required can be deleted.

• Previews can be edited, which goes to the same page used when creating the preview.

• Previews that are not the currently selected preview will have a button to switch to that preview.

Eg: If I need to make some customisations that are related to just a Style Colour Size product, the Basic StyleColourSize Product Receipt Preview should be selected from the above shown screen. This preview that has been created contains a transaction where just a Style Colour Size product has been sold, and this would allow to preview the customisations which are relevant to just this. The same way you can create your own set of previews here for the different scenarios that you will want to customise and preview your receipts.

Managing Receipt Columns

The placement of text on a line is controlled by columns. These tell the printer where the text should start and end, how it should be aligned, and whether there should be any wrapping.

The following table details the properties of the Column Definition:

Configuration	Description
Column Def Id	This ID is used to uniquely identify a column. Changing the ID of an existing column will have no effect on the users of that column and will stop the printer from being able to correctly place the output for that element.
Start and End Position	These control where an element can place its output. Positions that start before or end after the receipt line are meaningless and so will be prevented by the application. When multiple columns appear on the same line they are applied in order. Should two columns overlap, the later one will overwrite the earlier one. Whitespace can never overwrite text.
Allow Wrapping	Normally a column will truncate any output to fit within its bounds. By enabling wrapping, the column will instead use additional lines to fit any remaining output. Once the wrapping is done normal output will resume from the next line.
Horizontal and Vertical Alignment	This controls where the output is to be placed within the start and end boundaries of the column.

Addition of Elements to Receipts

Elements can be added to the different sections and elements of receipts. After navigating into the appropriate element of the Receipt, you will be able to add new elements using the dropdown shown below:

The Filter Enabled button can be used to toggle between enabled and disabled, allowing to add a filter to the elements in the dropdown list, which would make it easier to select an element that would be most appropriate to add within this element that you are in.

After selecting the appropriate element from the dropdown list, click on + Add button to add the selected element to your Receipt.

Creating a Barcode for Receipts

Similar to adding elements to the Receipt, barcodes can also be added by selecting the + Create Barcode button as follows:

This will navigate to the screen that allows to create a new barcode where the following options will have to be selected and entered:

Set the appropriate values as follows:

Configuration	Description
Element ID	Enter an ID to uniquely identify this new barcode.
Barcode Type	Select one of the following barcode types from the drop-down list: EAN 8 EAN 13 EAN 128 UPC ITF 14 Code 39 Code 93 QR Code
Barcode Size	Select one of the following barcode sizes from the drop-down list: Tiny Small Medium Large
Barcode Data	Enter the data is to be depicted by this barcode. For example, if it is the transaction ID that is to be displayed, the expression #{transaction.transactionId} is to be entered here.

Following is an example of how a QR Code Barcode has been configured to display the transaction ID of the transaction in the Receipt:

Click on + Create and then select an appropriate column. This will now have successfully added this new barcode to your Receipt.

Creating a List of Elements for Receipts

Receipt Maintenance provides the functionality to add multiple elements as a list within a table for any section. An existing example for this is the Table of Items found in the Basket Item List of Receipt Body section of the receipt.

Another existing example is the Table of Modifiers found within the Item Modifiers of the Receipt.

Lists can be created by selecting the + Create List button as follows:

An Element ID and List Expression should be entered for this new List.

The Element ID should be anything meaningful, and the List Expression should be associated with the elements that you will be adding within this list. Following is an example of a list created to add modifier elements.

The new list will then be displayed as follows:

Within this new list, you can add elements as required using the 4 buttons that are within this list.

1. Create Hide Element:
   Allows to create a simple element to hide additional data from the list.

2. Add:
   Allows to add elements from the dropdown list.

3. Add as Header:
   Allows to add an element from the dropdown list to be fixed as the first element of the list.

4. Add as Footer:
   Allows to add an element from the dropdown list to be fixed as the last element of the list.

Importing Containers from one Receipt to another Receipt

Different receipts will often ensure consistency by using the same containers for their layout. For instance, the Standard Receipt and the Combined Receipt. When you make changes in Receipt Maintenance, this consistency is technically broken. So, if you had just edited the Receipt Header section for the Standard Receipt, this then would no longer be the same Receipt Header section used by the Combined Receipt. To help with this, Receipt Maintenance pays attention to which Receipts have been edited. So, whenever you create or edit another custom receipt, Receipt Maintenance will provide you with the opportunity to import changes between receipts. This is shown below:

The above example shows how changes have been made in the above containers that are common for both Standard Receipts and Combined Receipts. Here, you can either select or de-select the containers to import into the Combined Receipt as needed. This will reduce the time taken to duplicate the customisations among the different receipt types.

Customisations to Receipts

There are various customisations that can be made to Receipts and this section covers most of the basic customisations. In the previous section, a customisation was made to hide the currency symbol of each merchandise item in the printed standard receipt.

This section would cover step-by-step on a wider range of customisations that can be made to Receipts.

Note: Each of the following customisations start by using a new Standard Receipt that has a 44-columns template from scratch (as shown in the Create a new Receipt section) and ends up with the customisation being made as per each requirement.

Following is the preview of the Standard Receipt with the 44-columns template without any customisations that we will be using throughout the next sections:

Add content such as date, time and thank you message to the footer

This section will guide you through on how customisations can be done in the footer section of the Receipt. In the existing Standard Receipts footer, there is already a line with the date, time, name and transaction ID. And also, this line is below the message that says, "Thank you for shopping at Enactor".

In this customisation, we will change the content of the footer and display it in the following order:

• Display only the date and time.

• Display the Thank you message.

• Centre align both lines.

Let us first disable the Thank you message that appears in the current Receipt.

1 - Navigate to the Receipt Barcode Section where we can find the "Location Trailer Lines" element that displays the Thank you message.

2 - Disable the Location Trailer Lines element as follows:

3 - Clicking on Receipt Preview now would show that the Thank you message does not display in the Receipt anymore.

Next, we need to disable the existing line that displays date, time, name and transaction ID.

4 - Navigate to the Receipt Footer Section where we can find the "Trailer Line" element that displays the date, time, name and transaction ID.

5 - Disable the Trailer Lines Element as follows:

6 - Clicking on Receipt Preview now would show that the date, time, name and transaction ID does not display in the Receipt anymore.

Now that we have disabled the existing elements of the current receipt, we can now start adding the elements in the order that we need.

First, we need to add the element to display just the date and time in the Receipt Footer.

1 - In the Elements column, from the dropdown, select the "Header Line" element and click on the Add button.

2 - Now we need to move it up in the order list.

Use the up arrow of the Header Line element row and move this element to the position of the Trailer Lines element that was disabled.

We must now customise this element to display only the Date and Time.

3 - Click on the edit icon of the Header Line element and disable the two elements that are not required to display the date and time.

The two date and time related elements that are enabled have "Three Columns Row 1 (Left)" assigned to them. This gives a left alignment to this element.

4 - To centre align the date and time elements, change the corresponding columns to "Full Width (Centre)" as follows:

Now that we have customised to display only the centred date and time in our Receipt footer, click Save.

Finally, we need to display the Thank you message as the final line of the Receipt.

1 - In the Elements column of the Receipt Footer section, from the dropdown, select the "Location Trailer Lines" element and click on the + Add button.

Since we need the Page Break to be final element of the Receipt, we need to move the Location Trailer Lines element up in the order list.

2 - Use the up arrow of the Location Trailer Lines element row and move this element to the position of the Page Break element.

Now that we have made all the necessary changes to the Receipt Footer section, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, your Receipt will now display the customised Receipt Footer in the POS as follows:

The Receipt Footer appears here as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

Style Colour Size Product Customisations

This section covers the customisations of the Receipts that are related to Style Colour Size Products.

The current Standard Receipt displays Style Colour Size Products as follows:

You can notice that the Product Description line and the Style, Colour and Size lines are all together. In this customisation we will change the content of the receipt to display the Style, Colour and Size lines indented to the right for each product, so that it will make the Receipt look more organised.

1 - Navigate to the Receipt Body Section > Basket Items List > Merchandise Item > Merchandise Item Style Colour Size Details where we can find the Style, Colour and Size elements.

2 - For these 3 elements, change the column from Item Detail 1 to Item Detail Line 2 as follows:

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, the customised Receipt with the Style, Colour and Size customisations will now show in the POS as follows:

The Style, Colour and Size customisations for the item appears here as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

Basket Modifiers

This section covers the customisations that are related to basket item modifiers of the basket items such as item discounts, transaction discounts and price overrides.

The current Standard Receipt displays discounts as follows:

It can be seen here that the discount reason is displayed twice in this Receipt, the discount value contains brackets and the item price after the reduction is not displayed in this Receipt.

So before starting any of the basket modifier customisations, let us first customise the current Standard Receipt to show the basket item modifiers in a clean and clear manner.

Initial Customisation for Basket Modifiers

In this customisation, we will change the current Standard Receipt content of the receipt as follows:

• Hide the item value that appears at the end of product description line.

• Disable the item discount that re-appears.

• Hide the brackets and leave just the discount value with the negative symbol.

• Display the final item value after discount, along with its Active Selling Code.

Let us first hide the item value of the item and leave only the product description in the first line of each item in the Receipt.

1 - Navigate to the Receipt Body Section > Basket Items List > Merchandise Item > Merchandise Standard Item Details and disable the "Value" element as follows:

This would now hide the item value and leave only the product description in the first line of each item in the Receipt as follows:

Now we have to disable the duplicate item discount that appears in the current Receipt.

1 - Navigate to the Receipt Body Section > Basket Items List where we can find the "Discount Item" element that displays the duplicate item discount reason.

2 - Disable the Discount Item element as follows:

3 - Clicking on Receipt Preview now would show that the duplicate item discount does not display in the Receipt anymore.

Next, we need to hide the brackets and leave just the item discount value with the negative symbol.

1 - From the Basket Items List page, navigate to Merchandise Item > Item Modifiers > Discount Modifier where we can find the elements that display the various item discount values.

The Discount Modifier Review Line is the element that displays the discount values with the brackets.

2 - Disable the "Discount Modifier Review Line" element and enable the "Discount Percentage Modifier" and "Discount Value Modifier" elements as follows:

This would now display the applied discount along with its reason as follows:

Now let us display the final item value after discount, along with its Active Selling Code.

1 - Navigate to the Receipt Body Section > Basket Items List > Merchandise Item where we can find the "Merchandise Item Trailer" element.

2 - Navigate into the Merchandise Item Trailer element where we can find the "Merchandise Item Article" element that enables the Active Selling Code.

3- Tick in the Enable column of the Merchandise Item Article to enable this element.

Following is a Receipt Preview that shows what has happened after enabling this.

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

This Standard Receipt is now ready to make basket modifier customisations.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done for the Standard Receipt should also be made to the Combined Receipt.

Item Discount Pricing

This section will guide you through on how Item Discount customisations can be made in Receipts.

In this customisation, we will change the content of the receipt and display it in the following order:

• Display only the Product Description of the item without the value.

• Display the Original Price of the item.

• Display the Item Discount and value.

• Display the Item Discount Reason.

• Display the Product ID or Active Selling Code and the final value of the item.

From the above list, the current customised standard receipt only needs customisations for the first 2 lines of the Receipt, i.e., hiding the item value from line 1 and adding the new line 2 which displays the original price of the item.

Note: Before starting the customisations in this section, make sure that you have made the customisations to the Standard Receipt as discussed in the sub-section "Initial Customisation for Basket Modifiers".

Let us first add the new line to display as line 2, of each item in the basket, which is to display the original price of this item before the item discount is applied.

1- Navigate to the Receipt Body Section > Basket Items List > Merchandise Item > Item Modifiers and enable the "PreItem Modifiers Conditional" element as follows:

This element would display the below contents of the Receipt for each item in the basket:

By enabling the above element, you can notice that the original price is displayed but the following 2 adjustments are to be made:

• Remove the duplicate item discount that appears from the Discount Modifier element.

• Fix the alignment of the Original Price label.

2 - In the current Item Modifiers page, disable the two "Discount Modifier" elements.

3 - In this same page, navigate to PreItem Modifiers Conditional > PreItem Modifiers Item Value.

4 - For the "Original Value Label" element, change the column to Item Detail Line 2 as follows:

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, the customised Receipt with the Item Discount customisations will now show in the POS as follows:

The Item Discount will be displayed in the format as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

Transaction Discount Pricing

This section will guide you through on how Transaction Discount customisations can be made in Receipts.

Following shows how transaction discounts are displayed in the current customised standard receipt:

Note: Before starting the customisations in this section, make sure that you have made the customisations to the Standard Receipt as discussed in the sub-section "Initial Customisation for Basket Modifiers".

In this customisation, we will change the content of the receipt and display it in the following order:

• Display only the Product Description of the item without the value.

• Display the Product ID or Active Selling Code and the final value of the item.

• Display a separator after all the basket items.

• Display the total of the original prices of the items in the basket.

• Display the reason and total value of all the Transaction Discount applied for each item in the basket.

• Display the final total of the Receipt which is the transaction discounts total deducted from the original price.

From the above list, the current customised standard receipt needs customisations for displaying the transaction discount and value of each basket item, display a separator at the end of the basket items and displaying of the 3 totals.

Let us add the separator, total transaction discount value and the final total value of the Receipt.

1- Navigate to the Receipt Body Section, disable the "Transaction Discount Item List" element and enable the "Basket Transaction Items List" element.

2 - Navigate into the "Basket Transaction Items List" element and enable both elements that are displayed as follows:

This element would display in the receipt as follows:

Let us now add a separator line to the first line of this element.

3 - Navigate into the PreBasket Transaction Discounts Conditional > PreTransaction Discounts Total and from the dropdown, select the "Separator" element and click on the + Add button. Now move it up to the first row by clicking on the up-arrow of this element once.

Let also fix the alignment of the Total Label here.

4 - Change the Column of the Label row to "Item Detail Line 1" as follows:

After adding the Seperator and fixing the total label alignment, the changes made are as follows:

The receipt preview after making the above changes is now shown as below:

There is still a duplicate transaction discount item line that appears above the new element that we added, which is to be removed.

5- Navigate to the Receipt Body Section > Basket Items List and disable the "Transaction Discount Item" element.

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, the customised Receipt with the Transaction Discount customisations will now show in the POS as follows:

The Transaction Discount will be displayed in the format as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

Price Overrides

This section will guide you through on how Price Override customisations can be made in Receipts.

Price Override Down

Following shows how Price Override Down is displayed in the current customised standard receipt:

Note: Before starting the customisations in this section, make sure that you have made the customisations to the Standard Receipt as discussed in the sub-section "Initial Customisation for Basket Modifiers".

In this customisation, we will change the content of the receipt and display it in the following order:

• Display only the Product Description of the item without the value.

• Display the Original Price of the item.

• Display the Price Override and its value with a negative symbol.

• Display the Product ID or Active Selling Code and the final value of the item.

• Remove the Duplicate Price Override that appears with a 0 value.

From the above list, the current customised standard receipt needs customisations from lines 2 to 4, which displays the original price, price override and the price override reason of the basket item. We need to also finally remove the duplicate price override that appears.

Let us first enable the original price of the item.

1 - Navigate to Receipt Body Section > Basket Items List > Merchandise Item > Item Modifiers > Price Override Modifier.

2 - Enable the "PreItem Modifiers Line" element and change its column alignment to "Item Detail Line 2" from the column dropdown as follows:

The Receipt Preview would now display the Original Price as follows:

Now we have to add the Price Override and its value with a negative symbol.

3 - In the same Price Override Modifier page, enable the "Price Difference" element and now the Receipt Preview will be as follows:

Let us now disable the duplicate price override line that appears at the end of the basket.

4 - Navigate back to the Basket Items List element and disable the "Price Override Item" element as follows:

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, the customised Receipt with the Price Override down customisations will now show in the POS as follows:

The Price Override down will be displayed in the format as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

Price Override Up

Following shows how Price Override Up is displayed in the current customised standard receipt:

Note: Before starting the customisations in this section, make sure that you have made the customisations to the Standard Receipt as discussed in the sub-section "Initial Customisation for Basket Modifiers".

In this customisation, we will change the content of the receipt and display it in the following order:

• Display only the Product Description of the item without the value.

• Remove the Price Override up in the Receipt.

• Display the Product ID or Active Selling Code and the final value of the item.

• Remove the Duplicate Price Override that appears with a 0 value.

From the above list, the current customised standard receipt needs customisations only to the lines 2 and 4, where we need to also remove the price override reason up and the duplicate price override that appears.

Let us first remove the price override reason up of the item.

1 - Navigate to Receipt Body Section > Basket Items List > Merchandise Item > Item Modifiers.

2 - Enable the "PreItem Modifiers Price Override Conditional" element and disable the two "Price Override Modifier" element as follows:

The Receipt Preview would now display as follows:

Let us now disable the duplicate price override line that appears at the end of the basket.

3 - Navigate back to the Basket Items List element and disable the "Price Override Item" element as follows:

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, the customised Receipt with the Price Override up customisations will now show in the POS as follows:

The Price Override up will be displayed in the format as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

Promotions

This section will guide you through on how Promotion customisations can be made in Receipts.

Following shows how promotions are displayed in the current customised standard receipt:

Note: Before starting the customisations in this section, make sure that you have made the customisations to the Standard Receipt as discussed in the sub-section "Initial Customisation for Basket Modifiers".

In this customisation, we will change the content of the receipt and display it in the following order:

• Display only the Product Description of the item without the value.

• Display the label "Current Value" and the value of the item.

• Display the label "Promotion" and the value.

• Display the Promotion Description.

• Display the Product ID or Active Selling Code and the final value of the item.

• Hide the Savings section that displays the promotion calculations.

From the above list, the current customised standard receipt needs customisations for displaying the current value label and the value of the item, the promotion label and value, the promotion description and hiding the savings section that shows the promotion calculations.

Let us first add the current value label and the value of the item before promotion.

1 - Navigate to the Receipt Body Section > Basket Item List > Merchandise Item > Item Modifiers

2 - Disable the 2 "Promotion Modifier" elements, enable the "PreItem Modifiers Promotions Conditional" element and navigate into "PreItem Modifiers Promotions Conditional > Promotion Modifier" as follows:

The receipt preview after making the above changes is now shown as below:

Now we have to display the label "Promotion" and the value, followed by the Promotion Descriptions.

3 - Disable the "Promotion Saving Item Trigger" elements.

4 - Enable the "Distributed Promotion Savings" and "Distributed Promotion Savings Amount" elements.

5 - Move the "Distributed Promotion Savings" element above the "Distributed Promotion Savings Amount" element.

The receipt preview after making the above changes is now shown as below:

Now let us fix the alignments of the Promotion and Current Value labels.

6 - Navigate to the "Distributed Promotion Savings Amount" element and change the column of the "Item" element to Item Detail Line 1 as follows:

7 - Now navigate back out to the "PreItem Modifiers Promotions Conditional" element and then from there, into the "PreItem Promotions Item Value" element and change the column of the "Original Value Label" element to Item Detail Line 1 as follows:

The receipt preview after making the above changes is now shown as below:

Now we have to finally hide the Savings section that displays the promotion calculations.

6 - Navigate back out to the "Receipt Body Section" element and disable "Promotion Calculation" element as follows:

Now that we have made all the necessary changes as required, click on Save and navigate to the root of the Receipt and save all changes to this Receipt.

You can select your Receipt again and preview it before broadcasting and using this new customised Receipt in the POS.

If everything is successful, the customised Receipt with the Promotion customisations will now show in the POS as follows:

The Promotion will be displayed in the format as required and hence it can be seen that the Receipt has been successfully customised and printed on the physical printer.

Note: If you are going to use card as the tender option, then it is the Combined Receipt type which is used in the POS to print and not the Standard Receipt. Hence, the same changes done above for the Standard Receipt should also be made to the Combined Receipt.

You can refer to Configuring Receipts for more details on receipt customization.