We are currently still building up the English documentation; not all sections have been translated yet. Please note that there may still be German screenshots or links to German pages even on pages that have already been translated. This guide mostly addresses English speaking users in Germany.
Variables, commands and formatting for cash receipts
On this page you will find an overview of all variables, commands and formatting options. You can use all of them in the print templates for receipts in the Printer settings. Some commands do not work on certain printers.
This list is constantly being expanded.
Variables for cash receipts
Here you will find a list of all variables that you can use in receipts.
$logo$
The logo stored in Settings > Printing objects > Logo
$header$
The header defined under Settings > Printing objects > Header
$customer$
Prints the customer data stored as variables in the printer settings under Menu > Printer > Tap on printer > Edit customer data template.
$pos_name$
Name of the line item (item name, name of the favourite, name of the custom line item, etc.)
$pos_no$
SKU of the line item
$pos_gtin$
GTIN of the line item
$pos_total$
Net sales price of the line item (total)
$pos_tax$
Tax rate abbreviation (Aor B; A = normal tax rate, B = reduced tax rate)
$pos_quantity$
Item quantity for the line item
$pos_price$
Sales price per piece
$pos_comment$
Comment on line item
$pos_unit$
Sales unit of line item
$currency$
Currency
$currency_sym$
Currency symbol (e.g. € or $)
$given$
Total amount received
$return$
Total change given
$gratuity$
Total tips received
$total$
Total gross amount for receipts
$total_net$
Total net amount for receipts (minus payments for returns)
$total_net_all$
Total net receipt amount (without deduction of payments for returns)
$total_tax$
Total tax
$t1$
Normal tax rate in percent
$t2$
Reduced tax rate in percent
$t1net$
Total net amount to which the normal tax rate applies
$t2net$
Total net amount to which the reduced tax rate applies
$t1tax$
The total amount of tax resulting from the normal tax rate
$t2tax$
Total amount of tax resulting from the reduced tax rate
$t1total$
Total gross amount for receipts to which the normal tax rate applies
$t2total$
Total gross amount for receipts to which the reduced tax rate applies
$date$
Date on which the receipt is issued
$time$
Time at which the receipt is issued, format: hh:mm (hours:minutes)
$receipt_no$
Receipt number
$receipt_paid_no$
Payment number
$cashbox_name$
Name of the cash register
$cashbox_id$
Cash register ID
$user_id$
User ID
$footer$
The footer defined under Settings > Printing objects > Footer
$payment_method$
Payment method
$discount$
Total discount
$payment_info$
Issues the transaction information of the card payment
$customer_no$
Customer ID
$customer_name$
First name and last name of customer, taken from customer master data
$customer_address$
Street and house number of the customer, taken from customer master data
$customer_postcode$
Postal code of the customer, taken from customer master data
$customer_city$
Place of residence of the customer, taken from customer master data
$customer_country$
Country of the customer, taken from customer master data
$receipt_no_long$
Receipt number is output in full
$company_tax_no$
Tax ID
$company_vat_id$
VAT identification number
Variables for TSE
$tse_sn$
Serial number of the TSE. Can only be used after the TSE has been activated.
$tse_footer$
Issues the signature of the TSS. The information in the signature comes directly from Epson and cannot be edited. Can only be used after the TSE has been activated.
$tse_qr$
Issues the signature of the TSS as a QR code. The QR code can only be added to printed receipts. It is not displayed on receipts sent via email. Can only be used after the TSE has been activated.
Other variables
$external_no$
External transaction ID, e.g. JTL-Wawi sales order ID if the order has been transferred from JTL-Wawi.
$user_name$
User name
Commands
You can insert these commands on receipts to control the printer. Not all commands are supported by all printers.
<CUT>
Cuts the paper at the tag position.
<OPENCD>
Opens the cash drawer connected to the printer.
<CUTSTAR>
Cut command for STAR printer.
<HEX>x1b,x64,x00</HEX>
With the hex command, bytes commands can be sent to the printer separately, e.g. for CUTSTAR.
<OPENCDSUNMI>
Opens the Sunmi cash drawer connected to the printer.
Formatting options
You can use these options to format your text. xxx can be replaced by plain text or one of the above variables. Not all formatting options are supported by all printer models.
<BR>
Inserts a line break.
<B>xxx</B>
Formats the text within the tags in bold.
<U>xxx</U>
Underlines the text within the tags.
<U2>xxx</U2>
Underlines the text within the tags and formats it in bold.
<F1>xxx</F1>
Selects Font 1 for the text within the tags.
<F2>xxx</F2>
Selects Font 2 for the text within the tags.
<H2>xxx</H2>
Doubles the hight of text within the tags.
<W2>xxx</W2>
Doubles the width of the text within the tags.
<T2>xxx</T2>
Makes the text within the tags twice as large (height and width).
<L>xxx</L>
Aligns the text within the tags to the left.
<R>xxx</R>
Aligns the text within the tags to the right.
<C>xxx</C>
Centres the text within the tags.
<FS>
Resets the font size to default.
<WIDTH>
Window width
Contents
Use these variables to mark certain elements of your receipt, for example, as a tip section. These are only printed if the corresponding content is required. In the case of a tip section, for example, when you are tipped.
<position>xxx</position>
Line item
<gratuity>xxx</gratuity>
Tip
<change>xxx</change>
Change
<discount>xxx</discount>
Discount
<copy>xxx</copy>
Copy
<cancellation>xxx</cancellation>
Cancellation reason
<payment>xxx</payment>
Payment
Bar codes
You can have bar codes printed on your receipts. You can use the following variables to do this.
<QRCODE>xxx</QRCODE>
Issues a QR code for the variable specified in xxx. The size is approx. 3.5 cm x 3.5 cm.
<QRCODE2>xxx</QRCODE2>
Issues a smaller QR code for the variable specified in xxx. The size is approx. 1.5 cm x 1.5 cm.
<CODE128>xxx</CODE128>
Issues a Code128 bar code (GS1-128) for the variable specified in xxx.
<EAN8>xxx</EAN8>
Issues a GTIN-8 bar code for the variable specified in xxx.
<EAN13>xxx</EAN13>
Issues a GTIN-13 bar code for the variable specified in xxx.
<UPC_A>xxx</UPC_A>
Issues a UPC-A bar code (GTIN-12) for the variable specified in xxx.
<UPC_E>xxx</UPC_E>
Issues a UPC-E bar code for the variable specified in xxx.
Variable length limitations
When printing, receipt variables have different lengths depending on the width of the paper used, so that the variables fit on the paper.
For numbers, these variables are limited to X characters in length, including two decimal places.
The designation LEN_X corresponds to the width of the paper in terms of number of characters. LEN_32 = 32 characters per line
LEN_48 = 48 characters per line, etc.
All prices, totals:
PRICE_LEN_32 = 9;
PRICE_LEN_42 = 12;
PRICE_LEN_48 = 12;
All tax amounts:
TAX_LEN_32 = 6;
TAX_LEN_42 = 8;
TAX_LEN_48 = 10;
Quantity in the line item:
QUANTITY_LEN_32 = 4;
QUANTITY_LEN_42 = 5;
QUANTITY_LEN_48 = 5;
Payment methods:
PAYMENT_METHOD_LEN_32 = 7;
PAYMENT_METHOD_LEN_42 = 11;
PAYMENT_METHOD_LEN_48 = 17;
Line item name:
NAME_LEN_32 = 20;
NAME_LEN_42 = 27;
NAME_LEN_48 = 33;
Receipt number:
RECEIPT_NO_LEN_32 = 7;
RECEIPT_NO_LEN_42 = 8;
RECEIPT_NO_LEN_48 = 10;
Related topics