The Volanté Self-Serve Kiosk solution is a simple, user-friendly, self-service touchpoint device that can be mixed and matched with traditional POS terminals or hand-held devices in any installation to increase your revenue, reduce labour costs and provide an excellent ROI.

Prerequisites

Version 4 - Build 1089 or higher
Computer with 1024x768 screen resolution.
- Note: If the resolution is higher, the POS screen image is docked to the top-right corner
POS Terminal Computer setup in Volante Back Office Hardware Section available to host the POS Kiosk solution
Barscanning setup (if applicable) - Scan Module and UPC Scan needs to be enabled and loaded
- To load the Scan Module: Enable the Scan Module from General Setup > Volante Modules and check off Scan Module
  - Please note that the user must have the Scan Module available for use.
- To enable UPC Scan, navigate to System Configuration > Tab 5 > Enable UPC Scan.
  - Ensure Scan Module is loaded, or UPC scan will be disabled in System Configuration.
  - For more details: Menu Item barcode (scan code) Setup
Unique "KioskUser" user with a username id and card code
KIOSK installation files (provided by Volanté or from own resources):
- Simple menu item export file (Optional file -- used to import menu items into the quick menu area)
- imageImport.txt file (BYOB install)
- volante.properties file (BYOB install)
- volante.properties.en file (BYOB install)
KIOSK image files (provided by Volante or from own resources):https://www.dropbox.com/s/h89tfd3xt5y44te/kioskfiles_20110110.zip
- idleBackground.png
- indicator.png
- indicatorActive.png
- mainBackground.png
- mainBackground2.png
- orderComplete.png
- payments.png
- watermark.png

*For a quick guide on kiosk, please visit Kiosk quick guide*

Setup Kiosk - Hardware Setup

Under Hardware, the Hardware and Terminal Setup window will open.

Locate the terminal you wish to be a kiosk, and enter the following in the Interface Link field, under Advanced Options:

Form:

KIOSK: <mode>,<option1>,<employeeUserId>,<PLU-Lookup>,<OptionsMode>,<OrderNumberPrefix>:<PaymentTypes>,<showButton>,<load type>,<minAmt>:<device port settings>:<dynamic flag>

Example 1: KIOSK:0,1,777,0,1,T001:23,1,3,1:DCOM2,VCOM9:
Example 2: KIOSK:0,1,777,0,3,T001:55,0,0,0.01:DNA,VNA:AFVDEL
Example 3: KIOSK:2,2,121212,0,3,T001 <- Basic BYOB type Kiosk. submitting orders.
Example 4: KIOSK:0,1,777,0,3,T001:47,0,0,0.01:VCOM2,DCOM3:AFVDEL

InterfaceLink	Description
Mode	0 = Cashier mode with payments 1 = Table-Service mode 2 = Cashier mode without payment (BYOB Mode) 3 = Load Only mode
Option1:	Table-Service Mode = Table Name: Name of the table being used for table-service mode Cashier Mode - Transaction Type: 0 - Not specified 1 - Dine-In Only 2 - Take-Out Only
EmployeeUserID	As pre-prerequisites, a unique user must be created to be used for login purposes on the Kiosk Terminal. This employee will need the appropriate permissions to perform table service by accessing the specified table or cashier mode. When the kiosk is in use, the employee is clocked in. You may need to clock out this user manually at the end of the day.
PLU-Lookup	Enable the ability to allow Product Lookup via PLU: 0 = Off 1 = On
Options Mode	1 = Options only 2 = Extras only 3 = Options then Extras 4 = Extras then Options
OrderNumberPrefix	Kiosks in Cashier mode will need to identify an Order Number on the reciept, and if there are multiple Kiosks, a prefix is required which indicates where it was from. ie. T003, T004 another kiosk might be M004,M00
Payment Types (Cashier mode only)	Sum of the following: 1 - Credit Card, 2 - Customer Account 4 - Gift Card 8 - Cash 16 - iGiftCard 32 - Debit Card 64 - Loyalty Points Accumulation 128-Data Candy Loyalty Member Example: 3 (which is Credit Card + Customer Accounts) Having a sum entered ensures there is a payment method available for Kiosk mode.
ShowLoadButton	The button is used to load cash or credit card funds to iGiftCard. The button is on left-bottom side of the mainscreen. 0 - Don't show Load button on Mainscreen 1 - Show load button on Mainscreen
Load Type	It is valid if the load button is on. This defines what media is acceptable to be loaded to iGiftCard. It is a sum of following: 0 - no load allowed 1 - allow load by credit card 2 - allow load by cash Example: 3 (Sum of bot allow load by credit card + cash)
Minimum Amount	Enter the minimum amount the coin dispenser and bill dispenser can return for change: Example: 0.01 would be one cent.
Device Port Settings	Accepts multiple port settings separated by comma. Port for Bill Validator: V+<port> Port for Bill Dispenser: D+<port> Example: VCOM2,DCOM3
Dynamic Flags	For dynamic flags, you can enter multiple flags or none (e.g. flag1, flag2, AFVDEL, flag3). There is no order for dynamic flags, but the string must be matched. AFVDEL = AFV Delivery Flag (enable Kiosk Delivery)

Old Kiosk Settings

KIOSK:<mode>:<option1>:<employeeUserId>:<PLU-Lookup>:<OptionsMode>:<PaymentTypes>:<OrderNumberPrefix>:<showButton>:<load type>:<minAmt>:<dispenser port>:<validator port>
Example: KIOSK:1:630:44444:1:3:15:T001:1:0:0.01:COM1:COM2

Variable No Longer Required (old settings for kiosk):

These were taken out and put in property files

Timeout: The amount of time in milliseconds allowed for inactivity by the user before the kiosk times out, cancels the order and exit to the idle screen. Default - 30000 milliseconds
End Timer (Cashier mode only): The amount of time in milliseconds allowed at the confirmation screen before it resets back to the idle screen. Default - 8000 milliseconds

Form:
KIOSK:<mode>:<option1>:<employeeUserId>:<Timeout>:<PLU-Lookup>:<OptionsMode>:<PaymentTypes>:<End Time>:<OrderNumberPrefix>

Example - KIOSK:1:630:44444:30000:0:1:3:7:8000:T001 - the OptionsMode 30000 and End TIme 8000 are no longer required

Kiosk AFV

For AFV kiosk set up instructions with a Precidia card refer to the following: Precidia - Setup.

Back Office

Choose Precidia as an iGiftcard in General setup > System Configuration > page4 Panel
Navigate to Hardware Setup > Terminal Setup, select the appropriate terminal and click the Credit Card tab.
Put PRECIDIA:::(e.g. PRECIDIA:192.168.1.39:8000:20000) in an iGiftcard Interfacelink
While in the hardware terminal setup, navigate to the Advanced Options tab.
Add appropriate info "KIOSK:,,,,,:,,,::" in Interface Link. See above for more information: Kiosk Setup - Hardware Setup.

POS Kiosk

Load Funds

Click the Check/Load Funds button on the MainScreen.
Swipe the card you are trying to load money onto or click No Swipe? and manually enter the card number.
The kiosk shows your balance on this card and you can select Load funds to load money on this card.
Choose your load type and enter the valid amount.

Note:

We can’t tell if there is money in the bill dispenser before the transaction begins to attempt dispensing money.
We can only return the last bill inserted into the validator to the customer. Only the last bill inserted is held in escrow so if the customer inserts 5 one dollar bills we could only return the last one.
We all want to keep it simple so the customer can understand the behavior.

Scenarios:

If there is not enough money in the bill dispenser to pay back all or any of the change, the customer is due and their card is credited with the amount that we were unable to pay back in addition to the amount they wanted on the card. Prompt the customer on the screen: "We apologize for the inconvenience. This kiosk is out of change we have applied $X to your card in lieu of change."

If there is a malfunction and the money is inserted into the bill validator, yet not applied to the customer’s account, dispense the appropriate amount from the dispenser. Prompt the customer on the screen: "We apologize for the inconvenience. Due to technical difficulties we are unable to apply money to your card. To report this issue please call 315-200-1790."

