Overview

InterfaceLinks allow for additional options that beyond the standard settings, accommodating unique needs or providing modifications to Volanté.

InterfaceLinks:

Are sometimes referred to as "Advanced Config" settings.
Enable unique settings for specific Menu Items not normally available through default Volanté settings.

This documentation also notes the differences between:

Advanced Tab InterfaceLinks
InterfaceLink Tab

Interface links are added to Menu Items by directly editing the item from the Menu Setup module in the BackOffice.

Select Menu Setup from the BackOffice Home screen.
Select the Menu Item tab.
Expand the tree from the menu pane (left margin), and select the desired menu item.
select the Advanced Accordion (right pane) to expand advanced options.
Enter the desired Interface link into the Interface Link 2 field.
Click SAVE ALL, then click the "x" icon (top-right) to exit.
Perform a Data Synch to update terminals.

InterfaceLink Tab: (Old InterfaceLink 1)


RECIPE
Sunset Grill Kitchen Printer

NO_SUMMARY

"No Summary" is an InterfaceLink that can be added to Option Groupings. When a Menu Item with this InterfaceLink is selected, users will skip past the "Summary with Option Item details".

Selected items with this InterfaceLink will automatically be added to the cart.
This option allows for faster Menu Item selection, and can be used at specific sites that do not make use of Options Grouping selections.
There is existing logic for skipping the screen if there is only one Option Item present as well.
If ordering multiple options within the same grouping, each Option Item must still be specified.
Option Items must be specified. This design allows for skipping specific option items, while showing all other items.

This InterfaceLink is comma delimited.
- E.g. NO_SUMMARY:<option id 1>,<option id 2>

RECIPE

Pizza Nova uses a special Recipe InterfaceLink for creating pizzas. It is based on PLUs and a specified number of units (i.e. to determine toppings).

Menu Item RECIPE:

RECIPE:TYPE<USER DEFINED>:PLU,units;PLU,units;PLU,units
Example format for Menu Items:
(LARGE):(PLU,units;PLU,units;PLU,units)
PIZZAITEM:0:20:0:1.69:1.69:TRUE:SINGLE:1.69:B<>RECIPE:MEDIUM:ab22000247,1

Menu Item OPTION RECIPE:

RECIPE:TYPE<USER DEFINED>-<PLU>,<units>;<PLU>,<Units>|TYPE <USER DEFINED>-<PLU>,<units>;<PLU>,<units>
Example format for Option Items:
(LARGE-PLU,units;PLU,units;PLU,units|MEDIUM-PLU,units;PLU,units)

For more information on RECIPE InterfaceLinks, see:

Old Volante KB

Marko's Google Doc

Definitions

U refers to Units of a particular topping or item (10U of pepperoni is 10 units of pepperoni; PLU2222).
TYPE is the size modifier of the pizza. Types are defined by the user (i.e. LARGE or SMALL)
- This is used for the modifiers so the modifiers know how much to deduct depending on size.

Defining Menu Item RECIPE

Ex. 1 Large Pizza - 1 Large Dough (PLU1111), 10U of pepperoni (PLU2222), 5U of tomato sauce (PLU3333), 3U of Ham (PLU4444)
- RECIPE:TYPE<USER DEFINED>:PLU,units;PLU,units;PLU,units
  - TYPE=LARGE for a large pizza, TYPE=SMALL for a small pizza
  - This is used for the modifiers so the modifiers know how much to deduct depending on size.
- Above example RECIPE:LARGE:1111,1
  - 3 Tokens (RECIPE) : (LARGE) : (PLU,units;PLU,units;PLU,units)

Defining Menu Item Option RECIPE

RECIPE:TYPE<USER DEFINED>-<PLU>,<units>;<PLU>,<Units>|TYPE <USER DEFINED>-<PLU>,<units>;<PLU>,<units>
Example RECIPE:LARGE-111000,10;111001,11|MEDIUM-111000,20;111001,15
Example 2:
- For pepperoni, RECIPE:DEFAULT-2222,5|LARGE-2222,10|MEDIUM-2222,5|SMALL-2222,3 for pepperoni
- When ordered with a item that has TYPE=LARGE, deduct PLU 2222 10U from inventory
- When ordered with a item that has TYPE=MEDIUM, deduct PLU 2222 5U from inventory
- When ordered with a item that has TYPE=SMALL, deduct PLU 2222 3U from inventory
- When ordered with a item that has TYPE=DEFAULT (when not specified), deduct PLU 2222 5U from inventory (DEFAULT)
- 2 Tokens (RECIPE) : (LARGE-PLU,units;PLU,units;PLU,units|MEDIUM-PLU,units;PLU,units)
- 2nd Token has Repeating Tokens (LARGE-PLU,units;PLU,units;PLU,units)|(MEDIUM-PLU,units;PLU,units)
- The inside Tokens have 2 Tokens (LARGE)-(PLU,units;PLU,units;PLU,units)

SHOW# – For Sunset Grill Kitchen Printers

Used by Sunset Grill.

Pick the column to print menu items on by entering the corresponding InterfaceLink:

SHOW1
SHOW2
SHOW3
SHOW4
SHOWNONE – "Show None" = Do not show menu items on print.

KIOSKLINKSTRANSFER

Kiosk Setup (V6 Kiosk)

KIOSKINFONOTESITEM

Kiosk Setup (V6 Kiosk)

COMBOMODE

Used by American Food and Vending (AFV) Cerner Kiosks. This enables the ability to use Options in Combo functionality on the kiosks.

Setup the interfaceLink for the option category. The interfaceLink includes:
- COMBOMODE:1 -> means it performs as combos
- ROW:3 -> means each page has 3 rows
- COLUMN:1 -> means each page has 1 column

For full details, please see:

Kiosk Images Customization - (1533 and Higher - Volante V6)#V1533andHigher-SetupOptions/Combos

KIOSKJUMPTO

Changes a Quick Menu item in kiosk to a shortcut button to the given tab

Possible values: MAIN, 1, 2

PIZZAITEM

PIZZAITEM indicates that this item is a Pizza Item and will display the special Pizza Screen when this item is ordered.

Pizza Menu Items can be configured using the following formatting:

PIZZAITEM:Min:Max:QuantityPt:QuantityPt1Price:QuantityPt2Price:RoundUpToppings:PizzaQuantity:HalfToppingPrice:SIZETYPE

For more detailed information on configuring the Pizza Menu, see Pizza Menu - Setup.

PIZZATOP

See Pizza Menu - Setup

PIZZAPRESETTOP

See Pizza Menu - Setup

DAYPASS

DAYPASS is used to indicate the item is a temporary season's pass for the day.

It is formatted as:
Used by Loch Lomond Ski Resort.
- For more details, see: /wiki/spaces/IS/pages/63610561
- Additional details: /wiki/spaces/IS/pages/63361880

VALETTICKET

This feature is used for importing and tracking unique parking tickets issued to customers. It sets the "Menu Item" as a Valet Ticket, which is used for Valet Parking Ticket systems at the site.

A list of valet ticket numbers are imported into the Volanté system and stored. Whenever the customer purchases a valet ticket item, a keyboard will pop up for them, and they may scan the ticket. Volanté will then check in the database to make sure this valet ticket is valid, and that it has never been used.

FORMAT:

VALETTICKET

For more detailed information, please see: /wiki/spaces/IS/pages/63349874

QM_LABEL

Stands for "Quick Menu Label".

Turns a menu item on the Quick Menu into a label.

NOREMOVE

Menu item can't be removed

KITCHEN_MODIFIER

SCALE_CONTAINER

Requisite: Can only be used with option items.

Used in Weight Scale Setup. Used when menu items need to be placed within containers (i.e. buying bulk items in own containers) and the weight of the container needs to be accounted for.

Format:

SCALE_CONTAINER:<weight>

... where <weight> is the container's weight.

See Weight Scale Setup for full details.

AR

Available only in V4 – V6 and not V7

Format: AR:1

AR stands for Activity Reports. This outputs

The original intent was to have additional AR reports, but this was never implemented; hence AR:1 only.
Used by /wiki/spaces/IS/pages/63353192.

QUANTITY_LIMIT

For Pizza Nova. Sets a quantity limit on the item during transaction type Manual Adjust, Purchase Received, Purchase Outside, or Wastage.

Format: QUANTITY_LIMIT:<amount>

This does not actually restrict ordering past the limit, it only displays a warning.

OPTIONMODS / OPTIONMOD (Quick Menu Option Modifier)

When an option is added to the quick menu and not used from a popup link, the option mode interface link can be used in the menu item.

This feature is obsolete in New Menu UI, in V7.

Note: This InterfaceLink is case-sensitive, and should be in all-caps

There is also OPTIONMODS

For more information, see:
- Option Item Setup
- Set Up Option Items

Weighscale Item

When configuring weigh scales to work with Volanté the interface link is used for the tear weight. The tear weight is referred to as the weight that needs to be removed before calculating the pricing. Usually the means the tear weight is the plate or take-away container as they should not be used when calculating the amount of product the requires pricing.

Interface Link = SCALE:1:0.2
For more information, Weight Scale Setup

QSR Menu Item Cook Time

Allows for configuring menu item cooktime in conjunction with QSR. Can be used to overwrite default cooktime = 0 and enter new cooktime in the InterfaceLink

Interface Link: COOKTIME:X
- Where X is number of seconds
For more information, QSR Setup
QSR has a maximum cook time of 30 mins

Minimum Charge

Used when requiring minimum bill amounts be applied.

Interface Link :MINCHARGE:0,2
Where:
- The field after the MINCHARGE: is for category grouping types defined below.
- 0,1 indicates that the Minimal charge applies to items from Category grouping FOOD and DRINKS
- 0,1,3 indicates that the Minimal charge applies to items from Category grouping FOOD, DRINKS and ALCOHOLIC Drinks.
- MINCHARGE: with nothing added indicates that it applies to all.
For more information, Minimum Charge Per Bill

BOLDstreet

BOLDstreet is a public Wi-Fi provider in Canada. Integration between Volanté and BOLDstreet allows Volanté to display the BOLDstreet codes on Volanté receipts.

Interface Link: BOLDSTREET
For more information, BOLDstreet

Step Pricing for Menu Items

*This does not work this way. QTY is not used for step pricing
Step pricing is when a menu item cost different amounts for different quantities.
InterfaceLink = QTY:<min quantity>,<max quantity>

For example,

     QTY:1,5      1 - 5 Muffins cost $1 each  (1 muffin = $1, 5 muffines = $5)
     QTY:6,11     6 - 11 Muffins cost $0.8 each (6 muffins = $4.8, 11 muffines = $8.8)
     QTY:12,999   12+ Muffins cost $0.5 each (12 muffins = $6, 24 muffins  = $12)

QTY

InterfaceLink = QTY:<min quantity>,<max quantity>
Restricts the quantity of the ordered item to between min and max amount
Does not take other items in the transaction into account

Menu Option - Local Counter

Implemented in 5.3.1048

This InterfaceLink is available only for Menu OPTIONS

