webkpi SaaS ETL Connector Installation & Configuration Guide

Transcription

1 webkpi SaaS ETL Connector Installation & Configuration Guide SaaS ETL Version Version 1.6 September 2013 webkpi SaaS ETL Connector Version V 1.6 Page 1

2 Table of Contents Table of Contents Getting Started... 4 Initialize Computer, QuickBooks and QuickBooks File... 4 Installing the SaaS ETL Connector... 5 Changing to Another QuickBooks File Adding Another QuickBooks File Adding Another QuickBooks File to Another Dataspace Balance Sheet Comparison Connection Trouble Shooting Setting The Days Back Running Daily Uploads Appendix A: MS Windows 7 & 8 Install UAC Setting Appendix B: Uninstall SaaS ETL Connector Appendix C: QuickBooks Error Messages Error Cannot access QuickBooks file Windows Vista and Windows 7 & Error code F3 - Could not start QuickBooks Error: 1062: Duplicate entry insurance for key 1. Executing: CREATE UNIQUE INDEX id Chart Of Accounts(Account Number) Error: 1054: Unknown column 'Date_Begin' in 'field list' Error F3 : This application is not allowed to log into this QuickBooks company data file automatically Error: No data files found to upload Error Could Not Start QuickBooks Error 6190, -816: QuickBooks was unable to open the company file when opening a file webkpi SaaS ETL Connector Version V 1.6 Page 2

3 Taking Long Time to Export Error QuickBooks Unrecoverable/Unknown Error webkpi SaaS ETL Connector Version V 1.6 Page 3

4 Getting Started 1. Critical Step: On a 64-bit computer, including Windows 7 & 8 and Vista, see UAC Settings in Appendix A. If communication problems persist, confirm that Port 3306 on the firewall is unblocked 2. If you have previously installed the SaaS ETL Connector and you re preparing to install a new version, see Appendix B. 3. Be prepared to log onto your computer as Admin, and also log into QuickBooks as Admin. If QuickBooks is running on a server, you must log into the server as Admin. a. On Windows 7 & 8 and Vista computers there are two types of users: standard users and administrators. Some tasks, such as installing and updating software, require administrator rights. If your operating system's User Account Control (UAC) is turned off (See Appendix A), administrator rights permission is granted automatically. b. Do I have Admin rights? i. To determine whether you already have administrator rights, right-click Start on the Windows taskbar. If Open All Users and Explore All Users appear on the menu, you have administrator rights. 4. Before starting the SaaS ETL Connector Installation and Configuration, please make sure to identify where the QBW file(s) are located in your computer directories. (i.e. c://program Files/Intuit/?) 5. And, check the Windows Task Manager (ctrl-alt del), select Processes and see if there are any QuickBooks processes running. If there are, remove them (select and Click End Process.) Initialize Computer, QuickBooks and QuickBooks File Log onto computer as Admin (Go to Control Panel -> User Accounts and confirm who is Admin) Log into QuickBooks as Admin Critical Step: If a dialogue box opens up when you run QuickBooks (e.g. Install Updates,..) be sure to clear this dialogue box before proceeding. An open dialogue box in QuickBooks will stall the SaaS ETL Connector Critical Step: Add a QuickBooks user called webkpi to the QuickBooks file (any password you want to use) o Grant the webkpi user full access Select Multi-User mode in QuickBooks The QuickBooks file must be left in Multi-user Mode for the SaaS ETL Connector to function properly! Critical Step: In QuickBooks with the QuickBooks file open, go to Edit -> Preferences o select Accounting, select Company Preferences tab and confirm that Show lowest subaccount only is unchecked and confirm that Use Account Numbers is checked o select Reports & Graphs, select Company Preferences tab and confirm that under Reports - Show Accounts: By - Name Only is selected o Select Integrated Applications, select Company Preferences, if SaaS_ETL is present, select it and click remove. Critical Step: Close QuickBooks webkpi SaaS ETL Connector Version V 1.6 Page 4

5 Installing the SaaS ETL Connector The SaaS ETL Connector (commonly known as the database connector tool) has been designed to create data upload tasks that extract data from the QuickBooks file and export the data to the webkpi server to be used by the webkpi applications. Below are the steps to download, install and configure the webkpi SaaS ETL Connector. 1. Use the link for the SaaS ETL Connector that has been provided. 2. Click Download. Click Run. If you re asked to save the download file, do so, and then Click run. 3. The webkpi ETL Engine splash screen will show and then the SaaS ETL Install screen will appear Note: If asked Do you want to install update? - Click Yes. 4. Click Install and the webkpi User Configuration window will open. Enter your webkpi Dataspace Username and Password (These will be provided by webkpi.) Click Save. webkpi SaaS ETL Connector Version V 1.6 Page 5

6 5. The SaaS Scheduler --- Version X window will open. Click Add and the SAAS Task Configuration window will open. Under Select a ERP: Click the down arrow and select QuickBooks Desktop Extractor in the drop-down box and Click Next. 6. A window will open with a table of upload models on the right. If you wish to upload data for all of the models Click Next. Move any models you do not wish to upload data for into the table on the left, and then Click Next. Note: Read the following information which will guide you through the Select ERP process - webkpi SaaS ETL Connector Version V 1.6 Page 6

7 7. Again, the SaaS Task Configuration window will open for Select ERP. Critical Step: Select New Company and Enter a Short Name in the box below (this is the name you ll see on webkpi Dashboard screens and reports, so make it meaningful.) Critical Step: Next, Double-Click on the folder box for Database Path, locate the QuickBooks file and hit Select. (Note: If you re not sure what the complete QB database path is for the QuickBooks file, bring up QuickBooks, bring up the QuickBooks file and Click F2. If the QuickBooks file is on a mapped drive, enter the complete path that s returned when you hit F2) Critical Step: It is required that you also locate and define the location of the correct version of QuickBooks used with this QuickBooks File - (use the QBW32.exe file). 8. Critical Step: Uncheck the Close QuickBooks box if you do not want the SaaS ETL to shut down QuickBooks before it executes the Upload Task(s). 9. Critical Step: Disable the SaaS Schedule Service - Click Start Control Panel Administrative Tools Services (Note: For Windows 7 & 8, Click Control Panel Systems & Security Administrative Tools Services For Windows 8 click Services on the Start menu) and look for SaaS Schedule Service. If present, Double-Click and set Startup Type to Disabled, Click Apply and then Click OK. 10. Critical Steps: Before testing the connection to the QuickBooks file, you will need to start QuickBooks, log in as the Admin, open the company file you want to configure and confirm Multi-User mode. 11. Also, before hitting Test Connection, be sure to do the following to allow accurate data extraction. a. Critical Steps: In QuickBooks, go to Edit -> Preferences, select Accounting, select Company Preferences tab, and confirm that Show lowest subaccount only is unchecked. And, that Use Account Numbers is checked. b. select Reports & Graphs, select Company Preferences tab and confirm that under Reports - Show Accounts: By - Name Only is selected 12. Click Test Connection. This action opens a dialog screen on the QuickBooks application called QuickBooks Application with No Certificate. 13. Critical Steps: On the QuickBooks Applications with No Certificate dialog screen, choose the following options: a. Yes, always; allow access even if QuickBooks is not running webkpi SaaS ETL Connector Version V 1.6 Page 7

8 b. In the Login as: selection box, select webkpi and Click Continue c. The Confirm to Proceed window will open. Click Yes and the Access Confirmation window will open d. Click Done and the ODBC Test will indicate Successful Connection. e. If the test is not successful, see Connection Trouble Shooting on Page Click Ok on the ODBC Test window. 15. Click Save on the SAAS Task Configuration window and the SAAS Scheduler will be populated with the tasks to be run. 16. Critical Step: At this time, Click No on the Execute task window 17. Note: On the initial install and configuration, select one Task (highlight) and Click Load. Note: If there are checkmarks in front of the upload tasks, ignor them. Do not remove them. The SaaS Run Now Peri.. window will open. Set the date range to just a few days and Click Ok. This upload will confirm that the SaaS ETL can execute an upload task successfully. webkpi SaaS ETL Connector Version V 1.6 Page 8

