Disclaimer: This article is for Lunchbox 2.0 customers only. If your dashboard header looks the same as below, you are in the right place:
Overview
Let’s set up in Brink the Destinations that will be available to guests through your online ordering site and apps with Lunchbox. This ensures that when an order is sent to your Brink POS, the correct Destination is labeled for the order type, such as pick-up and delivery orders.
Note: These steps must be completed for every additional destination required by product type.
Resellers and the onboarding team are responsible for setting this up.
Request Lunchbox access to Locations
Before starting the POS setup, you must request that Brink give Lunchbox access to all POS Data and receive the API tokens for your locations (this allows us to pull in your menu and settings from Brink). The request needs to come directly from the customer to the support team.
Please send an email to your Lunchbox account manager using the following format:
“I [Name of authorized user] authorize Lunchbox to access all POS data and receive the API Tokens for [Concept] for the following locations:” Then list all of your locations that Lunchbox will need access to, including any labs.
Note:
Once you have requested access from Brink, you will need to gather the required information and provide it to Lunchbox and configure settings in Brink, as outlined below, to allow Lunchbox to communicate with your POS:
Brink Setup
Menu ID
For Lunchbox to pull the menu from Brink, we must know the appropriate Menu ID(s). If you have not previously set up a Menu in Brink, you must create one and add all of your items to this Menu for Lunchbox to import. The Menu ID value is not exposed in the Brink Admin Portal, so the information must be found in the Changeset Log Details. This can be found in any Changeset Log in which Menu updates for the appropriate menu were made.
To locate your Menu ID in Brink:
Log in to the Brink Admin Portal
Click on Configuration and then open the Settings Editor
Click on Menus in the lefthand menu
Click the pencil icon to the left of the Menu that you need to find the Menu ID for
Make any change under ‘Edit Menu’ (add a menu category or remove a menu category - you can revert your changes after you retrieve the Menu ID)
Since there is no ID field for the Menu ID, once the changeset is published, you will need to find the Menu ID in the logs. The ID will be listed under <Menus> in the Changeset Details (see screenshot)
7. Copy the Menu ID and send it to Lunchbox.
Note: If you will utilize separate menus in Brink, please create unique menu categories for each menu to avoid import issues.
Tender IDs
You can create a Tender Type in Brink for each Payment Type you wish to differentiate for online ordering and reporting purposes. These could include Gift Cards, Grubhub, DoorDash, etc.
To locate your Tender IDs in Brink:
Log in to the Brink Admin Portal
Click on Configuration and then open the Settings Editor
Click on Tenders in the lefthand menu
Click the pencil icon to the left of the first Tender you will use with Lunchbox and copy the ID number listed.
Select External in the ‘Tender Type’ dropdown.
Repeat the above steps for each Tender Type that will need to be available for online ordering.
Send the copied IDs to Lunchbox labeled with the appropriate Tender Type
Destination IDs
You can create a Destination in Brink for each Service Type you plan to offer online. These could include Online Ordering Pick-up, Online Ordering Catering Pick-up, Online Ordering Delivery, Online Ordering GrubHub, etc. Assuming you are using both, you will need a Destination for Pickup and Delivery at a minimum.
Log in to the Brink Admin Portal
Click on Configuration and then open the Settings Editor
Click on Destinations in the lefthand menu
Click the pencil icon to the left of the first Destination you will use with Lunchbox and copy the ID number listed.
Repeat the above steps for each Destination that will be available for online ordering.
Send the copied IDs to the Lunchbox labeled with the appropriate Destination
Note: If the Destination will be used for DaaS or self-delivery, you will need to check the ‘Delivery’ box under the Delivery Tab to allow the POS to receive the customer’s delivery address. If this is not done, orders will be rejected with an error of ‘Delivery details required’
Comment Item ID
To receive order-level comments in the POS, you will need an item called ‘Comment’. If a comment item does not exist in the remote system, it must be created with Ask Name enabled.
To locate the ‘Comment’ Item ID:
Log in to the Brink Admin Portal
Click on Configuration and then open the Settings Editor
Click on Items in the lefthand menu
Click the pencil icon to the left of the Comment Item, ensure that Ask Name is enabled, and copy the ID number listed.
Send the copied ID to Lunchbox labeled ‘Comment Item ID.’
Note: For Curbside Check-in, a notification of customer arrival will be sent to the POS as an order comment item and printed in the kitchen. Print routing must be configured for the order comment item for the notification to print.
Open Item ID
An ‘Open Item’ with Ask Name and Ask Price must be created/enabled in Brink to allow orders to push to the POS, even when an item error occurs (Ex: item is marked as unavailable in the POS while customer is placing an order online. Open item allows order to send through to the POS successfully). To create an ‘Open Item’:
To locate the ‘Open Item’ ID:
Log in to the Brink Admin Portal
Click on Configuration and then open the Settings Editor
Click on Items in the lefthand menu
Click the pencil icon to the left of the Open Item, ensure that Ask Name and Ask Price is enabled, and copy the ID number listed
Send the copied ID to Lunchbox labeled ‘Open Item ID’
Section ID
Lunchbox will need a Section ID configured so we can send online orders to the Brink system.
To locate the Section ID:
Log in to the Brink Admin Portal
Click on Configuration and then open the Settings Editor
Click on Sections in the lefthand menu
Click the pencil icon to the left of the appropriate Section and copy the ID number listed
Send the copied ID to Lunchbox labeled Section ID
Configure Brink to accept Online Orders from Lunchbox
Associate the Online Ordering Menu:
In the Brink Admin Portal, click on Configuration and then open the Settings Editor
Click on Options in the lefthand menu
Select the Online Ordering Tab, then the General sub-tab
Select the menu that will be used for online ordering in the Menu drop-down
Publish Changes
Before Lunchbox can pull the changes, you will need to publish the updates that you just made in Brink:
After making any changes in the Settings Editor, select Save
2. Select Ok on the Save Changeset pop-up window
3. Select Publish from the top menu
4. Make any necessary notes and click OK
Optional Features
Enable Tips
If you allow tips on online orders, they will need to be enabled in Brink. To enable, follow the below steps:
In the Brink Admin Portal, click on Configuration and then open the Settings Editor
Click on Options in the lefthand menu
Select the Online Ordering Tab, then the General sub-tab
Enable the checkbox next to Allow Tips
Enter suggested tips, if applicable
6. You will also need to enable tips under the appropriate Tender Type by selecting Tenders in the lefthand menu
7. Click the pencil to the right of the tender type that will be used for online ordering
8. Enable the checkbox next to Allow Tips and any other options that you need
Delivery Configuration (for Self-delivery or DaaS)
You will need to configure a few extra settings to allow Brink to accept Delivery orders from Lunchbox, whether orders for the store to deliver or DaaS orders. Please complete the following steps:
Enable Delivery in Destination
For your Brink POS to accept a delivery address from Lunchbox, Delivery has to be enabled in the Delivery Destination or the order will be rejected.
Create a destination for ‘Delivery’ or create a destination for each Delivery Service Type and/or DSP (ex: Online Delivery, Uber DaaS Delivery, Postmates DaaS Delivery, etc), as explained in Destination IDs
Ensure that ‘Delivery’ is enabled under the Delivery Tab of any Destination that will require a delivery address
Leave the Delivery Time field set at ‘0’
Provide the Delivery Destination ID to Lunchbox
Setup Delivery Surcharge
In order for Lunchbox to pass a Delivery Fee to your POS, you must create a Delivery Surcharge in Brink. Otherwise, the order will be returned to Lunchbox with the delivery fee removed.
In the Brink Admin Portal, click on Configuration and then open the Settings Editor
Click on Surcharges in the lefthand menu
Click ‘Add New Surcharge’
Setup a new Surcharge with the following, as shown in screenshot:
Name: Delivery Surcharge
Automatically Apply: leave unchecked
Surcharge Style: Service Charge
Method: Fixed Per Order
Prompt: checked
5. There is no ID field for the surcharge, so once the changeset is published, you will need to find the ID in the logs. The ID will be listed under <Surcharges> in the logs (see screenshot)
6. Copy the new Surcharge ID and send it to Lunchbox
Coupon Setup
For Lunchbox to successfully send discounts/coupons to Brink, you must add a Discount in Brink for each discount type you plan to offer.
To setup the Discount in Brink:
In the Brink Admin Portal, click on Configuration and then open the Settings Editor
Click on Discounts in the lefthand menu
Click Add New Discount
Enter the following information specific to your discount:
Name
Enable the Active checkbox
Select Comp from the Type drop-down
Select Order from the Granularity drop-down
Enable the Must Enter Name checkbox
Enable the Must Enter Amount checkbox
Copy the ID number listed
Send the copied ID to Lunchbox labeled Coupon ID
Click OK
Troubleshooting
Error Messages
POS Error: This event is logged on the Event Logging tab in management when Lunchbox encounters an error when communicating with the POS. These errors will begin with an Error sending the order to POS, followed by a specific error from Brink.
Order Errors
Error sending order to POS: Error Code 1 - Unknown error - This error could be one of many things. Below is a list of things to check:
Confirm that the Comment Item ID is set and configured properly
Error sending order to POS: ‘pickup_destination_id’ - Please confirm the following:
The correct Destination ID was provided to Lunchbox
The destination is set as Active for the location in Brink
Error sending order to POS: Error Code 103 - Ordering not allowed - Please confirm the following:
Brink is configured to accept Online Orders from Lunchbox
Error sending order to POS: Error Code 104 - Invalid payment type - Please confirm the following:
The Tender Type is set to External in the Brink Portal. Settings editor -> Tenders -> Edit Tender -> Change Tender Type to External
Error sending order to POS: Error Code 104 - Invalid tip amount specified for payment - Please confirm the following:
Tips have been enabled in Brink
Error sending order to POS: Error Code 104—Delivery details required—Please confirm the following: Delivery is selected for the current destination in Brink, and the coresponding Service Type in Lunchbox is not sending a delivery address. Please contact your Lunchbox Rep to troubleshoot the issue further.
Error Code 104 - Delivery details provided for non-delivery destination - Delivery is not selected for the current destination in Brink, and the corresponding Service Type in Lunchbox sends a delivery address for the order.
Please enable delivery for the destination in Brink.
Unable to check in: The master terminal is offline (0). This means that Lunchbox is unable to connect to the master terminal, typically due to Register 1 (or your Primary Register) losing power or connection to the network.
Please check connection
Menu Issues
Error sending order to POS: Error Code 104—ItemId 2xxxx5 is invalid—When sent to the POS, an item on the order is identified as invalid.
If the item should be active, confirm that it is configured correctly for the location’s menu in Brink.
If the item is inactive, deploy the changes for this location from Brink. This will automatically trigger a menu import for the location.