It will append a counter number at the end of the option, each time this option is ordered in the POS. This a local counter to the POS, and therefore is not shared or synced with all other POSes.

Format

COUNTERITEM:<COUNTER NAME>,<MIN VALUE>,<MAX VALUE>

ex. COUNTERITEM:DELIVERY,41,70

NOTE: From Build 1249+ onwards, use Colons instead of commas

COUNTERITEM:<COUNTER NAME>:<MIN VALUE>:<MAX VALUE>

ex. COUNTERITEM:DELIVERY:1:20

It will appear on the OMD, receipt and Kitchen as follows:

<OPTION NAME> #<COUNTER>

In our example, the counter will only cycle between all numbers from 41 to 70 inclusively.

This counter is also only stored in memory, when the POS restarts the counter will start at MIN VALUE again. The counter will loop between MIN VALUE and MAX VALUE.

If you wish this to print on the RECEIPT, you have to have "Print Zero Priced Options" "ON" in the General Setup, System Configuration.

Locations using this feature: Fat Bastard Burritos (for Bag Numbers)

Menu Item Kitchen Consolidate

To use this feature, the System Param - Consolidate Kitchen Items must be off

KITCHEN_PRINT_CONSOLIDATE:<ITEMS_SAME_OPTIONS> | <ALL_LIKE_ITEMS>|<NEVER>

ie KITCHEN_PRINT_CONSOLIDATE:ITEMS_SAME_OPTIONS

Will consolidate items that only have the same options

1 Burger
  - Pickles
  - Mustard
1 Burger
  - Pickles
1 Burger
  - Pickles
  - Mustard

becomes

2 Burger
  - Pickles
  - Mustard
1 Burger
  - Pickles

ie KITCHEN_PRINT_CONSOLIDATE:ALL_LIKE_ITEMS
- Will consolidate items that are the same in this format
```
3 Burger
  - 3 Pickles
  - 2 Mustard
```
ie KITCHEN_PRINT_CONSOLIDATE:NEVER
- Will not consolidate the items even it is set as consolidate in system params.
```
1 Burger
  - Pickles
  - Mustard
1 Burger
  - Pickles
1 Burger
  - Pickles
  - Mustard
```

PLACEHOLDERITEM

PLACEHOLDERITEM
- use on options only using the new option screen
- if this interfacelink tag is there, then this item will not print to kitchen or receipt.
- Used for Kiosk, Make it a Combo then after that combo choices. Make it a Combo will not want to be printed or on receipt.

Pizza Delivery Charge Check

Add DELIVERY_CHARGE to interface link
Used in conjunction with Global Sales Functions (GFS) to allow users to bypass mandatory delivery charges.
- For more details, see: /wiki/spaces/IS/pages/63610574

PRICELEVELMOD (Price Level Mod)

The Price Level Modifier applies to Menu Options Interfacelink

PriceLevelMod is primarily used to account for price differences between Stay In and Take Out options. This will allow the charging of different prices without creating an additional price modifier.

Syntax

PRICELEVELMOD:<price level name>:<allow menu item combos>:<allow price mod combos>

i.e.:

PRICELEVELMOD:takeoutPL:false:false

In this example, the price level to look for would be called 'takeout pl'. Once applied, this item will not be applicable to price mod combos (i.e. Tim combos) and Menu Item tag combo.

This is used for cases like Take Out, where all take out items have special pricing, but they do not want to create a set of take out items. They will create a "take out price level" and each time an option with this PRICELEVELMOD interacelink is added to an item, the item will use the price level price specified in the interfacelink.

Example:

Create item Burger $10
Create option TakeOut with interfacelink PRICELEVEMOD:takeoutPL:false:false
Create pricelevel takeoutPL, for simplicity sake, all items in this price level will be $2
On POS, order Burger, price will be $10
Add option TakeOut to Burger, then Burger will now use the price level takeoutPL price of $2.00

Setup:

Create price level for your purpose called takeoutPL
Set up the prices for all items applicable to this price level takeoutPL
Create an option with the interface link set to PRICELEVELMOD:takeoutPL:FALSE
Drag this option to the Menu and/or Quick Menu

On the POS:

Order an Item: Item A.
Order this option for the item.
If the Item A has a price level in takeoutPL, then the price level price will be applied.

Price Modifier in Quick Menu QM_PM

Ability to associate price modifiers using the Quick Menu Keys.

Setup:

To be able to add price modifiers to the quick menu, you have to associate the price modifier with a menu item. PRICELEVELMOD

Go to General Setup > Price Modifier > Primary Info and copy down the price modifier ID
Go to Menu Setup and create a new menu item
In the InterfaceLink Tab, set the InterfaceLink as QM_PM:<Price modifier Id>
Add the newly created menu item(s) to the menu set you are working with
From the Quick menu, left click to get to popup
Select 'add price modifier', it will display a list of menu item associated with price modifiers that belongs to this menu set
Choose the appropriate menu item (price modifier) to add to the quick menu
Note: Cannot use Item price mods

Note: In 1730 +, use Add Special Button to add Price Modifiers to the quick menu http://volantedocs.com/confluence/display/IS/Menu+Setup+-+Add+Special+Button

Change Menu Set in Quick Menu

Ability to associate menu sets using the Quick Menu Keys.

Setup:

To enable adding Menu Sets to the Quick Menu, users will need to associate the menu set with a Menu Item.

Go to Menu Setup > Create Menu > Copy down the Menu Set Name.
Go to Menu Setup and create a new menu item
In the InterfaceLink tab set interfacelink = QM_MENUSET:<Menu Set Name>
Add the newly created menu item(s) to the menu set you are working with

