QuickBooks#

QuickBooks Desktop is the accounting system for tenants that don’t use ManexCloud’s own GL as their book of record. The integration pushes journal entries (and, in some configurations, invoices / bills) from ManexCloud into QuickBooks.

Architecture#

• ManexQbApplication/ — the QuickBooks Desktop connector app. Runs on a machine that has QuickBooks Desktop installed and talks to it via the QBXML SDK.
• MnxQb*Helper.cs (in MnxEFModel/Helper/) — server-side sync logic.
• QbSettingsHelper — per-tenant QuickBooks connection settings.
• QbSyncModulesHelper — which modules are enabled for sync.
• MnxQbMappingHelper — mapping of ManexCloud GL accounts / items / classes to QuickBooks equivalents.
• MnxQbGeneralJournalEntrySyncHelper — the journal-entry sync itself.

Flow#

1. GL entries post in ManexCloud as normal.
2. QbSyncModulesHelper enumerates released entries that haven’t been synced.
3. MnxQbMappingHelper resolves each ManexCloud account to its QuickBooks account.
4. MnxQbGeneralJournalEntrySyncHelper builds a QBXML journal entry and queues it.
5. ManexQbApplication/ picks up the queue and pushes to QuickBooks.

Business rules#

• Only released GL entries sync — unreleased ones would create QuickBooks entries that don’t tie to ManexCloud reports.
• Account / item mapping must be complete before enabling sync — any unmapped account blocks the run.
• Sync is one-way (ManexCloud → QuickBooks). Anything entered directly in QuickBooks is out of scope and won’t reconcile.

Where it lives#