9 18. Critical Step: Run upload task Chart of Accounts with a date range of just a few days. Contact webkpi to check for duplicate account numbers. 19. On the initial load to get all of the data (the historical upload), for QuickBooks files that are smaller than 200MB, select the tasks in the SaaS Main Window one by one, and set the Start Date to the earliest date in the QuickBooks file, set the End Date to the current date and Click OK. It s very important to run each Upload Task from the earliest Transaction date to the current date.the data upload job for this task has been created and will now begin to execute. Run the upload tasks one at a time, waiting until one upload task executes completely before running the next upload task. 20. If you left the Close QuickBooks box unchecked in Step #8 and you re running the Network version of the SaaS ETL, it will execute without closing QuickBooks. Otherwise, the task manager will now pause for 1 minute. This message will be displayed on everyone s computer who currently has this QuickBooks file open and/or is using the version of QuickBooks specified in Step #7 above, and will allow them 1 minute to close the file and exit QuickBooks. If QuickBooks is still open on your computer, it will close after one (1) minute. Then, the task will execute and upload data. If you know that no one is using this QuickBooks file or version of QuickBooks, Click OK. Note: Do not enter anything until the SaaS ETL completes the upload and the Green status bar is gone even if a QuickBooks login appears. Note: If the QuickBooks file is larger than 200MB, then the initial total data upload will need to be broken into managable date range blocks, especially the webkpi Accounting task. webkpi SaaS ETL Connector Version V 1.6 Page 9

10 Changing to Another QuickBooks File This also covers the case for the same company when the QuickBooks filename or file location has changed. Select (highlight) all of the Upload Tasks for the company (don t do anything with the checkmark in the box before the upload task name) and click Delete Follow the instructions below for Adding Another QuickBooks File Adding Another QuickBooks File To add another QuickBooks file to the SaaS ETL data upload process, start the SaaS ETL, and in the SaaS Main Window, Click Add. This will put you at Step #5 on Page 6 of the webkpi SaaS ETL Connector Installation and Configuration Guide. Before you start, go to Initialize Computer, Quickbooks and QuickBooks File on Page 4 and initialize this QuickBooks file. When you reach Step #7 on Page 7, be sure to enter a unique name for the company Short Name, or if it s the same company, but a new QuickBooks file, select the Short Name that you previously defined. The Short Name should be something that will associate the Upload Tasks with the QuickBooks file, because once you complete the configuration for this additional QuickBooks file, you ll have double the upload tasks. Adding Another QuickBooks File to Another Dataspace To add another QuickBooks file, but upload data to a different Dataspace, start the SaaS ETL, and in the SaaS Main Window, Click Switch. This will put you at Step #4 on Page 4 of the webkpi SaaS ETL Connector Installation and Configuration Guide. webkpi SaaS ETL Connector Version V 1.6 Page 10

