How to Set Up an NCR Integration in the GRUBBRR Portal

Last updated: August 5, 2026

GRUBBRR integrates with NCR Aloha to fulfill our clients' self-ordering requirements. For seamless communication between the GRUBBRR Portal and NCR, it is essential to configure the client's menu and our portal correctly. This article will provide a step-by-step guide for setting up a menu for a new client or location using this integration.

Prerequisites

Before beginning the integration process, please confirm that all of the following prerequisites have been met:

  1. The client must contact NCR and permit GRUBBRR to access their menu.
  2. The client must meet the following software requirements:
    • Aloha POS v.15.1 or Higher, 19.1 or Higher
      • Please note: GRUBBRR only supports versions 15 and 19
    • Aloha Take Out v19.10.15 or higher
    • Configuration Center v.20.29 or Higher (Not NAM)
  3. The client must have completed all steps of BSL setup, as outlined in the Aloha Takeout and BSL Integration guide. Please verify that the client has:
    • Created an Interface Employee role for their GRUBBRR Kiosk
    • Configured Payment Types and Custom Tenders for GRUBBRR
    • Assigned GRUBBRR to the Custom_Prepaid1 payment type (or another Custom_PrepaidX if that is already in use)
    • Provisioned Aloha Takeout to communicate with BSL properly
    • Entered the correct shared key and secret key in their Aloha Takeout settings (Client obtains this from their NCR Representative- not the same that GRUBBRR uses to integrate with the client's POS)
  4. The client must have created and published their menu through the NCR Aloha Online Menu Configurator

We've created an onboarding questionnaire you can use during initial conversations with the client to ensure all of these prerequisites have been met. 

Installing a Backup Printer

As part of every NCR deployment, GRUBBRR includes a backup printer. This printer serves as a fail-safe, enabling our system to detect when an order is submitted and paid for at the kiosk but fails to reach the POS. In such cases, the system prints a KOT (Kitchen Order Ticket) of the customer’s order, allowing the kitchen to fulfill it even without POS confirmation.

Capabilities

GRUBBRR Can import the following from NCR: 

  • Names for All Menu Items/Categories/Modifiers
  • Descriptions for All Menu Items/Categories/Modifiers
  • Images for All Menu Items/Categories/Modifiers
  • Prices for All Menu Items/Categories/Modifiers
    • If there is a price change on the POS that is not present in the Menu Configurator, GRUBBRR will match the POS price during order calculation and submission
  • Menu Display Order
  • Category Mapping for all Menu Items
  • Item Modifier Group Mapping
  • Common Modifier Groups
  • Nested Modifiers
  • Store Hours* 
  • Modifier Codes (No/Light/Extra)
  • Item Availability Updates (Via Webhook)

In addition to the imports mentioned above, GRUBBRR's integration with NCR also supports the following Custom Configurations from the GRUBBRR Portal: 

  • Menu Images
  • Menu Display Order
  • Menu Display Names
  • Custom Subcategories
  • Customer Information Fields sent to POS
  • Upsells
  • GRUBBRR Discounts
  • Punchh Loyalty Support
  • GRUBBRR supports Table Tent using the First Name field

Limitations

  • Combos
  • Discounts
  • NCR Loyalty/Gift CardsX

Super-Admin Configurations

Because we require clients to use a Backup Kitchen Printer with our NCR integration, we need to ensure that we configure Printer Partners for the company through the Super Admin Portal. 

  1. Log in to the Super Admin Portal
  2. Select Company Master in the sidebar
  3. Select Printer Partner from the dropdown menu
     
  4. Search for the company you've created
  5. Click Edit in the action column
     
  6. Enable the appropriate printer models from the table
     
  7. Click Save All

Location-Level Configurations

There are three required steps to complete our initial connection to the NCR POS: 

  1. Configuring the Integration
  2. Mapping Order Types and Channels
  3. Configuring Backup Printers

We need to complete these steps correctly to place orders on the NCR system. 

Configuring the Integration

To perform the initial POS connection and menu pull, follow the steps below: 

  1. Sign in to the client's GRUBBRR Portal at the Location level
  2. Select Integration in the left sidebar
  3. Select NCR from the dropdown menu
     
  4. On the NCR Integration configuration page, make the following configurations:

     
    • Client Identification (Mandatory):
      • nepOrganization: The client will get this information from NCR and share it with us.
      • nepEnterpriseUnit: After entering the Organization Name in the field above, click on Lookup Enterprise Unit and select the appropriate location from the list. 
      • External Tender ID: Unless otherwise instructed, enter custom_prepaid1
      • Menu Version: Select 'V1 (Configurator)' from the dropdown
      • Menu Type: Select 'DefaultMenu'
      • Default Menu: Click the blue 'Load Default Menu' option to choose the menu created by the client in their NCR POS, then select that menu from the dropdown menu.
      • Promotion Reference Id: This section connects the integration to the Punchh loyalty program. Unless otherwise requested, leave this blank.
    • Customize Fields Sent to NCR (Optional): 
      • These settings allow us to change the information the GRUBBRR Portal sends to the client's POS. Enabling these settings generally tells the GRUBBRR Portal not to send customer information collected during an order to the client's POS. These settings can be activated by request: 
        • Don't Hyphenate Order Prefix and Order Token: If this is on, the system will not print a hyphen between a configured Order Prefix and Order Token
        • Don't Send Table Tent 
        • Don't Send Customer Name
        • Don't Send Customer Email Address
        • Don't Send Customer Phone Number
      • Sync Settings: 
        • These settings affect the information the GRUBBRR Portal pulls from a client's POS during a menu sync. Unless otherwise requested, GRUBBRR uses the following configurations: 
          • Ignore Display Name should be off unless you will be configuring custom display names for the client's Kiosk. 
          • Ignore Record Images should be off unless you will be configuring custom item images for the client's Kiosk. 
          • Ignore Display Order should be off unless you will be configuring a custom display order for the client's Kiosk. 
          • Daily Sync should be on; use the 24H clock to configure sync time according to the client's preference.
          • Subscribe to Item Availability and Order Status Webhook should always be on
            • Note: If you ever have to make changes to configurations on the NCR integration page, please be sure to re-subscribe to webhooks; failing to do so can cause issues with the ordering process

After finishing your configurations, you will have two options: 

  • Save Only applies the configurations to the Portal but does not pull any data from the client's POS
  • Save & Sync Data Now uses your configurations and pulls data from the client's POS. 

Mapping Order Types and Channels

The client's NCR POS has pre-defined order types that it expects to receive from GRUBBRR. To ensure that the POS can properly receive and process orders from the Kiosk, we will need to map orders from our Kiosk to those order types and channels in the GRUBBRR Portal. To map order types and channels, follow the steps below: 

  1. Select Configure in the left sidebar
  2. Select General Settings
     
  3. On the Common tab, the first section you will see is the Order Type table
  4. Make the following configurations to the Dine In and Takeout order types:  
    • Dine In: 

      • In the dropdown for Third Party Order Type (see example below), select the client's preset dine-in option
      • In the dropdown for Channel, select Web unless the client specifies a different channel
    • Takeout 

      • In the dropdown for Third Party Order Type, select the client's preset takeout option
      • In the dropdown for Channel, select Web unless the client specifies a different channel

Refer to the image below to verify your configurations:

Scroll to the bottom of the page and select Save to apply your configurations. 

Configuring Backup Printers

GRUBBRR requires the use of a backup printer to ensure a smooth flow of service even if orders do not properly transmit to the client's POS. This printer only prints tickets when an order is processed at the Kiosk, but not at the POS. 

Printer Configurations

  1. Select Configure in the left sidebar
  2. Select Printer Settings
     
  3. On the Printer Settings Page, select Add New at the top right of the page
     
    • Assign the printer a Name and an App ID
      • Both can be user-defined
    • IP Address and Mac Address

      • There are a few ways that you can find this information from your printer; one of which is outlined here. 
    • Select your printer's model from the dropdown on the top right of the page
    • From the toggles below the dropdown, select Backup POS Kitchen Printer
    • Click Save

Check the image below to verify your printer configurations:

Kitchen Configurations

  1. Select Configure in the left sidebar
  2. Select Kitchen Settings
     
  3. Select Add New
  4. On the pop-up screen for your new kitchen, enter the following:

    1. Name the Kitchen something easily identifiable (i.e., GRUBBRR Backup)
    2. Select the backup printer from the Kitchen Printer dropdown
    3. Select Save

Review the image below for an example of a configured New Kitchen screen.



Procedure Warnings: