nopCommerce

Where is the plugin configured?

You just need to install the plugin. The plugin is configured on Connex for QuickBooks' website. The plugin just installs a web service and the DLLs for it to build.

Install Plugin Files

Connex needs a nopCommerce plugin installed on the server hosting the website. Here are the steps for installing the plugin:

  1. Login to the admin of your nopCommerce website.
  2. On the top right, note your build number (3.3, 3.4, etc.)
  3. Download the nopCommerce Connex for QuickBooks plugin
  4. Open the zip file.
  5. If you see a folder called nopQBConnex, double click it.
  6. Match the build number from step 1 with the build number folder and double click the folder. 
  7. Merge the plugins folder with the plugins folder of your website. To see a screenshot, click here.
  8. Merge the contents of the folder with your website.
  9. Merge the QBOWebService.asmx, located in the folder with nopCommerce version numbers, of the zip file with the root of the site.
  10. Login to nopCommerce.
  11. Go to Configuration > Plugins.
  12. Go to Accounting.QuickBooks > Install.

This plugin requires no configuration inside of nopCommerce. All of the settings are done on our website. The plugin installs the files necessary for the QBOWebService.asmx file to work.

 

Testing

If the installation was successful, you will see a blue and white screen at http://www.yoursite.com/qbowebservice.asmx. All of your settings are configured on the Connex website. Click here to see a screenshot.

Here is a screenshot of a nopCommerce version number:

Here is the end result:

 

Connex for QuickBooks

Next, go to Connex for QuickBooks and pair nopCommerce and QB:

  1. Login to connexforquickbooks.com with your Intuit account
  2. On the my connections page, choose nopCommerce
  3. Enter your admin user name, password, and your website URL. 

Upgrading

If you are upgrading your existing plugin, follow the steps above to step 8. Login to your website and click restart application.

Order Payments

Our system can create invoices for unpaid orders. When you choose settings on cloudcartconnector.com, choose invoices payments if paid. Make sure that the order has no paid date. The system will pick up the order and create an invoice only. Our system will query orders from five days ago to see if there was a payment status change. If so, it will create a payment for the invoice at a later time. 

Can I filter orders by nopCommerce store?

If you use nopCommerce versions 3.6 and lower, please contact us. In this example, we will use two separate connections for two separate stores. The site URL is http://www.mysite.com and it has an SSL:

  1. At the Cloud Cart my connections page, enter your nopCommerce admin login and http://www.mysite.com as the site URL.
  2. On the configure page, click the second tab that says QB export.
  3. In the store list field, enter a comma separated list of nopCommerce store names. You can find the store names by logging in nopCommerce, going to configuration and clicking stores: stores.png
  4. Complete the settings and click submit.
  5. Click my connections.
  6. Click add new connection.
  7. Enter your nopCommerce admin login.
  8. As the site URL, enter https://www.mysite.com.
  9. Click the second tab on the configure page and enter your store name.
  10. Click submit.

How do I map custom fields?

In this example, we will create a custom field called other and give it a value of test.We will map the value to the QuickBooks other field. Here is the end result. Here are the steps:

  1. Go to the Connex rules engine.
  2. Add this rule to map a custom field to the other field.
  3. Contact us by email with your nopCommerce version. We will email you the source code.
  4. In the source code, open JMAWebServiceCommon.cs.
  5. Find this line: JMAOrder jmaOd = new JMAOrder();
  6. Beneath it, add this method: AddCustomFields(jmaOd);
  7. Here is the source for the method:
private void AddCustomFields(JMAOrder jmaOd)
{
    //the accounting and e-commerce name fields are used to find the field and map it in QuickBooks
    jmaOd.JMACustomFields.Add(new JMACustomField()
    {
        AccountingName = "Other",
        ECommerceName = "Other",
        Value = "Test"
    });
}
Have more questions? Submit a request
Powered by Zendesk