11 Balance Sheet Comparison To check and see if you picked up all of the data in the QuickBooks file, compare the Balance Sheet in webkpi with the Balance Sheet in QuickBooks. If they match, then that s a good indication that you ve picked up all of the historical data. If they don t match, it usually means one of three things: 1. You didn t go all of the way back to the beginning of the QuickBooks file. 2. The initial balances in the QuickBooks file were entered as Balances, and not Transactions. webkpi pulls the transactions. 3. The webkpi Balance Sheet is Accrual Method and you might be looking at a QuickBooks report using Cash Method. Connection Trouble Shooting 1. If unable to test connection to QuickBooks file successfully (see pages 5-7), confirm that: o o webkpi user exists in QuickBooks file Under Company Users Under Edit Preferences Integrated Applications that: SAAS ETL & webkpi are ( ) re: Allow Access SAAS ETL Properties Access Rights Allow this application to read and modify this company file Allow this application to log in automatically Login as webkpi webkpi Properties Access Rights Allow this application to read and modify this company file Allow this application to log in automatically Login as webkpi 2. If SAAS ETL fails to execute, confirm that QuickBooks file is in Multi-user Mode 3. If SAAS ETL executes successfully, but only 1 record uploads, check the log file to see if the upload task failed to complete. Setting The Days Back Note: The default number of days back is 30 days. To change the number of days back that the SaaS ETL will use to go back from the current date to start extracting data, initiate the SaaS ETL to open the SAAS Scheduler. Open the QuickBooks file and confirm Multi-User mode. Highlight a SaaS ETL task and then hit the Edit Button on the lower left. Note: You will need to make this change for each SaaS ETL task. webkpi SaaS ETL Connector Version V 1.6 Page 11

12 Hit Next until you get to the Task Schedule window that you see at the right. Click OK on the Read Me window that pops up first. Also, you do not have to test the connection when prompted. Set the Days Back field to the number of days that you would like the SaaS ETL to go back from the current date to start extracting data. Click Save. Running Daily Uploads Note: When preparing to run an upload by Double- Clicking on the.vbs script or setting up a Scheduled Task to run the.vbs script, be sure that other behind the scenes applications will not be trying to access your QuickBooks file at the same time that the uploads are scheduled to run. For example: an automated file backup system or a virus checker solution that will possibly be accessing the QuickBooks file at the same time that the webkpi SaaS ETL is trying to connect to the QuickBooks file. There are three (3) ways to run the regular data uploads: 1. Run each Upload Task separately as you did above when you ran the initial Historical data uploads. 2. Go to the folder C:\Program Files (Windows 7 & 8 - C:\Program Files (x86)), Double-Click on the folder webkpi and when the folder opens you ll see 2-3 file names ending in.vbs. These are vbs scripts. Double- Click on the file that ends in.vbs but not the file whose name includes ALL_Data or AllHistory. By Double-Clicking on the.vbs script, you will begin the process that will run all of the upload tasks. The correct.vbs script will be the file named (your Dataspace name) with a.vbs appended to the end. 3. Create a Windows Scheduled Task that calls the.vbs file described above. (For Windows 7 & 8, see Step 4 below.) For Windows XP and earlier versions of Windows, do the following: a. Click Start Click Control Panel Double- Click Scheduled Task Double-Click Add Scheduled Task webkpi SaaS ETL Connector Version V 1.6 Page 12

13 b. The Scheduled Task Wizard Opens: c. Click Next and you ll be asked to browse and select the program that you want to run. Browse to the.vbs script described above in #2 and Click Open. d. Enter a name for this Scheduled Task, select when you want the Scheduled Task to be run and Click Next. e. Select Scheduled Task Start Time, the Day you want the Task to run, the Start Date and Click Next f. Enter Username and Password 4. Create a Scheduled Task in a Windows 7 & 8 environment. Open the Task Scheduler window and Click on Create Basic Task webkpi SaaS ETL Connector Version V 1.6 Page 13

14 a. This will start the Create Basic Task Wizard. Enter a name for your scheduled task and, if you like, an optional description and then Click Next. b. The Task Trigger window will open. Select when you want your Scheduled Task to start, and Click Next. c. The Daily window will open where the user can enter the Start Date, Start Time and days that the Task will reoccur. Then click Next. webkpi SaaS ETL Connector Version V 1.6 Page 14

