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) |
Copyright 2014 SwiftTec - All Rights Reserved