QuickBooks configuration changes affect financial records. Coordinate with the business’s accounting owner, test in a controlled period, and never place OAuth credentials or company identifiers in screenshots or support notes.
Before you beginUse an authorized administrator account and confirm the business shown in the top bar. Record the previous value before changing a live operational setting.
Step by step
- Go to Admin → QuickBooks Online for the intended storefront. Choose Connect to QuickBooks and complete Intuit authorization for the exact company. Return to CentriPOS and verify Connected, the company identity, and the connection time before mapping anything.
- Choose Refresh QuickBooks options to load current accounts, products/services, payment methods, tax codes, and classes into CentriPOS. A missing option can mean the cache needs refresh; it does not justify selecting a similarly named account without verification.
- In Invoicing, distinguish the storefront mapping switch, Customer Account invoice sync choice, the CentriPOS-led or QBO-led workflow, and the separate collection and edit-lock choices. Saving these preferences does not itself post a document, import a payment, or activate every integration path. Incoming QuickBooks payment activity can be displayed as accounting evidence; do not assume a setting has created a new CentriPOS tender or reconciled a local balance.
- Choose QuickBooks invoice date deliberately: Date of the sale in CentriPOS, Delivered date in CentriPOS, or Date first sent to QuickBooks. The setting applies to new invoice creation and uses the sale location’s business timezone. Delivered date requires all connected fulfillments to be complete with an unambiguous business date; split fulfillment uses the final delivery date, while no connected fulfillment falls back to the sale date. Net terms and default due days start from the selected invoice date; saved delivery deadlines stay unchanged. A first-send date is retained for retries. Changing this setting does not rewrite dates on existing linked invoices or enable automatic sending.
- In Sale Information, map the general sales item, optional invoice custom fields, discrepancy, rounding, discount, and any other supported adjustment items. Set the default class, then location classes and register classes; a register mapping overrides its location and the default. Enable summarized register-closure sync only when this is the approved accounting model.
- In Expense Information, map cost of goods sold, inventory asset, freight or shipping, purchase discounts, duty, and import-fee accounts used by supported inventory and purchasing entries.
- In Vendors & Purchasing, review supplier/vendor matching and the purchase-order, received-PO bill, direct-receive bill, supplier-return credit, Accounts Payable, reference and document-link settings. These are separate workflows. The supported received-PO bill action still requires eligible received stock, the expected vendor and mappings, and a confirmed result. Do not infer that every purchasing option is active because its value can be saved, or infer that an available invoice/payment action is absent solely from a broad Still to wire notice.
- In Liabilities, map store-credit issuance expense and liability accounts plus gift-card breakage revenue and gift-card liability accounts. These mappings should match how the accountant recognizes outstanding obligations.
- In Payment Types, map each enabled CentriPOS tender to the intended QuickBooks payment method. Disabled tenders remain visible for historical context but should not be mapped casually to an active method.
- In CentriPay & Processing Fees, map the processing-fee expense/category, register-invoice fee service item, surcharge item, and approved deposit-matching method. Prefer processor reporting when reliable evidence is available; use any manual fallback only under a documented accounting policy and effective date.
- For an enabled EPX invoice-settlement workflow, select Invoice settlement deposit bank account. This is the destination for a staff-reviewed invoice settlement deposit, separate from register-closure deposits. The review verifies an active USD bank account in the connected company and the processing-fee expense mapping before it can post. Saving the account does not create a deposit.
- In Sales Taxes, map each CentriPOS tax rate to the exact QuickBooks tax code. Compare name, percentage, jurisdiction, and taxable behavior rather than matching by a similar label alone.
- Choose Save Settings. Run one controlled example for each live workflow the business intends to use, then inspect the CentriPOS source record and the resulting QBO customer/vendor, invoice or report document, payment, tax, class, item lines, fees, and total. Keep a recovery path before Disconnect; disconnecting authorization does not delete previously posted accounting records.
- Keep manual invoice-send permission separate from connection administration. Send to QB requires an owner, super admin, finance/accounting role, or an explicitly granted invoice-send permission. It adds or links the accounting invoice; it does not send customer email. A collection, deposit confirmation, or customer communication remains its own action and may require different permission.
Screen and contract reference
| Control or area | What it means |
|---|---|
| Connection | Storefront-level authorization to one verified QuickBooks company. |
| Refresh QuickBooks options | Hydrates the local mapping cache with current QBO values. |
| Invoicing | Customer Account invoice, payment, link, due-date, matching, collection, lock, and exclusion behavior. |
| Invoice custom-field mapping | Maps a supported CentriPOS storefront, customer, or sale value into a named QBO invoice field. |
| General sales / adjustment items | QBO products or services used for sales, discrepancy, rounding, discount, fee, or surcharge lines. |
| Class precedence | Register class overrides location class, which overrides the default class. |
| Expense Information | COGS, inventory asset, freight, purchase discount, duty, and import-fee account mappings. |
| Vendors & Purchasing | Supplier matching and supported PO, bill, direct-receive, return-credit, reference, and link settings. |
| Liabilities | Store-credit and gift-card accounting mappings. |
| Payment Types | CentriPOS tender-to-QBO payment-method mapping. |
| Processor reporting | Uses synchronized processor/deposit evidence for fee and net-deposit treatment. |
| Manual fallback | Documented temporary fee calculation used only when approved and processor evidence is unavailable. |
| Sales Taxes | CentriPOS tax-rate-to-QBO-tax-code mapping. |
| Save Settings | Stores intended mappings; it does not retroactively prove or execute every possible sync. |
| Disconnect | Removes active authorization while leaving previously created QBO records intact. |
| QuickBooks invoice date | Chooses sale, completed-delivery, or first-send date for new invoices using the sale location’s business timezone; retry reuses its saved date. |
| Invoice settlement deposit bank account | Verified active USD bank destination for staff-approved EPX invoice settlements; does not change register-closure deposit settings. |
| Invoice-send permission | Separate authorization for manual Send to QB; it does not grant all QuickBooks administration or send customer email. |
| Incoming QuickBooks activity | Observed invoice/payment/deposit information and timeline evidence, kept separate from local tender posting. |
Expected result
The authorized QuickBooks company reports a healthy connection, mappings point to the intended accounts and records, and one controlled CentriPOS transaction syncs once.
Troubleshooting
- Confirm you are changing the intended business and location before saving.
- Record the previous setting when a change affects live selling, payments, tax, or integrations.
- Use a controlled test record after saving before rolling the setting out broadly.
- If Delivered date blocks a send, verify every connected fulfillment and business delivery date. Do not change the accounting date merely to bypass an incomplete delivery.
- If a QuickBooks notice conflicts with a supported record-level action, preserve the exact screen and result for support. A broad setup notice is not an all-records status.
- If the mapped invoice deposit bank or processing-fee account fails validation, have the accounting owner correct the exact mapping before reviewing the same settlement again.
CentriPOS API explorer · API Center administration
More guides
Build an itemized payment in MoneyUse Products or Amount & description to build one receipt, attach the customer, and follow the appropriate payment or service-estimate workflow.
Take a one-time payment in Virtual TerminalReview a one-time amount, tax and contact at the correct payment station, use its verified secure checkout, and recover the original receipt after an uncertain result.
Review booking payments, refunds and earned careKeep a booking’s customer payments, unused advances, completed care, cancellation fees and refunds distinct, then read a correctly scoped accrual report.
Configure booking properties and customer pagesSet accommodations, service packages, availability, required intake and payment terms, then review the correctly branded booking page before sharing it.