15 d. The Action window will open and the user will select Start a program. Click Next. e. The Start a Program window will open and the user will enter or Browse for the.vbs script that will be found in the C: \Program Files (x86)\webkpi folder Note: the (x86) is a Windows 7 & 8 feature. The correct.vbs script will be the file named (your Dataspace name) with a.vbs appended to the end. Select the.vbs file to run and click Next Appendix A: MS Windows 7 & 8 Install UAC Setting User Account Control (UAC) is a new Microsoft feature that helps prevent malicious programs, also known as "malware", from damaging a system. UAC stops the automatic installation of unauthorized applications. UAC also prevents unintended changes to system settings. On a computer with Windows 7 & 8, the UAC settings need to be turned OFF. Restart the computer after setting the UAC profile for the changes to take effect. See screen example. Windows 7: Click the Start Button Type UAC Click Change User Account Control Settings Turn off Windows 8: Click Settings Control Panel User Accounts Change User Account Control Settings Turn off Note: For Windows operating system Vista, the UAC needs to be turned on. webkpi SaaS ETL Connector Version V 1.6 Page 15

16 Appendix B: Uninstall SaaS ETL Connector To re-install SaaS ETL Connector, uninstall as follows: 1. First, execute SaaS ETL by Double- Clicking the icon on the desktop: This will bring up the SaaS Main Window. Select all tasks and Click delete. This will remove these company specific upload tasks from the webkpi server. 2. Click Start -> Click Control Panel -> Double-Click Add or Remove Programs locate and Click SaaS ETL -> Click Change/Remove 3. Click Yes -> System will report that SaaS ETL Has Been Successfully Uninstalled -> Click Ok 4. Delete the c:\program files\webkpi folder if it exists (or c:\program file (x86)\webkpi on Windows 7 & 8 or Vista Computers.). 5. Also check the service tray on your computer and exit or remove any SaaS processes. 6. Click Start Control Panel Administrative Tools Services and look for SaaS Schedule Service. If present, Double-Click and set Startup Type to Disabled. 7. Check the Windows Task Manager (ctrl-alt Del) and remove any SaaS processes (Select and End Process): 8. In QuickBooks, switch to Single User Mode, edit Preferences Integrated Applications Company Preferences Select SaaS_ETL and Click Remove, and then Click Yes. 9. Go to Step #1 on Page 4 webkpi SaaS ETL Connector Version V 1.6 Page 16

17 Appendix C: QuickBooks Error Messages QuickBooks Compatible add-on programs (also referred to as third party programs) generally use the SDK (software development kit) provided by Intuit. This allows them to exchange information with QuickBooks in a controlled and secure fashion. If your QuickBooks Compatible program is failing but the error message it gives to you is vague, there is a log file that contains information that might be helpful. Look for a file named qbsdklog.txt. The location varies with the operating system you are using. Here is a sample of that file, showing a typical error. The error code is highlighted. Error Cannot access QuickBooks file The usual resolution for this, if you had a program that was working but then stopped working after you installed an upgrade to a new version, is to remove permission for the program from QuickBooks, then re-establish permissions. To remove permissions you must be logged in to QuickBooks in single user mode as the Administrator. Select Edit then Preferences and select the Integrated Applications preference. Click on the Company Preferences tab. Locate the QuickBooks Compatible program in the list, select it, and Click the remove button. Please note that this is not an un-install your program is still installed on your computer. You are just removing information about it from this QuickBooks company file (you need to repeat this for each company file you are having problems with). Click OK to close this window. Next you need to follow the setup instructions in your other program usually this just means running the program (while still logged in as the admin in single user mode) and telling QuickBooks that it is OK for this program to access your data something similar to the following: webkpi SaaS ETL Connector Version V 1.6 Page 17

18 Windows Vista and Windows 7 & 8 If you are using these operating systems please note that you can receive these errors if: Vista User Account Control (UAC) is set to off. Intuit requires that you have this set on for all third party programs to work correctly (including those offered directly by Intuit) and it is a good idea to have it on anyways. You didn t install QuickBooks and the QuickBooks Compatible programs to run with standard user permissions you do NOT want to run them with elevated permissions. You don t have your QuickBooks company file in the proper folder, such as the PUBLIC folder in a network I can t explain why, but in at least two instances s I resolved the problem by turning UAC off, rebooting the computer, turning UAC back on, and rebooting the computer again. That shouldn t matter, but it seemed to work. webkpi SaaS ETL Connector Version V 1.6 Page 18

