We can't find the internet
Attempting to reconnect
Something went wrong!
Hang in there while we get back on track
QuickBooks Desktop error codes
Every statusCode QuickBooks Desktop can put on a qbXML response and every error the Web Connector reports, with the message each one sends. Where we have seen a code from a real company file, its page says what caused it and what fixed it.
Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).
Errors
QuickBooks refused the request. Nothing was saved.
- 1000 There has been an internal error when processing the request.
- 1001 There has been an internal error. …
- 1010 System not available
- 1030 This QuickBooks does not support the request.
- 1060 The request ID … is invalid, possibly too long, max 50 chars.
- 2000 Signon failed. QuickBooks error message: …
- 2010 Not authorized to access the server.
- 3000 A ListID or TxnID in the request is not a valid id at all; the message names the field.
- 3010 There was an error when converting the boolean value … in the field ….
- 3020 There was an error when converting the date value … in the field …. …
- 3030 Invalid date range: From date is greater than To date. …
- 3031 The "From" or "To" values in the provided … are invalid.
- 3035 There was an error when converting the time interval … in the field …. …
- 3040 QuickBooks couldn't read an amount: it was written without its two decimals, such as 40 for 40.00, which the qbXML schema allows and QuickBooks doesn't. The message names the value and the field.
- 3045 There was an error when converting the price … in the field …. …
- 3050 There was an error when converting the percent … in the field …. …
- 3060 There was an error when converting the quantity … in the field …. …
- 3065 There was an error when converting the GUID value … in the field …. …
- 3070 A text value is longer than QuickBooks allows for that field; the message names the field.
- 3080 The string … is invalid.
- 3085 There was an error when converting the number … in the field ….
- 3090 There was an error when storing … in the … field. …
- 3100 The name is already used by a customer, vendor, employee or other name.
- 3101 Multiplying the rate and the quantity results in an amount that exceeds the maximum allowable amount.
- 3102 The name … of the list element is already deleted.
- 3110 The enumerated value … in the field … is unknown or invalid for the qbXML version in use.
- 3120 The request named a record by its ListID or TxnID, and the company file has no such record.
- 3121 Data Extension Definitions specified by OwnerID … not found for this object type.
- 3130 There is an invalid reference to a parent … in the … list. …
- 3140 A reference names a record the company file does not have; the message says which list (Account, Item, Customer...).
- 3150 QuickBooks requires an element the request left out; the message names it.
- 3151 Cannot use the element … in this request.
- 3152 The enumerated value … may not be used in the element … in this request.
- 3153 The specified parameters conflict with each other. …
- 3160 QuickBooks refused to delete the record.
- 3161 The transaction is dated on or before the company's closing date, which is password-protected.
- 3162 This operation is not allowed in multi-user mode.
- 3170 QuickBooks refused to save the change to an existing record.
- 3171 The transaction is dated on or before the company's closing date, which is password-protected.
- 3172 An attempt was made to modify a … with a date that is on or before the last inventory cleanup process date. …
- 3173 The related … transaction object … was deleted or modified.
- 3175 The record is in use, so it cannot be added, changed or deleted right now.
- 3176 Someone has the record open in QuickBooks, or QuickBooks is in a single-user mode (such as the Adjust Quantity/Value on Hand window) that blocks changes.
- 3177 The transaction object … may only be provided once in this request.
- 3180 QuickBooks refused to save the new record; the text after 'QuickBooks error message:' says why.
- 3181 Could not add … to the list … because the list contains the maximum number of items. To find the list limits for your version of QuickBooks, search QuickBooks Help for "Maximum numbers of list items".
- 3185 Cannot void the object specified by the id = …. …
- 3190 Cannot clear the element in the … field. …
- 3200 The EditSequence sent is not the record's current one: the record changed in QuickBooks after you read it.
- 3205 There was an error when composing an address in …. …
- 3210 A field's value is not one QuickBooks accepts; the message names the field and the value.
- 3220 QuickBooks refused the request: no permission for it, or the feature is turned off in this company file.
- 3230 The request has been rolled-back.
- 3231 QuickBooks didn't run this request: an earlier request in the batch failed under stopOnError, or, for a request sent alone, the company file doesn't allow it.
- 3240 Object … specified in the request cannot be found. …
- 3250 The feature is turned off in this company file, or this edition of QuickBooks does not have it.
- 3260 The permission level QuickBooks granted does not allow this action.
- 3261 The application isn't allowed to read or write personal data in this company file.
- 3262 The request needs the company file to be subscribed to Intuit's payroll service.
- 3263 The application has read-only access to this company file, so it cannot add or change records.
- 3264 The request needs the company file to be subscribed to QuickBooks Merchant Account Services.
- 3270 QuickBooks needs an account to post this to, and none was given or defaulted.
- 3280 The item … cannot be used in this line item. It does not have a correct type.
- 3290 The item … is placed in the request in incorrect order.
- 3300 Could not open the requested … form or window.
- 3301 Cannot perform this request unless an interactive QuickBooks user is logged in.
- 3310 Failed to save the Time Tracking transaction. The employee … provided in the TimeTrackingAdd request has the checkbox "Use time data to create paychecks" set to the Unknown state. Have your application ask the user whether or not to set time tracking for this employee. Then issue an EmployeeMod request to set this option to either UseTimeData or DoNotUseTimeData. If UseTimeData, activities will be transferred to paychecks.
- 3320 The required report could not be generated.
- 3330 Cannot use the value … in the … field in this request.
- 3340 This request cannot be processed from within a data event callback procedure.
- 3350 Unable to define a new public data extension; the list of public extension definitions is full. …
- 3351 The value or values provided for AssignToObject or RemoveFromObject may not be used for public data extension requests.
- 3352 The data extension named … was previously defined with a different, incompatible AssignToObject. Unable to use the AssignToObject type in this request.
- 3360 The callback application cannot be found from the CLSID or ProgID provided in the subscription request.
- 3370 QuickBooks does not have enough components on hand to build this assembly item.
- 3380 This request requires QuickBooks 2006 or later and an updated version of QBXMLRP2.
- 3390 You have exceeded the maximum number of open iterators for this session. Please close some iterators before attempting to start a new one.
- 3391 The iteratorID … is not valid.
- 3392 The iteratorID … is not valid for this type of query request.
- 3400 Invalid credit card number: credit card number should be masked with 'x's except for the last 4 digits (for example, "xxxxxxxxxxxx1234").
- 3401 …
- 3410 An attempt was made to modify the … account(s) for … list. This modification would affect the existing transactions of the company. If you are sure you really want to do this, please ask a user with Admin privileges to remove the password for the closing date (this setting is in the Accounting Company Preferences), then try again.
- 3411 ….
- 3412 Customer has an overdue transaction.
- 3500 Merge not allowed from object with id =… to object with id =…. …
- 3510 An error occured while executing QBCommand …. Please consult the QBWIN.log file. …
- 9100 The macro name … is already in use; it may only be defined once.
- 9101 The macro name … is too long.
- 9102 The macro name … contains invalid characters.
- 9103 The request was unable to use a macro value, probably due to an earlier error encountered when defining the macro.
Warnings
QuickBooks did what it could and is telling you what it left out.
- 500 A record was looked up by an exact key (a FullName or ListID) and does not exist.
- 501 Unable to represent … … in this version of the qbXML spec.
- 502 The query request has not been fully completed.
- 510 Unable to return object.
- 530 QuickBooks saved the record but ignored a field it does not support; the message names the field.
- 531 The enum value … in the field … is not supported by this implementation.
- 550 The … object was saved successfully, but its corresponding Notes record could not be saved.
- 560 The field … is deprecated.
- 570 Unable to link to transaction … because it has already been closed.
- 580 The specified special account already exists.
- 581 The specified special item already exists.
- 582 The … object was saved successfully, but its corresponding Contact record could not be saved. The following contacts failed to save: …
Information
Nothing went wrong.
Web Connector errors
The Web Connector couldn't get an answer from QuickBooks. It reports an hresult and a message in place of a response.
- 0x80040400 QuickBooks found an error when parsing the provided XML text stream.
- 0x80040401 Could not access QuickBooks.
- 0x80040402 Unexpected error. Check the "qbsdklog.txt" file for possible additional information.
- 0x80040403 Could not open the specified QuickBooks company data file.
- 0x80040404 The version of QuickBooks currently running does not support qbXML.
- 0x80040405 qbXML components have not been installed.
- 0x80040406 Could not determine the version of the QuickBooks company data file, or the data file has been modified and requires a newer version of QuickBooks.
- 0x80040407 The installation of QuickBooks appears to be incomplete. Please reinstall QuickBooks.
- 0x80040408 Could not start QuickBooks.
- 0x80040409 The current version of QuickBooks cannot work with the specified company data file. %s
- 0x8004040A A QuickBooks company data file is already open and it is different from the one requested.
- 0x8004040B Could not get the name of the current QuickBooks company data file.
- 0x8004040C The "BeginSession" method has not been called or it did not succeed.
- 0x8004040D The ticket parameter is invalid.
- 0x8004040E There is not enough memory to complete the request.
- 0x8004040F The "OpenConnection" method has not been called.
- 0x80040410 The QuickBooks company data file is currently open in a mode other than the one specified by your application.
- 0x80040411 Before calling the "BeginSession" method, you must call the "EndSession" method to terminate the current session.
- 0x80040412 You cannot make multiple successive calls to the "OpenConnection" method. Call "CloseConnection" before calling "OpenConnection" again.
- 0x80040413 QuickBooks does not support the "rollbackOnError" value of the "onError" attribute.
- 0x80040414 A modal dialog box is showing in the QuickBooks user interface. Your application cannot access QuickBooks until the user dismisses the dialog box.
- 0x80040415 A call to the "OpenConnection" method must include the name of your application.
- 0x80040416 If QuickBooks is not running, a call to the "BeginSession" method must include the name of the QuickBooks company data file.
- 0x80040417 If the QuickBooks company data file is not open, a call to the "BeginSession" method must include the name of the data file.
- 0x80040418 This application has not accessed this QuickBooks company data file before. The QuickBooks administrator must grant an application permission to access a QuickBooks company data file for the first time.
- 0x80040419 This application's certificate is invalid. An application must have a valid certificate to access QuickBooks company data files.
- 0x8004041A This application does not have permission to access this QuickBooks company data file. The QuickBooks administrator can grant access permission through the Integrated Application preferences.
- 0x8004041B Unable to lock the necessary information to allow this application to access this QuickBooks company data file. Try again later.
- 0x8004041C An internal QuickBooks error occurred while trying to access the QuickBooks company data file.
- 0x8004041D This application is not allowed to log into this QuickBooks company data file automatically. The QuickBooks administrator can grant permission for an automatic login through the Integrated Application preferences.
- 0x8004041E This application's certificate is expired. If you want to allow the application to log into QuickBooks automatically, log into QuickBooks and try again. Then click "Allow Always" when you are notified that the certificate has expired.
- 0x8004041F This flavor of QuickBooks cannot accept XML requests. Another product in the QuickBooks line, such as QuickBooks Pro or Premier, 2002 or later, is required.
- 0x80040420 The QuickBooks user has denied access.
- 0x80040421 The returned text is passed via the qbXML COM Request Processor directly from QuickBooks to your application and is not issued by the qbXML COM Request Processor itself. You may find it useful to copy the text verbatim to your message window.
- 0x80040422 This application requires Single User file access mode and there is already another application sharing data with this QuickBooks company data file.
- 0x80040423 The version of QBXML that was requested is not supported or is unknown.
- 0x80040424 QuickBooks did not finish its initialization. Please try again later.
- 0x80040425 Invalid parameter.
- 0x80040426 Scripts are not allowed to call QBXMLRP.
- 0x80040427 The QuickBooks application needs to be registered.
- 0x80040428 The version of QBXML that was requested is not supported by this version of the QBXMLRP library.
- 0x80040429 The message set requested cannot be processed through the API that was called.
- 0x8004042A This call may not be made from a remote system.
- 0x8004042B This call is unavailable in this version of QuickBooks.
- 0x8004042C This application's certificate has been revoked by its certification authority. An application must have a valid certificate to access QuickBooks company data files.
- 0x8004042D QuickBooks did not finish opening the data file while launching its UI, and we decided to give up. Perhaps the user did not complete the QuickBooks login process.
- 0x8004042E This call cannot be made after calling "BeginSession" and before calling "EndSession".
- 0x8004042F The requested connection type could not be found.
- 0x80040430 This application is unable to log into this QuickBooks company data file automatically. The QuickBooks administrator must grant permission for an automatic login through the Integrated Application preferences. If such permission was already granted, the administrator must revoke permission, save preferences, then grant the permission again.
- 0x80040431 The application trying to connect to QuickBooks does not support QuickBooks Simple Start Edition. Please contact the manufacturer of your application for a version that does support QuickBooks Simple Start Edition.
- 0x80040432 The application trying to connect to QuickBooks does not support QuickBooks Pro. Please contact the manufacturer of your application for a version that does support QuickBooks Pro.
- 0x80040433 The application trying to connect to QuickBooks does not support QuickBooks Premier. Please contact the manufacturer of your application for a version that does support QuickBooks Premier.
- 0x80040434 The application trying to connect to QuickBooks does not support QuickBooks Enterprise. Please contact the manufacturer of your application for a version that does support QuickBooks Enterprise.
- 0x80040435 Recent changes to your configuration require you (the QuickBooks Administrator) to go into the Integrated Applications preferences and re-authorize your integrated application to log in automatically.
- 0x80040436 This application requires Multi User file access mode, but QuickBooks Simple Start does not support Multi User access.
- 0x80040437 The user you are trying to log in with is already logged in from another machine.
- 0x80040440 Quickbooks can't return sensitive information, if company file is not protected with a complex password