SwiftTec MBS Help (Module-Based Data System)

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

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

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