QuickBooks

Push invoices and payments from Nyumba Zetu into QuickBooks Online, and track what has and has not synced.

Finance → Accounting → Quickbooks → /quickbooks/invoices · Payments → /quickbooks/payments

Organisations that keep their statutory books in QuickBooks Online do not have to re-key anything: the QuickBooks screens list the invoices and payments Nyumba Zetu has raised, in the shape QuickBooks expects, and push the ones you select.

What syncs, and in which direction

The sync is one-way: Nyumba Zetu → QuickBooks.

Object hereBecomes in QuickBooks
Invoice (with its line items, tax code and tax amount)Invoice
PaymentPayment, applied against the matching invoice
Lease / resident being billedCustomer, created on demand if it does not exist

Nyumba Zetu stays the system of record for money. QuickBooks holds the accounting mirror, and the platform keeps a crosswalk of every pushed object — the QuickBooks id plus its sync token — so a re-sync updates the existing QuickBooks record instead of creating a duplicate.

The Invoices tab

The grid deliberately mirrors QuickBooks' own invoice import layout, which is why several column headers carry an asterisk — those are the fields QuickBooks treats as required:

ColumnNotes
*InvoiceNoThe Nyumba Zetu invoice number. It becomes the QuickBooks document number.
*CustomerThe QuickBooks customer name resolved for the lease.
*InvoiceDate / *DueDateStraight from the invoice.
Item(Product/Service)The service type behind the line, mapped to a QuickBooks item.
ItemDescription, ItemQuantity, ItemRate, *ItemAmountThe line detail.
*ItemTaxCode, ItemTaxAmountThe tax class and computed tax. Tax is exclusive — see Tax and eTIMS.
SyncedTrue in green once the invoice exists in QuickBooks, False in red while it does not.

Because the layout matches the import template, exporting the grid gives you a file you can load into QuickBooks manually if you ever need to work offline. See Reports for export mechanics.

The Payments tab

The same treatment for receipts: each row is a payment recorded here, with its own Synced flag. Sync payments after their invoices — a payment cannot be applied in QuickBooks until the invoice it settles is there.

Syncing

  1. Filter to what has not synced

    Sort or filter on Synced = False. That is the backlog; everything else is already in QuickBooks.

  2. Select the rows

    Tick the invoices or payments you want to push. Selection is per grid — invoices and payments are pushed separately.

  3. Run “Sync with QuickBooks”

    The bulk action asks for confirmation, then pushes each selected row and marks it synced.

  4. Re-read the Synced column

    Refresh the grid. Anything still False did not go through — see below.

When a row will not sync

SymptomUsual cause
Everything fails at onceThe QuickBooks connection has expired or been revoked. It has to be re-authorised.
One invoice failsA required field is empty — most often the customer, the service type's item mapping, or the tax code. Fix the invoice, then sync again.
A payment fails but its invoice syncedThe payment is applied to an invoice that is not in QuickBooks yet, or is applied across more than one invoice. Sync the invoices first.
A row flips back to FalseThe QuickBooks record was deleted on the QuickBooks side. Sync again to recreate it.

Re-running the sync on an already-synced row is safe: the crosswalk makes it an update, not a duplicate.

Good practice

  • Sync on a rhythm — end of day or end of week — rather than ad hoc. A predictable backlog is easier to read than a grid where nobody knows what was last pushed.
  • Reconcile monthly. Compare the financial statements here against the equivalent QuickBooks report before you close the period. They should agree to the cent; a gap means something failed to sync and nobody looked.
  • Fix data here, not there. Correcting the invoice in Nyumba Zetu and re-syncing keeps both sides consistent. Editing the copy in QuickBooks leaves the platform believing the wrong figure is filed.
  • Do not use QuickBooks as the arrears source. Balances, allocations and collections all read the platform ledger — see Invoices and payments.