QuickBooks Errors and Solutions: A Comprehensive Guide

QuickBooks Errors and Solutions: A Comprehensive Guide

Overview

Here are a list of errors that you may have encountered, which have solutions that we provided in order to guide you to fixing them.

No Buyer Details Provided

The "No Buyer Details Provided" error typically occurs when a user is trying to create or save a transaction (like an invoice or sales receipt) and the system expects buyer or customer details, but they are either missing or incomplete. 

Preliminary Steps

Gather Client Information

VAT Registered Clients: If the client is VAT registered, enter the following details:
  1. Registered Name: The official name of the client/business.
  2. TIN (Taxpayer Identification Number): The unique tax identification number assigned to the client.
  3. VAT Number: The VAT number issued to the client.
Non-VAT Registered Clients: If the client is not VAT registered, enter "CASH SALE" as the name of the client/buyer. Below are the steps to create a cash sale account.

Solution

Step 1. 

  1. Click “Customers” on the toolbar in QuickBooks.
  2. Click “Customer Centre” button.


Step 2.

  1. Click and Select “New Customer” to add a new client 
  2. Type in “Cash Sale” as the client’s name
  3. Click "Save" to save the customer profile.

Info
Note: After the cash sale account is created, go to the fiscal harmony application and retry to process the invoice again

FISCAL HARMONY APP NOT RESPONDING

Why the app may not be responding

  1. Lost connection between the Fiscal Harmony API keys and QuickBooks.
  2. Fiscal Harmony application certificates may not be installed or running in the QuickBooks background.

SOLUTION

Step 1.

  1. Close the QuickBooks application if it is open.
  2. Sign in as an administrator on your computer.
  3. Open the Fiscal Harmony plugin as administrator.

Step 2.

Try processing the invoices again to restore the connection and complete the task. This should help resolve the issue regarding the failed connection between Fiscal Harmony and QuickBooks.
Attempt to process an invoice or credit note, from the Fiscal Harmony Application.

How to put HS-Codes in QuickBooks

HS codes, also known as Harmonised System Codes, are standardized numerical codes used to classify products in international trade. They are unique codes that identify and describe a product or service. 

To implement HS-Codes in QuickBooks, go to this article: How to Add HS Codes in QuickBooks

"Object reference not set to an instance of an object" Error



Cause of error message on the Fiscal Harmony App log

The inserted HS Code characters on the product/service may be less or more than the required. HS Codes normally contain 8 characters. 
Info
Note: HS Codes are unique identifiers that describe/ locates the product or service.

SOLUTION 1 

  1. Launch QuickBooks and log in to your account if you have not already done so.
  2. Navigate to the "List" Menu.
  3. Select "Item List": From the drop-down menu under "List" click on "Item List". This will take you to a list of all products and services that are set up in QuickBooks .
  4. In the Item List, scroll through the list or search for the specific product or service to which you want to add or update the HS Code.
  5. In the item details window, look for the "Custom Fields" button. This button allows you to add additional information to the item. 
  6. Click on the "Custom Fields" button to open the custom fields settings. Click "Define Fields" and type HS CODE. 
  7. Once you locate the HS CODE field, input the correct HS CODE string for the item or service. 
  8. After entering the correct HS CODE, click "OK" or "Save" to apply and save the changes to the item or service. 
  9. After updating the HS CODE in QuickBooks, go back to the Fiscal Harmony plugin. 
  10. Retry the Invoice: Now that the HS CODE has been added or updated, try to generate or process the invoice again in the Fiscal Harmony plugin. 

SOLUTION 2

Step 1.

  1. From the drop-down menu under "List," click on "Item List". This will take you to a list of all products and services that are set up in QuickBooks 
  2. In the Item List, scroll through the list or search for the specific product or service to which you want to add or update the HS CODE.
  3. In the item details window, look for the "Custom Fields" button. This button allows you to add additional information to the item.

Step 2.

  1. Click on the "Custom Fields" button to open the custom fields settings. Click "Define Fields" and type HS CODE.