Version 7+

- Drag over menu item setup with the interfacelink QM_MENUSET to the quick menu

Before Version 7

- From the Quick menu, left click to get to popup
- Select 'add Menu Set', it will display a list of menu item associated with menu sets that belongs to this menu set
- Choose the appropriate menu item (Menu Set) to add to the quick menu

Note

Sizes in Quick Menu

Enables the ability to change item sizes from the Quick Menu.

Setup:

To be able to add sizes to the quick menu, you have to associate each size with an item:

Create a new menu item and set the menu item interfacelink = QM_SIZES:<size>
1. <size> = {0-Single,1-Double,2-Triple,3-Half,4-Small,5-Mediuml,6-Large,7-X-Large}
2. Add the menu item(s) to the Menu Set you are currently working on.
From the Quick Menu, left click to get to the popup
1. Select 'Add Sizes'. This will display a list of menu items associated with sizes that belongs to this menu set.
2. Choose the one you want to add to the quick menu.

Print Solo

If you want an item to print to the Kitchen by itself, after the regular print has been printed, then add this interfaceLink to the menuItem:

PRINTSOLO

The following implementations were done for Fat Bastard Burrito.

Using the following order as an example:

2 Burrito

Will print:

2 Burrito
then
1 Burrito
1 Burrito

Each entry will be printed in separate chits.

For V6, Build 1321+ – To enable printing of "1 of Total", "2 of Total" at the bottom of each chit, set the following parameter in the VolantéResource.properties file:
- KitchenPrint.showPrintSolorTotal=yes

Special case

In these cases, it will display the total of print solo items, allowing the staff or customers to know how many total items should be in this order:

For example:

Order 2 Burrito
- 2 separate chits are printed, with 1 of 2 and 2 of 2 at the bottom of the chit.
Order 3 more Burritos
- 3 separate chits are printed with 3 of 5, 4 of 5, and 5 of 5

Locations using this feature:

Fat Bastard Burritos
One Pizza True True

AUTOPAYITC

To automatically link up a menu item in Volanté to print up the ITC payment screen.

AUTOPAYITC:<accountNum>

There are 5 accounts associated with the ITC account, each will send a different account code. For example:

AUTOPAYITC:1 will send to account 1
AUTOPAYITC:5 will send to account 5

AFV Kiosk Delivery

For AFV Kiosk, if "AFVDEL" flag is on, we need to select one and only one delivery time for each transaction.

Interface Link: AFVDEL
parameters: <STARTTIME>:<ENDTIME>
Time is in format HH-MM
For more information, Kiosk Delivery Time (1446)

KITCHEN_RED

Since 1620_0060

Menu item with this interface link will be printed to kitchen printer in red color.

KITCHEN_RED

AUTOADD

Inventory Purchase Order
See: /wiki/spaces/IS/pages/63353300

InterfaceLink 2:

Refers to InterfaceLinks that are not specific to sites (i.e. not for Pizza Nova, not for AFV)

Menu Item Count Deduction

Menu Item - InterfaceLink2

<MENUITEMCOUNT:multiplier>

The count will be deducted by value of = QUANTITY * Multiplier

Example:

Each time you sell a Nugget, there are actually 5 of them. You want to reduce the count by 5.

InterfaceLink2 = <MENUITEMCOUNT:5>

Combo Option Link InterfaceLinks:

SELF_ORDER

Used with Kiosks.

AUTO_SELECT

Used with Kiosks. Will determine which menu item options are pre-selected upon ordering a menu item, i.e. these options will already be selected by default.

This InterfaceLink should be entered in the Menu Option Links (older Menu Setup UI) or Combo/Options (newer UI) screen.

Select a Menu Item, and then the respective Option to be set up.

Format 1: Pre-selected Options

AUTO_SELECT:<OPTIONITEMID1,OPTIONITEMID2>

E.g. AUTO_SELECT:500000068,500000068

... where Option Item 1 and Option Item 2 should be separated by a comma, and no space.

Function: The item is Pre-Selected when the Option Dialog is brought up.

Format 2: Pre-selected Options with Quantity

AUTO_SELECT:<OPTIONITEMID1>=<Quantity>,OPTIONITEMID2=<Quantity>

E.g. AUTO_SELECT:500000068=2

Function: The Item is Pre-Selected with a Quantity associated to the Item. Note that for this to function on the Kiosk, Wings Mode must also be activated by setting its values to 1.

Wings Mode = 1
Wings Multiplier = 1

Format example

Menu Options contains a "Veggie Toppings" group. Within these options is a Tomatoes option, and a Lettuce option, as well as other vegetable options.

We want Tomatoes and Lettuce to be pre-selected by default, upon ordering this menu item. The customer will still be able to deselect these items.

The Option Item ID for "Tomatoes" is 46005442
The Option Item ID for "Lettuce" is 46005441

The user wants Tomatoes and Lettuce to be pre-selected from this group. When a customer goes to order an item from the kiosk, Tomatoes and Lettuce will already be selected from the start.

In Menu Options > Option Links, in the rightmost column for an item with Veggie Toppings, enter in the following Interfacelink:

AUTO_SELECT:46005442,46005441

This will enable the two items to be pre-selected.

AUTOGROUPING

Automatically tags menu items that were added via API calls (addMenuItem and/or addMenuItemsIn Bulk APIs) for a specified Division, Group, or Category.

See the Menu Setup guide for more information about this InterfaceLink.

To set it up in the BackOffice:

Navigate to the grouping type for your menu item under the Division, Group, or Category
Advanced Config. Enter the InterfaceLink.

