Advanced Config of SELLmatix Point of Sale (POS). Output Variables

When SELLmatix POS generates an Output Event, certain variables are available to be output to the various devices depending on the state of processing. The variable available to be output belongs to a Dataset, and if an Output Event has Header Dataset variables available, the output can contain any of these variables, embedding the variable name in % characters.

Back to top

When an output event occurs which has the Header Dataset available, the following variables can be used. For a list of Output Events which have the Header Dataset of variables available, click here

Header Dataset Variables
Variable	Description
%SITE NAME%	The name of the vendor running the POS and selling the goods.
%SITE ADDR 1%	Line 1 of the address of the vendor.
%SITE ADDR 2%	Line 2 of the address of the vendor.
%SITE ADDR 3%	Line 3 of the address of the vendor.
%SITE ADDR 4%	Line 4 of the address of the vendor.
%SITE PHONE%	Vendor's phone number.
%SITE FAX%	Vendor's fax number.
%SITE EMAIL%	Vendor's email address.
%SITE GROUP%	Reserved. Do not use.
%POS NAME%	The computer Name of the POS machine that processed the sale.
%DOCNUM%	The receipt or document number of the transaction.
%CLERK NAME%	The Clerk logged on who processed the sale.
%LOCATION%	The Location (Table Number) of the Order.
%COVERS%	The number of guests at the table in a restaurant.
%COMMENT%	The Comment entered in the Sale Header.
%CUST NO%	Customer Account number if applicable.
%CUST NAME%	Customer Name if applicable.
%ADDRESS 1%	The first line of the customer address.
%ADDRESS 2%	The second line of the customer address.
%ADDRESS 3%	The third line of the customer address.
%ADDRESS 4%	The fourth line of the customer address.
%DATE%	Date sale processed in short format.
%LONGDATE%	Date sale processed in long format.
%TIME%	Time sale processed.
%TOTAL%	Total amount of the Sale.
%ROUND ADJ%	Cents rounding adjustment. Applicable to finalisations where rounding required. Otherwise blank.
%TAXTOT%	Total amount of tax on the sale.
%BALANCE%	Balance unpaid on the sale. This amount= Sale Total - payments while sale processing, and when sale complete = zero.
%ORDER NO%	Order Number supplied by the customer. Optional and normally blank.
%MESSAGE 1%	The first line of the Customer Message set in General Settings.
%MESSAGE 2%	The second line of the Customer Message set in General Settings.
%MESSAGE 3%	The third line of the Customer Message set in General Settings.

Back to top

When an output event occurs which has the Line Dataset available, the following variables can be used. For a list of Output Events which have the Header Dataset of variables available, click here

Line Dataset Variables
Variable	Description
%DESC%	Description of the line item.
%ALT DESC%	Alternate Description of the line item.
%GUEST%	The Guest Number that ordered the item.
%TAXFLAG%	Flag indicating if the item includes tax. Contains "*" if yes blank otherwise.
%TAXVAL%	The value of the tax on this line.
%DISCOUNT%	The value of the discount on this line.
%DISCCALC%	Reserved. Do not use.
%CODE%	The item code for this line. ie. PLU/Adjustment/Finalisation number.
%DEPT%	The department code for the product.
%QTY%	The quantity of items on this line.
%UNIT PRICE%	The unit price of the item.
%TOTAL%	The total including tax.
%TOTAL EX%	The total excluding tax.
%ZSTOTAL%	Zero Suppressed total including tax. (Blank instead of zero for zero value)
%ZSTOTAL EX%	Zero Suppressed total excluding tax. (Blank instead of zero for zero value)
%CHANGE%	The amount of change due. Applies only to finalisations otherwise blank.

Back to top

When an output event occurs which has the Receipt Header Dataset available, the following variables can be used. For a list of Output Events which have the Receipt Header Dataset of variables available, click here

