Difference between revisions of "Troubleshooting"

From HandiFox Desktop Wiki
Jump to navigation Jump to search
(Replaced content with "{{DISPLAYTITLE:<span style="position: absolute; clip: rect(1px 1px 1px 1px); clip: rect(1px, 1px, 1px, 1px);">{{FULLPAGENAME}}</span>}} <big>'''<big><center>Troubleshootin...")
Tag: Replaced
Line 1: Line 1:
−
This section covers common issues related to HandiFox, QuickBooks connections, handheld device synchronization, scanning, and miscellaneous problems.
+
{{DISPLAYTITLE:<span style="position: absolute; clip: rect(1px 1px 1px 1px); clip: rect(1px, 1px, 1px, 1px);">{{FULLPAGENAME}}</span>}}
−
<br>
+
<big>'''<big><center>Troubleshooting</center></big>'''</big>
−
== <big>Installation</big> ==
+
[[File:Foxtroubleshooting.png | center | 150px]]
−
<br>
+
<big><center><span style="color:#FF8C00">Having trouble with HandiFox? Don't worry, you are in the right place. This page covers common problems and how to fix them quickly so you can get back to running your business..</span></center></big>
−
{{Gototop}}
 
−
<br>
 
  
−
==<big>QuickBoooks Connection and QuickBooks Synchronization</big>==
+
<table style="width: 100%; max-width: 1300px; padding: 5px; margin: 0 auto;">
 +
<td style="vertical-align: top; width: 33%;">
  
−
This section covers common issues and solutions related to connecting HandiFox to QuickBooks and synchronizing data between QuickBooks and your handheld devices.
+
{{TitledBlockTroubleshooting | '''[[Installation]]''' |
 +
}}
  