The format for the following Autogrouping InterfaceLink is:

AUTOGROUPING:<GROUPINGID1>,<GROUPINGID2>

The grouping ID can include the Menu Set ID, Discount ID, Tax ID, Printer Type ID, Tag ID, and/or Allergens ID, i.e., AUTOGROUPING:<Menu Set ID 1>,<Discount ID 1>,<Taxes ID 1>

The grouping ID will vary depending on which grouping type you include in the InterfaceLink.

Example:

AUTOGROUPING:31000026,31000046

CUSTOM_PRICE

Set up in COLinks:

CUSTOM_PRICE:menuItemId=price

To set multiple custom price links:

Custom_Price:menuitemid=price,menuitemid=price

Format

<menuItemId> – Item Id of the option item price to be customized.
<price> – New price used for overwriting a price level.

Notes

This InterfaceLink is for Option items only.
This InterfaceLink allows for overwriting a price level price an option.
This link can be referred to as an "Option Custom Price".

Related Articles

Filter by label

There are no items with the selected labels at this time.

See Also:

Troubleshooting Articles

Overview

InterfaceLinks allow for additional options that beyond the standard settings, accommodating unique needs or providing modifications to Volanté.

InterfaceLinks:

Are sometimes referred to as "Advanced Config" settings.
Enable unique settings for specific Menu Items not normally available through default Volanté settings.

This documentation also notes the differences between:

Advanced Tab InterfaceLinks
InterfaceLink Tab

InterfaceLink Tab: (Old InterfaceLink 1)


RECIPE
Sunset Grill Kitchen Printer

RECIPE

Pizza Nova uses a special Recipe InterfaceLink for creating pizzas. It is based on PLUs and a specified number of units (i.e. to determine toppings).

Menu Item RECIPE:

RECIPE:TYPE<USER DEFINED>:PLU,units;PLU,units;PLU,units
Example format for Menu Items:
(LARGE):(PLU,units;PLU,units;PLU,units)
PIZZAITEM:0:20:0:1.69:1.69:TRUE:SINGLE:1.69:B<>RECIPE:MEDIUM:ab22000247,1

Menu Item OPTION RECIPE:

RECIPE:TYPE<USER DEFINED>-<PLU>,<units>;<PLU>,<Units>|TYPE <USER DEFINED>-<PLU>,<units>;<PLU>,<units>
Example format for Option Items:
(LARGE-PLU,units;PLU,units;PLU,units|MEDIUM-PLU,units;PLU,units)

For more information on RECIPE InterfaceLinks, see:

Old Volante KB

Marko's Google Doc

Definitions

U refers to Units of a particular topping or item (10U of pepperoni is 10 units of pepperoni; PLU2222).
TYPE is the size modifier of the pizza. Types are defined by the user (i.e. LARGE or SMALL)
- This is used for the modifiers so the modifiers know how much to deduct depending on size.

Defining Menu Item RECIPE

Ex. 1 Large Pizza - 1 Large Dough (PLU1111), 10U of pepperoni (PLU2222), 5U of tomato sauce (PLU3333), 3U of Ham (PLU4444)
- RECIPE:TYPE<USER DEFINED>:PLU,units;PLU,units;PLU,units
  - TYPE=LARGE for a large pizza, TYPE=SMALL for a small pizza
  - This is used for the modifiers so the modifiers know how much to deduct depending on size.
- Above example RECIPE:LARGE:1111,1
  - 3 Tokens (RECIPE) : (LARGE) : (PLU,units;PLU,units;PLU,units)

Defining Menu Item Option RECIPE

RECIPE:TYPE<USER DEFINED>-<PLU>,<units>;<PLU>,<Units>|TYPE <USER DEFINED>-<PLU>,<units>;<PLU>,<units>
Example RECIPE:LARGE-111000,10;111001,11|MEDIUM-111000,20;111001,15
Example 2:
- For pepperoni, RECIPE:DEFAULT-2222,5|LARGE-2222,10|MEDIUM-2222,5|SMALL-2222,3 for pepperoni
- When ordered with a item that has TYPE=LARGE, deduct PLU 2222 10U from inventory
- When ordered with a item that has TYPE=MEDIUM, deduct PLU 2222 5U from inventory
- When ordered with a item that has TYPE=SMALL, deduct PLU 2222 3U from inventory
- When ordered with a item that has TYPE=DEFAULT (when not specified), deduct PLU 2222 5U from inventory (DEFAULT)
- 2 Tokens (RECIPE) : (LARGE-PLU,units;PLU,units;PLU,units|MEDIUM-PLU,units;PLU,units)
- 2nd Token has Repeating Tokens (LARGE-PLU,units;PLU,units;PLU,units)|(MEDIUM-PLU,units;PLU,units)
- The inside Tokens have 2 Tokens (LARGE)-(PLU,units;PLU,units;PLU,units)

SHOW# – For Sunset Grill Kitchen Printers

Used by Sunset Grill.

Pick the column to print menu items on by entering the corresponding InterfaceLink:

SHOW1
SHOW2
SHOW3
SHOW4
SHOWNONE – "Show None" = Do not show menu items on print.

KIOSKLINKSTRANSFER

Kiosk Setup (V6 Kiosk)

KIOSKINFONOTESITEM

Kiosk Setup (V6 Kiosk)

COMBOMODE

Used by American Food and Vending (AFV) Cerner Kiosks. This enables the ability to use Options in Combo functionality on the kiosks.

Setup the interfaceLink for the option category. The interfaceLink includes:
- COMBOMODE:1 -> means it performs as combos
- ROW:3 -> means each page has 3 rows
- COLUMN:1 -> means each page has 1 column

