QuickBooks Web Connector error 0x8004041D

The Web Connector reports this when it can't get an answer from QuickBooks at all: QuickBooks never ran the request, so there is no statusCode.

What QuickBooks says

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.

Your SOAP service receives it in connectionError, or in receiveResponseXML in place of the response, as hresult 0x8004041D with this text in message. The Web Connector's log shows the same pair.

Things to know

  • With unattended access granted, the Web Connector opens the company file itself when QuickBooks is closed, runs the session and exits it, so a closed QuickBooks is not a connection error for that app
  • A QWC file with RunEveryNSeconds leaves the Web Connector's Every_Min column blank rather than showing "Real Time", and the postponement in QuBe's idle answer still holds a standard connection to about one call every 5 minutes

With QuBe Sync's API

QuBe Sync runs the SOAP service for you and puts this error on the request as JSON:

error on the request and its webhook
{
  "debug_message": null,
  "error_code": null,
  "error_type": "quickbooks_connection_error",
  "hresult": "0x8004041D",
  "message": "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.",
  "user_message": "QuickBooks is closed, and this app isn't allowed to open it on its own. Open QuickBooks with the company file on the Web Connector's computer, or allow the app to run while QuickBooks is closed (Edit > Preferences > Integrated Applications > Company Preferences)."
}

Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).