This article provides a brief idea of the errors that you might experience with Xero integration. For details on how to check the error log, please refer to
How to Manage QuickBooks - Error Log.
This article explains the errors, their causes, and solutions. You can use this as a troubleshooting reference. If the error you are experiencing is not included or you have tried the mentioned solutions but they didn't work, please contact our support team on chat.
Error: System Out Of Memory Exception
You may encounter this error when you are trying to sync sales invoice, purchase order, customer profiles, sales transactions and supplier.
Cause: This error occurs when the QuickBooks API is down at the time of triggering.
Solution: We recommend you check if there is any active process running on.
To check these running active processes please navigate to Integrations --> Sync Process Log and untick the option 'Errors only'.
If there is no active process running, please navigate to the page you are facing and click on Sync now to check how it works.
Error: No payment method found against HikePOS payment option, Please map payment method of QuickBooks!
You may encounter this error when you are trying to sync sales invoices or register closure to QuickBooks.
Cause: The payment used in the invoice has not been mapped with an account in QuickBooks. It might happen when you add a new payment type after the Hike-QuickBooks integration is set up.
Please map the payment options with the QuickBooks account mapping.
Error: Business Validation Error: Enter a transaction amount that is 0 or greater
Cause: This error means the sale amount is in negative and this will not allowed to sync to QuickBooks. This is a validation error from QuickBooks and we at Hike cannot do anything to sync this sale.
The negative amount sales are not supported in QuickBooks.
Solution: There is no solution for this error. These sales cannot be synced to QuickBooks.
Error: Products Not Allowed.
You may encounter this error on the product page, sales history or purchase orders when you are trying to sync products which are not synced to QuickBooks.
Cause: The products are not allowed to sync or sell. There're two commonly seen scenarios.
Scenario 1: The products or the products in the invoice are not allowed to sync from Hike to QuickBooks. If you want to sync each individual invoice from Hike to QuickBooks, you will have to sync products from Hike to QuickBooks or in both ways.
Troubleshoot: Please
check the sync settings of Hike-QuickBooks integration. Have you disabled the sync of products between Hike and QuickBooks or only allow products syncing from QuickBooks to Hike?
Scenario2: The product included in the invoice is not active in QuickBooks.
Troubleshoot: Please check if the product is active in QuickBooks.
Solution: Please search for the product in QuickBooks and make sure it's active.
Error: Required Tax mapping
The error may occur to products and invoices, including register summaries.
Cause: The tax assigned to the product or included in the invoice is not mapped properly between Hike and QuickBooks. It might happen when you create a new tax rule after the integration between Hike and QuickBooks has been set up.
Troubleshoot: Please
check the sync settings to see whether all the tax rules in Hike have been mapped with taxes in QuickBooks.
NOTE: Please note that before making any changes in QuickBooks we strongly recommend seeking the advice of your accountant in order to make any changes.
Solution: Please map all the tax rules. Then you can
click on sync now for the invoices or products that failed to sync.
Error: Invalid account type: For an inventory product, the inventory asset account must have an Account type
The error may happen to products and invoices.
Cause: The inventory account mapped in the sync settings is not under the proper account type in QuickBooks
NOTE: Please note that before making any changes in QuickBooks we strongly recommend seeking the advice of your accountant in order to make any changes.
To check the validity of the account, please navigate to the QuickBooks platform and check for the chart of accounts.
After navigating to the chart of accounts please search for the account which was listed as an Inventory asset account.
Now, you need to change the account types as mentioned in the error. The correct Account Type should be "Current Asset" and Detailed type should be "Inventory"
Please make sure that the account type is set to Current Asset and the Detailed type is Inventory. Otherwise, please create another account
After creating this account type. Please navigate to the Hike platform and the newly created account should appear in the Inventory asset account drop-down.
Please select the correct account type. After selecting the account. Please navigate to the products page --> check for the product and press
Sync Now, as it triggers a
sync.
After the product has been synced, please navigate to Sales History --> check for the sale and
Sync Now and you will see that the sale is also synced to QuickBooks.
Error: Invalid Reference Id: Accounts element id not found
This error may occur when you are trying to sync products or sale associated with the product.
If it happens for an invoice, please click on the sale and check whether all the products are synced properly.
If a product associated with the sale is not syncing, please click on the product and open the product.
Please check the below mentioned codes are valid or not.
To check the validity you must navigate to the QuickBooks platform and check whether the sales code and purchase code associated with the product are correct.
NOTE: We recommend contacting your accountant before making any changes to your QuickBooks account.
You can check the sales and purchase codes and update them accordingly. Alternatively, you can also remove these codes keeping both these fields blank and the sales and purchases associated with it go to your default accounts defined in the integration settings.
After making necessary changes please save the product and you can check whether the product has synced to QuickBooks.
After performing these changes in the product please navigate to sales history and click on
Sync now for the sale. The sale should sync to QuickBooks.
If the problem still persists, please email us your enquiry at helpdesk@hikeup.com
Error: Business validation error. You
are not allowed to modify the quantity of an inactive inventory item.You may encounter this error when you are trying to sync
invoices. There might be an issue with the product which is associated with
your invoice in QuickBooks.
Cause: When the product/s associated with the invoice are inactive in QuickBooks.
Troubleshoot:
Search the product by using the product name or SKU in QuickBooks under
‘Products and Services'. If you cannot find the products under the ‘active’
products change the status filter to ‘Inactive’ and check if the product is there.
Solution: Make this product active in QuickBooks and update the stock with the
correct quantity (because QuickBooks updates the stock to 0 when you make these products active again) in QuickBooks and perform
a manual
data sync for the products and failed invoices.
Error: Could not found the product.
Maybe it's deleted.
You may encounter this error when you are trying to sync
invoices. There might be an issue with the product deletion and re-creation
which is associated with your invoice in Hike.
Cause: You might have deleted the product from Hike and re-created it with the same or a different SKU but, didn't perform 'Refresh Data' in your store before processing sales for this newly created product. This is why the invoice gets mapped with the old product id which is now deleted.
Troubleshoot: In Hike, check both the product creation date and the invoice date under ‘Products->
Select the product -> Product History -> View Product History’ and ‘Sales
History -> Select the sale -> Sales History’ respectively. You will see that the invoice was created before the product.
Solution: Refund
the particular invoice and perform a ‘Refresh Data’ on the cash register screen
and re-create the sale.
Note: Hike always recommends performing a 'Refresh Data' in your store when you delete or create a product.
Error: Business validation error. Not
a valid product or service name. Names must have at least one character and
cannot include tabs, newlines or '.'.
product or service
You may encounter this error when you are trying to sync products.
There might be an issue with the product name which you have recently created/updated.
Cause: When the product name + variant name (if you have any variants for this product) consists of special characters like ‘:’, tabs, newlines, etc. or the product
name length exceeds the maximum limit allowed by QuickBooks (21 characters).
Troubleshoot: Check if the product name + variant name (if you have any variants for this product) have any special characters like ’:’, tabs, newlines, etc. Also, make sure that the product name doesn't exceed the maximum character length allowed by QuickBooks (21 characters).
Solution: Remove any special characters
like ’:’, tabs, newlines from the product name or shorten the name to be less than or equal to 21 characters and save the product in Hike. After that
perform a manual data sync for the product.
Error: Duplicate
customer is not allowed in HikePOS! Already HikePOS
customer Id() is mapped with QuickBooks customer Id().
You may encounter this error when you are trying to sync
customers from QuickBooks. You might have some duplicate customers’ email
addresses in QuickBooks.
Cause: When you
sync the customer from QuickBooks -> Hike or Hike -> QuickBooks, one QuickBooks customer’s account gets successfully mapped with the one in Hike and the rest duplicate accounts that have the same email addresses fail to sync. This is because Hike doesn’t allow you to have the same email
address for multiple customers. Email addresses have to be unique in Hike.
Troubleshoot: Go
to the QuickBooks error log and check the failed entry and if that customer’s email address is linked with multiple customers accounts in
QuickBooks.
Solution: Use a unique
email address for each customer in QuickBooks.
Error: String length specified does
not match the supported length. Min 0 Max 21 supported. Supplied length: ‘Length
of your PO number’
You may encounter this error when you are trying to sync purchase
orders. There might be an issue with the purchase order number.
Cause: The purchase
order number length exceeds 21 characters (the maximum limit supported by QuickBooks).
Troubleshoot: Check whether the purchase order number length exceeds 21 characters in Hike.
Solution: Rename the purchase order if it hasn’t been
sent yet (because Hike doesn’t support renaming a PO after it has been sent to the supplier) and perform a manual data sync for the purchase order/s. Alternatively, if the purchase order is already
sent/received, then delete the purchase order and re-create it Hike ensuring that the PO number doesn't exceed the 21 characters limit.
Error: Unauthorized-401
You may encounter this error when you are trying to sync
Hike data to QuickBooks. You might have an authorisation issue with your
integration.
Cause: When you
have an authorisation issue with your QuickBooks integration.
Troubleshoot: Check
with your accountant whether he/she has deleted the account which was used for the Hike - QuickBooks integration or changed permissions of this account.
Solution: Check
both Hike and QuickBooks whether there is any data discrepancy/inconsistency between the 2 platforms. If everything seems correct and no data has been lost, re-integrate the QuickBooks Online account in your Hike store. We strongly recommend contacting the Hike Support Team to get technical help before proceeding with the re-integration.
Error: Invalid account type: For an
inventory product, the expense account must have Account Type: 'Cost of Sales'
and Detail Type: 'Supplies and Materials.'
You may encounter this error when you are trying to sync products
from Hike to QuickBooks. You might have an issue with the ‘QuickBooks Purchase
code’ in your Hike store.
Cause: When you
use wrong ‘QuickBooks Purchase code’ for that particular product in Hike. It
means the ‘QuickBooks Purchase code’ which you entered under the product is not
a proper account to record the cost of goods of an inventory product in
QuickBooks.
Troubleshoot: Go
to ‘Products’ and find that product in your Hike store. Then check whether the ‘QuickBooks
Purchase code’ which you have entered has a proper ‘Cost of Goods’ account in QuickBooks.
Solution: Go to
‘Products’ and find that product in your Hike store. Then change the 'QuickBooks Purchase Code' to the account ID of a proper QuickBooks’ ‘Cost
of Goods’ account. Click on the 'Save' button to save changes and perform
a manual data sync for the product.
Error: Transactions with inventory (QOH)
products cant be dated earlier than the Inventory Start Date for the product
You may encounter this error when you are trying to sync invoices
from Hike to QuickBooks. You might have an issue with the ‘As of date’ of your
product in QuickBooks.
Cause: When a product associated with the failed invoice has a future ‘As of date’
in QuickBooks.
Troubleshoot: Go
to your QuickBooks account and check the product/s associated with your failed invoice and
check whether the product has a future ‘As of date’ or a date after the invoice date. To check ‘As of date’ in QuickBooks, Go to Products and Services -> select the
product -> click edit -> click Starting value. You will see the ‘As of
date’ of the product in QuickBooks.
Solution: Change
the ‘As of date’ to the invoice date or earlier date and save the changes in
QuickBooks. Perform a manual data sync for the invoices in Hike. Error: Duplication of product (Test Product
4-10056) in HikePOS! Already HikePOS product Test Product 4 Id(71) is mapped
with QuickBooks product Id(63).
You may encounter this error when you are trying to sync
products from QuickBooks. You might have some duplicate products in Hike.
Cause: When you
sync the products from QuickBooks to Hike or Hike to QuickBooks, one of the QuickBooks product gets successfully mapped with the one in Hike and the rest of the duplicate products that have the same name fail to sync.
Troubleshoot: Go
to the QuickBooks error log in to your Hike store and check the failed entry. Check whether the same product name is used for multiple products.
Solution: Use a unique product name for each product in Hike while using the QuickBooks and
Hike integration.