19 Error code F3 - Could not start QuickBooks Here is an update on this issue. Turn UAC off, and then try to register QuickBooks integrated application. Error: 1062: Duplicate entry insurance for key 1. Executing: CREATE UNIQUE INDEX id Chart Of Accounts(Account Number) Duplicate account numbers can be resolved by using the account numbers. In QuickBooks, there can be no duplicate account numbers while there can always be account name duplicates. In QB, go to Edit Preferences/Accounting/Company Preferences. If you would like to add account numbers, this will create the setup profile. If you prefer not to use account numbers, then you need to be aware that you cannot have the same account name twice in the account description. For example: Owner 1 Owner 2 Contributions Withdrawals Contributions Withdrawals Even though the account names Contributions and Withdrawals are used as sub accounts, in exporting to another database, they are viewed as duplicates. So you would have to rename to make unique. Error: 1054: Unknown column 'Date_Begin' in 'field list' An issue with the auto-update feature in QuickBooks Web Connector Here are the registry key instructions for reference: Close QuickBooks and the QuickBooks Web Connector, if they are open. * In the Windows Start Menu, choose "Run...". Type "regedit" in the text field in the Run window that opens, and Click "OK" to run the Windows Registry Editor. * In the left hand column of the Registry Editor, you will navigate to the settings for the Web Connector. To do this, open My Computer, then HKEY_CURRENT_USER, then Software, then Intuit, then QBWebConnector, then Scheduler. * Under Scheduler, you will see a folder for Minute7. Right Click on the folder, and select "Delete" to remove the entire Minute7 folder of registry settings. After the folder has been deleted, you can close the Registry Editor. * Reopen QuickBooks and the QuickBooks Web Connector. The auto-update box should not be selected, and for now, we recommend that you leave it unchecked. To sync with Minute7, simply make sure the Minute7 application is checked off to run, and Click "Update Selected" in the upper left of the Web Connector window. Error F3 : This application is not allowed to log into this QuickBooks company data file automatically. The QuickBooks administrator can grant permission for an automatic login through the Integrated Application preferences. webkpi SaaS ETL Connector Version V 1.6 Page 19

20 Error: No data files found to upload. This is a false positive error message. Simply the task that is being generated has no data in QuickBooks for the period selected. Error Could Not Start QuickBooks Recent changes to your configuration requires you (the QuickBooks Administrator) to go into the Integrated Applications Preference and reauthorize your application to login automatically. Exit the error. Open QuickBooks with the correct company file, logged in as the QuickBooks Administrator and in single-user mode. You must have Administrator privileges to perform the functions described below. From the top QuickBooks menu; choose Edit, Preferences, scroll to Integrated Applications, and choose the Company Preferences Tab. If the program is not listed, exit the Preferences section and run the program again, granting permissions as shown below. If the applications are present, make sure that the top two boxes on this screen are not checked. Below these check boxes is a box listing applications that have requested access to your QuickBooks company file. Make sure that there is a check mark under the "Allow Access" column, highlight the application name, and Click on the Properties button. In this window, you will want to make sure "Allow this application to access this company file" is checked and "Allow this application to login automatically" is also checked. The "Login as" drop down box should be set to Admin or someone with the same privileges as the Admin. Additionally, you will want to make sure that "Allow this application to access Social Security Numbers, customer credit card information, and other personal data" is also checked. Error 6190, -816: QuickBooks was unable to open the company file when opening a file QuickBooks was unable to open the file [path\filename] on the host computer [host name]. Try opening the file with QuickBooks on the host computer or run the QuickBooks Database Server Manager on the host computer and then try opening the file on your computer. This error can be caused by a mismatch between the transaction log file (.tlg) and the company file (.qbw). This error can also occur if the company file was copied to a different computer and updated without the associated transaction log file. How to fix it Intuit recommends 3 solutions for this problem. The first solution may solve your problem, or you may need to try all 3 to resolve the issue. For best results, perform the solutions in the order shown. Solution 1: Download the QuickBooks Company File Diagnostic Tool 1. Download and run the QuickBooks Company File Diagnostic Tool. 2. If the tool detects data damage, you have 2 options: Restore a recently backed up company file. webkpi SaaS ETL Connector Version V 1.6 Page 20

