Glossary of QuickBooks API Errors

 

These are some of the errors that the Intuit API will give us.

Note - before you look into anything like a connection error, or general error, you can see if Intuit is just *down* here:

http://developer-status.intuit.com/

This probably means a payment method was deleted in QB that we are using. You should not be deleting things in Quickbooks.

Area/Entity Subject/Message Details    
General Unexpected Internal Error. (-30000) An error in the QuickBooks API. Try recreating the document in QuickBooks Web UI and let us know if you can identify the blocking issue.    
Customer Another $$customer$$ is already using this Yes, Quickbooks requires unique names.    
Customer sdk NAME must be unique in QB! name = Yes, Quickbooks requires unique names.    
Invoice Actual Quickbooks Error: There was an error when converting the quantity "1.0" in the field "item quantity". QuickBooks error message: You cannot set the quantity for items of this type. Our QuickBooks integration does not support use of "Discount" type items in inventory due to Intuit's irregular treatment of these items in their integration.

To resolve, you'll need to create a new discount item in Quickbooks, but not assign it the 'Discount Item' category type. Then you will need to resend this to the system (using the 'Resync Quickbooks products and services' button on the Quickbooks settings page) and assign the new item to your discount items in the Inventory tab.
   
Invoice You must fill out at least one split line. We think this means you are using Quickbooks that is NON-USA and not supported by the API that we tried.    
Invoice You must specify a different number. This number has already been used. The invoice number collided with Quickbooks, they require unique numbers.    
Invoice p_validate_txn - unable to find MBL customer REF id = 849630 id They weren't able to find the customer by the ID we sent, it's not currently clear why this only happens intermittently.    
Invoice Business Validation Error: We're sorry, QuickBooks encountered an error while calculating tax. Try reselecting the tax rate or reentering the product/service item and saving the form again. This error can occur for users with a Global Tax Model (not USA) when a Tax Rate is used for an Invoice that does not have a SalesTaxRate. Generally this happens for tax rates defining a PurchaseTaxRate and not both, eg "GST on non-capital"    
Payment Error validating Customer ID:Required field not specified. We're still exploring why this would happen, Quickbooks says we are not sending the customer.    
Payment p_validate_txn - Credit Memo, Charge, Estimate, Invoice, Payment, Sales Order must have a customer reference defined Same as above, they cannot find the customer for some reason.    
Payment One of the list elements assigned to this transaction has been deleted. Before you can modify this transaction, you must restore Check (deleted). This indicates that an item on the invoice has been removed or archived in the Quickbooks account.     
Customers Actual QuickBooks Error: statusCode=3170 statusMessage=There was an error when modifying a Customers list, element "800068EE-1548258840". QuickBooks error message: Cannot merge list elements. This means that there is a duplicate customer record or change was made to the customer. You need to merge the customer records in Quickbooks and then re-map the customer inside RepairShopr.     
Products Actual QuickBooks Error: Invalid Reference Id: Invalid Reference Id : Categories cannot be used in transactions.
Products cannot share the name of a category. Common examples of this are you have a "Labor" category inside Quickbooks and a product in RepairShopr called "Labor".
 
You will need to change either the category name or the product name slightly so they are not a direct match
   
Products Actual QuickBooks Error: A business validation error has occurred while
processing your request: Business Validation Error: You are not allowed to
modify the quantity of an inactive inventory item.
One of your products is mapped to an inactive item. Make sure all products are mapped to an item that is active in Quickbooks    
Purchase orders  PurchaseOrder:
Actual QuickBooks Error: Required param missing, need to supply the required value for the API: Required parameter Line.ItemBasedExpenseLineDetail.ItemRef is missing in the request
 An item in your PO order list is not mapped to a corresponding item in Quickbooks, you need to make sure all of your items are linked to an item in Quickbooks    
General Stale Object Error: QuickBooks version has an unrecognized updated to this resource. This error happens when a object (customer, products, invoices, payments) version instance does not match the version instance number held in RepairShopr. Click "Force Update" to sync up and fix the error.    

Invoice Actual QuickBooks Error: A business validation error has occurred while processing your request: Business Validation Error: We're sorry, QuickBooks encountered an error while calculating tax. Try reselecting the tax rate or reentering the product/service item and saving the This error is saying that for whatever reason, QB had a problem updating the tax line on the invoice. Recommended fix is to wait a minute or so and in RS, click Actions > Resync to QB. It should update the invoice on the QB side.    

 

 

Feedback and Knowledge Base