Setting Up Lightspeed K-Series Ordering Integration

This article assumes you already have an active LOKE and Lightspeed account. If you do not already please speak to your relevant account manager or sales representative.

TLDR: 

• If the add-on integration isn't installed for your organisation then do this first
• Once installed you will then need to authorise a Lightspeed account to use with the LOKE organisation
• Enable a LOKE location to use with this integration
• Select a Lightspeed business location to pair with this LOKE location
• Choose the menus and corresponding account profiles to sync
• Perform the initial menu sync

1. Install add-on to LOKE organisation

When accessing the Lightspeed Ordering Link, the first page you will see is the LOKE authentication page. From there, you will be required to enter your LOKE credentials and grant permissions to use it in the Lightspeed Ordering Link.

Once the permissions are granted, you will be redirected to the Organizations page. From here, you can view installed organisations and find a button to install a new organisation.

Look for your organisation and click on the "Install" button to continue.

Once your organisation is installed, navigate to your organisation page. Here, you'll find relevant information about your organisation and an option to uninstall it.

2. Authorize Lightspeed for your organisation

From the previous screen, click in “Connect Lightspeed” (if not done already). You can also disconnect Lightspeed Integration to your organisation from this page.

When connecting Lightspeed to your organisation, you will be redirected to the Lightspeed authentication page, where your Lightspeed credentials will be required.

Login and authorize Lightspeed, make sure that ‘orders-api’ is enabled before authorize.

Note: The process of disconnecting and reconnecting to Lightspeed does not affect other configurations you may have made on this integration.

After connecting to Lightspeed, you'll be able to see your LOKE locations.

3. Enable LOKE location in add-on

When navigating to your location, the first step is to enable it.

Note: In case of losing communication with Lightspeed, try deactivating and then reactivating your location. This will prompt Lightspeed to resubscribe the webhooks with your location. No pre-existing configurations (location mapping and menu mapping) will be lost.

4. Select a business and a business location to link to the LOKE location

Once your location is enabled, you can access Location Mapping and Menu Mapping.

Location Mapping is the link between your Lightspeed business location and your LOKE location. It is necessary to set up Location Mapping before proceeding to Menu Mapping.

Important: To prevent conflicts, it's not allowed to set the same location mapping that is already in use on another LOKE location.

5. Add one or more menus, specifying menu times, fulfillment types and account profiles (for pricing)

After setting up Location Mapping, you can configure Menu Mapping for your location.

In this section, select an Account Profile (for pricing), a Menu, and at least one Fulfillment Type. Additionally, choose the days your menu will be visible (Service Availability).

You can set up more than one Menu Mapping for your location.

Important: Ensure that the configuration you make in the Lightspeed back office matches the integration settings. This means if you have an account profile in Lightspeed with availability on Monday from 6:00 to 13:00, ensure that the configuration you input here matches to avoid conflicts with POS systems.

Important: Mixing multiple account profiles for the same fulfillment types during the same time of day is not allowed. Orders submitted to Lightspeed must be on a single account profile.

6. Sync your menu configuration

Once Menu Mapping is set, you can synchronize the menus.

This is an example of what a menu looks in the Lightspeed back office.

This is what the menu looks in LOKE.

This is what the menu and completed orders looks in POS.