Interface Setup: Integrations

The Interface Setup (Integrations) page is where connections from Squirrel Cloud to other interfaces are configured.

The page and instructions vary substantially depending on the Interface Type selected. Proceed to the appropriate section of the article below to continue the integration configuration:

• Customer Engagement
• Hotel
• Kitchen
• Ordering
• Reservation

Customer Engagement

Customer Engagement is an integration for gift cards. You can easily create and manage gift card programs that are fully integrated with your Cloud POS system.

• DataCandy: DataCandy gift card management capabilities provide a comprehensive solution for managing and optimizing your gift card programs within the Squirrel Cloud system.

Note: To configure your DataCandy, you will need certain information that you received when you set up your DataCandy account. This includes your Client Access Key, Merchant Identifier, Merchant Password, as well as the Low and High eight-digit card number range, and the Length card number. If you do not have this information, please get in touch with your DataCandy Representative.

1. On the Advanced Setup > Integrations page, click Add Integration.

1. In the Interface Type field, select Customer Engagement.

   

2. Set the Integration System select DataCandy This will automatically take you to the Driver tab

   

4. In the URL field, enter the following URL: https://squircloud.dcuat.com

5. In the Client Access field, enter your client access key that was provided to you by DataCandy.

6. In the Merchant Identifier field, enter your client access key that was provided to you by DataCandy.

7. In the Merchant Password field, enter your client access key that was provided to you by DataCandy.

8. Select Test Credentials to verify configuration settings are correct.

9. Select the Card Range tab

10. Enter your Low:Enter first eight digits of your Low card number range that was provided to you by DataCandy.

11. Enter your High: Enter your first eight digits of your High card number range that was provided to you by DataCandy.

12. Enter your Length: Enter your card number Length that was provided to you by DataCandy.

13. Select Test Credentials to ensure the settings are correct.

14. Select Save IntegrationUnless you need to configure the system to accept Squirrel CRM Gift Cards

    Additional step required to configure the system to accept Squirrel CRM Gift Cards

    To configureSquirrel CRM Gift Cards that have previously imported into DataCandy select the Legacy Check Box.

    

15. Enter the Prefix that was provided to you by DataCandy.

16. Select Save Integration

    ---

• Givex: Givex gift card management capabilities provide a comprehensive solution for managing and optimizing your gift card programs within the Squirrel Cloud system.

Note: To configure your Givex, you will need certain information that you received when you set up your Givex account. This includes your Primary URL, Secondary URL, Merchant Identifier, Merchant Password, and Timeout as well as the Low and High eight-digit card number range, and the Length card number. If you do not have this information, please get in touch with your Givex Representative.

1. On the Advanced Setup > Integrations page, click Add Integration.

2. In the Interface Type field, select Customer Engagement.

1. Set the Integration System select Givex This will automatically take you to the Driver tab

1. In the Primary URL field, enter the URL provided to you by Givex:

2. In the Secondary URL field, enter your client access key that was provided to you by Givex.

3. In the Merchant Identifier field, enter your client access key that was provided to you by Givex.

4. In the Merchant Password field, enter your client access key that was provided to you by Givex.

5. In the Timeout field, enter 30

6. Select the Card Range tab

1. Enter your Low: Enter first five digits of your Low card number range that was provided to you by Givex.

2. Enter your High: Enter your first five digits of your High card number range that was provided to you by Givex.

3. Enter your Length: Enter your card number Length that was provided to you by Givex.

4. Select Add Card Range

5. Repeat Steps 10-13 for all card ranges accepted.

6. Select Save Integration

Hotel

A hotel's Property Management System (PMS) is established in order to process room payments. This page also allows the mapping of time periods and sales and tax categories from Squirrel Cloud to the PMS. Squirrel cloud supports the following hotel integrations: Amadeus, Fidelio 3, Opera 4, and Opera POS.

It is possible to have the sales and tax category information defined as one lump amount, or to completely split / have a combination of the categories or the taxes grouped together. Hotel management needs to make the decision regarding the potential breakdown of categories.

Squirrel Cloud only supports communication to PMS through IP. There are no serial configuration options.

1. On the Advanced Setup > Interface Setup page, click Add New Integration Setup.
2. In the Interface Type field, select Hotel.
3. Set the Integration System field to the PMS being used.

1. All PMS Integrations require the following
   1. In the IP Address field, enter the IP address of the PC running the PMS interface.
   2. In the Port field, enter the port number the PMS uses to communicate over IP.
2. Amadeus requires the following additional steps
   1. Integration Sub System
   2. URL; This is determined by the Sub System
   3. Hotel Code
   4. Subscription ID: only for PMPRO and IDPMS Sub Systems
   5. Username
   6. Password

The information above is suffcient for configuring the system to transfer room payment information.

All Hotel integrations require Sales Classes, Time Periods and Taxes. The below steps will walk through how to configure map sales categories, time periods, or tax categories to the PMS system, continue following the steps in the rest of this section.

1. Click the Sales Classes tab. Remain on the Sales Classes tab.

The Sales Classes tab is used to map Squirrel Cloud's categories to the PMS sales categories. Squirrel Cloud's categories are configured on the Categories page (see the Creating Categories article).

The configuration of this tab depends on the number of sales categories the PMS uses. It does not restrict the number Squirrel can use. However, it configures how these categories are summarized to the PMS.

1. In the top fields, enter the PMS category names and their numeric ID1. Click Add for each entered category / bucket name and ID.
2. Under Mapping to Squirrel Categories, map the created PMS categories (left) with the Squirrel Cloud categories (right). You can map multiple Squirrel Cloud categories with a single PMS category by selecting it multiple times in the left field and mapping it to another Squirrel Cloud category in the right field.
   

1. Click the Time Periods tab. Remain on the Time Periods tab.
   

The Time Periods tab is used to map Squirrel Cloud's time periods to the PMS time periods.

1. In the top fields, enter the PMS time period names and their numeric ID. Click Add for each entered time period and ID.
2. Under Mapping to Squirrel Time Periods, map the created PMS time periods (left) with the Squirrel Cloud time periods (right).
   

1. Click the Taxes tab. Remain on the Taxes tab.

The Taxes tab is used to map Squirrel Cloud's taxes to the PMS taxes.

1. Under Mapping to Squirrel Taxes, map the created PMS taxes (left) with the Squirrel Cloud taxes (right). You can only map a tax a single time2.
   

1. Click Save Interface.

Kitchen

Kitchen integrations, such as QSR, are configured using the "Kitchen" interface type.

1. On the Advanced Setup > Interface Setup page, click Add New Integration Setup.
2. In the Interface Type field, select Kitchen.
3. Set the Integration System field to the kitchen interface being used.

Instructions differ between kitchen systems and are continued in separate sections. Navigate to the appropriate section of the article for the selected integration system.

• QSR Cloud
• QSR Relay

QSR Cloud

1. Navigate to the Site UID tab.
2. Select a store.
   
3. Enter the store's unique identifier (UID) in the Site UID field beside the store.
   
   If needed, repeat steps five and six for other stores.
   
   
4. Click Save Interface.

QSR Relay

4. Navigate to the Connections tab.
5. Select a store.
   
6. Enter the IP address and port used by the QSR Relay installation for that store.
   
   If needed, repeat steps five and six for other stores.
   
   
7. Click Save Interface.

Digital Ordering

Currently we offer xDine as a 3rd party integration for online ordering. Xdine's online ordering system allows customers to easily place orders from a restaurant's website or mobile app and requires no configuration setup in Squirrel Cloud Back of House. Additional Integration will be added to this article as they are released.

Reservation

Restaurant reservation system integrations are configured using the "Reservation" interface type.

At this time, only the SevenRooms POS integration is available. Other integrations will be added to this article as they are released.

1. On the Advanced Setup > Interface Setup page, click Add New Integration Setup.
2. In the Interface Type field, select Kitchen.
3. Set the Integration System field to SevenRooms.
4. Navigate to the Store Mapping tab.
5. Select a store.
   
6. In the Venue ID, Client ID, and Client Secret fields, enter the information provided by SevenRooms.
   
   If needed, repeat steps five and six for other stores.
   
   
7. Click Save Interface.