ISSUE (Observed Behavior):
Punchh button not responsive at POS on all terminals
Cannot lookup guests or use redemptions at POS
EXPLANATION:
Possible causes for this behavior:
When pressing the Punchh button on the POS, the Punchh GUI is attempted to be launched. In order for this functionality to occur the following requirement must be met:
The required "PunchhInter.ActivityHandler" has been defined in
Configuration Center/Maintenance/Business/Store/SystemAloha connect is licensed on key
.net framework is installed on the POS terminal
punchhInter.dll is registered on the POS terminals
This article addresses requirement 1: PunchhInter.ActivityHandler has not been properly defined
VERIFICATION:
If the PunchhInter.ActivityHandler has not been properly defined in the Aloha:
Logging artifacts:
Log file (location/machine)
Include snippet to look for and an example of the actual log file
Configuration File Validation:
ACTIVITYCLSID1=AlohaPOSKitchenInterface.AlohaPOSKitchenInterface
ACTIVITYCLSID2=AlohaIntercept.AlohaIntercept
ACTIVITYCLSID3=FPSSvr.FPSSvr
ACTIVITYCLSID4=Radiant.Hospitality.AlohaToGo.Intercept.AlohaToGoIntercept
ACTIVITYCLSID5=
See: AcvtivityCLSID1: HERE is where the Punchh Activity Handler information MUST GO.
The link listed above contains the PunchhInter.ActivityHandler information as well.
RESOLUTION:
Following the setup article: https://support.punchh.com/hc/en-us/articles/360040097993-Aloha-POS-Punchh-Integration-Fresh-Install-
PunchhInter.ActivityHandler
In this case, the PunchhInter.ActivityHandler wasn’t defined in ALOHA.INI via Configuration Center (ALOHA CFC).
See example below:
The image is an example of a correctly configured PunchhInter.ActivityHandler … if this line is missing in the image above, in “component 1” line, then the GUI will not fire on POS Terminals.
Register the punchh dlls. Refer to docs that show how those dlls can be registered (e.g. FOHADM.BAT) also in documentation link provided above towards the bottom 1/4 of document.
Register Punchh DLL's:
Since the PunchhInter.ActivityHandler line was NOT listed in the PunchhInter.log this indicates that the DLL that handles the button click is not Registered and Loaded by Aloha. if lines like the above are appearing then the UI will be displayed.
The files: PunchhPrt.dll and PunchhInter.dll must be registered on the FOH terminals in order for aloha to utilize them. If the file, FOHADM.BAT is not present when the setup program is run, the setup program will install it with the following commands:
%windir%\Microsoft.NET\framework\v2.0.50727\regasm.exe %localdir%\bin\PunchhPrt.dll
%windir%\Microsoft.NET\framework\v2.0.50727\regasm.exe %localdir%\bin\PunchhInter.dll
If these commands are not run successfully, then punchh will not produce a bar code and/or send check data to punchh
The Punchh programs will create log files in the aloha tmp folder for debugging and trouble shooting. They are named: PunchhInter*.log and AlohaPunchh*.log
TAGS:
PUBLISHING to https:/support.punchh.com
Articles that are approved and ready for publishing to the Punchh Support center library in https://support.punchh.com should follow the steps here