For full details, please see:

Kiosk Images Customization - (1533 and Higher - Volante V6)#V1533andHigher-SetupOptions/Combos

KIOSKJUMPTO

Changes a Quick Menu item in kiosk to a shortcut button to the given tab

Possible values: MAIN, 1, 2

PIZZAITEM

PIZZAITEM indicates that this item is a Pizza Item and will display the special Pizza Screen when this item is ordered.

Pizza Menu Items can be configured using the following formatting:

PIZZAITEM:Min:Max:QuantityPt:QuantityPt1Price:QuantityPt2Price:RoundUpToppings:PizzaQuantity:HalfToppingPrice:SIZETYPE

For more detailed information on configuring the Pizza Menu, see Pizza Menu - Setup.

PIZZATOP

See Pizza Menu - Setup

PIZZAPRESETTOP

See Pizza Menu - Setup

DAYPASS

DAYPASS is used to indicate the item is a temporary season's pass for the day.

It is formatted as:
Used by Loch Lomond Ski Resort.
- For more details, see: /wiki/spaces/IS/pages/63610561
- Additional details: /wiki/spaces/IS/pages/63361880

VALETTICKET

This feature is used for importing and tracking unique parking tickets issued to customers. It sets the "Menu Item" as a Valet Ticket, which is used for Valet Parking Ticket systems at the site.

A list of valet ticket numbers are imported into the Volanté system and stored. Whenever the customer purchases a valet ticket item, a keyboard will pop up for them, and they may scan the ticket. Volanté will then check in the database to make sure this valet ticket is valid, and that it has never been used.

FORMAT:

VALETTICKET

For more detailed information, please see: /wiki/spaces/IS/pages/63349874

QM_LABEL

Stands for "Quick Menu Label".

Turns a menu item on the Quick Menu into a label.

NOREMOVE

Menu item can't be removed

KITCHEN_MODIFIER

SCALE_CONTAINER

Requisite: Can only be used with option items.

Used in Weight Scale Setup. Used when menu items need to be placed within containers (i.e. buying bulk items in own containers) and the weight of the container needs to be accounted for.

Format:

SCALE_CONTAINER:<weight>

... where <weight> is the container's weight.

See Weight Scale Setup for full details.

AR

Available only in V4 – V6 and not V7

Format: AR:1

AR stands for Activity Reports. This outputs

The original intent was to have additional AR reports, but this was never implemented; hence AR:1 only.
Used by /wiki/spaces/IS/pages/63353192.

QUANTITY_LIMIT

For Pizza Nova. Sets a quantity limit on the item during transaction type Manual Adjust, Purchase Received, Purchase Outside, or Wastage.

Format: QUANTITY_LIMIT:<amount>

This does not actually restrict ordering past the limit, it only displays a warning.

OPTIONMODS / OPTIONMOD (Quick Menu Option Modifier)

When an option is added to the quick menu and not used from a popup link, the option mode interface link can be used in the menu item.

Note: Feature obsolete in new Menu UI in V7

Note: This InterfaceLink is case-sensitive, and should be in all-caps

There is also OPTIONMODS

For more information, see:
- Option Item Setup
- Set Up Option Items

Weighscale Item

When configuring weigh scales to work with Volanté the interface link is used for the tear weight. The tear weight is referred to as the weight that needs to be removed before calculating the pricing. Usually the means the tear weight is the plate or take-away container as they should not be used when calculating the amount of product the requires pricing.

Interface Link = SCALE:1:0.2
For more information, Weight Scale Setup

QSR Menu Item Cook Time

Allows for configuring menu item cooktime in conjunction with QSR. Can be used to overwrite default cooktime = 0 and enter new cooktime in the InterfaceLink

Interface Link: COOKTIME:X
- Where X is number of seconds
For more information, QSR Setup
QSR has a maximum cook time of 30 mins

Minimum Charge

Used when requiring minimum bill amounts be applied.

Interface Link :MINCHARGE:0,2
Where:
- The field after the MINCHARGE: is for category grouping types defined below.
- 0,1 indicates that the Minimal charge applies to items from Category grouping FOOD and DRINKS
- 0,1,3 indicates that the Minimal charge applies to items from Category grouping FOOD, DRINKS and ALCOHOLIC Drinks.
- MINCHARGE: with nothing added indicates that it applies to all.
For more information, Minimum Charge Per Bill

BOLDstreet

BOLDstreet is a public Wi-Fi provider in Canada. Integration between Volanté and BOLDstreet allows Volanté to display the BOLDstreet codes on Volanté receipts.

Interface Link: BOLDSTREET
For more information, BOLDstreet

Step Pricing for Menu Items

*This does not work this way. QTY is not used for step pricing
Step pricing is when a menu item cost different amounts for different quantities.
InterfaceLink = QTY:<min quantity>,<max quantity>

For example,

     QTY:1,5      1 - 5 Muffins cost $1 each  (1 muffin = $1, 5 muffines = $5)
     QTY:6,11     6 - 11 Muffins cost $0.8 each (6 muffins = $4.8, 11 muffines = $8.8)
     QTY:12,999   12+ Muffins cost $0.5 each (12 muffins = $6, 24 muffins  = $12)

QTY

InterfaceLink = QTY:<min quantity>,<max quantity>
Restricts the quantity of the ordered item to between min and max amount
Does not take other items in the transaction into account

Menu Option - Local Counter

Implemented in 5.3.1048

This InterfaceLink is available only for Menu OPTIONS

It will append a counter number at the end of the option, each time this option is ordered in the POS. This a local counter to the POS, and therefore is not shared or synced with all other POSes.

