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's systems are down here:
|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. This probably means a payment method was deleted in QB that we are using. You should not be deleting things in Quickbooks.|
|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
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|
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.|
|Invoice||Actual QuickBooks Error: statusCode=3150 statusMessage=There is a missing element: "TxnID".||If you click Details and it takes you to the Invoices page with the message, "Sorry, invoice was not found - probably deleted," there is nothing more to do and you can ignore the error. Otherwise, It is referring to the tax id, so look into tax rates and make sure the taxes are mapped and active.|
|Varies||Actual QuickBooks Error: statusCode=3070 statusMessage=The string "Really long name" in the field "LastName" is too long. ("LastName" can be different field names.)||The name or description has exceeded the number of characters allowed. Shorten what is in the specific field so that it is within the max number of characters allowed. See Character limitations for fields in QuickBooks for maximum field lengths.|