Skip to main content
All CollectionsDataHub Integrations
Toast to SkyTouch/Choice Advantage | Onboarding guide
Toast to SkyTouch/Choice Advantage | Onboarding guide

By Omniboost.

Vincent Verschueren avatar
Written by Vincent Verschueren
Updated yesterday

Guide Overview:

This guide offers comprehensive instructions on establishing and customizing the integration between Toast and SkyTouch/Choice Advantage 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 (SkyTouch) Settings:

    • Step-by-step guidance on configuring your PMS settings in Datahub.

  • Configuring the mapping:

    • Precise instructions for aligning POS product categories with device codes and types from SkyTouch/Choice Advantage.

  • 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:

Important: This integration only supports room charges. Direct payments will not be processed to SkyTouch/Choice Advantage with this integration at this time.


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 SkyTouch:

  • Create a test room in SkyTouch 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.

Device types and codes:

  • SkyTouch will assist you in setting up device types and codes (e.g., Toast locations such as “Restaurant” or “Market”) and a tip code. If they haven’t contacted you yet, please call 800-528-3118 and select option 3 for assistance.

    • In the example below, SkyTouch created a device type “TIP” and code “99” and a device type “REST” (for the Restaurant) and code “1”.

      • Important: The onboarding process cannot be completed without these codes.


Access Datahub

To access Datahub, follow these steps:

  1. 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.

  2. Navigate to Datahub:

    • Open your web browser and go to https://datahub.omniboost.io/

  3. Enter Your Credentials:

    • Email: Input the email address you used to create the account.

    • Password: Enter the password you received in the email.

  4. Select “Remember Me”:

    • Check the Remember me box to save your login details for future access.

  5. Click “Login”:

    • Press the Login button to proceed.

Note: For a visual guide, please refer to the image below for further information:


Setting Up Two-Factor Authentication (2FA)

  1. Log In to Datahub:

    • Ensure you are logged in to Datahub with your credentials.

  2. Initiate 2FA Setup:

    • Locate and click on the Enable button to start the Two-Factor Authentication (2FA) setup process.

  3. 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.

  4. 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:

  1. 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.

  2. 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.

  3. 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.

  4. 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

  1. Access the Next Screen:

    • After successfully creating your user and setting up Two-Factor Authentication (2FA), you will be directed to the next screen.

  2. Click “Start Setup”:

    • On this screen, find and click the Start setup button to begin configuring the integration.


Configuring POS (Toast) Settings:

  1. Select the “On Room Payment Type”:

    • Choose the payment type that corresponds to Room Charges. Typically, this is labelled as Room Charge.

  2. 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.

  3. Meal Periods & Split Tax:

    • Ensure the options “Use Meal Periods” and “Split Tax” are disabled. These features are not compatible with the integration, so please avoid enabling them.

Note: For a visual guide, please refer to the image below for further information.

Important: Please click on “Next step” before proceeding.


Configuring PMS (SkyTouch) Settings:

  1. Enable or disable the first option:

    • Ensure the option "I'm part of the Choice Advantage group" is enabled, if you are part of the Choice Advantage group, otherwise disable it.

  2. Fill in the “Property Code”:

    • Enter your SkyTouch property code. Ensure the code is accurate to avoid configuration issues.

  3. Configure “Default Analysis Code”:

    • Enter the ID for the Default Code you created in SkyTouch.

      • Example: If a new item is added in Toast without mapping, the data will default to this code.

  4. Configure the “Receipt description”:

    • Add a description that will appear on receipts in SkyTouch.

      • Example: Use your hotel name, restaurant name, market name, or a similar identifier in the ‘Receipt Description’ field.

  5. Configuring the VAT Brackets:

    • TBC

  6. Enter the “Tip Code”

    • Please enter the Tip Code which was provided by Omniboost or SkyTouch.

      • TBC

  7. Configuring the Device Types:

    • Use the device codes and types provided by SkyTouch or Omniboost to complete these fields (In the example below: ‘Tip Code’ is ‘99’ and ‘Device Type’ is ‘REST’ for all fields.)

      • Device Code: A specific number identifying a device or transaction type (ex. '99' for tip transactions)

      • Device Type: A label describing the category or function of the device (ex. 'REST' for restaurant-related transactions)

Important: This setup example applies to the Restaurant location. If your hotel has multiple locations, ensure you are configuring the correct one. Double-check the location displayed in the top-left corner to confirm you're setting up the settings for the Restaurant or the intended location.


Configuring the mapping:

Again, you need the device codes and types to fill in the next fields. (In the example below: “PMS Category” is “1” for all fields, based on the ‘REST’ device type (for the Restaurant) created in the example.)

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 settings 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 the Restaurant.


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 SkyTouch. 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

Currently, House Accounts and Group Accounts are not supported with this integration. For workarounds, reach out to SkyTouch at 800-528-3118, press option 3, and mention “Interface issue” along with your property ID.

You will receive an email notification when these features become available.


Common issues

If a Toast popup displays “No guest found,” it’s likely because the room charge is not enabled in SkyTouch.

How to resolve this issue:

  • Ensure the guest is not marked as a cash guest. Check the 'Payment Info' in the reservation details.

  • Navigate to the room reservation information and confirm that the ‘No Post’ field is disabled.

  • In the room reservation info, click ‘Interface Options’ and ensure that ‘Disable Charges to Room’ 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.

Did this answer your question?