Format

COUNTERITEM:<COUNTER NAME>,<MIN VALUE>,<MAX VALUE>

ex. COUNTERITEM:DELIVERY,41,70

NOTE: From Build 1249+ onwards, use Colons instead of commas

COUNTERITEM:<COUNTER NAME>:<MIN VALUE>:<MAX VALUE>

ex. COUNTERITEM:DELIVERY:1:20

It will appear on the OMD, receipt and Kitchen as follows:

<OPTION NAME> #<COUNTER>

In our example, the counter will only cycle between all numbers from 41 to 70 inclusively.

This counter is also only stored in memory, when the POS restarts the counter will start at MIN VALUE again. The counter will loop between MIN VALUE and MAX VALUE.

If you wish this to print on the RECEIPT, you have to have "Print Zero Priced Options" "ON" in the General Setup, System Configuration.

Locations using this feature: Fat Bastard Burritos (for Bag Numbers)

Menu Item Kitchen Consolidate

To use this feature, the System Param - Consolidate Kitchen Items must be off

KITCHEN_PRINT_CONSOLIDATE:<ITEMS_SAME_OPTIONS> | <ALL_LIKE_ITEMS>|<NEVER>

ie KITCHEN_PRINT_CONSOLIDATE:ITEMS_SAME_OPTIONS

Will consolidate items that only have the same options

1 Burger
  - Pickles
  - Mustard
1 Burger
  - Pickles
1 Burger
  - Pickles
  - Mustard

becomes

2 Burger
  - Pickles
  - Mustard
1 Burger
  - Pickles

ie KITCHEN_PRINT_CONSOLIDATE:ALL_LIKE_ITEMS
- Will consolidate items that are the same in this format
```
3 Burger
  - 3 Pickles
  - 2 Mustard
```
ie KITCHEN_PRINT_CONSOLIDATE:NEVER
- Will not consolidate the items even it is set as consolidate in system params.
```
1 Burger
  - Pickles
  - Mustard
1 Burger
  - Pickles
1 Burger
  - Pickles
  - Mustard
```

PLACEHOLDERITEM

PLACEHOLDERITEM
- use on options only using the new option screen
- if this interfacelink tag is there, then this item will not print to kitchen or receipt.
- Used for Kiosk, Make it a Combo then after that combo choices. Make it a Combo will not want to be printed or on receipt.

Pizza Delivery Charge Check

Add DELIVERY_CHARGE to interface link
Used in conjunction with GFS allow user to bypass mandatory delivery charge

PRICELEVELMOD (Price Level Mod)

The Price Level Modifier applies to Menu Options Interfacelink

PriceLevelMod is primarily used to account for price differences between Stay In and Take Out options. This will allow the charging of different prices without creating an additional price modifier.

Syntax

PRICELEVELMOD:<price level name>:<allow menu item combos>:<allow price mod combos>

i.e.:

PRICELEVELMOD:takeoutPL:false:false

In this example, the price level to look for would be called 'takeout pl'. Once applied, this item will not be applicable to price mod combos (i.e. Tim combos) and Menu Item tag combo.

This is used for cases like Take Out, where all take out items have special pricing, but they do not want to create a set of take out items. They will create a "take out price level" and each time an option with this PRICELEVELMOD interacelink is added to an item, the item will use the price level price specified in the interfacelink.

Example:

Create item Burger $10
Create option TakeOut with interfacelink PRICELEVEMOD:takeoutPL:false:false
Create pricelevel takeoutPL, for simplicity sake, all items in this price level will be $2
On POS, order Burger, price will be $10
Add option TakeOut to Burger, then Burger will now use the price level takeoutPL price of $2.00

Setup:

Create price level for your purpose called takeoutPL
Set up the prices for all items applicable to this price level takeoutPL
Create an option with the interface link set to PRICELEVELMOD:takeoutPL:FALSE
Drag this option to the Menu and/or Quick Menu

On the POS:

Order an Item: Item A.
Order this option for the item.
If the Item A has a price level in takeoutPL, then the price level price will be applied.

Price Modifier in Quick Menu QM_PM

Ability to associate price modifiers using the Quick Menu Keys.

Setup:

To be able to add price modifiers to the quick menu, you have to associate the price modifier with a menu item. PRICELEVELMOD

Go to General Setup > Price Modifier > Primary Info and copy down the price modifier ID
Go to Menu Setup and create a new menu item
In the InterfaceLink Tab, set the InterfaceLink as QM_PM:<Price modifier Id>
Add the newly created menu item(s) to the menu set you are working with
From the Quick menu, left click to get to popup
Select 'add price modifier', it will display a list of menu item associated with price modifiers that belongs to this menu set
Choose the appropriate menu item (price modifier) to add to the quick menu
Note: Cannot use Item price mods

Note: In 1730 +, use Add Special Button to add Price Modifiers to the quick menu http://volantedocs.com/confluence/display/IS/Menu+Setup+-+Add+Special+Button

Change Menu Set in Quick Menu

Ability to associate menu sets using the Quick Menu Keys.

Setup:

To enable adding Menu Sets to the Quick Menu, users will need to associate the menu set with a Menu Item.

Go to Menu Setup > Create Menu > Copy down the Menu Set Name.
Go to Menu Setup and create a new menu item
In the InterfaceLink tab set interfacelink = QM_MENUSET:<Menu Set Name>
Add the newly created menu item(s) to the menu set you are working with

Version 7+

- Drag over menu item setup with the interfacelink QM_MENUSET to the quick menu

Before Version 7

