BLOG
Notes from the bridge
Field notes on putting a QuickBooks Online–compatible API in front of QuickBooks Desktop and Enterprise: sync, errors, hosting, and the sandbox.

Marking QuickBooks Desktop Transactions Cleared Over a REST API
How to set and read cleared status on QuickBooks Desktop transactions over REST: per-split semantics, which types work, and why the read-back needs a GL report.
Read more
A New Hostname, a Hosted Desktop, and a Firewall That Said No
A September 2026 hosted QuickBooks cutover failed twice: a Let's Encrypt chain the desktop wouldn't validate, and a FortiGate that blocked an unrated hostname.
Read more
TenkeyBridge Changelog, October 2026: 84 Reports, Cleared Status, Multicurrency, and More Writes
What shipped in the QuickBooks Desktop API in October 2026: 84 reports, cleared status, multicurrency, Desktop-only voids, Projects as jobs, and new npm clients.
Read more
84 QuickBooks Desktop Reports Over One REST API: A Field Guide
A tour of the 84 reports TenkeyBridge exposes from QuickBooks Desktop over a QBO-shaped REST API: groups, params, five sample GETs, and the edges that bite.
Read more
Void vs. Delete in QuickBooks Desktop via API: What Each One Leaves Behind
Void keeps the transaction with zeroed amounts and a VOID: memo; delete erases it. How operation=void works on Desktop, which types support it, and the payment exception.
Read more
Why a $0.0725 Rate Came Back as $0.07: Sub-Cent Prices on QuickBooks Desktop
A lab-testing integration billed fractions of a cent per unit and QuickBooks rewrote the amount. Here's the price-vs-amount distinction and the gateway v126 fix.
Read more
503 vs. 504 from QuickBooks Desktop: Which Requests Are Safe to Retry
503 AGENT_OFFLINE means the request never reached QuickBooks. 504 AGENT_TIMEOUT means it may have applied. Here's a retry policy that respects the difference.
Read more
QuickBooks SDK vs. Web Connector vs. a REST Bridge: Picking a Desktop Integration Path
Three ways to reach QuickBooks Desktop: raw qbXML over the COM SDK, a SOAP Web Connector service, or a QBO-shaped REST API. Who hosts what, and what breaks.
Read more
Syncing Invoices to QuickBooks Desktop Over a REST API
Create and update QuickBooks Desktop invoices with QBO-style JSON: CustomerRef, line items, tax codes, the 11-character DocNumber limit, and SyncToken handling.
Read more
QuickBooks Batch Requests Are Not Transactions: Handling Partial Failure on Desktop
A QuickBooks batch is not atomic. How to read per-item results by bId, why structural errors reject the whole request, and how to retry only the failed items.
Read more
Change Data Capture Against QuickBooks Desktop: The 30-Day Window, the 1,000-Object Cap, and the Deactivation Gotcha
How /cdc behaves against a QuickBooks Desktop company file: the 30-day changedSince limit, CDC_OVERFLOW faults, per-entity isolation, and why deactivation isn't a delete.
Read more
A QuickBooks MCP Server for Desktop: Giving an AI Agent Safe, Checkable Access
Run @tenkeybridge/mcp over npx to give Claude or any MCP client five QuickBooks Desktop tools, a compatibility catalog, and errors agents can actually fix.
Read more
Hosted QuickBooks on Rightworks: Connecting Without Installing Anything
Hosted QuickBooks Desktop blocks agent installs. Here's how to reach it over the Web Connector that's already on the machine — four steps, no inbound firewall rules.
Read more
QBO Sandbox vs. TenkeyBridge Sandbox: The Same Request, Side by Side
Run the same QuickBooks API request against Intuit's QBO sandbox and a Desktop-backed sandbox, diff the responses, and see where Desktop semantics actually differ.
Read more
Build Against QuickBooks Desktop Without Installing QuickBooks
Every TenkeyBridge org gets a free QuickBooks Desktop sandbox: a hosted realm that answers the /v3 API with seeded data, fixed record IDs, and on-demand resets.
Read more
Sparse Updates vs. Full Replacement: Syncing Invoices to QuickBooks Desktop Without Clobbering Edits
How QBO's sparse update semantics map onto QuickBooks Desktop's EditSequence, why SyncToken conflicts happen, and how to write a sync loop that's actually idempotent.
Read more
Integrating with Multi-User and Hosted QuickBooks Desktop (RDS, Right Networks, Citrix)
How sessions, file modes, integrity levels, and Windows service accounts change when QuickBooks Desktop lives on a server or a hosting provider — and what actually works.
Read more
Decoding QuickBooks Desktop Errors: qbXML Status Codes, HRESULTs, and QBO-Style Faults
A field guide to QuickBooks Desktop error codes — qbXML statusCode 3140, COM HRESULTs like 0x80040408 — and how they map onto QuickBooks Online-style faults.
Read more
The Checklist for Pointing Your QuickBooks Online Integration at Desktop
A practical, step-by-step checklist for developers adapting a working QBO integration to support QuickBooks Desktop and Enterprise via a compatible REST API.
Read morePoint your QuickBooks Online integration at QuickBooks Desktop
Point your QuickBooks Online integration at QuickBooks Desktop
The whole migration is a base URL. Here's the full walkthrough — token, query, and invoice write — against a real Desktop company file.
Read moreQuickBooks Desktop errors don't have to be cryptic
QuickBooks Desktop errors don't have to be cryptic
How TenkeyBridge turns Desktop's 3140s and 0x8004-somethings into QBO faults with causes, fixes, and a docs link on every error.
Read more