Toast Connector
Intro
Toast is a point-of-sale software system for restaurants that provides order tracking and a reporting and analytics solution. Use the Domo Toast connector to retrieve data about orders, menu items, and payments. To learn more about the Toast API, visit their page (https://pos.toasttab.com/integrations).
You connect to your Toast account in the Data Center. This topic discusses the fields and menus that are specific to the Toast connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your Toast account and create a DataSet, you must have the following:
-
Your Toast client ID
-
Your Toast client secret
-
The Toast restaurant ID for one of the restaurants in your restaurant management group
For information about obtaining these credentials, reach out to your Toast representative.
Connecting to Your Toast Account
This section enumerates the options in the Credentials and Details panes in the Toast Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your Toast account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Client ID |
Enter your Toast client ID. |
Client Secret |
Enter your Toast client secret. |
Restaurant ID |
Enter the ID for any one restaurant in your restaurant management group (this is necessary to make API requests). |
Once you have entered valid Toast credentials, you can use the same account any time you go to create a new Toast DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
Menu |
Description |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select the Toast report you want to run. The following reports are available:
|
||||||||||
Restaurant Selection |
Select whether you want to pull data for all the restaurants in your management group or only specific restaurants. |
||||||||||
Restaurants |
Select the restaurants you want to retrieve data for. |
||||||||||
Sub Report |
Select to flatten the data by either the selections or the payments within an order. For example, if you have an order with 3 selections, choosing selections will result in 3 rows of data for that order. |
||||||||||
Include Applied Discounts | Selecting this option will further expand the selections to include one row of data per discount applied to the selection. | ||||||||||
Start Date |
Select the start date for this report. Starting from this date, Domo will retrieve 7 days of data at a time until the connector has caught up to the current date. After this point, each run will only retrieve any new data added since the previous run. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.