Heartland Retail

How do I connect my inventory with Heartland Retail?

Setting up your Heartland feed consists of the following steps:

Step 1: Open the Heartland Retail Integration in Locally

  1. Log in to your Locally account.
  2. From the left navigation menu, select Inventory > Inventory Feed Setup.
  3. From the POS dropdown, select Heartland Retail.
  4. An Access Key field will appear. Leave this page open, you'll return to it after generating your API token in Heartland.

Step 2: Generate an API Token in Heartland Retail

  1. Log in to your Heartland Retail account.
  2. Click your name in the upper-right corner and select My Account.
  3. Open the API Tokens tab.
  4. Click Generate New Token.
  5. In the Description field, enter Locally so you can easily identify the token later.
  6. Click Generate Token.
  7. Copy the API token immediately.
    • Important: For security reasons, the API token is only displayed once. After you leave this page, it cannot be viewed again. If you lose it, you'll need to generate a new token.
  8. Return to the Locally setup page.
  9. Paste the token into the Access Key field.
  10. Click Connect.
    • If the connection is successful, you'll see a confirmation message.

Step 3: Configure Your UPC Field

  1. Locally needs to know where your UPC information is stored in Heartland Retail.
  2. Determine whether your UPCs are stored in:
    • The Item # field, or A Custom field.
  3. In the Locally setup screen, select the appropriate option.
    • If you selected Custom, enter the exact name of the custom field.

Step 4: Map Your Store Locations

  1. Map each Heartland Retail location to its corresponding Locally location.
    • This ensures inventory is imported from the correct store locations.
  2. Review the list of Heartland Retail locations displayed in the setup screen.
  3. Select the matching Locally location for each Heartland location.
  4. Verify that every location has been mapped before saving your configuration.

Step 5: Contact Locally Support

After completing the setup and mapping your store locations, please email [email protected] to let us know your Heartland Retail integration is complete.



Did this page help you?