Articles in this section

See more

Focus POS Systems POS Integration Setup Guide (Phase 1)

Avatar
Scott Morgan
Updated Print PDF

Phase 1 integration is limited in Punchh feature support

  • Does not support Barcode earning

  • Does not support all Punchh program types

(See the Focus POS Systems POS (Phase 1) Integration guide for complete feature support details)

Punchh Portal POS Configuration Requirements

Location configuration information

Punchh will need to provide the following items:

  • Location Key: <Unique PER POS Location>

    Copy the API key and save for POS Punchh configuration

  • POS API URL: <typical default value for Production Punchh Portal pos.punchh.com>

    • Same for all brand locations

  • Receipt Datasync API URL: <typical default value for Production Punchh Portal islpunchh.com>

    • Same for all brand location

Set POS Type

If all locations are running Focus Point of Sale, then you Customer Success manager will set the following settings for POS configuration in Punchh Portal Cockpit:

  • If your brand is not running Focus POS in ALL locations and Focus POS is not the default POS for the brand, then you will set the POS setting for Focus POS on a per location basis to the following:

Focus POS Configuration Settings

Using Admin user access:

Setup (Wrench Icon>Setup)

Miscellaneous>Credit/Gift/Loyalty/Customer

  • Step 1

    • Set the Loyalty Type to Punchh under the Gift Cards/Loyalty Tab

  • Step 2

    • Set Punchh Parameters under the
      Repeat Returns/Datacandy/Punchh Tab

    • Recommended to copy and paste all parameters supplied from Punchh

    • Location Key, POS API URL, DATASYNC API URL

    • Set the Discount to the first unused Discount in the dropdown

    • Save and Close

  • Step 3

    • Setup Punchh Discounts
      Order Entry>Discounts

    • Scroll to the first unused discount 

    • Set Name to your desired Punchh discount name 

    • Set following settings:

      • Computation Method: Item $

      • Item Selection  Selected Items

      • Options required for selection

      • Active

      • Item $ Allocate

      • No other selections should be checked

      • Include Modifiers

      • Optional setting:  G

        • Guest Check Name – printed override if you wish to have a different description printed on the customer guest check

    • Save and Close

  • Step 4

    • Punchh Package
      Order Entry>Packages

    • Scroll to the first unused Package

    • Name Punchh or Rewards (customer defined)

    • Command Line 1: Punchh

    • Save and Close

  • Step 5
    Place Punchh Package on applicable Canvases using Canvas designer

Logging

Focus writes all the requests and responses to either 1 of the following locations depending on the site configuration and can vary from station to station in the Focus environment

Option 1:

\\focus\c\focus\status\ 
Filename is MSGMMDD and logs are retained for 30 days
MM=2-digit Month
DD=2-digit day

Option 2:

Terminals working directory (varies you will need to verify that desktop shortcut to confirm) typically c:\focus or d:\focus

<working directory>\Focus\localstatus\
Filename is MSGMMDD-STN and logs are retained for 30 days 
MM=2-digit Month
DD=2-digit day
STN=station position slot in station list, valid 001-999