If there is a malfunction and the money is inserted into the bill validator yet not applied to the customer’s account and there is not enough money (if any) to dispense in the dispenser or the dispenser is malfunctioning, print a receipt for the customer, showing they are owed $X stating: "We apologize for the inconvenience. Due to system malfunctions, we were unable to apply funds to your card or return your money."

Pay by cash (Disabled for AFV)

Click anywhere on the Main Screen to go to the Basic Order Screen.
Select Pay Now after you make a purchase, navigate to the payment screen.
Insert Cash in payment screen. It will process and dispense if you insert more cash than the subtotal.

Secret Code for Dispense Money

https://docs.google.com/a/volantesystems.com/spreadsheet/ccc?key=0AsP9gL4fe_tmdFJPN2s5WlNUWkZkYUVnd3pmSXlYbXc#gid=0

Check status code. 13695
KioskSettings.numCCSlipToPrint=0

BYOB Setup

Loading Kiosk Images

imageImport.txt file into dbSQL

Open dbSQL
Select Data > Imports
Find file name "imageImport.txt" and select Open
Import into the pictures table
Follow defaults of import wizard
To verify pictures are imported run "select * from pictures"
Exit dbisql

Edit these files to set store ID, to match the store you are importing to, ensure the store ID is correct.

KioskQuickMenuImage.txt
KioskPicImage1.txt
KioskPicImage2.txt

Use imageloaderutility.class
Edit volantebackoffice.bat chezTesoro.interfaces.kiosksTools.ImageLoaderUtility Param1 = path of file Param2 is the delimiter used in the file param3 = (1 - image in menuitemdetails, 2 - image2 in menuItemDetails, 3 - QuickMenuSets)

chezTesoro.mainPackage.BOMain  - Replace with chezTesoro.interfaces.kiosksTools.ImageLoaderUtility file 1 then run again for file 2 and then file 3 (you must edit the batch file and run 3 times)

Note in Developer Environment, the above step is done via:

Creating a new Java App
Editing the arguments with something similar to the following:

Example (running 3x pointing to the source location of the files with the parameter)

c:\dev\src\kiosk\kioskpicImage1.txt , 1
c:\dev\src\kiosk\kioskpicImage2.txt , 2
c:\dev\src\kiosk\kioskquickMenuImage.txt , 3

Customizing Kiosk Look & Feel

To replace any of these images in the kiosk, simply place the file with the same name as the file you are replacing into the folder: C:\volantev4\chezTesoroGraphics\customFiles\customImages\kiosk\.

Do not replace the file of the original image. You will need to restart the POS for it to take effect.

The originals are found at c:\volanteV4\chezTesoro\posMain\posGUI\kiosk\images
Navigate to the Customizing Kiosk Images page for a list of images that can be customized in the kiosk.
Reference the Customizing Kiosk Appearance page for further customization including text, colours and layouts.

Different Kiosk Plugins

There are many different kiosk plugins that provide slightly different modes. Please see youtube for difference. Below is a summary:

Plugin Name	Description	Link page
customer.afv	sfv
customer.afv2	byob
customer.cerner	afv - cerner	Kiosk Images Customization - (1533 and Higher - Volante V6)
customer.PTI	IQ - PTI	Kiosk Images Customization - (1533 and Higher - Volante V6)
customer.kioskPinpad	Compass - SUMSANG

Customize Kiosk Graphics

For information on adding graphics and pictures to the Kiosk setup -- click here Kiosk Images Customization (Up to V1533).

Configuring Options & Extras

For the most part, Options and Extras behave the same way as they currently do in the POS.

To specify whether Options and/or Extras are shown to the user, configure when Setting up a Kiosk Terminal.
The Min (1) and Abs. Max (3) values are used to determine whether the user has selected the correct number of options within the specific range before proceeding. They can be left as 0, if there is either no minimum or maximum for the link, respectively.
To enable Wings mode, enter the number of total quantity in the Wings (7) column.
To specify the increment of quantity allowed for each option, enter that value in Wings Multiple (8). (Note: If Wings cannot divide into Wings Multiple or if Wings Multiple is less than 1, then Wings Multiple defaults to 1)

Example of option select:

Example of option select in Wings mode:

Table Service Use