- From the Quick menu, left click to get to popup
- Select 'add Menu Set', it will display a list of menu item associated with menu sets that belongs to this menu set
- Choose the appropriate menu item (Menu Set) to add to the quick menu

Note

Sizes in Quick Menu

Enables the ability to change item sizes from the Quick Menu.

Setup:

To be able to add sizes to the quick menu, you have to associate each size with an item:

Create a new menu item and set the menu item interfacelink = QM_SIZES:<size>
1. <size> = {0-Single,1-Double,2-Triple,3-Half,4-Small,5-Mediuml,6-Large,7-X-Large}
2. Add the menu item(s) to the Menu Set you are currently working on.
From the Quick Menu, left click to get to the popup
1. Select 'Add Sizes'. This will display a list of menu items associated with sizes that belongs to this menu set.
2. Choose the one you want to add to the quick menu.

Print Solo

If you want an item to print to the Kitchen by itself, after the regular print has been printed, then add this interfaceLink to the menuItem:

PRINTSOLO

The following implementations were done for Fat Bastard Burrito.

Using the following order as an example:

2 Burrito

Will print:

2 Burrito
then
1 Burrito
1 Burrito

Each entry will be printed in separate chits.

For V6, Build 1321+ – To enable printing of "1 of Total", "2 of Total" at the bottom of each chit, set the following parameter in the VolantéResource.properties file:
- KitchenPrint.showPrintSolorTotal=yes

Special case

In these cases, it will display the total of print solo items, allowing the staff or customers to know how many total items should be in this order:

For example:

Order 2 Burrito
- 2 separate chits are printed, with 1 of 2 and 2 of 2 at the bottom of the chit.
Order 3 more Burritos
- 3 separate chits are printed with 3 of 5, 4 of 5, and 5 of 5

Locations using this feature:

Fat Bastard Burritos
One Pizza True True

AUTOPAYITC

To automatically link up a menu item in Volanté to print up the ITC payment screen.

AUTOPAYITC:<accountNum>

There are 5 accounts associated with the ITC account, each will send a different account code. For example:

AUTOPAYITC:1 will send to account 1
AUTOPAYITC:5 will send to account 5

AFV Kiosk Delivery

For AFV Kiosk, if "AFVDEL" flag is on, we need to select one and only one delivery time for each transaction.

Interface Link: AFVDEL
parameters: <STARTTIME>:<ENDTIME>
Time is in format HH-MM
For more information, Kiosk Delivery Time (1446)

KITCHEN_RED

Since 1620_0060

Menu item with this interface link will be printed to kitchen printer in red color.

KITCHEN_RED

AUTOADD

Inventory Purchase Order
See: /wiki/spaces/IS/pages/63353300

InterfaceLink 2:

Refers to InterfaceLinks that are not specific to sites (i.e. not for Pizza Nova, not for AFV)

Menu Item Count Deduction

Menu Item - InterfaceLink2

<MENUITEMCOUNT:multiplier>

The count will be deducted by value of = QUANTITY * Multiplier

Example:

Each time you sell a Nugget, there are actually 5 of them. You want to reduce the count by 5.

InterfaceLink2 = <MENUITEMCOUNT:5>

Combo Option Link InterfaceLinks:

SELF_ORDER

Used with Kiosks.

AUTO_SELECT

Used with Kiosks. Will determine which menu item options are pre-selected upon ordering a menu item, i.e. these options will already be selected by default.

This InterfaceLink should be entered in the Menu Option Links (older Menu Setup UI) or Combo/Options (newer UI) screen.

Select a Menu Item, and then the respective Option to be set up.

Format 1: Pre-selected Options

AUTO_SELECT:<OPTIONITEMID1,OPTIONITEMID2>

E.g. AUTO_SELECT:500000068,500000068

... where Option Item 1 and Option Item 2 should be separated by a comma, and no space.

Function: The item is Pre-Selected when the Option Dialog is brought up.

Format 2: Pre-selected Options with Quantity

AUTO_SELECT:<OPTIONITEMID1>=<Quantity>,OPTIONITEMID2=<Quantity>

E.g. AUTO_SELECT:500000068=2

Function: The Item is Pre-Selected with a Quantity associated to the Item. Note that for this to function on the Kiosk, Wings Mode must also be activated by setting its values to 1.

Wings Mode = 1
Wings Multiplier = 1

Format example

Menu Options contains a "Veggie Toppings" group. Within these options is a Tomatoes option, and a Lettuce option, as well as other vegetable options.

We want Tomatoes and Lettuce to be pre-selected by default, upon ordering this menu item. The customer will still be able to deselect these items.

The Option Item ID for "Tomatoes" is 46005442
The Option Item ID for "Lettuce" is 46005441

The user wants Tomatoes and Lettuce to be pre-selected from this group. When a customer goes to order an item from the kiosk, Tomatoes and Lettuce will already be selected from the start.

In Menu Options > Option Links, in the rightmost column for an item with Veggie Toppings, enter in the following Interfacelink:

AUTO_SELECT:46005442,46005441

This will enable the two items to be pre-selected.

CUSTOM_PRICE

Set up in COLinks:

CUSTOM_PRICE:menuItemId=price

To set multiple custom price links:

Custom_Price:menuitemid=price,menuitemid=price

Format

<menuItemId> – Item Id of the option item price to be customized.
<price> – New price used for overwriting a price level.

Notes

This InterfaceLink is for Option items only.
This InterfaceLink allows for overwriting a price level price an option.
This link can be referred to as an "Option Custom Price".

Related Articles

Filter by label

There are no items with the selected labels at this time.

See Also:

Troubleshooting Articles

Browser not supported