QBWC1012: Authentication Failed
When the QuickBooks Web Connector us run there is step called "authenticate." The method's purpose is to validate the account and connection information before Connex can begin syncing order data. If the method fails to authenticate, the Web Connector will return an authentication failed message to the Web Connector.
If either the Connex account or integration information cannot be authenticated when the Web Connector is run, the Web Connector will return an Authentication failed error message. This can occur due to any number of reasons including, but not limited to: poor internet connection; the target website is offline; sync date range issue; integration credentials are incorrect.
Within the Web Connector, beneath the red Authentication failed error message, click the blue hyperlink. This will launch the Web Connector log and allow for greater explanation as to what is happening. If you're unsure, copy + paste this message into a Notepad file and contact us.
Website URL changed
Shopify and ShipStation users should skip to the next step.
Did you recently change your website URL or create a redirect? If your site was http and you redirected all pages to https, then the sync would fail. Read this guide on changing the URL on file.
Beneath authentication failed, there is a blue link. Click the link to see the details. If the message says timeout, shorten your sync dates:
- If Connex fails to receive the orders in two minutes, the sync will fail. Your query dates are too far apart. Login to Connex. Under manually sync an existing connection, adjust the dates to a 24 hour range:
- If you are syncing historically, login to Connex and click configure. Scroll down to advanced transaction. On the bottom, check insert orders in bulk. Wait fifteen minutes. Connex will queue the sales in the background. Turn off this feature, when you are done.
If the message says 404, confirm you have an internet connection and visit your website.
E-Commerce Pairing Failure
Connex checks if your credentials to your selling channel allow us to sync. This error could mean the credentials need to be updated. Log into Connex. Click log on the left. Here is an example with Shopify:
If you changed the URL of your website or deleted the connection, the sync will fail. To update your pairing file, follow these steps:
- Open QuickBooks and login as admin.
- Open your web connector.
- Click remove.
- Login to Connex.
- Under pair on another machine, choose your connection.
- Click submit.
- Double click the pairing file.