Guide Overview
This guide offers comprehensive instructions on establishing and customizing the integration between Toast and Opera Cloud through DataHub to be able to post room charges. It comprises the following sections:
Accessing DataHub:
Instructions on how to log in to our system, DataHub.
Configuring POS (Toast) Settings:
Step-by-step guidance on configuring your POS settings in DataHub.
Configuring PMS (Opera) Settings:
Step-by-step guidance on configuring your PMS settings in DataHub.
Configuring the mapping:
Precise instructions for aligning POS product categories with transaction codes from Opera Cloud.
Testing the integration:
After configuring the integration, you'll be able to test the integration.
Common issues:
While testing and using the integration, you may come across some common issues.
To access DataHub, you'll also require an Authenticator app on your phone for the 2FA. We recommend using one of the following free apps:
Apple: Google Authenticator
Apple: Microsoft Authenticator
Important: This integration supports also all other payment types. If you want to enable the full revenue push (all other payment types), please contact pos-support@omniboost.io.
Integration Setup Requirements
Before you're able to start connection these two systems to each other and continue with the onboarding, the following information must be ready:
Access to DataHub:
You must have a DataHub account ready before proceeding. Credentials are sent from no-reply@omniboost.io. Please check your inbox to confirm you have received them.
Test room in Opera Cloud:
Create a test room in Opera Cloud before starting the onboarding process. This allows you to test the integration immediately after completing onboarding.
Toast Terminal:
To test the integration, you will need a handheld or terminal device from Toast. Ensure one is available for the setup process.
Transaction codes within Opera Cloud:
A transaction code called ‘Fallback Toast’
A transaction code called ‘Fallback Payments Toast’
A transaction code called ‘Service Charge Toast’
A transaction code called ‘Gratuity Toast’
A transaction code for your local tax
Use this link to learn how to create a transaction code: Configuring Transaction Codes
Important: If you create a new transaction code or want to use an existing one, ‘Manual Posting’ needs to be enabled.
Access DataHub
To access Datahub, follow these steps:
Obtain Login Credentials:
Ensure you've been provided with login credentials by an Omniboost support agent. If you haven't received them, kindly request them from your designated contact at Omniboost.
Navigate to DataHub:
Open your web browser and go to
https://datahub.omniboost.io/
Enter Your Credentials:
Email: Input the email address you used to create the account.
Password: Enter the password you received in the email.
Select “Remember Me”:
Check the
Remember mebox to save your login details for future access.
Click “Login”:
Press the
Loginbutton to proceed.
Note: For a visual guide, please refer to the image below for further information:
Setting Up Two-Factor Authentication (2FA)
Log In to DataHub:
Ensure you are logged in to DataHub with your credentials.
Initiate 2FA Setup:
Locate and click on the
Enablebutton to start the Two-Factor Authentication (2FA) setup process.
Follow the Instructions:
Follow the on-screen instructions to complete the 2FA setup. This involves linking your account with an authentication app (e.g., Google Authenticator, Authy) on your phone and entering a verification code.
Complete Setup:
Once the 2FA setup is complete, confirm any additional steps or settings as prompted.
Important: Enabling 2FA is a crucial step to enhance the security of your account. Make sure to follow all instructions carefully to ensure that 2FA is properly configured. If you skip this step, you won’t be able to log in again. If you accidentally do this, please reach out to pos-support@omniboost.io.
Steps to Set Up 2FA
Scan the QR Code:
On the screen where you clicked
Enable, you will see a QR code.Download a 2FA app such as Google Authenticator or Microsoft Authenticator on your smartphone.
Open the app and use it to scan the QR code displayed on the screen. This QR code will set up your 2FA codes.
Generate and Enter 2FA Code:
The 2FA app will start generating a new authentication code every 30 seconds.
Enter the current code from your app into the provided field on the Datahub screen to complete the setup.
Save Recovery Codes:
Make sure to note down the recovery codes displayed on the screen.
These recovery codes can be used to access your account if you lose access to your 2FA app.
Complete Setup:
Follow any additional prompts to finalize the 2FA setup.
Important: Ensure you store your recovery codes in a safe place. They are essential for accessing your account if you ever lose access to your 2FA app.
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, find and click the
Start setupbutton to begin configuring the integration.
Configuring POS (Toast) Settings
Select the “On Room Payment Type”:
Choose the payment type that corresponds to Room Charges. Typically, this is labelled as Room Charge.
Configure “Tip Name”:
Customize the description for tips based on your preferences. For example, you can name it Tips, Gratuity, or any term you prefer. This description will be used for the transaction code.
Meal Periods & Split Tax:
If you are using meal periods or planning to map the transaction codes with breakfast, lunch and dinner; enable the Use Meal Periods checkbox.
Be sure that all hours are the same as on the Toast Web under the function ‘Service Hours’. Use the following link to learn how to view the Service Hours: Set Up Restaurant Hours and Services
Enable the Split Tax checkbox if you want to split out the different taxes. Otherwise, the system will use the total tax rate
Note: For a visual guide, please refer to the image below for further information.
Configuring PMS (Opera) Settings
Important: If you have the full revenue push feature enabled please have a look at the steps via this link: Full Revenue Push | Toast to Opera Cloud
Configure “Default Analysis Code”:
Enter the Default Code Fallback Toast you created in Opera Cloud.
Example: If a new item is added in Toast without mapping, the data will default to this code.
Configure “Default Payment Code”:
Enter the Default Code Fallback Payment Toast you created in Opera Cloud.
Configure “Folio Window Number”:
Enter the folio number that will be used for room charges, 1 by default.
Example: There are multiple folios you can send charges to in the guest folio in Opera Cloud. Fill in the window number that you want the room charges to end up in within the guest folio.
VAT/TAX Inc.:
Enable the check box ‘VAT/TAX inc.’ if VAT/TAX is included in the price (commonly used in Europe)
Auto Balance Account:
Disable the check box if you are not using the ‘Full Revenue Push’ feature
Use Package Allowance:
Enable the check box ‘Use Package Allowance’, if you are using package allowances. Package allowance is a fixed amount given to hotel guests for services like meals and if any amount exceeded is charged to the guest's folio
Configure Payment Accounts:
If you are NOT using the ‘Full Revenue Push’ feature use the default code 'DON’T USE PAYMENT ACCOUNTS'
Configuring the VAT/TAX Buckets:
Select the TAX transaction code (for example ‘Sales tax’).
Configure Service Charge Code:
Select the service charge code ‘Service Charge Toast' that you created and do the same for the ‘Service Charge With Vat Code’ field
Configure Tip Code"
Select the tip code ‘Gratuity Toast' that you created
Configure the “Receipt description”:
Add a description that will appear on receipts in Opera Cloud.
Example: Use your hotel name, restaurant name, market name, or a similar identifier in the ‘Receipt Description’ field.
Configuring the mapping (without 'Meal Periods')
You can map everything to a transaction code (such as ‘Room Charge’) or you can have more detailed mapping, where you map everything separate. Please note that if you are not using the ‘Full Revenue Push’ feature, you can map all Payment Methods to ‘Fallback Payment Toast’.
Use this link to learn how to create a transaction code: Configuring Transaction Codes
Use this link to learn how to create a Sales Category: Configure Sales Categories
Click ‘Save Mapping’ at the bottom of the screen and make sure all fields are selected, otherwise you can't save
Important: If your property has multiple floors or revenue centers and you apply the same settings for all, the system will automatically implement these settings across all floors—even if they aren’t visibly displayed.
If you prefer to map separately for each floor, update them individually using the floor buttons at the top.
Additionally, if you have other Toast locations (e.g., Market, Rooftop), ensure you set up the integration for each location following the same process as this one.
Configuring the mapping (with 'Meal Periods')
Please map all the floors on top that are linked to the meal periods, you do not need to map the first ones. Go back to 'Step 1' if you want to know how to setup the meal periods.
Click ‘Save Mapping’ at the bottom of the screen and repeat this for the other floors with the meal periods
Testing the Integration
You can now test the integration using a Toast handheld or terminal with either an available room or a test room. All transactions and any errors can be viewed in the logs within the Omniboost DataHub, accessible on the left side of the screen.
Important:
After testing, make sure to void your invoice. This action will automatically sync with Opera Cloud. For detailed instructions, refer to the article Void Items, Payments, and Checks
If you need to change an item in Toast after a room charge has already been processed, you must void the receipt, update the item, and create a new room charge. Directly updating the receipt will not work.
If you encounter any issues, contact pos-support@omniboost.io for assistance.
Future Possibilities
View detailed check on the guest folio in Opera Cloud
You will receive an email notification when this feature become available.
Common issues
If you are not receiving any transaction codes in our system, please check the following settings in Opera Cloud.
Menu > Administration > Enterprise > Opera Controls > Cashiering > Transaction Code by User Role
Make sure this setting is marked as inactive.
If a Toast popup displays “No guest found,” it’s likely because the room charge is not enabled in Opera Cloud.
How to resolve this issue:
Go to the ‘Check In Reservation’ of the guest in Opera Cloud and have a look at the ‘Payment Instruction’ settings and see if ‘No Post’ is disabled.
If a Toast popup displays "Payments through SkyTouch are currently unavailable," double-check that all sales categories are properly linked to the items in Toast.
How to resolve this issue:
Go to ‘Menus’.
Navigate to ‘Advanced Properties’.
In the dropdown menu on the right, select ‘Sales Category’.
Ensure that every ‘Sales Category’ is filled in.
Click ‘Save’ and then ‘Publish’.
If you encounter any other issues, please reach out to pos-support@omniboost.io for further assistance.