Difference between revisions of "Troubleshooting"

From HandiFox Desktop Wiki
Jump to navigation Jump to search
 
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Installation Issues ==
+
== <big>Installation</big> ==
+
<br>
 +
{{Gototop}}
 +
<br>
 +
 
 
== QuickBooks Permission Errors ==
 
== QuickBooks Permission Errors ==
 
[[File:QBpermerror.PNG | left | 500px]]<br>
 
[[File:QBpermerror.PNG | left | 500px]]<br>
It is strongly recommended logging into QuickBooks as "Admin" or a user that has Admin-like permissions. If you encounter a warning displaying Failed to get .... Insufficient permission level to perform this action, it means the user currently logged-in user lacks some of the minimum permissions required by QuickBooks to access data necessary for the proper functioning of HandiFox.
+
It is strongly recommended to log into QuickBooks as "Admin" or a user with Admin-like permissions. If you encounter a warning displaying ''Failed to get .... Insufficient permission level to perform this action'', it means the currently logged-in user lacks some of the minimum permissions required by QuickBooks to access data necessary for the proper functioning of HandiFox.
 
Fixing this issue requires the Admin to grant read or full permissions to any user who logs in to QuickBooks on the computer on which HandiFox is installed. Granting new permissions can be done via ''Company →  Users → Set  Up Users and Roles...'' Below is a summary of the minimum permissions a QuickBooks user should have to ensure the proper functioning of HandiFox.<br>
 
Fixing this issue requires the Admin to grant read or full permissions to any user who logs in to QuickBooks on the computer on which HandiFox is installed. Granting new permissions can be done via ''Company →  Users → Set  Up Users and Roles...'' 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>
Line 15: Line 20:
 
<br>
 
<br>
 
=== List of Permissions ===
 
