Disclaimer: This article is for Lunchbox 2 Enterprise customers only. If your dashboard header looks the same as below, you are in the right place:
Native Ordering - Menu Configuration - Revel:
Lunchbox Menus are pulled into the Admin Dashboard the same way whether it is the initial sync or a subsequent sync.
Menu Structure and Menu Barcode Requirements
For ideal performance Lunchbox recommends the use of a single Custom Menu in a lab location set to Online that contains all categories, items and modifiers. This lab location will be used as the Lunchbox Master Restaurant.
Important: The use of Multi-Channel Mode/Stations are NOT supported.
All other locations must be set with the same menu structure. Revel does not have the ability to align Item IDs across all locations so instead Lunchbox employs the use of Barcodes. Lunchbox leverages the barcode field to allow us to import a single menu from the Lab or Master location and consistent menu structure and barcodes allow to apply that master menu across all locations.
VERY IMPORTANT: FAILURE TO FOLLOW THESE RULES WILL LEAD TO MENU INGESTION ISSUES.
Barcodes must be added consistently from location to location for all items/modifiers and combos before importing your menu to Lunchbox.
Make sure that the menu structure is the same at all locations and that barcodes are applied consistently across all products.
A single barcode CANNOT be used twice in a Custom menu.
For locations that run different categories and products it is very important that the structure of these additional menus and categories matches exactly to the lab location and barcodes must align perfectly with the lab and all locations running these additional selections.
Menus:
Name, Menu Subcategories & Location Availability
Subcategories:
Name, Description & Location Availability, Products within the Subcategory
Products:
Name, Price, Description, Image, Location Availability. Modifier Classes and Modifiers within the group.
Note: It is still unknown whether we pull the image from the Image or Images field.
Modifier Classes:
Name, Min, Max & Location Availability, Menu Modifier Classes and Modifiers within the group.
Modifiers:
Name, Price, Description, Image & Location Availability, Menu Modifier Classes and Modifiers within those groups. Modifier Required Min Max.
Note: Lunchbox supports pulling Products>Modifiers>Modifier Details > Name*
NOT Third Party Name
Additional Menu Import Notes
Menu Photos come through on every import. See rule 2 below for image sizing requirements.
Menu Taxes are imported.
Active checked and Active unchecked is also imported.
Modifier Sort Order - Note: the default modifier will always appear at the top, regardless of the sort order, and the remaining modifiers will follow the sort order from Revel. If two modifiers have the same sort number in Revel, they’ll be listed alphabetically.
Important Note: Modifier Sort order following the POS is NOT automatically provided with your Revel Integration. If you wish to follow the modifier sort order from Revel you will need to notify your IPM and they will have to enable update_pick_list_display_order to TRUE.
Revel Menu Terminology vs Lunchbox Menu Terminology:
Custom Menu Groups - Lunchbox doesn’t have an equivalent for this and all Categories have to be added to the same Custom Menu Group.
Menu = Menu
Subcategory = Category
Product = Item
Modifier Class = Pick List
Modifiers = Picklist Members / Items
Menu Building Rules:
The following is a list of menu-related rules that must be adhered to on the Revel Dashboard before doing the initial menu sync. There are a few Rules when configuring the menu in order to make sure it communicates properly with Lunchbox. Make sure to read through all of these carefully before proceeding to edit or build your menu.
RULE 1: Price It Right - Menu & Modifier Pricing Limitations
Supported Revel Item Pricing Structures
Price
Price Overrides
Group Combos Pricing
Uplift *Surcharges Amounts (Powered by Lunchbox)
Supported Revel Modifier Pricing Rules
Price
Free Price
Qty
Amount
Split Modifiers - Primarily used for Modifier Placement on Pizza Example (Left, Right, Whole)
Not Supported Revel Pricing Strategies
Group Combo Items Cannot have the same modifier on the parent item that is in use on a combo selection. Doing this causes the modifier group to only display on the parent item and not the child in the combo.
Example: Burger Combo that has a modifier for a cola that also uses that same modifier group in the combo.
Applying Tax Groups On Items
Select the tax groups to which this item belongs. Tax groups dictate what tax(es) are applied to the product. If no group is chosen the item will be taxed at the prevailing rate. To remove taxes with Auto All, please navigate to the tax form and remove the Category.
Split Modifier Configuration
Step 1: In Revel locate the Modifier Group you are looking to apply Split Modifiers to and click the Pencil Icon.
Step 2: Under modifier class details check Allow Split Modifiers, click Save and be sure to Publish All Changes.
Step 3: To check that this feature is behaving correctly. After Publishing in Revel navigate back to the Lunchbox Admin Dashboard and Click the Menus Tab>Edit Menu for Location> Select your location> Click Request POS Upload.
Step 4: To ensure that placement has been added to modifiers located the modifier group in the menu you are editing locate a modifier and click the blue styles link under the modifier.
Step 5: You will see Left Right and Whole.
Step 6: Also you will need to check the modifier group associated with the menu item. By locating the menu item. Click the Blue Pick list papers next of the menu item you are checking.
Step 7: Click the blue link of the modifier group you are checking.
Step 8: Scroll down to Display Style this should be set to gallery with children. If it is not then you will need to submit a ticket to your Implementation Project Manger or [email protected].
Note: If this pick list is associated with more than one menu item, this change will be made to all items that it is associated with.
Size Pricing Alternative - We recommend using product subcategories by size for products with modifiers grouped by the corresponding size with prices set per ingredient.
(Example: 1/2 Sandwich Spreads have Modifiers applied 1/2 Sandwich Items and Full Sandwich Spreads Modifiers applied to a Full Sandwich.)
Note: If you want size based menu items to be listed as a single item notify your project manager and they will create a dev escalation.
RULE 2: Image Sizing Requirements
It is important that menu images be uploaded in the proper format. If images aren’t uploaded properly, it can cause resolution problems, scaling issues, and delayed image loading times. Please follow these guidelines carefully:
Menu Item Images
Size: 1280x517px; landscape (16:9) ratio
File: JPG recommended or PNG
160kb or smaller
Menu Modifier Images
Size: 100x100px; square (1:1) ratio
File: PNG
160kb or smaller
RULE 3: Target Your Menus, Items and Modifiers Properly
Make sure all Menus that need to be available for Online Ordering are set to…
Application Type - Mode
Mode/Station - Online
Hiding Portions of Your Menu
If you're trying to hide a menu item or category from Lunchbox online ordering...
Verify that it’s marked as inactive on the Lunchbox-specific menu in Revel.
Next, check that the item doesn’t appear on any other 'Online' mode menus. If it does, and you don’t want to deactivate it on those menus because they’re still in use, you’ll need to manually hide the item or category in the Lunchbox dashboard by following these instructions. https://support.lunchbox.io/en/articles/8684293-menu-item-management-lb-2-0#MenuItemManagement-Activate/DeactivateanItem
RULE 4: Cloning Menu Products & Copying Modifiers
Cloning Menu Products - Cloning does not make a copy of the modifier classes or modifiers within with product. It will apply the same exact modifier classes and modifiers.
WARNING: Cloned products within the same location must have different barcodes. Example Happy Hour Wine Item vs Non Happy Hour Wine Item
Copying Menu Modifiers to Other Products - This will copy modifier settings to other products. This is the quickest way to apply the same modifier classes to other products.
RULE 5: Menu Targeting for Enterprise
All Categories/Menus that need to live on Lunchbox should be added to one Custom Menu Grouping On Revel.
Note: These barcodes cannot be updated in Revel once an item has been imported. When building your menu between locations it is important to make sure that like product bar codes match across restaurants. Baked Potato at Location A must have the same bar code as Baked Potato at Location B.
RULE 6: Finish Your Menu in the POS and Be Thorough
Make sure your menu is finalized in Revel before pulling the initial sync following all of the aforementioned rules and you should be all set to go and ready to sync!
For a full detail on how to build out the Menu on Revel check out the Revel article below:
RULE 7: Sync It Before You Sink It!
Before pulling a menu sync, remember to save all changes properly on all establishments on Revel and the menu will automatically sync.
Native Ordering - Menu Configurations - Revel:
Step 1: Log into the Revel Dashboard using the provided credentials.
Step 2: Go to Advanced POS Settings and search for Barcode standard. Ensure it is set to UPC-A.
Each menu, menu group, product, modifier, modifier class needs a barcode. This setting should enable it to be auto created for all items being made in the future. If it does not - add a barcode number that is unique. Also for reference - this document will show you how to add barcodes to all previously made items: Revel Documentation
Step 3: Click Products in the top navigation and ensure you are on the products page on the left navigation as well. Shown below are how to + add a category/menu, subcategory/menu groups, and products/menu items. To help understand how to organize these sections it is important to understand the Revel Terminology.
Category = Menu Name example Lunchbox Menu
Product = Menu Items
Step 4: Fill in the items outlined under “Basic product Details” below. Custom menu groups will be addressed in the next category, but you should have a custom menu set in each item.
Native Ordering - Modifiers/Options - Revel:
Step 1: On the Revel Dashboard choose Products, then Modifiers on the left navigation. Below you can see how to add a modifier and modifier class/group.
Step 2: Go back to products - products on the left navigation, click the pencil icon on any item and then find the modifiers settings as shown below. Configure as needed
Native Ordering - Custom Menu Grouping Setup - Revel:
Step 1: On the Revel Dashboard choose Products, then Custom Menus (On the left-hand side after you select Products). From here, you can add a new custom menu as shown below:
Step 2: Set the APPLICATION TYPE to Mode and MODE/STATION to “Online”, then Save in the top right corner (floppy disk):
Step 3: Edit Lunchbox Online Menu by clicking the pencil button:
Step 4: Check the box of any Category you would like associated with Lunchbox, then select Save on the top right corner: