QuickBooks Desktop Connector

Run the setup link from your administrator, confirm the company and project, and click Connect.

The Hedy CLI is a separate Windows and Linux tool for shell-capable Hedy workflows. It does not replace this Windows-only QuickBooks Desktop connector.

Download

Your administrator sends a link. Opening it downloads Hedy-QuickBooks-Connector-hqs_….exe. That file is already aimed at one company, one project, and either production or sample data. A generic copy of the executable is also listed in release.json for checksum verification; that generic file asks you to paste a setup code.

Verify checksum

The executable is unsigned, so Windows SmartScreen may warn. The SHA-256 in release.json matches the generic executable. A setup-code download is the same bytes with a different file name.

Local setup dashboard certificate

The dashboard runs only on https://127.0.0.1:5188. On first use the connector generates a self-signed certificate locally and never sends it to Hedy. Accept the one-time browser warning for 127.0.0.1.

Connect

  1. Run the downloaded executable. No console window opens; the browser opens the dashboard.
  2. Confirm the company, project, and mode, then click Connect. If the file name has no setup code, paste the code your administrator sent.
  3. The dashboard switches to Connected and the connector starts polling. No restart and no extra fields.

Diagnostic logs are written to logs\connector-YYYYMMDD.log under %ProgramData%\Hedy\QuickBooksDesktop. Run with --console to see live output.

Sample data

Sample-data codes use the same Connect button. The dashboard shows a sample-data banner, and the hosted app tags that traffic as mock. A Windows service install is only for production codes.

Optional Windows service

After Connect, choose Install as Windows service and approve the UAC prompt. The connector copies itself under Program Files and starts the HedyQuickBooksDesktop service. Run the button again to upgrade.