Preparing ProductCart: Install the Synchronizer

Last Updated: Oct 09, 2014 08:00PM EDT
Installing the ProductCart Synchronizer for use with QuickBooks® is very easy. The following assumes that you have installed and activated ProductCart on your Web server. If you haven’t done so, perform the ProductCart installation as described in the "Getting Started" section of this support base, and then continue with the instructions below.
 

Parent Paths Enabled

ProductCart v5 and the QuickBooks Synchronizer no longer come with a version of files that are compatible with web servers where Parent Paths have been Disabled... so make sure that Parent Paths are ENABLED on your web server.
 

Step 1 - Back up your store


If you haven't already done so, back up your store database.

You will not need to turn your store off as the files you will be uploading to it will not interfere with your storefront.
 

Step 2 - FTP new files to your server


Upload the files to their respective folders, overwriting the existing files. DO NOT delete any of the files that are currently on your Web server.
  • pcadmin
    Most of the ProductCart Synchronizer files will go into the pcadmin folder. Please note that the pcadmin folder has likely been renamed on your store. We recommend that you rename the same folder in the update files locally on your computer so that when you FTP the files there is no chance that a new pcadmin folder is created, which would mean that some of your store files are not being updated.

The ProductCart Synchronizer contains around 80 files for a total of roughly 3 MB. Make sure that once the FTP process has finished, your FTP client reported a success message. Most FTP programs have a way to show whether some files were uploaded successfully or not. If needed, repeat the FTP upload until successful.
 

Step 3 - Setup ASP.NET Application Directory


After all of the files are successfully uploaded to your server you must designate the “pcadmin/Quickbooks/webservice” folder an “ASP.NET application directory”. Your Web server must be running the ASP.NET 2.0 framework or above.

Dedicated Server

If you have a dedicated Web server and therefore have direct access to IIS (Internet Information Services), you can quickly and easily make any folder an application folder by doing the following.

IIS 6
  • Launch IIS, locate the Web site, and browse to the “webservice” folder.
  • Right-click on it and select Properties.
  • On the Properties window, select the Directory tab. Click on the Create button next to Application Name. This turns the folder into an application folder.
  • Under the ASP.NET tab, make sure that ASP.NET 2.0 or above is selected. Otherwise, change the selection.
  • Click OK

IIS 7
  • Launch IIS, locate the Web site, and browse to the “webservice” folder.
  • Right-click on it and select Convert to Application.
  • Click OK
Shared Server
Find out whether your Web hosting Control Panel contains a tool to configure this setting. Many Web hosts allow you to make a folder an application folder (e.g. see instructions below for GoDaddy).

If such a tool is not available, open a support ticket with your Web host and ask them to convert the “QuickBooks/webservice” folder into an “ASP.NET application directory”. This Microsoft article contains very specific instructions.

Here are instructions specific to some Web hosts.
 
GoDaddy
Log into your GoDaddy account, go to the section where you can manage your Web hosting accounts, then click on “Manage Account” next to the Web site that you are working with. When the Hosting Control Panel has been loaded:
  1. Select Content > IIS Settings from the top navigation menus.
  2. Check Content Root and click on the Create button.
  3. Enter the path to the “webservice” folder. For example, assuming that your “productcart” folder is in the root, has been renamed “shop”, and that the “pcadmin” folder has been renamed “myControlPanel”, the path to enter in the “Directory Name” input field would be: shop/myControlPanel/QuickBooks/webservice
  4. Check the check boxes next to:
    1. Anonymous Access
    2. Set Application Root
  5. Click on OK.
  6. The system will take a few minutes to perform the task and show “Pending Setup” next to the “webservice” folder name. Once it has been setup, try loading the file “ProductCartWC.asmx” in that directory. You should not receive any errors.

Step 4 - Update the Store Database

  1. Log into your ProductCart Control Panel
  2. Load the following URL:
    www.yourstore.com/store/pcadmin/QB_default.asp

    …where yourstore.com is the store URL, store is the name of the 'ProductCart' folder and pcadmin is the name of the Control Panel, which has likely been renamed
  3. You will be prompted to run the database update script
  4. Run the database update script. 
    Troubleshooting:
    • If you receive any errors or warnings (e.g. a table could not be updated), run the database update again. In some cases these errors disappear on the second execution of the update.
    • If the errors persist even after re-running the database update script a few times, leave the store OFF and open a support ticket by logging in to your account and scrolling down to the QuickBooks Synchronizer Ticket section of the page, and click on the link to open a ticket.
 

Step 5 - Validate the Installation


After the database update script is complete ProductCart will attempt to validate your installation. ProductCart will check for some of the most common issues, such as a file permission problem, and alert you if a problem is found. If ProductCart does not detect any problems you will be asked to proceed to the setup wizard, which will help you active the ProductCart Synchronizer for use with QuickBooks®.
 
File Permissions
A common issue at this stage consists of the pcadmin/quickbooks folder not having “delete” or “modify” permissions. This is normal as the initial ProductCart installation requirements do not call for these permissions within the “pcadmin” folder. You will need to add them now as the ProductCart Synchronizer needs these additional folder permissions.

To add “delete” permissions to the “quickbooks” folder, use the tools included in the Web hosting administrator area provided by your Web host, or contact your Web host sending the following message: “Please assign 'Delete' permissions to the 'store/pcadmin/quickbooks' folder for the Internet or Everyone user”, where the pcadmin folder has likely been renamed on your store, as mentioned elsewhere in this documentation (so adjust your message to the Web host company accordingly).
 

Step 6 - Proceed to the Setup Wizard


After completing these steps, the system will display a “No action to be taken” message, and you may continue to the Setup Wizard.


QuickBooks® is a registered trademark and service mark of Intuit Inc. in the United States and other countries.
647e99095133bd6d1ae916f97dc7f92f@productcart.desk-mail.com
https://cdn.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete