Welcome to the Toast–Maestro integration setup guide. This document outlines the steps required to configure your integration through DataHub, enabling room charge posting.
To ensure a smooth onboarding experience and successful deployment, please review and complete each section of this guide in the order presented. Following these instructions carefully will help ensure that all systems are configured correctly and operating as expected.
1.Set up Toast
1.1 Request the integration
Request the "Toast to Maestro by Omniboost" integration via the Toast Marketplace. This is required for two reasons: it allows Omniboost to receive the necessary credentials from Toast, and it automatically triggers your onboarding. You'll receive an email from Omniboost DataHub with the next steps.
This document provides some guidance on how to request the integration:
1.2 Configure your Toast environment
Before you can fill in the mapping spreadsheet in the next step, your Toast environment needs a few things configured: revenue centers, service periods (if used), sales categories, and service charges.
You can find more information on how to get your Toast configurations ready for the integration here: Toast Setup Requirements
2. Use Toast to populate the spreadsheet
Once you've completed your Toast configuration (step 1.2), download the Maestro mapping sheet below and use it to fill in the first tab:
How the spreadsheet works:
Tab 1 ("Your Toast Setup"): assign a number to each of your Toast revenue centers, service periods, sales categories, service charges, and tax. Fill in the dashed boxes and add, if needed, additional rows to each category.
Tab 2 ("Toast to Maestro Mapping"): using those numbers, enter the Maestro posting code for each combination.
This gives you control over how detailed your Maestro postings are. Before filling anything in, use the table below to choose your level of detail, it determines which sections you'll complete.
Option | Posting codes based on | Example | What to do |
5. Unified | One code for all Toast revenue |
| Skip 2.2. Enter |
4. Limited detail - Sales Categories only | Sales Category | Food: | Complete every section except 2.2. Enter |
3. Limited detail- Revenue Centers only | Revenue Center | Dining room: | Complete every section except 2.2. Enter |
2. Detailed | Revenue Center + Sales Category | REstaurant, FOod: | Complete every section except 2.2 (Service Periods) |
1. Maximum detail | Revenue Center + Service Period + Sales Category | REstaurant, FOod, BReakfast, : | Complete every section below |
2.1 Revenue centers
Add all revenue centers set up in Toast Web in the "Name" column
Choose a number in the "Number" column for each revenue center
Enter at least one revenue center.
💡 Tip
Chose option 4 or 5 above? Enter
1for every revenue center.Chose option 1, 2 or 3 above? Give every revenue center a different number.
2.2 Service Periods
Complete this section only if you want Maestro to post to different codes depending on the service period. This is optional and depends on how detailed you want your Maestro setup to be.
If you use service periods, enter them in the "Name" column exactly as configured in Toast Web. Omniboost DataHub supports a maximum of four.
💡 Tip
Chose option 1 above? Give every service period a different number.
Chose another option? Skip this section.
2.3 Sales Categories
Assign a number to each sales category you want to post to its own posting code.
In the “Name” column, enter the name of each sales category exactly as it is configured in Toast Web.
Assign a number to each sales category. If sales categories should be posted to the same posting code in Maestro, please assign them to the same number.
Enter at least one sales category.
💡 Tip
Chose option 3 or 5 above? Enter
1for every sales category.Chose another option? Give every sales category a different number.
2.4 Service Charges
Assign a number to each service charge that you would like to post to it's own posting code.
Add the name of each sales category configured in Toast Web in the "Name" column.
Assign a number for each service charge in the "number" column. Continue the numbering from the sales categories. If service charges should be posted to the same code in Maestro, please assign them to the same number.
2.5 Tax
Assign a number to each tax that you would like to post to it's own posting code.
Add the name of each tax configured in Toast Web in the "Name" column.
Assign a number for each tax in the "number" column. If taxes should be posted to the same code in Maestro, please assign them to the same number.
3. Use the spreadsheet to set up Datahub
With your spreadsheet completed, you're ready to configure the integration in Omniboost DataHub.
❗️Maestro server access
Before configuring Datahub, the connection with Maestro needs to be established.
Maestro supports two server environments:
Maestro Hosted Server: hosted and managed by Maestro → skip this and move on.
Local Maestro Server: hosted by your hotel's IT team or an external provider. Ask your IT team to create a firewall routing rule allowing inbound TCP communication from Omniboost's IP addresses (18.201.250.37, 52.51.59.121, 54.229.50.238) to your local Maestro Interface server, routed to an external IP address and port.
Share your external IP address and port with the Omniboost team once configured. The connection can only be established once this is done on our end.
3.1 Accessing DataHub
To access DataHub, follow these steps:
Obtain Login Credentials:
After requesting the integration in the Toast Marketplace you will receive your personal login credentials via email. If you haven't received them, kindly request them from your designated contact at Omniboost or send an email to 'pos-support@omniboost.com'
Navigate to DataHub:
Open your web browser and go to https://datahub.omniboost.io/
Enter Your Credentials:
Use the email and password provided Omniboost
Select “Remember Me”:
Check the
Remember mebox to save your login details for future access.
Click “Login”:
Press the
Loginbutton to proceed.
3.2 Setting Up Two-Factor Authentication (2FA)
When logging into Omniboost DataHub for the first time, you will be prompted to set up Two-Factor Authentication (2FA).
This step is required and must be completed carefully, as you will need your 2FA device each time you log in going forward.
Download a 2FA Application
Install a 2FA application on your smartphone, such as: Google Authenticator, Microsoft Authenticator
Scan the QR Code
Open your 2FA app
Select the option to add a new account
Scan the QR code displayed on the DataHub screen. This will link your account and start generating authentication codes.
Generate and Enter 2FA Code
Your 2FA app will generate a new code every 30 seconds
Enter the current code into the DataHub screen to verify your setup
Save Recovery Codes
Carefully store the recovery codes shown on the screen
These codes allow you to regain access if you lose your phone or 2FA app
❗Important You will need your 2FA app every time you log in to DataHub. |
3.3 Starting the Integration Setup
Access the Next Screen: After successfully creating your user and setting up Two-Factor Authentication (2FA), you will be directed to the next screen.
Click “Start Setup”: On this screen, click the
Start Setupbutton to begin configuring the integration.
3.4 Configuring POS Settings
Configuring the 'On Room Payment Type'
Select the payment type that represents room charges (typically named
Room Charge)This ensures that these transactions are recognized and sent to Maestro as revenue only (not as payments)
Do not select "Room Charge (Offline)"
If you do not see the Room Charge option in the drop down menu, please do send an email to 'pos-support@omniboost.com'.
Fill in the 'Tip Name'
Define the description used for tip-related transaction codes in Maestro.
Enter a name such as:
Toast Tip,Gratuity
This name will be used as a description for the corresponding posting code.
Enable or disable 'Split Tax'
Enable the Split Tax checkbox if you want to split out the different taxes set up in Toast into separate lines in your guest folio.
3.5 Configuring PMS Settings
Use your Maestro mapping worksheet to complete all fields in this section. All values must be numbers only unless otherwise noted.
Default Analysis Code
Enter 99 for both default fields. This value will be used whenever a mapping field is left empty, ensuring transactions are still posted even if a mapping is missing.
Time Zone
Select the time zone that applies to your property.
Revenue Center ID
Enter the revenue center numbers from your Maestro mapping worksheet. These values correspond to the blue section of the mapping file.
Tax Buckets
Enter the tax rate numbers from your Maestro mapping worksheet. These values correspond to the red section of the mapping file.
Service periods
Enter the service period hours and corresponding numbers as defined in your Maestro mapping worksheet. These mappings correspond to the yellow section of the mapping file.
3.6 Configuring the Mapping
In this step, you will map all sales categories, service charges, and payment methods from Toast to Maestro within Omniboost DataHub.
Navigation Tabs
At the top of the screen, you will see a dropdown meny representing your Toast revenue centers (e.g., Dining Room, Patio, Bar). For this integration, only completing the first is required, you can ignore the other selection options. Your separate revenue centers are mapped in the PMS settings, where you assign the Revenue center ID’s.
Sales Categories
On the left side of the screen, you will see all sales categories pulled directly from Toast. On the right side, enter the corresponding Sales Bucket ID from your Maestro mapping file. These values correspond to the orange section of the mapping file.
For example, if Food is mapped to Sales Bucket 1, enter 1 in the Food field.
Service Charges
Below the sales categories, you will see the service charges configured in your Toast environment. Map these using the purple section of the mapping file.
Final step: Click Save Mapping & Continue at the bottom of the screen. Make sure all required fields are completed, otherwise the page will not save.
❗Important If you have multiple locations in Toast (e.g., Market, Rooftop), you must configure the integration for each location separately by following the same steps. You can switch between locations using the dropdown menu in the top-left corner of Omniboost DataHub. |
4. Testing the Integration
You can now test the integration using a Toast POS handheld or terminal with a checked-in room in Maestro.
How to run a test:
Create a new receipt on a Toast handheld or terminal
Select the payment method Room Charge
Note: this may be located under “More payment options”
Search for and select the correct room number
Close the receipt
Verify in Maestro:
Check the Logs page in Omniboost DataHub
Check if the transaction appears correctly in Maestro
Test Adjustment (Recommended)
Void the receipt in Toast
Learn how in the following article: Void Items, Payments, and Checks
Verify that the transaction is also voided or adjusted correctly in Maestro
All transactions and potential errors can be reviewed in the logs within Omniboost DataHub, accessible from the left-hand menu.
❗Important If you need to modify a receipt in Toast after the room charge has already been sent to Maestro, you must void the entire receipt, make the necessary changes, and create a new room charge. Updating an existing receipt will not be reflected correctly in Maestro. |
Support
Support Contact
If you encounter issues with the DataHub configuration or Data:
Omniboost Support 📧 pos-support@omniboost.ioIf you encounter issues with your Toast configuration.
Toast Support 📧 integrations-support@toasttab.comIf you encounter issues with your Maestro configuration, please reach out to your Maestro point of contact.