Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

What‘s on this page:

Table of Contents

Required Permissions

...

  • This article is applicable to users who need to connect Quickbooks On-Premise to MSPbots.
  • Only users with admin roles can configure the steps in this guide, including accessing the necessary API endpoints. The reason for restricting configuration to users with admin roles is that these operations require administrative permissions to be carried out.

How to Connect

...

Quickbooks On-Premise to MSPbots

...

  1. Open the Company QuickBooks file and make sure keep it stays open.open. You cannot link the Web Connector if you are not logged in and when the QuickBooks file is closed.
  2. Go toLog in to https://app.mspbots.ai/IntegrationsImage Removed MSPbots Integrations and search for QuickBooks On-Premise.
    image MSPbots integration QuickBooks On-PremiseImage Added

  3. Copy the password, update the path, then save it.
    The path of the platform comes from the file path of QuickBooks on the server.
    Image RemovedThe path has to include the file name and .QBW extension.
    Image Added

  4. Download "Web Connector Installer" and "Web Connector File".
    1. Quickbooks Web Connector Installer:   QBWebConnector2_3R0-00036_00215.zip
    2. Install QuickBooks Web Connector if you don't have it alreadyyet.
      image download quickbooks web connectorImage Added 
  5. Download Quickbooks Desktop Web connector file: APP_QBFS.qwc.
  6. Then Double double-click the "Web Connector Files" QWC file , it should to open the QuickBooks Web Connector Application.

    If you haven't configured Web Connector to run when QuickBooks is closed yet, do the following steps:

    1. Sign in to QuickBooks as the Admin user.
    2. If QuickBooks is on Multi-user mode, go to the File menu, then select Switch to Single-user Mode.
    3. From the Edit menu, select Preferences.
    4. Select Integrated Applications and then select the Company Preferences tab. 
      Image Added
    5. Select the third-party app.
    6. Select Properties.
    7. Check Allow this application to log in automatically.
    8. In the Authorization window, select Yes, always; allow access even if QuickBooks is not running.
      QB application certificateImage Added
    9. Select User to log in, then OK
      Image Added
    10. Start the QuickBooks Web Connector
    11. Authorize access :Click 'by clicking Add an Application' and choose choosing the QWC file. Click Ok OK.
    12. Enter Password
      1. Input the password
    13. In the Password Required pop-up window, enter the password copied from the QuickBooks On-Premise Integration in MSPbots. 
      Image Added
    14. Synchronous Data. Click the Update Selected button and check the progress bar to 100%. If you encounter failure, please send us the log. Refer to the section on Submitting Logs for Troubleshooting below.
      Image Added
  7. Sync the data to MSPBots: Sync data to MSPBots
    1. Click the checkbox of the application added, and click
    '
    1. Update Selected
    '
    1. to do a manual sync.
    2. Check
    '
    1. autorun
    '
    1. and set
    up
    1. the autorun interval
    in '
    1. at Every 720 Min
    '

    1. It takes about 10-15 minutes to sync up the data. You can close the windows once the progress bar reaches 100%. 

Submitting Logs for Troubleshooting

...

If the connection fails, please save the log information as shown below. Send the log file to support@mspbots.ai and we will help you resolve the problem.

Image Added

Status: Could not start QuickBooks

...

Quickbooks Web Connector relies on the QuickBooks program to be able to synchronize properly. When the integration shows this message, it indicates that the customer has not opened the QuickBooks program.

Image Added

How to View Errors in Log Files 

...

Open the synchronization view log file and scroll to the end of the log to view the error message during the synchronization of data. The sample log is shown below.

Important: The QuickBooks program should always be open and running normally.


Image Added

If the synchronization does not progress at a certain moment (for example, at 30%), please check the log file for an error. If there is an error, please restart the QuickBooks program and initiate a new synchronization.

Image Added

Fixing error QBWC1039 

...

Learn how to fix error QBWC1039 in QuickBooks Desktop.

You might see this error when you connect an app to QuickBooks Desktop using Web Connector. This happens for varied reasons, but don’t worry. We’ll help you fix it. Visit the links below and follow the applicable steps based on the error message you encountered.

Error QBWC1039 when connecting the QuickBooks Web Connector to MSPbots

Fix error QBWC1039

Image Added

Quickbooks On-Premise API documentation

...

If you can't find the data that you need in our prebuilt datasets, please review the following documentation, then send an email to support@mspbots.ai with the business use case for each dataset. Our development team will review it and let you know the ETA of the dataset.

https://developer.intuit.com/app/developer/qbdesktop/docs/get-started/api-reference/qbdesktop

How to Give Financial Access to Other Users

...

Important: Only the user who linked the Quickbooks API has access to datasets, widgets, and dashboards related to Quickbooks. This user is also the only person who can give other users access to Quickbooks-related assets.Even the admin cannot see the financial data.

Do the following procedure to give other users access to financial data:

  1. Go to User Management (mspbots.ai) and search for the user to be given access to the data. 
    user managementImage Added
  2. Click the Edit button beside the user's name.
  3. Go to Teams User Mapping on the Edit window and select Financial
    user financial accessImage Added
  4. Click Confirm.  

QuickBooks Desktop API Sync List

...

QuickBooks Desktop API Sync ListImage Added

FAQ

...

I get QBWC1039 Error

Please

...

see the MSPbots Help article Error QBWC1039 when connecting the QuickBooks Web Connector to MSPbots for steps on how to resolve this error. 

You may also view other resolutions here: https://quickbooks.intuit.com/learn-support/en-us/your-books-or-my-company/fix-error-qbwc1039/00/294400#