POS Terminal - Receipt Configuration

The POS terminal allows the receipt to be configured using the receipt printer menu. This is a dialog with several tabs.

Printer

This tab allows the printer device to be selected. Select the type to be None to disable receipt printing, Standard for a normal windows printer or POS Compatible for a device that does not have a standard windows printer driver (normally connected via a serial cable).

To enable a standard printer select the Standard type and the select the printer from the drop down list. If the cash drawer is directly attached to the printer enter the character sequence need to open the cash drawer as a comma separated list of hexadecimal values, e.g 07,00,F0 . You will find the information in your printer documentation.

Header

In this section enter the formatted text that appears at the start of each printed receipt. See below for formatting and substitution information.

Example:

<font face="Arial" size="14" bold=1>
Your Company Name
</font><br>${tstamp}<br>

Items

In this section enter the formatted text that is used to output each item. This is split into 3 parts

Pre is output before the items
Row is output once for each item
Post is output after the items

If you start a section in the Pre section (e.g. <font>) you should close it in the Post section (e.g. </font>).

Pre Example:

<font face="Lucida Console" size="7.0"><br>

Row Example:

${quantity:2:right} <i>${code:10}</i>${description:23}<b>${total:8:right}</b><br>

Post Example:

${"Total charge":36:right}<b>${totalcharge:8:right}</b><br></font>

Payments

In this section enter the formatted text that is used to output each item. This is split into 3 parts

Pre is output before the payment
Row is output once for each payment
Post is output after the payments

If you start a section in the Pre section (e.g. <font>) you should close it in the Post section (e.g. </font>).

Pre Example:

<font face="Lucida Console" size="7.0"><br>

Row Example:

${description:36:right}<b>${amount:8:right}</b><br>

Post Example:

${"Total payment":36:right}<b>${totalpayment:8:right}</b><br></font>

Change

In this section enter the formatted text that appears in the change section of the printed receipt. See below for formatting and substitution information.

Example:

<font face="Lucida Console" size="7.0"><br>
${"Change":36:right}<b>${change:8:right}</b><br></font>

Notes

In this section enter the formatted text that appears in the notes section of the printed receipt. See below for formatting and substitution information.

Example:

<font size=7.0 italic=1>${description}</font><br>

Loyalty Points

In this section enter the formatted text that appears in the loyalty points section of the printed receipt. See below for formatting and substitution information.

Example:

<font face="Arial" size="14" bold=1>Loyalty Points</font><br>
<font face="Lucida Console" size="8.0"><br>
${loyaltymemberid} - ${loyaltymembername}<br>
Points added: ${loyaltypointsadded}<br>
Points redeemed: ${loyaltypointsredeemed}<br>
Points balance: ${loyaltypointsbalance}<br>
</font>

Footer

In this section enter the formatted text that appears at the end of the printed receipt. See below for formatting and substitution information.

Example:

<br>
<font size=7>
<b>Facility</b> ${fid} - ${facilityname}<br>

<b>Location</b> ${location}<br>
<b>Hostname</b> ${hostname}<br>

<b>Terminal</b> ${terminal}
</font>

Formatting

The formatting uses a basic HTML-like format which allows for the following entries:

Entry	Description
<br>	Substitute with a new line (line break)
<b>....</b>	Bold text
<i>....</i>	Italic text
<u>....</u>	Underlined text
<font params>....</font>	text with the specified font where the params can be face="font name" - set the font face, e.g. Arial size="point size" - Set the font size, e.g. 10.0 color="color name" - Set the font color (color printers only), e.g. red or #FF0000 bold=1 or 0 italic=1 or 0 underline=1 or 0

Text Variable Substitutions

As it is printed the receipt will substitute text that has the form ${....}. The text within the curly braces { } can contain up to 3 parts separated by colons. The 3 parts are param, width and alignment.

If the width component is specified the output will be padded using spaces using the width specified

If the alignment component is specified the output will be aligned in the padding string according to that given left=left align right=right align

So to output a number padded to 8 charaters and right aligned one might put in the text ${number:8:right}

The following parameters are recognised:

Parameter	Section	Description
"any string"	any	The contents of the string (excluding the quotes) is output - useful for outputting fixed strings in a padded / aligned manner
hostname	any	The hostname of the terminal computer
location	any	The location of the terminal
facilityid \| fid	any	The facility ID for the terminal location
terminalid \| terminal	any	The terminal ID
facilityname	any	The facility name for the terminal location
organisationid \| orgid	any	The organisation ID for the terminal location
organisationname	any	The organisation name for the terminal
operatorid \| opid	any	The ID of the terminal operator
operatorname	any	The name of the terminal operator
transactionid \| tid	any	The transaction ID
transactiontime \| ttime	any	The transaction time
transactiondate \| tdate	any	The transaction date
transactiontimestamp \| tstamp	any	The trasnsaction timestamp (date & time)
totalcharge	items	The total charge of all items
totalpayment	payments	The total amount paid
loyaltymemberid	loyalty	The ID of loyalty points member
loyaltymembername	loyalty	The name of loyalty points member
loyaltypointsadded	loyalty	The number of loyalty points added to the member account
loyaltypointsredeemed	loyalty	The number of loyalty points redeemed from the member account
loyaltypointsbalance	loyalty	The loyalty points balance for the member
change	change	The amount of change given
quantity	items	The quantity of items in the row
code	items	The item code
description	items, payments, notes	The item/payment description
amount	items	The single item amount
total	items	The item line total (quantity * amount)