Receipt Header Dataset Variables
Variable	Description
%SITE NAME%	The Name of the vendor selling the goods.
%SITE ADDR 1%	The first address line of the vendor.
%SITE ADDR 2%	The second address line of the vendor.
%SITE ADDR 3%	The third address line of the vendor.
%SITE ADDR 4%	The fourth address line of the vendor.
%SITE PHONE%	The phone number of the vendor.
%SITE FAX%	The fax number of the vendor.
%SITE EMAIL%	The email address of the vendor.
%SITE GROUP%	Reserved. Do not use.
%POS NAME%	The computer name of the POS machine that processed the sale.
%DOCNUM%	The receipt/transaction/Invoice number of the sale.
%CLERK NAME%	The name of the Clerk that processed the sale.
%LOCATION%	The Location (Table Number) of the sale.
%COVERS%	The number of Guests at the table in a restaurant.
%COMMENT%	The Comment entered into the Sale Header.
%GUEST%	The Guest Number. This field only contains data when separate accounts are being printed for each guest at a Location (Table).
%CUST NO%	The account number of the customer that purchased the goods.
%CUST NAME%	The name of the customer that purchased the goods.
%ADDRESS 1%	The first address line of the customer that purchased the goods.
%ADDRESS 2%	The second address line of the customer that purchased the goods.
%ADDRESS 3%	The third address line of the customer that purchased the goods.
%ADDRESS 4%	The fourth address line of the customer that purchased the goods.
%REP%	Reserved. Do not use.
%DATE%	The date of the sale in short localised format.
%LONGDATE%	The date of the sale in long localised format.
%TIME%	The time of the sale in localised format.
%TOTAL%	The sale total amount.
%EX TOTAL%	The sale total amount not including tax.
%ROUND ADJ%	The round amount applied to the sale total.
%TAXTOT%	The total amount of taxes applied to the sale.
%BALANCE%	The amount remaining unpaid on the sale. Always zero when receipt printed.
%ORDER NO%	The customer order number if entered.
%PAGE NO%	The page number on multi page invoices.
%MESSAGE 1%	The first line of the receipt message.
%MESSAGE 2%	The second line of the receipt message.
%MESSAGE 3%	The third line of the receipt message.

Back to top

When an output event occurs which has the Receipt Line Dataset available, the following variables can be used. For a list of Output Events which have the Receipt Header Dataset of variables available, click here

Receipt Line Dataset Variables
Variable	Description
%DESC%	Description of the item purchased.
%ALT DESC%	Alternate Description of the item purchased.
%GUEST%	Guest number that ordered the item.
%TAXFLAG%	Contains '*' if the item is taxable, blank otherwise.
%TAXVAL%	The amount of tax if applicable.
%DISCOUNT%	The value of the discount give, blank otherwise.
%CODE%	The Barcode/Adjustment/Finalisation number.
%DEPT%	The Department code for the item sold.
%QTY%	Quantity of items purchased on this line.
%UNIT PRICE%	The Unit Price of the item.
%TOTAL%	The extended line total for this line.
%TOTAL EX%	The total excluding tax.
%ZSTOTAL%	Zero Suppressed total including tax. (Blank instead of zero for zero value)
%ZSTOTAL EX%	Zero Suppressed total excluding tax. (Blank instead of zero for zero value)
%CHANGE%	The amount of change given for finalisation lines. Otherwise blank.

Back to top

When an output event occurs which has the Report Header Dataset available, the following variables can be used. For a list of Output Events which have the Report Header Dataset of variables available, click here

Report Header Dataset Variables
Variable	Description
%SITE NAME%	The name of the shop.
%SITE ADDR 1%	The first address line of the shop.
%SITE ADDR 2%	The second address line of the shop.
%SITE ADDR 3%	The third address line of the shop.
%SITE ADDR 4%	The fourth address line of the shop.
%SITE PHONE%	The phone number of the shop.
%SITE FAX%	The fax number of the shop.
%SITE EMAIL%	The email address of the shop.
%SITE GROUP%	Reserved. Do not use.
%POS NAME%	The computername of the machine processing the report.
%POS NUMBER%	Reserved. Do not use.
%DATE%	The date of the report in short localised format.
%LONGDATE%	The date of the report in long localised format.
%TIME%	The time of the report in localised format.
%HEADING%	Title of the report.
%SHIFT%	The shift number of the report.
%ZREAD NUMBER%	The sequential Z-Read Number.

Back to top

When an output event occurs which has the Report Line Dataset available, the following variables can be used. For a list of Output Events which have the Report Line Dataset of variables available, click here

Report Line Dataset Variables
Variable	Description
%DESC%	The text of the report line.
%QTY%	The number of items reported on.
%VALUE%	The value of items reported on.

Back to top