Web Connector Setup

ℹ️ What you’ll need:

• An nXus API key (create one in Settings → API Keys)
• QuickBooks Desktop 2006 or later (running on Windows)
• QuickBooks Web Connector installed on the same machine

Interactive setup

Use the wizard in the dashboard to create your connection, download the .qwc file, and generate the password in one place. All API calls are made directly from your browser to the nXus server using your API key.

👉 Open the QWC Setup Wizard in your Dashboard

What the .qwc file contains

The QWC file is an XML configuration file that tells the QuickBooks Web Connector how to contact your nXus server. It includes:

• The service URL — your nXus SOAP endpoint
• A unique App ID tied to your connection
• The username used to identify your connection on the server
• A schedule hint (the actual interval is configured in the QWC UI)

⚠️ One company file per connection. Each .qwc file is tied to one connection ID and therefore one QuickBooks company file. If you need to sync multiple company files, create a separate connection for each and repeat this setup process.

Recommended QWC settings

Setting	Recommended value	Notes
Auto-Run Interval	Blank (automatically configured in qwc config)	this setting should never be modified manually
Run on a Schedule	Enabled	Required for automatic syncing
Personal Data Sharing	Allow	Required for write operations

Troubleshooting

QWC shows “Connection Error”

Verify that the nXus server URL in the .qwc file is reachable from the QuickBooks machine. If you’re running a self-hosted nXus instance, ensure the server is accessible on the network and the TLS certificate is trusted.

Wrong password error

The password is generated once and cannot be retrieved. If you lose it, go back to Step 3 in the wizard and generate a new password — then re-enter it in the QWC application by right-clicking your connection and selecting Properties.

Connection status stays “Not connected”

QuickBooks must be open with the correct company file active. Make sure you clicked Update Selected in the Web Connector after importing the .qwc file, and that the auto-run checkbox is checked. Check Step 5 (Verify Connection) once the QWC has had time to run its first sync.

QuickBooks prompts “Do you want to allow this?”

This is expected. Select Yes, Always Allow and check “Don’t ask me this again for this application” to prevent the prompt on future syncs. Selecting a lesser permission level will limit which QuickBooks data nXus can read or write.