Sometimes your QuickBooks Online integration may need to be reconnected to STRATAFOLIO, especially when you see an error message. This can happen for several reasons. The QuickBooks Online administrator on the account may have changed. A password may have been updated. Intuit may have changed its integration certificates. Whatever the cause, this does not happen often, and it is usually easy to fix. Reconnecting the account tells STRATAFOLIO and QuickBooks Online to trust each other again so your financial data can keep flowing between the two systems.
Before You Begin
Only the Administrator on your STRATAFOLIO account, or a user with Admin rights, can reconnect a QuickBooks Online integration. Before you start, make sure you have your QuickBooks Online login information ready, since you will need to sign in during the reconnection process.
Where to Find This Feature
You can find your QuickBooks Online integrations from your Organization’s detail view in STRATAFOLIO. Expand Hierarchy from the left-side navigation menu, select Organizations, and click your Organization’s name. Then select the Integrations tab. Any integration that has stopped syncing will show a red Failure status, and you may also see a red bell icon alerting you that something needs attention.
/image
IMAGE PLACEHOLDER — REPLACE WITH FINAL IMAGE
Format: JPG
File name: integrations-tab-failure-status-kb.jpg
Alt text: Integrations tab showing a QuickBooks Online integration with a red Failure status
Title: QuickBooks Online Integration Failure Status
Description: Shows the Integrations tab in STRATAFOLIO with a QuickBooks Online integration displaying a red Failure badge in the top right corner
Purpose: Helps users recognize what a broken sync looks like before they start troubleshooting
How to Use This Feature
- From the Integrations tab, click the QuickBooks Online integration that shows the red Failure status.
- Select the Setup tab. This tab shows the specific error message from QuickBooks Online, such as “Could not connect to QuickBooks Online. Please try again.” along with a short error description.
- Click the green Connect to QuickBooks button.
- This opens QuickBooks Online in your browser. Sign in if you are not already logged in.
- Select the same QuickBooks Online company you connected before. It is important to choose the same account, since connecting a different one can cause your STRATAFOLIO data to map incorrectly.
- Follow the remaining prompts to confirm the connection. Once finished, return to STRATAFOLIO and refresh the Integrations tab. The status should change from Failure to a healthy sync status within a few minutes.
- If any new accounts or classes were added in QuickBooks Online since your last successful sync, you may need to confirm them before your data is complete. You can do this from the Accounts tab inside the same integration.
More Information on QuickBooks Online Integrations
Not every alert on the Integrations tab means something is broken. A yellow Outdated status simply means there has been no activity in your QuickBooks Online account for more than 72 hours. This is normal and does not require reconnecting. If you complete a transaction in QuickBooks Online, the status should refresh within a few minutes. If it does not update after an hour, reach out to STRATAFOLIO support.
A red Failure status is different. It means STRATAFOLIO can no longer authenticate with QuickBooks Online, and the steps above are needed to restore the connection. Common error messages you may see include Authorization has expired, Authorization denied, Unauthorized, and Authorization failed, along with the generic Unknown error message shown in the example above.
Examples and Best Practices When Using QuickBooks Online
If you manage more than one entity, you may have several QuickBooks Online integrations connected to STRATAFOLIO. Check the Integrations tab regularly and repeat the reconnection steps for every integration showing a red Failure status, not just the first one you find.
Always reconnect using the same QuickBooks Online company you originally linked. Connecting the wrong company can cause income, expenses, and accounts to map incorrectly across your portfolio.
Troubleshooting Your QuickBooks Online Integration
If you complete the steps above and the integration still shows a Failure status, double-check that you are signed into the correct QuickBooks Online account and that you have Administrator access on that account. If the issue continues, use the Contact Us button in the left-hand navigation bar to reach STRATAFOLIO support for further assistance.