21 Solution 2: Download and run the QuickBooks Connection Diagnostic Tool 1. Go to the QuickBooks Connection Diagnostic Tool page. 2. To download the tool, enter your address and select I agree to the Terms and Conditions. 3. Follow the wizard to install and use the tool. Note: Instructions for using the tool can be found on the How to Use the Tool tab. If you see File Open successful (all Advanced statuses have green checkmarks), your network connection is OK, and you should be able to open the file. If you still encounter the error, try solution 3. Solution 3: Rename the.tlg file 1. Right-Click the Windows Start button and choose Explore (in Windows 7 & 8 select Open Windows Explorer). 2. Go to the folder containing your company file. 3. Locate the transaction log file. It has the same name as your company file, but with a.tlg extension. 4. Right-Click the transaction log file and choose Rename. 5. Enter a new name, for example companynameold.tlg. 6. Try to open the company data file. If you are successful, create a QuickBooks backup. Note: Deleting the transaction log file (.tlg) is not recommended because it can be used to recover lost data. When you need to move the company file from the server to another computer to work in it: 1. Create a manual backup of the file to clear the.tlg file. 2. Copy both the company and.tlg files to the other computer. 3. Repeat Steps #1 and #2 to copy the file back to the server. webkpi SaaS ETL Connector Version V 1.6 Page 21

22 Taking Long Time to Export There are a number of factors regarding sync time including QuickBooks file size and speed of the computer/server doing the sync. Typically, a 100Mb QuickBooks file can take up to a few hours for the initial sync. This is primarily dependent on your system s performance with the processor and amount of memory the most important elements. The sync app simply pulls the data from the QuickBooks file and stores it in an encrypted file on the system s hard drive. Internet speed is not an issue at this point. Once the sync is completed the sync app sends the file to the webkpi servers with this part taking roughly 1 minute. Sync times are completely dependent on how fast the system can run QuickBooks. The minimum system configuration for syncing a QuickBooks file is recommended to be: o o o (1) 2 Ghz, Dual Core processor 4Gb of Ram 80Gb Hard drive Error QuickBooks Unrecoverable/Unknown Error Some clients may experience a QuickBooks Unrecoverable/Unknown Error when syncing their QuickBooks file to a third party application. This can happen if the QuickBooks company file for which you are synchronizing has data damage. This is an error with your QuickBooks file. To resolve this issue you must Verify and Rebuild your QuickBooks file: 1. Make a backup copy of your QuickBooks file. 2. Open the QuickBooks file and verify by Clicking File > Utilities > Verify Data. 3. After the verification has completed, rebuild your data. 4. Open the webkpi Application and attempt to sync with QuickBooks again. If the above steps do not resolve this issue then follow the steps below: 1) Make a backup copy of your QuickBooks file. 2) Close QuickBooks. 3) Navigate to the QuickBooks installation directory. This is typically C:\Program Files\Intuit\<QuickBooks version>. 4) Run the reboot.bat file. 5) Restart the machine. 6) Remove the webkpi application from the list of Integrated Applications (within QuickBooks, Edit >> Preferences >> Integrated Applications >> Company Preferences). 7) Execute the process and re-authorize the webkpi application. webkpi SaaS ETL Connector Version V 1.6 Page 22