9999 bar codes occur when there is a loss of communication the POS terminal and Punchh Proxy Service. A connection is established each time a bar code is printed. If the connection is not successful, 9999 bar codes are printed.
The most common 9999's are a result of the following conditions:
1. the proxy service is NOT running.
2. the port that proxy service (e.g. usually set to 8008) is running on is being blocked by firewall on the boh.
3. the proxy port is not set correctly in punchhinter.config file. E.g. it may be blank or is different than what punchh.exe (proxy service) is set to run on.
External firewall settings, will NOT cause 9999's.
We need to ensure that the Punchh Proxy is running. Please see the instructions below.
Please make sure the Punchh Proxy service is actively running on the file server in the BOH. Restart if it is not running.
Also, confirm that the following FQDN (Fully Qualified Domain Names) endpoints are properly whitelisted in the site's firewall/router:
TCP using port 443 to:
TCP using port 80 & 443
Please also make sure the following directories and sub-directories are excluded from AntiVirus and real time scanning on the AlohaBOH Server:
c:\Program Files (x86)\Punchh\*
If you need to log a zendesk trouble ticket, please be sure to include the following:
1. Location experiencing the issue.
2. Is it happening or every bar code or intermittently?
3. A image of the receipt.