Qvinci RoyaltyHub - Moving the QuickBooks Web Connector

The QuickBooks Web Connector can only run from one computer or user session at a time, and it supports one active connection between QuickBooks Desktop and Qvinci RoyaltyHub. If you are moving to a new computer, changing workstations, or switching to a different remote desktop user session, you must remove the existing Qvinci RoyaltyHub connection before setting it up again.

Before You Begin

• Confirm that you have administrator access to the QuickBooks Desktop company file.
• Make sure QuickBooks Desktop is available on the computer or remote desktop session where the Web Connector will run.
• Close any duplicate QuickBooks sessions or old Web Connector connections before reconnecting.
• Have access to Qvinci RoyaltyHub so you can download a new Web Connector file and generate the required password.

Step 1: Remove the Existing Web Connector Application

Start by removing the existing Qvinci RoyaltyHub application from the QuickBooks Web Connector. Open the Web Connector, select the Qvinci RoyaltyHub application, and choose the option to remove it. When prompted, confirm that you want to stop exchanging data through that connection.

Step 2: Remove the Application from QuickBooks Desktop

Next, remove the old integration record from QuickBooks Desktop. In QuickBooks, open the Integrated Applications preferences, go to the company preferences area, select the Qvinci RoyaltyHub entry, and remove it. This clears the previous authorization so the new Web Connector setup can be added cleanly.

Step 3: Download a New Web Connector File

After the old connection has been removed, sign in to Qvinci RoyaltyHub and download a fresh QuickBooks Web Connector file. If the file path has changed because the company file moved to a new computer or hosted environment, reset the Web Connector setup so the new connection points to the correct QuickBooks file location.

Step 4: Add the Application Back to the QuickBooks Web Connector

1. Open the QuickBooks Web Connector.
2. Select the option to add an application.
3. Choose the newly downloaded Web Connector file.
4. Review the QuickBooks access prompt and confirm that the application information looks correct.
5. When prompted, authorize Qvinci RoyaltyHub to access the QuickBooks Desktop company file.

Step 5: Configure Access Permissions

For the most reliable connection, allow Qvinci RoyaltyHub to access QuickBooks even when QuickBooks is not running, using the appropriate QuickBooks admin user for the company file. This helps prevent connection interruptions when the Web Connector runs automatically.

Step 6: Enter the Web Connector Password

Once Qvinci RoyaltyHub appears in the QuickBooks Web Connector, enter the Web Connector password generated inside Qvinci RoyaltyHub. After entering the password, save it when prompted so the Web Connector can continue syncing without requiring the password each time.

Step 7: Validate the Connection

Keep the correct QuickBooks Desktop company file open, select the checkbox next to Qvinci RoyaltyHub in the Web Connector, and choose Update Selected. This forces the Web Connector to communicate with QuickBooks immediately instead of waiting for the next automatic run. If the update completes successfully, the connection has been moved and is ready to use.

Troubleshooting Tips

• If the connection fails, confirm that the correct QuickBooks company file is open.
• Remove duplicate or outdated Qvinci RoyaltyHub entries from both QuickBooks and the Web Connector before adding the new file.
• Run QuickBooks Desktop and the Web Connector with the required permissions, especially in hosted or remote desktop environments.
• If the company file was renamed or moved, download a new Web Connector file so the connection uses the updated file path.

Key Takeaway

Moving the QuickBooks Web Connector is not just a download-and-install process. The old Qvinci RoyaltyHub connection should be removed from both the Web Connector and QuickBooks Desktop before the application is downloaded, reauthorized, and validated on the new computer or user session.