Opening a table

The kiosk cannot start ordering if the specified table for the Kiosk has not been opened and/or if a PIN has not been assigned to the table. To open a table:

In the tables screen, locate the table used by the kiosk, and tap it to open
Enter head count for the table
Tap on Kiosk PIN
You will be asked if you would like to add seats
A table will appear, indicating the PIN for all the available seats
To change a PIN, tap on the PIN itself
To generate a new PIN for a seat, tap Generate Random.

Instructions for WEGZ

Admin keycode: 55555
Server keycode: 777

Opening a Table

The Kiosk cannot start if its specified table has not been opened and/or if a PIN has not been assigned to the table. To open a table:

Upon opening the POS, the Kiosk should automatically load. To close the Kiosk screen, tap the bottom of the screen
Tap on Tables
Log in as a server with keycode 777
Tap on table 100
Enter head count for the table
Tap More Options
Tap Kiosk PIN
A keypad should appear. Enter a PIN code of which the customers will need to later enter in the Kiosk in order to submit their order. The PIN can be changed later by opening the Tables screen again.
To add seats to the table, select Add Seats
Tap Exit
Restart the POS to load the Kiosk screen (may need to use Admin keycode 555)

Closing a table

Upon opening the POS, the Kiosk should automatically load. To close the Kiosk screen, tap the bottom of the screen
Tap on Tables
Log in as a server with keycode 777
Select Close Table
Tap on table 100
Restart the POS to load the Kiosk screen (may need to use Admin keycode 555)

Special Navigation Options

Links Transfer

This was done for BYOB. They had a special: 1 Burger for $2 or 3 Burgers for $5.
They wanted to stay on the Burger selection screen until all Burgers were selected (however many they want).
They later wanted a done button and this done button would ask if they wanted to turn it into a Combo
So how we can handle it is have a menu item on that screen named Done, and this menu item has a link to it asking if it's a combo. Once this Done item is selected, it will transfer its links over to the last item ordered, and go through the links for that item.

The Done Menu Item has an interface link: KIOSKLINKSTRANSFER

Navigate to Screen After Ordering a Certain Option or Item

This was also done for BYOB. After Combo Options popped up asking if they want a combo or No Thanks
If No Thanks was selected, they wanted it to go to the Side Dishes Screen.
To do this, link the No Thanks interface link with:

KIOSKJUMPTO:quickMenuId which will jump to the screen or
KIOSKJUMPTO:MAIN which will jump back to the main screen

Note: This only works if it's the last link chosen.

Pop-up Notes for Menu Item

To pop-up notes instead of ordering the item use interfaceLink on Menu Item and it will pop-up the notes section.

KIOSKINFONOTESITEM

Kiosk for the Cashier

Use Kiosk Options

Allow the Cashier Screen to use the Kiosk Options instead of the regular options

USEKIOSKOPTIONS

In terminal interface link

Kiosk Cashier

If the terminal is used as a Cashier for the Kiosk, it needs special functions such as be able to scan items and see items that are from the Kiosk Users

KIOSKCASHIER:<OptionalPrefixOrderNumber>

Configuring Number of Credit Card Slips

In chezTesoroGraphics/resources/VolanteResource.properties

You can configure the number of credit card slips to print by changing this property

KioskSettings.numCCSlipToPrint=1 (1 or 2)

Database

Assigning PIN to Transaction

The PIN for each transaction info (per seat) is saved in the TRANSACTION_NOTES table in the column NotesA in the format: KIOSK:<PIN>

TroubleShooting and FAQ

Q: Shows menu but not the pictures
A: Do freshTermDB

Q: Cannot click Start Here
A: You need to ensure you have a user created Kiosk User Code to match the one in the interface link and job role: Cashier

Q: Setting up the Kiosk interface link
A: USEKIOSKOPTIONS<>KIOSKCASHIER:P<>CASHIERFORKIOSK

Q: Why sections for Quick menu not showing on Kiosk
A: Add system parm: kioskPinpadUsePosQuickMenu

Q: Why credit needs to be swiped on Kiosk but not on pinpad
A: Enable plugin: customer.kioskWithPinpad

Browser not supported