−
===Restore the Connection Between HandiFox and QuickBooks===
+
{{TitledBlockTroubleshooting | '''[[QuickBoooks Connection and QuickBooks Synchronization]]''' |
−
'''Problem:'''
+
*[[QuickBooks_Synchronization#Every_time_HandiFox_synchronizes.2C_QuickBooks_locks._Is_there_a_way_to_synchronize_without_locking_QuickBooks | Preventing QuickBooks from Locking During HandiFox Sync]]
−
Sometimes you may notice that transactions or other data created or updated on handheld devices:
+
*[[QuickBooks_Synchronization#HandiFox_cannot_find_my_company_file_after_renaming_or_moving_it._How_do_I_fix_this.| Company File Not Found After Renaming or Moving]]
−
*Do not upload to QuickBooks
 
−
*Do not download from QuickBooks to the handheld device
 
−
*Warning messages in HandiFox Monitor, such as:
 
−
  *''Connecting to QuickBooks under user x'' (repeated several times without connecting)
 
−
  *''Cannot connect to QuickBooks''
 
−
  *''Cannot connect to ComAdapter.exe''
 
  
−
These issues indicate that HandiFox is having trouble connecting to QuickBooks through the ComAdapter.
+
}}
 +
</td>
 +
<td style="vertical-align: top; width: 33%;">
 +
{{TitledBlockTroubleshooting | '''[[Handheld Synchronization]]''' |
 +
}}
  
−
'''Solution:'''
+
{{TitledBlockTroubleshooting | '''[[Scanning and Barcoding]]''' |
−
Restoring the connection is straightforward by restarting the ComAdapter (ComAdapter.exe).
 
  
−
'''Steps:'''
+
}}
 +
</td>
 +
<td style="vertical-align: top; width: 33%;">
  
−
#Open '''[[Troubleshooting#How_to_Launch_Task_Manager|Task Manager]]''' on your computer.
+
{{TitledBlockTroubleshooting | '''[[Miscellaneous Issues]]''' |
−
#Go to the '''Details''' tab.
+
}}
−
#Locate '''ComAdapter.exe''' in the list of processes.
 
−
#Right-click '''ComAdapter.exe''' and select '''''End Task''''' or '''''End Process Tree'''''.
 
−
#Navigate to the HandiFox installation folder (usually C:\Program Files (x86)\Tecom Group\HandiFox)
 
−
#Launch '''ComAdapter.exe''' manually by double-clicking the file.
 
−
<br>
 
−
'''Note:''' <br> After launching '''ComAdapter''', you can trigger the QuickBooks synchronization by either synchronizing a handheld device (depending on the HandiFox settings) or by restarting the QuickBooks connection. To restart the connection: right-click the HandiFox icon near the clock, select '''''Stop QuickBooks Connection''''', and then right-click again and select '''''Start QuickBooks Connection'''''.
 
−
By default, if HandiFox is running in multi-user mode, QuickBooks synchronization occurs every hour, but this interval can be changed in File → HandiFox → Settings → Advanced.
 
  
−
<br>
+
</td>
−
{{Warningshort | After performing this procedure, the HandiFox menu in QuickBooks will not respond. To restore access to HandiFox functions within QuickBooks, simply restart QuickBooks.}}
 
−
<br>
 
−
{{Gototop}}
 
−
<br>
 
−
 
 
−
===QuickBooks Permission Errors===
 
−
<br>
 
−
[[File:QBpermerror.PNG | left | 500px]]
 
−
<br>
 
−
If you see error messages like:<br>
 
−
''"Failed to get ... Insufficient permission level to perform this action"''
 
−
<br>
 
−
It means the current logged-in QuickBooks user lacks the minimum permissions required for HandiFox to function properly.
 
−
<br>
 
−
<br>
 
−
'''Solution:'''
 
−
<br>
 
−
Log in as a QuickBooks Admin and grant the necessary permissions to the users who log in to the company file on the computer where HandiFox is installed.
 
−
Granting new permissions can be done via ''Company →  Users → Set  Up Users and Roles...
 
−
<br>
 
−
Below is a summary of the minimum permissions a QuickBooks user should have to ensure the proper functioning of HandiFox.<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
====List of Permissions====
 
−
{|class="wikitable" style="border-style: solid; border-width: 10px 10px 10px 10px; display: inline-table";
 
−
|+
 
−
|-
 
−
!  Area !! Activities !! Access Level
 
−
|- style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" | '''ACCOUNTING'''
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | General Journal ||  style="text-align:center;" | VIEW
 
−
|-style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" |'''BANKING'''
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Checks || style="text-align:center;" | VIEW
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Credit card charges  || style="text-align:center;" | VIEW
 
−
|- style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" | '''CENTERS'''
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Customer center || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Vendor center || style="text-align:center;" | FULL
 
−
|- style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" |'''CUSTOMERS & RECEIVABLES'''
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Credit card refunds || style="text-align:center;" | VIEW
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Credit Memos || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Invoices || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Receive Payments || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Sales Orders || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Sales Receipts || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Statement Charges || style="text-align:center;" | VIEW
 
−
|}
 
−
{|class="wikitable" style="border-style: solid; border-width: 10px 10px 10px 10px; display: inline-table";
 
−
|+
 
−
|-
 
−
!  Area !! Activities !! Access Level
 
−
|- style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" |'''LISTS'''
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Chart of Accounts || style="text-align:center;" | VIEW (without balances)
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Customer & Vendor Profile:
 
−
* Sales Rep List
 
−
* Terms List
 
−
||
 
−
*VIEW
 
−
*VIEW
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Inventory Site List || style="text-align:center;" | FULL
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Item List || style="text-align:center;" | FULL
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Other Names List  || style="text-align:center;" | VIEW
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Price Level List || style="text-align:center;" | VIEW
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Price Rule List  || style="text-align:center;" | VIEW
 
−
|- style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" |'''SALES TAX'''
 
−
|-
 
−
|  scope="row" colspan="2" style="text-align:right;" | Sales Tax Code List || style="text-align:center;" | VIEW
 
−
|- style="font-style: italic; color: green; text-align:left;"
 
−
| scope="row" colspan="3" | '''VENDORS & PAYABLES'''
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Adjust Quantity on Hand || style="text-align:center;" | FULL
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Build Assemblies || style="text-align:center;" | FULL
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Enter Bills || style="text-align:center;" | VIEW
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Item Receipts || style="text-align:center;" | FULL
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Purchase Orders || style="text-align:center;" | FULL
 
−
|-
 
−
| scope="row" colspan="2" style="text-align:right;" | Transfer Inventory || style="text-align:center;" | FULL
 
−
|}
 
−
<br>
 
−
{{infoshort | Tip: Creating a role and assigning it to each user who logs into the company file on the computer where HandiFox is installed is easier and more efficient than granting individual permissions to each user. This role should include all the permissions required for HandiFox to synchronize properly with QuickBooks. Once assigned, all users with this role will have the necessary access, simplifying administration and ensuring consistent permissions.}}
 
−
{{Gototop}}
 
−
<br>
 
−
 
 
−
===HandiFox Cannot Find the QuickBooks Company File After It Was Renamed or Moved===
 
−
If you have renamed or moved your QuickBooks company file, HandiFox may not be able to locate it. The good news is that this is an easy fix. By updating one setting in the '''HandiFox.ini''' file and restarting the connections in the correct order, you can point HandiFox to the right company file and continue syncing with QuickBooks.
 
−
<br><br>
 
−
'''Step 1. Get the QuickBooks company file path'''
 
−
*Open QuickBooks.
 
−
*Press '''''F2''''' or '''''Ctrl'''''+'''''1''''' to open the '''Product Information''' window.
 
−
*Find and copy the full path to your company file under '''File Information'''.
 
−
<br>
 
−
'''Step 2. Open the HandiFox configuration file'''
 
−
*Locate the file named '''HandiFox.ini'''. By default, this file is stored in the HandiFox installation folder, usually C:\Program Files (x86)\Tecom Group\HandiFox.
 
−
*Open the file with a text editor such as '''Notepad'''.
 
−
<br>
 
−
'''Step 3. Update the path to the QuickBooks company file '''
 
−
*In the HandiFox.ini file, go to the section '''[Application]'''.
 
−
*Find the parameter '''QBFile='''.
 
−
*After the equal sign '''=''', paste the QuickBooks company file path you copied in Step 1. Do not add any spaces after the equal sign.<br>
 
−
[[File:Pathtocompanyfile.JPG|559px|thumb|left|Example of the Configuration File]]
 
−
<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 
−
'''Step 4. Save the configuration file'''
 
−
*Save your changes and close the text editor.
 
−
<br>
 
−
'''Step 5. Restart the HandiFox connections'''
 
−
*Locate the '''HandiFox icon''' near the clock in the Windows system tray.
 
−
*Right-click the icon and select '''''Stop QuickBooks Connection'''''.
 
−
*Right-click the icon again and select '''''Stop Handheld Connection'''''.
 
−
*Right-click the icon again and select '''''Start Handheld Connection'''''.
 
−
*Right-click the icon again and select Start '''''QuickBooks Connection'''''.
 
−
<br>
 
−
{{Gototop}}
 
−
<br>
 
−
 
 
−
==<big>Handheld Synchronization</big>==
 
−
<br>
 
−
{{Gototop}}
 
−
<br>
 
−
 
 
−
==<big>Scanning</big>==
 
−
<br>
 
−
 
 
−
===Zebra Scanners===
 
−
==== Scanner does not find or pick items after reinstalling/updating the mobile app or clearing data. ====
 
−
[[File:Dw14.jpg | right | 250px]]
 
−
<br>
 
−
'''Solution:'''
 
−
#Go to ''Admin → Settings → Select scanner''.
 
−
#Check the input field to the left of the '''Scan Bluetooth''' button:
 
−
##If it says '''DataWedge''', proceed to re-enable the profile.
 
−
##If it does not say DataWedge'''Bold text''', you can manually input DataWedge (capital '''D''', capital '''W''').
 
−
#Tap '''Save''' and [[Setting_Up_and_Configuring_Scanner#Testing_Scanner|test]] your scanner.
 
−
<br>
 
−
{{infoshort | The DataWedge profile can only be re-enabled if it has not been deleted.}}
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
{{Gototop}}<br>
 
−
====Known problems that may arise when testing if your scanner works in HandiFox====
 
−
{| class="wikitable"
 
−
|-style="font-style: italic; color: orange; text-align:center; border-style: solid; border-width: 2px 2px 2px 2px;
 
−
| '''Problem'''|| '''Tips'''
 
−
|-
 
−
| The scanner doesn't recognize the barcode at all (doesn't beep).
 
−
|| The barcode label could be damaged or poorly printed, so it is not readable. Try another one. Also see the next problem.
 
−
|-
 
−
| The scanner fails to recognize all or a large part of your product labels.
 
−
|| Perhaps the correct decoder for your label type is not active. Go back to the profile in DataWedge, find the '''Barcode Input''' section and tap on Decoders. Enable more decoders (perhaps all of them, just in case).
 
−
|-
 
−
| The scanner beeps when reading a barcode, but nothing happens in HandiFox (literally nothing at all).
 
−
|| Double-check the settings of your [[Setting_Up_and_Configuring_Scanner#Creating_a_DataWedge_Profile_.28for_Zebra_Devices.29|HandiFox profile in DataWedge]], '''especially''' the '''Intent Action Name''' {{Info | '''Intent Action Name:''' <big>'''''com.motorolasolutions.emdk.handifox.recvr'''''</big> (no spaces at the beginning or in between characters!)}}. [[File:Dw12.jpg | 250px]]
 
−
|-
 
−
| After scanning an item, its product code gets entered in the search field in HandiFox.
 
−
|| Go back to the HandiFox profile in DataWedge and make sure '''Keystroke Output''' is '''''disabled'''''. <br>
 
−
[[File:Dw9.jpg | 250px]]
 
−
|-
 
−
| When scanning labels, HandiFox always gives the '''''"Cannot find scanned item"''''' message for all your products.
 
−
|| You need to assign correct barcodes to your products in HandiFox. Click [[Barcoding#Assigning_Barcodes|here]] to learn about assigning barcodes in HandiFox
 
−
|}
 
−
{{Gototop}}<br>
 
−
===Bluetooth Scanners===
 
−
 
 
−
==<big>Miscellaneous</big>==
 
−
===Issues assigning device after reinstalling, updating or clearing data up===
 
−
[[File:Assigndevice.gif|thumb|right|Select Site Looping]]<br>
 
−
<br>
 
−
<br>
 
−
 
 
−
<br>
 
−
If you're unable to assign your handheld device after reinstalling or updating the handheld mobile application or clearing its data up and, the synchronization loops, prompting you to assign it to a site/location, you need to assign it to a specific site in HandiFox's Integrated Module. In QuickBooks, go to ''File → HandiFox  → Handheld Device Manager'', mark the checkbox on the left of the device to which you want to assign a site/location and,  click on '''Change Site''' to assign the device to a specific site/location.
 
−
<br><br><br>
 
−
 
 
−
 
 
−
[[File:Notassign.png | 400px | left]]<br><br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
<br>
 
−
{{Warningshort | If the device's not highlighted in red and displays the name of site under the column '''Site''' and, you want to assign/changing it to a different site, the following warning will pop-up  and, you'll need to reinstall the application or clear its data if you proceed with the operation (confirm) in order to continue synchronizing data. See pics bellow}}
 
−
<br>
 
−
[[File:Changesitepopup.PNG | 250px ]] [[File:Reinstallchangesite.PNG |300px ]]
 
−
<br>
 
−
[[File:info-sign.png | 25px ]] We recommend switching sites directly from the handheld device on the '''Synchronization''' screen to avoid having to reinstall the application or clear its data and, losing any unsynchronized data. Click [[Managing_Handheld_Devices#Switching_Sites.2FLocations_on_the_Handheld_Device|here]] to know more about Switching Sites.
 
−
<br>
 
−
<br>
 
−
{{Gototop}}
 
−
<br>
 
−
 
 
−
==How to Launch Task Manager==
 
−
'''Option 1: Keyboard Shortcut (Fastest)'''
 
−
*Press Ctrl + Shift + Esc simultaneously.
 
−
 
 
−
'''Option 2: Ctrl + Alt + Delete Screen'''
 
−
*Press Ctrl + Alt + Delete simultaneously.
 
−
*Select ''Task Manager'' from the menu.
 
−
 
 
−
'''Option 3: Right-Click Taskbar'''
 
−
*Right-click an empty area on the taskbar.
 
−
*Select ''Task Manager'' from the context menu.
 
−
 
 
−
'''Option 4: Start Menu Search'''
 
−
*Click Start or press the Windows key.
 
−
*Type ''Task Manager'' and press Enter or click the app.
 
−
 
 
−
'''Option 5: Run Dialog'''
 
−
*Press Windows key + '''R''' to open the Run dialog.
 
−
*Type ''taskmgr'' and press Enter.
 
−
 
 
−
'''Option 6: Command Prompt or PowerShell'''
 
−
*Open Command Prompt or PowerShell.
 
−
*Type ''taskmgr'' and press Enter.
 
−
<br>
 
−
<br>
 
−
{{Gototop}}
 
−
<br>
 

Revision as of 15:29, 27 August 2025

Troubleshooting
Foxtroubleshooting.png
Having trouble with HandiFox? Don't worry, you are in the right place. This page covers common problems and how to fix them quickly so you can get back to running your business..
Retrieved from "https://help.handifox.com/index.php?title=Troubleshooting&oldid=1778"