QuickBooks Web Connector error 0x80040417

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

If the QuickBooks company data file is not open, a call to the "BeginSession" method must include the name of the data file.

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

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": "unexpected_error",
  "hresult": "0x80040417",
  "message": "If the QuickBooks company data file is not open, a call to the \"BeginSession\" method must include the name of the data file.",
  "user_message": "An unexpected error occurred: If the QuickBooks company data file is not open, a call to the \"BeginSession\" method must include the name of the data file."
}

Wording read from QuickBooks Enterprise Solutions 24.0 (R21_80).