=== List of Permissions ===
{|style="border-style: solid; border-width: 10px 10px 10px 10px"; class="wikitable"
+
{|class="wikitable" style="border-style: solid; border-width: 10px 10px 10px 10px; display: inline-table";  
 +
|+
 
|-  
 
|-  
! Area !! Activities !! Access Level
+
! Area !! Activities !! Access Level
|- style="font-style: italic; color: green;"
+
|- style="font-style: italic; color: green; text-align:left;"
| '''ACCOUNTING''' ||  ||
+
| scope="row" colspan="3" | '''ACCOUNTING'''  
 
|-
 
|-
| || General Journal ||  style="text-align:center;" | VIEW
+
| scope="row" colspan="2" style="text-align:right;" | General Journal ||  style="text-align:center;" | VIEW
|- style="font-style: italic; color: green;"
+
|-style="font-style: italic; color: green; text-align:left;"
| '''BANKING''' ||  ||
+
| scope="row" colspan="3" |'''BANKING'''  
 
|-
 
|-
| || Checks || style="text-align:center;" | VIEW
+
| scope="row" colspan="2" style="text-align:right;" | Checks || style="text-align:center;" | VIEW
 
|-
 
|-
|| Credit card charges  || 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;"
+
|- style="font-style: italic; color: green; text-align:left;"
|'''CENTERS''' ||  ||
+
| scope="row" colspan="3" | '''CENTERS'''  
 
|-
 
|-
||Customer center || style="text-align:center;" | FULL
+
scope="row" colspan="2" style="text-align:right;" | Customer center || style="text-align:center;" | FULL
 
|-
 
|-
|| Vendor 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;"
+
|- style="font-style: italic; color: green; text-align:left;"
| '''CUSTOMERS & RECEIVABLES''' ||  ||
+
| scope="row" colspan="3" |'''CUSTOMERS & RECEIVABLES'''  
 
|-
 
|-
| || Credit card refunds || style="text-align:center;" | VIEW
+
| scope="row" colspan="2" style="text-align:right;" | Credit card refunds || style="text-align:center;" | VIEW
 
|-
 
|-
|| Credit Memos || style="text-align:center;" | FULL
+
scope="row" colspan="2" style="text-align:right;" | Credit Memos || style="text-align:center;" | FULL
 
|-
 
|-
|| Invoices || style="text-align:center;" | FULL
+
scope="row" colspan="2" style="text-align:right;" | Invoices || style="text-align:center;" | FULL
 
|-
 
|-
|| Receive Payments || style="text-align:center;" | FULL
+
scope="row" colspan="2" style="text-align:right;" | Receive Payments || style="text-align:center;" | FULL
 
|-
 
|-
|| Sales Orders || style="text-align:center;" | FULL
+
scope="row" colspan="2" style="text-align:right;" | Sales Orders || style="text-align:center;" | FULL
 
|-
 
|-
|| Sales Receipts || style="text-align:center;" | FULL
+
scope="row" colspan="2" style="text-align:right;" | Sales Receipts || style="text-align:center;" | FULL
 
|-
 
|-
|| Statement Charges || style="text-align:center;" | VIEW
+
scope="row" colspan="2" style="text-align:right;" | Statement Charges || style="text-align:center;" | VIEW
|- style="font-style: italic; color: green;"
+
|}
| '''LISTS''' || ||
+
{|class="wikitable" style="border-style: solid; border-width: 10px 10px 10px 10px; display: inline-table";
 +
|+
 
|-
 
|-
| || Chart of Accounts || style="text-align:center;" | VIEW (without balances)
+
! Area !! Activities !! Access Level
 +
|- style="font-style: italic; color: green; text-align:left;"
 +
| scope="row" colspan="3" |'''LISTS'''
 
|-
 
|-
|  || Customer & Vendor Profile:  
+
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  
 
* Sales Rep List  
 
* Terms List  
 
* Terms List  
Line 62: Line 73:
 
*VIEW
 
*VIEW
 
|-  
 
|-  
|| Inventory Site List || style="text-align:center;" | FULL  
+
scope="row" colspan="2" style="text-align:right;" | Inventory Site List || style="text-align:center;" | FULL  
 
|-
 
|-
|| Item List || style="text-align:center;" | FULL  
+
scope="row" colspan="2" style="text-align:right;" | Item List || style="text-align:center;" | FULL  
 
|-
 
|-
| || Other Names List  || style="text-align:center;" | VIEW  
+
| scope="row" colspan="2" style="text-align:right;" | Other Names List  || style="text-align:center;" | VIEW  
 
|-
 
|-
|| Price Level List || style="text-align:center;" | VIEW  
+
scope="row" colspan="2" style="text-align:right;" | Price Level List || style="text-align:center;" | VIEW  
 
|-
 
|-
|| Price Rule 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;"
+
|- style="font-style: italic; color: green; text-align:left;"
| '''SALES TAX''' ||  ||
+
| scope="row" colspan="3" |'''SALES TAX'''  
 
|-
 
|-
|| Sales Tax Code List || style="text-align:center;" | VIEW
+
scope="row" colspan="2" style="text-align:right;" | Sales Tax Code List || style="text-align:center;" | VIEW
|- style="font-style: italic; color: green;"
+
|- style="font-style: italic; color: green; text-align:left;"
| '''VENDORS & PAYABLES''' ||  ||
+
| scope="row" colspan="3" | '''VENDORS & PAYABLES'''  
 
|-
 
|-
| || Adjust Quantity on Hand || style="text-align:center;" | FULL
+
| scope="row" colspan="2" style="text-align:right;" | Adjust Quantity on Hand || style="text-align:center;" | FULL
 
|-
 
|-
| || Build Assemblies || 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>
 +
{{Gototop}}
 +
<br>
 +
 
 +
== <big>Handheld Synchronization</big> ==
 +
<br>
 +
{{Gototop}}
 +
<br>
 +
 
 +
== <big>Scanning</big> ==
 +
<br>
 +
 
 +
=== Zebra Scanners ===
 +
==== Scanner not finding/locating items after reinstalling, updating or clearing the mobile app's data ====
 +
[[File:Dw14.jpg | right | 250px]]
 +
''"I reinstalled/updated the mobile application or cleared the mobile application's data, and now the scanner won't locate or pick any items up"''<br>
 +
 
 +
Assuming you didn't delete your [[Setting_Up_and_Configuring_Scanner#Creating_a_DataWedge_Profile_.28for_Zebra_Devices.29|HandiFox DataWedge Profile]], all you need to do is "re-enable" your DataWedge profile.<br>
 +
 
 +
Simply go to '''''Admin → Settings → Select scanner''''', Make sure it says '''DataWedge''' in the input field to the left of the '''Scan Bluetooth''' button, Tap '''''Save'''''.
 +
[[Setting_Up_and_Configuring_Scanner#Testing_Scanner|Test]] you scanner again.
 +
 
 +
<br>
 +
<br>
 +
<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.
 
|-
 
|-
| || Enter Bills || style="text-align:center;" | VIEW
+
| 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).
 
|-
 
|-
| || Item Receipts || style="text-align:center;" | FULL
+
| 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]]
 
|-
 
|-
| || Purchase Orders || style="text-align:center;" | FULL
+
| 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]]
 