Step 3.

  1. In this stage the message box tells the user that QuickBooks is in Multi-user mode, kindly switch to "SINGLE USER MODE" and try to process the invoice again  

"Not Found" Error

The error message indicates that something is "Not Found" during the update process, which might suggest that either a file is missing, an incorrect path was used, or there was a server issue while trying to fetch the update.

How to locate the error

Navigate to C:\ProgramData\FiscalHarmony\QuickBooksPlugin\Log\Error on your computer.

 

Cause of error 

This is caused by Internet Connectivity Problems, where your computer may not have a stable or active internet connection.

Solution

  1. Close the QuickBooks application if it is open.
  2. Sign in as an administrator on your computer.
  3. Open the Fiscal Harmony application as an administrator.

"One or more errors occurred" Error

What causes this error?

This error also occurs when QuickBooks is trying to process an invoice that lacks critical information. The error in QuickBooks is triggered by missing essential elements in an invoice and in particular, missing quantities, item descriptions, or unit prices.  Another cause of the issue is loss of internet connectivity 


Solution for missing essential items

Step 1.

  1. Crosscheck every item listed on the invoice, ensuring you have specified the quantity. If it is a service rather than a product, check that the quantity field is populated (even if it is just "1" for a service rendered). 
  2. Further make sure that for every item listed on the invoice, you have specified the description of the product. If it's a service rather than a product, check that the description field is populated. 
  3. Make sure that the unit price is entered for every item or service on the invoice. This can either be manually entered or pulled from the product/service list in QuickBooks if the item is set up with a predefined price. 

Step 2.

  1. Click "Save" in QuickBooks, you're saving the invoice or transaction you are working on.
  2. Return to the Fiscal Harmony plugin, click "Retry" button in the app to attempt to process the invoice again after QuickBooks has been updated. 
Info
Note: This step ensures that any changes or updates made to the invoice (after you click “Save” in QuickBooks) are reflected in the Fiscal Harmony plugin.

Solution for internet connection error

Step 1. Check Internet Connectivity

  1. Ensure that your device is connected to the internet. You can do this by checking if other apps or websites are working.
  2. You can also check your device’s network settings to confirm it is connected to the right network.

Step 2. Retry in the Fiscal Harmony plugin.

  1. Open the Fiscal Harmony plugin and try to click the “Retry” button, wait a few minutes and try again.
  2. Check "Log" or "Error" button, check it for more details about why the issue occurred.


For further assistance, reach out to our support team:
Call Centre: +263 8677 010 305
WhatsApp: +263 783 323 154



    • Related Articles

    • QuickBooks and Fiscal Harmony Integration Guide

      Overview This guide provides a step-by-step process for integrating QuickBooks with the Fiscal Harmony plugin, facilitating the fiscalization of invoices and credit notes for compliance with the Zimbabwe Revenue Authority (ZIMRA). Step 1. Downloading ...

    • QuickBooks Online and Fiscal Harmony Integration Guide

      Overview Steps to Access and Set Up API Keys in Fiscal Harmony Step 1. Log in to the Fiscal Harmony app on https://app.fiscalharmony.co.zw/. Once logged in, navigate to Settings > API keys. Create an API Key if you do not have one, making sure to ...

    • How to add HS Codes in QUICKBOOKS

      What are HS-Codes ? HS codes, also known as Harmonized System Codes, are standardized numerical codes used to classify products in international trade. They are unique codes that identify and describe a product or service. How to implement HS Codess ...

    • Buyer Details Verification Guide

      This Buyer Details Verification Guide walks you through a simple, step-by-step process to confirm important buyer information. It shares practical tips, useful tools, and key compliance points to help businesses set up a smooth, secure verification ...

    • MS Excel and Fiscal Harmony Integration Guide

      Overview This guide explains how to install and configure fiscalisation in Microsoft Excel using the Fiscal Harmony software. It walks you through downloading the required files, installing the necessary tools, and setting up the integration so that ...