Windows Vista or higher
.NET 4.5.2 or higher (to check what version of .NET Framework you have, https://support.microsoft.com/en-us/kb/318785)
100 MB available free space
If using Datacap/EMV, Dinerware 184.108.40.20697 or higher
If not using Datacap/EMV, Dinerware 220.127.116.1163 or higher
Before you Begin
You will be installing the ToGo Integration Module (TIM) on the DinerWare Brain.
Confirm User Account Control is completely off in Windows:
Confirm Windows IIS is Disable or Uninstalled:
Disable McAfee or Anti-Virus program. Web browsing protection can keep the host from connecting.
Identify who will OWN getting the Dinerware ToGo live.
Ensure there are no recursive menu items. Example 1: Item A has option 1 which includes A, B and/or C. Since it references the parent, it creates a loop. Example 2: Item A has option 1 with options X Y Z and one of those options has a sub-option with an option linked back to A.
Ensure no Items are using Price Levels. Instead, use Choice Sets for price levels or sizes.
Confirm the following is whitelisted:
The surcharge and convenience fee options under Order Types in OrderCloud DO NOT integrate with Dinerware.
Part 1: Install TIM
Download the TIM 2.5.1 ZIP file containing the TIM application from the following URL: https://drive.google.com/open?id=1GJ0RPto_8KLYNCy2bb2UtAI7O49fbz5t
NOTE: If you are unable to download the module, please email firstname.lastname@example.org to request access to the Google drive.
NOTE: This application can be used for multiple Dinerware ToGo installs. You simply need to change the location ID, security key, and endpoint address to be unique to each site.
Un-zip the contents on the machine that has the Dinerware Brain by right-clicking on the file and select "Extract All."
If the folder name is in green font after you un-zip the contents, right click the folder > Properties > Advanced > uncheck the “Encrypt…” option > Okay > Apply to all sub folders and files.
Open and configure the following two files:
Update the “locationID” value by replacing the zeros with the ToGo Location ID provided to you by ToGo. NOTE: If you do not have a location ID, please email email@example.com and request one.
Login to https://home.togotechnologies.com > click the Merchant > Manage Stores > click the Location > Admin tab. Select “Dinerware” under POS Integration. Leave all fields blank (you will fill these out later) and click “Save POS Integration Settings”. Refresh the page and go back to the Admin tab. Click the orange “Generate New Integration Security Key” button to generate a security key. Update the “locationSecurityKey” value by replacing “xxxxxxx” with the security key that was generated.
Open the Dinerware Brain and click "Show Pool View". Click “Copy” next to "External WCF" to copy the address. Update the “endpointAddress” value by replacing the address with the External WCF address.
Now configure log4net.config file
Update the tag value, “tim,dinerware, 0000”, by replacing the zeros with the ToGo Location ID provided to you by ToGo.
Install and start the application. Right click on install-start.bat (which is found in the folder you unzipped) and select "Run as Administrator." If you do not see, "Run as Administrator," log into your Windows account as the administrator. Then simply double click the "Install-start.bat" file.
Make sure the service is running, click the Windows button in the bottom left and search for Services. Click “Services” at the top. Find and click “TGO Integration”. In the left window, it will say “Stop” or “Restart” the services.
If you ever need to uninstall TIM: Right click on "stop-uninstall.bat" (which is found in the folder you unzipped) and select "Run as Administrator." If you do not see, "Run as Administrator," log into your Windows account as the administrator. Then simply double click the "stop-uninstall.bat" file.
The service runs using the local system account (this can be changed, if need be).
Part 2: Set Up Dinerware
Set up the following items in the Dinerware Workstation:
Create two new Sections called “Online Ordering” and “Web Delivery” by clicking Add Section
Create a new Job called “Online Ordering”
Go to: Manager > Jobs > New
UNcheck "User can clock out"
Check "Logs in and does not autologout"
Select “Online Ordering” as the Default Section
Enter “0” for Base Pay Rate
Create Revenue Center called “Online Ordering”
Go to: Manager > Advanced > Revenue Centers > New
Assign it the Online Ordering and Web Delivery Section
Assign it the Online Ordering Job
Create a new Tender Type called “ToGoTech”
Go to: Manager > Advanced > Tender Types > New
Check “Allow Tip”
Assign it the Online Ordering Job
Create a new Employee named “ToGoUser”
Go to: Manager > Employees > New
Create a Pin
Assign it the “Non-Management” Security Template
Assign it the “Online Ordering” Job by clicking Jobs and select “Online Ordering” from the left and click the right arrow so that “Online Ordering is in the right column
Create a new Item Group called “ToGoTech”
Go to: Manager > Menu > Item Group > New Create a Revenue Class called “ToGoTech”
Create a Revenue Class called “ToGoTech”
Go to: Menu > Revenue Classes > New
Ensure multiple tax rates ARE NOT assigned
Create an Item called "COMMENT". If an item is ordered that does not sync with Dinerware, we will send it in the COMMENT item with the order.
Go to: Menu > Menu Items > New
Assign it to the ToGoTech Revenue Class
Assign it to the ToGoTech Item Group
Assign it to any Screen Category
Assign it to ALL Printers
If the merchant offers delivery, create Items for each delivery fee/zone
The price should be the delivery fee.
Assign to any Revenue Class, Item Group and Screen.
Additional steps in Part 3.
Clock in the ToGoUser user.
Part 3: Configure OrderCloud and Import Menu
This will confirm the integration is set up correctly in Dinerware.
Log in to https://home.togotechnologies.com
Select the Merchant > Manage Stores > select the Location > Admin tab
Under POS Integration, select “Dinerware” from the dropdown. A pop-up window will display fields in which you’ll need to insert the following values. If Dinerware is already selected, click “Edit” next to Other Settings.
Dinerware TenderType Name for Paid Orders = ToGoTech (or whatever you named the new Tender Type)
Dinerware Section Name for Delivery Orders = Web Delivery (or whatever you named the new delivery Section)
Dinerware Section Name for Take Out = Online Ordering (or whatever you named the new takeout Section)
Dinerware User Name = ToGoUser (or whatever you named the new Employee)
DO NOT ENTER A PLU IN THE “Comment-Only Menu Item PLU ID” FIELD. You will do this after you import the menu.
Turn on (orange) “Exclude Tip from Payment Amount”
Choose (dropdown) “Send to POS Immediately” to send orders as soon as they are placed. Otherwise, orders are sent at the pickup or delivery time minus the wait time. The wait time is configured in Order Types in OrderCloud.
Click “Save POS Integration Settings”
In the Admin tab
Under Checkout Options
Turn on (orange) “Allow Tipping” if you’d like customers to be able to add a tip
Under Accounting Contact Email
Add an email address to send automated reports. Separate multiple email addresses with a comma, no spaces between email addresses, only a comma
If Merchant offers Delivery
Find and open the delivery fee item(s) you created in Dinerware. Take note of the PLU(s).
Select the Merchant > Manage Stores > select the Location
Under Order Types, click “Add”
Enter the fields requested
Turn on “Apply Delivery Fee Pre-Tax” if the delivery fee items created in Dinerware are taxed
Ignore “Send to Printer Immediately” as this only applies if they are using a ToGo printer purchased from ToGo
Select the Merchant > Manage Stores > select the Location > Delivery Zones tab
Select the Order Type, “Delivery”
Click the polygon icon on the map. Then click the map to mark the first corner of your delivery zone shape. Click again to mark the second corner of your delivery zone shape and so on. Click “Save Changes”.
Click “Edit Zone” in the Zone 1 you just created. Enter the Flat Fee as the delivery fee. Enter the PLU of the delivery fee item as the “Integration ID”. Enter additional delivery time (if applicable), which is added to the delivery time already entered in the Order Type. Click “Save Changes”.
Select the Merchant > Manage Stores > select the Location > Location Home tab
Under Order Types, click each Order Type and adjust settings like Enable Curbside, Allow In-Store Payments, etc.
Under Menus, click “Add”
Name the new Menu “Main Menu” and click “Add Menu”
Click the Menu you just created. On the left side, click "Import from Dinerware." A few notes about Menus:
After you import the menu, find and open the item called "COMMENT". Copy the PLU and paste it into the “Comment PLU” field back under the POS Integration settings in the Admin tab
Once you have completed all these steps, please email Support@ToGoTechnologies.com to let us know the ToGo integration module is installed on the merchant’s machine so we can move forward with our installation process and complete the menu.