Grubhub Order Aggregation Onboarding & Configuration
In this article, we’ll detail the process for Onboarding and Configuring a brand or location for Grubhub Order Aggregation.
For general Order Aggregation Onboarding, please refer to: Order Aggregation Onboarding & Transition Walkthrough
Note: Lunchbox can only send 1 menu to 3rd Party Marketplaces for Order Aggregation.
Table of Contents
Limitations
We do not have the ability to void or cancel orders that are voided or canceled on the Third Party Marketplace.
We do not currently support self-delivered Marketplace Ordering
We do not currently automatically overwrite the Takeout Pricing (A dev escalation would be required to achieve this for DoorDash. Ubereats would need to be manually adjusted.)
If you have menus overridden to close on certain days on the online menu we cannot override these settings you would need to uncheck and remove any daily closure overrides.
We do not have the ability to remove other integration's menus from the ordering platform. You would need to get in touch with Marketplace Support to remove old menus. This can be done on the day of launch.
We do not have the ability to remove the previous aggregator's connection to the marketplace. It is important to remember to reach out to both the previous aggregator and the marketplace to remove the previous integration. Failure to do this could lead to order failures.
We do not have the ability to send more than one menu to each 3PD Marketplace by location by marketplace.
Onboarding
To get started with onboarding your Grubhub Marketplace for Order Aggregation, refer to the following steps.
If you have a Grubhub Account Manager, introduce them to your Lunchbox POC (Point of Contact) so they can assist with providing any specific Grubhub information.
If you are comfortable with sharing, provide your Lunchbox POC with access to your Grubhub Merchant Portal by creating a login for them. This will help will testing and troubleshooting.
Provide the following information to your Lunchbox POC for each of your locations:
Location Name
POS External Location ID
Location Address
Location Hours
Location Lead & Prep Times
Grubhub URL
Grubhub POS External Service Type ID
Alternatively, you can use 1 “3PD” External Service Type ID for all Order Aggregation Marketplaces.
Grubhub POS External Payment ID
Alternatively, you can use 1 “3PD” External Payment Type ID for all Order Aggregation Marketplaces.
Determine if you would like to use a Grubhub (or 3PD Marketplace) specific menu or if you are going to use a menu that will require an Uplift % for the entire menu being sent to Grubhub.
Provide the POS External Menu ID or Name to your Lunchbox POC.
Provide your Lunchbox POC with each store’s Grubhub CIDs. These CIDs can be retrieved from the URL of the each store's specific location:
Once your Lunchbox POC has your Grubhub Store CIDs and the dates for launch, they will coordinate with Grubhub and provide them with the following information on the Lunchbox/Grubhub Shared Onboarding Sheet:
Store/ Merchant ID
Account Manager
Brand / Restaurant Name
Street Address
City
State
Launch Date
Once this information is provided to Grubhub, meet your Lunchbox POC and confirm the launch date and time for the Grubhub Order Aggregation transition.
Note: Locations must be added by Friday of the following week for Monday launch
Your Lunchbox POC will then have Grubhub added as an integration to your Lunchbox Dashboard.
Once the integration is complete, Lunchbox will schedule time to test orders and make sure they are flowing properly from Grubhub to Lunchbox to your POS and follow up with any additional information or requirements.
When you are live, please utilize [email protected] and Grubhub support for any assistance.
Note: Grubhub refers to Lunchbox internally as Lunchbox v2
Lunchbox Configurations
The Lunchbox Onboarding and Configurations Team will perform the following in your Admin Dashboard to prepare, test and launch Grubhub for Order Aggregation (the following instructions are for the older version of the Lunchbox 2.0 Dashboard:
Gather Location & Menu information provided by the RP (Restaurant Partner) as mentioned above.
Request Grubhub to be added to the Integrations page of the RP’s Admin Dashboard by submitting an Engineering Change Request ticket.
Populate Location information from the POS on the Locations page (if it is not auto-populating from the POS)
Navigate to Menus > Admin Links > Service Types and create a Grubhub Service Type
Add the Global External Service Type ID (if applicable) that will used when sending orders to the POS. If there is a Local External Service Type ID, populate that in Service Types.
Mark as Visible and Internal Use so it is not displayed to customers on the 1st party order site.
Select Pick-up as the Service Group ID.
Alternatively, you can use 1 “3PD” Service Type for all Order Aggregation Marketplaces
Navigate to Menus > Admin Links > Edit Provider and select Grubhub
Enter the Global Service Type ID and select the Take Out Service Type.
Navigate to Menus > Admin Links > Payment Types and create a Grubhub Payment Type.
Add the Global External Payment Type ID (if applicable) that will used when closing orders out in the POS (as an “Other Payment option”). If there is a Local External Service Type ID, populate that in Payments.
Alternatively, you can use 1 “3PD” Payment Type for all Order Aggregation Marketplaces
Navigate Menus > Admin Links > Edit Order Provider and select Grubhub
Enter the Global Menu ID that will be used for All locations. If there is a Local Menu ID, populate that in Integrations > Order Providers > Grubhub for each location.
Navigate to Integrations > Order Providers > Grubhub and populate the following:
Grubhub V2 ID = Grubhub CID
Service Type Ext ID = Only populate Grubhub (or 3PD) Local External ID if the RP is not using a Global External ID for all locations
Menu ID = Only populate the Local Menu ID if the RP is not using a Global Menu ID for all locations
(Optional) Open Offset Minutes = Negative time that you would like to allow orders to start being placed from Grubhub (for example if your business hours open at 11 AM and you want to start taking Grubhub orders at 11:15, set this to -15.
(Optional) Close Offset Minutes = Negative time that you would like to stop orders from being placed from Grubhub (for example if your business hours close at 10 PM and you want to stop taking Grubhub orders at 9:45, set this to -15.
Item Upcharge % = Local Menu Upcharge percentage that you would like to add to your menu items if not using a Global Menu Upcharge.
Enable Menu Integration = Set the date for when the menu should be sent to Grubhub
Enable Order Integration = Set the date for when the integration with Grubhub should begin.
Navigate to Menus and click on the Menu you are using to send to Grubhub. Ensure that the new Grubhub (or 3PD) Service Type is checked off
Navigate back to Menus, select Edit Menu for a Location, and add the Menu that you are using to send to Grubhub.
Navigate to Business Hours, select the Location, select the Menu being sent to Grubhub, and update the Custom Hours.
If you have the same hours for all locations, leave the location unselected and set up Default Hours to be used across your brand. Custom (local) will always override Default (global) hours.
Navigate to Payments, select a location and add the Grubhub (or 3PD) Payment Type. Enter the Local External Payment ID if it is specific to the location (this will override the Global External Payment ID)
You will need to add the Grubhub (or 3PD) Payment Type individually for all locations.
Navigate to Service Types, select a location, Approve the Grubhub (or 3PD) Service Type and Save.
Once Approved, configure the following and Save:
Status = Enabled
Payment Processing = Grubhub (or 3PD)
Order Fulfillment = Enter Lead Minutes, Prep Minutes and Minimum Order Amount
Order Handling = Auto Send to the POS & (optional Hold Same Day & Future Orders if you want send scheduled orders to the POS based on Prep time).
Tax Rules = Will populate with the Menu
External ID = Enter Local External Payment ID if it is specific to the location (this will override the Global External Service Type ID)
You will configure the Grubhub (or 3PD) Service Type individually for all locations.
(Optional) Configure Order Throttling Rules for Grubhub by navigating to Order Processing > Order Throttling Rules, selecting the Grubhub (or 3PD) Service Type and configuring the rules.
Once the above has been completed and Grubhub has alerted Lunchbox and the client that they are ready for Lunchbox to send the menus, navigate to Menus > Edit Menu for a Location. Select the location and click Publish Menu. This will send the menu and integration information to Grubhub.
Do this individually for all locations.
Navigate to Event Logging, select the location and make sure there are no errors when sending the integration to Grubhub. This is what a successful integration looks like:
Navigate to the Grubhub Location URL and ensure that all of the settings that you’ve configured along with the menu structure are correct.
Do this for all locations.
Communicate with the RP and place a test order to ensure that the order is flowing into Lunchbox and being sent to the POS without error. Provide the Restaurant Partner with the Testing Checklist: https://drive.google.com/file/d/1lwbR0OBEFqriBxOY7p1HosbO3OEopPOH/view?usp=sharing