|-
 
|-
| || Transfer Inventory || style="text-align:center;" | FULL
+
| 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
 
|}
 
|}
[[Troubleshooting|Go back to the top]]
+
{{Gototop}}<br>
  
== Handheld Synchronization Issues ==
+
== <big>Miscellaneous</big> ==
 
+
===Issues assigning device after reinstalling, updating or clearing data up===
== Scanning Issues ==
+
[[File:Assigndevice.gif|thumb|right|Select Site Looping]]<br>
 
+
<br>
== Miscellaneous ==
+
<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>
 +
{{Warning | 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.<br>
 +
[[File:Changesitepopup.PNG | 250px ]]<br>
 +
[[File:Reinstallchangesite.PNG |300px ]]<br>
 +
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>

Latest revision as of 01:44, 22 April 2023

Installation


[Back to top]


QuickBooks Permission Errors

QBpermerror.PNG


It is strongly recommended to log into QuickBooks as "Admin" or a user with Admin-like permissions. If you encounter a warning displaying Failed to get .... Insufficient permission level to perform this action, it means the currently logged-in user lacks some of the minimum permissions required by QuickBooks to access data necessary for the proper functioning of HandiFox. Fixing this issue requires the Admin to grant read or full permissions to any user who logs in to QuickBooks on the computer on which HandiFox is installed. Granting new permissions can be done via Company → Users → Set Up Users and Roles... Below is a summary of the minimum permissions a QuickBooks user should have to ensure the proper functioning of HandiFox.











List of Permissions

Area Activities Access Level
ACCOUNTING
General Journal VIEW
BANKING
Checks VIEW
Credit card charges VIEW
CENTERS
Customer center FULL
Vendor center FULL
CUSTOMERS & RECEIVABLES
Credit card refunds VIEW
Credit Memos FULL
Invoices FULL
Receive Payments FULL
Sales Orders FULL
Sales Receipts FULL
Statement Charges VIEW
Area Activities Access Level
LISTS
Chart of Accounts VIEW (without balances)
Customer & Vendor Profile:
  • Sales Rep List
  • Terms List
  • VIEW
  • VIEW
Inventory Site List FULL
Item List FULL
Other Names List VIEW
Price Level List VIEW
Price Rule List VIEW
SALES TAX
Sales Tax Code List VIEW
VENDORS & PAYABLES
Adjust Quantity on Hand FULL
Build Assemblies FULL
Enter Bills VIEW
Item Receipts FULL
Purchase Orders FULL
Transfer Inventory FULL


[Back to top]


Handheld Synchronization


[Back to top]


Scanning


Zebra Scanners

Scanner not finding/locating items after reinstalling, updating or clearing the mobile app's data

Dw14.jpg

"I reinstalled/updated the mobile application or cleared the mobile application's data, and now the scanner won't locate or pick any items up"

Assuming you didn't delete your HandiFox DataWedge Profile, all you need to do is "re-enable" your DataWedge profile.

Simply go to Admin → Settings → Select scanner, Make sure it says DataWedge in the input field to the left of the Scan Bluetooth button, Tap Save. Test you scanner again.









[Back to top]


Known problems that may arise when testing if your scanner works in HandiFox

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 HandiFox profile in DataWedge, especially the Intent Action Name
Info-sign.png Intent Action Name: com.motorolasolutions.emdk.handifox.recvr (no spaces at the beginning or in between characters!)
. Dw12.jpg
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.

Dw9.jpg

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 here to learn about assigning barcodes in HandiFox
[Back to top]


Miscellaneous

Issues assigning device after reinstalling, updating or clearing data up

Select Site Looping





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.



Notassign.png














Warning-sign.png 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.

Changesitepopup.PNG
Reinstallchangesite.PNG

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 here to know more about Switching Sites.