Salesforce

Interface Setup: Integrations

Printable View
« Go Back

Information

 
TitleInterface Setup: Integrations
Details

 

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

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.

    InterfaceType_575x257

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

    datacandy driver_575x311

  1. In the URL field, enter the following URL: https://secure.datacandy.com 

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

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

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

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

  6. Select the Card Range tab

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

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

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

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

  11. Select Save Integration

    If you need to configure the system to accept Squirrel CRM Gift Cards, please complete step 15 below. If this is not required, proceed to step 16.

  12. Additional steps required to configure the system to accept Squirrel CRM Gift Cards:

    • Select the Legacy Check Box.

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

    • Select Save Integration

      Card Range_575x303

  13. Configure Menu Entries for any amount that customer wishes to have available for sale, making sure that they are setup as Gift Card types, and with no taxes. Then add them to the appropriate Menu Screen to be available at FOH. Open priced gift cards can be configured as well. Instructions on creating Menu Entries can be found here;

    • It is recommended that you create a separate Gift Card category to assign these to for reporting purposes

  14. Create a Gift Card payment, making sure that it is assigned to the Gift Card type. Instructions for creating a payment can be found here;

  15.  Run a test transaction to ensure the integration is set up correctly and working as expected. Instructions on how to sell, redeem, and check a balance of a gift card can be found here: 

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

InterfaceType_575x257

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

GivexDriver_575x347

  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

GivexCardRange_575x266

  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.

HotelChoice_575x235

  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.
hotel_settings-sales_classes_tab_511x212

  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.
    hotel_settings-mapping_multiple_categories_509x83
  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.

hotel_settings-time_periods_536x185
  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).
    hotel_settings-time_periods-mapping_525x73
  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.
hotel_settings-taxes_tab_575x225

  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.
    hotel_settings-taxes_tab-mapping_463x88
  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

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

  4. Click Save Interface.

QSR Relay

  1. Navigate to the Connections tab.
  2. Select a store.
    qsr_cloud-select_store
  3. Enter the IP address and port used by the QSR Relay installation for that store.
    qsr_relay-enter_ip
    If needed, repeat steps five and six for other stores.

  4. 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.
    qsr_cloud-select_store
  6. In the Venue ID, Client ID, and Client Secret fields, enter the information provided by SevenRooms.
    venue_identifier_575x53
    If needed, repeat steps five and six for other stores.

  7. Click Save Interface.

1 Opera 4 supports up to eight category mappings (ID 1 - 8). Opera POS supports up to 16 category mappings (ID 1 - 16).

2 Opera 4 supports up to three tax mappings (ID 1 - 3). Opera POS supports up to 16 tax mappings (ID 1 - 16).

 

URL NameContent-Cloud-BoH-Advanced-Setup-Integrations-Cloud-BOH
Powered by