A Connected badge or saved mapping does not prove that every CentriPOS workflow has posted to QuickBooks. Read the status on the exact receipt, payment, invoice, or register report, then verify the linked QuickBooks record. Never create a second accounting transaction merely to clear an uncertain state.
Step by step
- Open Admin → QuickBooks Online and confirm the selected storefront, authorized QuickBooks company, Connected status, last connection time, and cached-option readiness. Refresh QuickBooks options only when an authorized administrator needs current accounts, items, payment methods, tax codes, or classes.
- Treat connection, saved mappings, record-level linkage and the result of the supported action as separate evidence. Some broad Ready now / Still to wire setup notices can lag the enabled record workflows. Do not use one notice as proof that every invoice/payment path is unavailable or active. If the notice conflicts with the action on your record, stop and have support confirm the intended workflow before changing accounting data.
- Start from the CentriPOS source record that should have created accounting activity. For a Customer Account transaction, open Sales → Receipts or Customers → Customer Accounts. For a register summary, open Register → Reports and select the exact closed report. Do not infer one record’s status from the storefront-level connection badge.
- On a Customer Account receipt, look for the linked QBO invoice number/action and payment rows. QBO posted means that payment has an external QuickBooks payment ID. QBO failed means the payment has no external ID and its last accounting attempt failed; preserve the displayed error before changing anything.
- Use Send to QBO on an eligible receipt or Send to QB on an eligible invoice only with the required invoice-send permission. If a customer match is required, compare the local customer name, company, email, phone, and source code with every proposed QuickBooks customer. Select the existing customer only when identity is certain. Approve creating a new customer only after confirming that no valid match exists.
- After the action, confirm Customer account receipt sent to QBO, Invoice added to QuickBooks, or the existing-invoice linked result. Open the linked invoice and compare customer, document number, dates, items, tax, payments and total. Send to QB adds or links the accounting document; it does not email the customer. A successful accounting link proves only that document relationship.
- Disconnecting a Customer Account invoice removes the CentriPOS link; it does not delete or void the invoice in QuickBooks. Confirm the named invoice before disconnecting, then reconcile the still-existing QBO document before resending so a duplicate is not created.
- For an eligible Customer Account payment with no external payment ID, use the supported resubmit control once. QBO payment posted confirms a new external payment reference; QBO payment already linked means the existing reference was recovered; QBO payment was not posted means the workflow was skipped and the reason must be reviewed.
- On Register Reports, use the exact badge as the starting point: QB not connected, QB manual only, QB older report, QB resend needed, QB ready, QB future report, QBO Synced, Send to QBO, EPX Review Needed, Awaiting EPX Deposit, an open-EPX-batch label, or Account payments sync separately. The badge describes that report, not the health of all accounting.
- An open register is a future report and cannot be sent. The list does not offer Send to QBO when the report’s accounting net is zero or when it contains only customer-account payments. Account payments sync separately means those payments follow their own invoice/accounting path and must not be posted a second time as a register-summary invoice. QB older report stays manual because it predates the configured sync start point. QB ready means eligible under the current rules; it does not prove a QuickBooks document exists.
- QB resend needed means one or more tracked sales changed after the drawer closed. Inspect the edits and report totals before choosing Resend report. If the notice is accurate but no resend is required under approved accounting policy, dismissing the notice only acknowledges the tracked edits; it does not update QuickBooks.
- CentriPay can gate a register report on processor evidence. Awaiting EPX Deposit means the expected deposit record is not yet available. An open EPX batch is still accumulating or settling. EPX Review Needed means the processor-to-report evidence needs review. Trace payment → receipt → register closure → EPX batch/deposit before sending or repairing.
- Choose Send report or Resend report only for the eligible closed report after reviewing its edits and totals. If a matching accounting document already exists, CentriPOS can restore its link. Open the returned document and read its type: ordinary report summaries use an invoice; eligible refund-only reports can use a refund receipt; older linked sales receipts may still exist. Do not replace one type merely to make its label match another report.
- A linked register report displays Connected to QuickBooks or QBO Synced. Compare the company, report number/date, included sale and tender totals, customer-account exclusions, tax, class, processing fees, payments and final total. A synced document or an observed linked deposit does not prove processor settlement, bank-feed matching, or final bank reconciliation.
- Only owners, super admins, and finance managers can disconnect a linked QuickBooks register report. The confirmation requires the exact CentriPOS report number. Disconnect removes the CentriPOS link but leaves the QuickBooks invoice or sales receipt in place and makes the report eligible to resend.
- For any failed, skipped, resend, missing-link, processor-review, or mismatch state, preserve the CentriPOS receipt/report number, QBO document/payment identifier, EPX reference when applicable, time, amount, and exact error. Correct the verified source or mapping, use one supported retry, and re-open both records to confirm the result.
- On Customer Accounts invoices, Refresh QuickBooks status or Check QuickBooks reads the linked accounting evidence. It does not send invoices or post new local payments. Incoming invoice/payment/deposit notifications can update observed status, communication history and accounting details while payment posting remains a separate workflow.
- If QuickBooks shows no remaining balance while CentriPOS still shows an open balance, use Check the open balance and reconcile the existing payment before requesting money again. Do not record a second tender solely to make the two displays agree.
- When Payments recorded in QuickBooks lists one payment covering several invoices, the displayed Payment total is the full payment, not this invoice’s allocation. Review the linked invoice allocation before adding amounts to a report. A missing linked deposit means no deposit was observed for that payment; it is not evidence that the customer must pay again.
- For an enabled processor-backed invoice payment, Pending QBO sync for EPX deposit means the customer payment is recorded but QuickBooks posting is waiting for matched settlement evidence. EPX settlement needs accounting review is a separate exception. Do not retry the card payment, create another account payment, or turn a pending settlement into a manually marked paid invoice.
- Where Matched EPX settlement is available, compare the full deposit processing fee with the fee allocated to this invoice, any surcharge credit, the invoice principal payment and the processor reference. Review & sync deposit is a real accounting action: an authorized administrator reviews the entire settlement and confirms one QuickBooks bank deposit. It does not rewrite the original invoice totals or replace bank-feed matching.
Screen and contract reference
| Control or area | What it means |
|---|---|
| Connected | The selected storefront has an active QuickBooks authorization; it is not a blanket all-records-synced status. |
| Cached options | QuickBooks accounts, items, payment methods, tax codes, classes, and other values available to mapping controls. |
| Ready now / Still to wire | Broad setup notices that may lag specific enabled record workflows; use the exact supported action, result and linked record as evidence. |
| QBO invoice linked | An existing or newly created QuickBooks invoice is attached to this Customer Account receipt. |
| QBO posted | The individual payment row has an external QuickBooks payment identifier. |
| QBO failed | The payment lacks an external payment identifier and its last accounting attempt failed. |
| Customer match | Identity decision that links the CentriPOS customer to an existing QBO customer or explicitly approves creation. |
| QB not connected | The report remains local because this storefront has no active QuickBooks authorization. |
| QB manual only | Automatic register-report sync is disabled; an eligible report can be sent manually. |
| QB older report | Closed report predating the configured automatic-sync start point. |
| QB ready | Closed report eligible under current sync rules but not yet proof of a posted document. |
| QB future report | Open register that will be evaluated under the configured rules after closure. |
| QB resend needed | Tracked sale edits occurred after close and require accounting review. |
| QBO Synced | A sent sync record with a QuickBooks transaction identifier, URL, or document number is linked to the report. |
| Send to QBO | Manual action available only for an eligible nonzero closed report that is not processor-gated or already linked. |
| Awaiting EPX Deposit | CentriPay report is waiting for matching processor deposit evidence. |
| EPX Review Needed | Available processor evidence does not reconcile cleanly enough for an automatic send decision. |
| Open EPX batch | Processor batch evidence exists but the batch has not reached its final closed/settled condition. |
| Send report / Resend report | Supported register-report action; resend is used after tracked edits or a prior unlinked/send attempt. |
| Disconnect | Removes only the CentriPOS-to-QBO link; the external QuickBooks document remains. |
| No public screenshot | No approved Harbor & Hearth capture matches these record-level states without exposing financial data, so this guide intentionally uses no invented image. |
| Send to QB | Permission-controlled manual invoice action that adds/links the QBO document without emailing the customer. |
| Refresh QuickBooks status / Check QuickBooks | Read and display linked QuickBooks evidence without sending invoices or creating local tender. |
| Check the open balance | QuickBooks reports the balance paid while CentriPOS still has an open amount; reconcile the existing payment before asking again. |
| Payments recorded in QuickBooks | Observed accounting payments; a payment total may cover several invoices and must not be counted once per invoice. |
| Pending QBO sync for EPX deposit | Recorded invoice payment is awaiting matched processor settlement, not a request to collect the payment again. |
| Matched EPX settlement | Processor deposit, full fee, per-invoice fee/surcharge allocation and principal-payment evidence. |
| Review & sync deposit | Separate staff-approved creation/recovery of one linked bank deposit after full settlement validation. |
| Account payments sync separately | The register report contains only customer-account payments, which use their own invoice/accounting path and are not sent again as a register-summary invoice. |
Expected result
Each source invoice, receipt, payment, report and settlement has a traceable accounting reference and an understood posted, pending, skipped, failed or review state. Observed QuickBooks data is distinguished from local tender, and duplicate collection or duplicate accounting entries are avoided.
Troubleshooting
- Check the processor transaction status before retrying an uncertain payment or refund.
- Confirm the terminal, register, amount, and transaction reference all belong together.
- Never include full card numbers or protected credentials in a support request.
- If a QBO balance and local balance disagree, reconcile the actual linked payment and allocations before collecting or posting again.
- If a settlement review changed or a created deposit has not been confirmed locally, reopen the same review to recover the existing deposit; do not create a second deposit elsewhere.
- A signed incoming provider update is accounting evidence, not permission to create another local payment.
CentriPOS API explorer · API Center administration