Support Center

Connecting to Volusion

Follow

 

Volusion is available as a shopping cart system at Shopgate.

By setting up a connection in your Volusion shop to Shopgate, you will get these wonderful features straight into your mobile shop and apps:

 

Supported Version Import to Volusion

Volusion "Pro" and "Premium" plans

  Orders
Sync Export to Shopgate Mobile Shop

Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page



Products
Categories
Reviews


Customer Account Validate, upon Cart Changes

Login with Desktop Shop Account
Login to Desktop Shop with Mobile Account
Customer Groups / Tier Pricing
Show Desktop Orders on Mobile



✘ / ✘
Coupon
Shipping Method
Payment Method
Product Availability



Supported Payments Notes
Authorize.net

Tiered Pricing and Customer Groups are NOT supported at the moment.

 

In this article, you will find the instructions to set up a connection to Shopgate for your Volusion shop.

 

Topics covered in this article:

  1. Getting started
  2. Building your mobile shop
  3. Mapping payment methods
  4. Frequently Asked Questions (FAQ)

 

1. Getting started

1.1 Creating an API administrator

To create a mobile shop from your Volusion backend, an API connection is required. Your orders and product imports / updates will be processed via the secure API method. Please follow the steps here to create an API admin user:

  1. Log into your Volusion backend and navigate to Customers -> Administrators.


  2. On the page, click ADD.


  3. Enter the Basic Customer Info. Set Access Key to "Administrator". Choose an email Address and a safe password.


  4. Scroll down to "Special Privileges" and check "Is Super Admin." Click Save.

 

Now the page will refresh and an ID will be created for this API admin user. A new API admin user has been added in your Volusion backend.

 

1.2 Editing Access Rules

With this API admin user, your mobile shop can now talk to your Volusion backend. Please edit access rules so your mobile shop can receive updated information such as user accounts, orders, products and more.

  1. Click the red link Edit Cust#n Access Rules (n is the ID) under "Administrator".


  2. Click Check All and Save.

 

1.3 Enabling product import & export in XML format

You're almost there!

  1. Navigate to Inventory > Import/Export.


  2. Click on Volusion API. Check both boxes for "Enable the public XML for Featured Products" and "Enable public XML for All Products", click both Save buttons.

 

1.4 Finding your "Product export URL"

Now that you have created an API admin user, you can soon start building your mobile shop! In order to do that, all you need is to find your "Product export URL" to make the connection.

  1. On the page where you left off from the previous step (Inventory > Import/Export > Volusion API), click Get Help text in the top right corner and select Get help with this page.


  2. A pop-up window will open. Click Volusion API Integration Help.


  3. In the drop-down box next to Export, select Generic Products. Select the email address you used to create the API account. Now click on the second section "URL with Query String and General Information for Importing and Exporting" to review a URL at the bottom.

 

This is the URL your mobile shop needs to communicate to your shop system. Now continue to the next chapter to enter it in your Shopgate Admin.

 

2. Building your mobile shop

2.1 Establishing a connection to Shopgate

To establish a connection between your Volusion backend and your mobile shop, enter the URL for importing and exporting your products. Follow the steps below:

  1. Log in to your Shopgate Admin page.
  2. Click on Integration from the menu bar, then select Install Interface.


  3. In the drop-down labeled Select a system, start typing Volusion and select it when it appears.


  4. A popup opens. Paste the URL you found in Chapter 1.4 in the text field. Click connect to establish the interface.


  5. If a connection is made successfully, a popup shown below will open. Here you will be able to assign jobs for your first connection. We recommend leaving all assignments to ON at this time. Click Save.


  6. Congratulations! Now you should see the progress bar running, and the Shopgate backend automatically filling your mobile shop with your products.

 

Depending on how many products you have, the import process can take anywhere from a few minutes to a few hours. You can always check the status of the imports. If no status bar is shown, it means either the import is finished, or no import is running at the moment. Welcome to the mobile world :)

 

2.2 Activating your mobile website

To redirect mobile visitors to your mobile website, a few lines of codes need to be modified in your main template file. Follow the steps below to do so.

  1. In your Volusion backend navigate to Designs > File Editor. On the right, click on your main template file, that’s usually the first one under Shortcuts > Template Files.


  2. Copy these JavaScript codes and paste them into the marked position of your template file (right below the opening <head> tag):
    <!-- SHOPGATE MOBILE HEADER START -->
    <script type="text/javascript">
    var _shopgate = new Object();
    _shopgate.shop_number = "YOUR_SHOP_NUMBER";
    var shopgateRegHome = /^https?:\/\/[^\/]+(?:\/?(?:default\.aspx?)?)?(\/?\?.+)?$/i
    var shopgateRegCategory = /(-|_)s\/([0-9]+)\.htm(\??.*)$/
    var shopgateRegProduct = /(-|_)p\/([-a-z0-9]+)\.htm(\??.*)$/

    if (/\sg_debug=1$/.exec(document.URL) != null) {
    window.navigator = new Object({"userAgent":"RedirectBot"});
    }
    if (shopgateRegProduct.exec(document.URL) != null) {
    _shopgate.redirect = "item";
    _shopgate.item_number_public = RegExp.$2.toUpperCase();
    } else if ((shopgateRegCategory.exec(document.URL) != null)) {
    _shopgate.redirect = "category";
    _shopgate.category_number = RegExp.$2;
    } else if (shopgateRegHome.exec(document.URL) != null) {
    _shopgate.redirect = "start";
    } else {
    _shopgate.redirect = "default";
    }

    _shopgate.is_default_redirect_disabled = true;

    _shopgate.host = (("https:" == document.location.protocol) ? "https://static-ssl.shopgate.com" : "http://static.shopgate.com");
    document.write(unescape("%3Cscript src='" + _shopgate.host + "/mobile_header/" + _shopgate.shop_number + ".js' type='text/javascript' %3E%3C/script%3E"));
    </script>
    <!-- SHOPGATE MOBILE HEADER END -->
  3. Replace YOUR_SHOP_NUMBER (line 4) with your shop number at Shopgate. Then click SaveWhere can I find my shop number?

 

Now you have activated your mobile website.

 

3. Mapping payment methods

To show your Shopgate mobile orders correctly in your shop's backend, please create 2 payment methods in your shop's backend, and then map them to Shopgate payment methods in your Shopgate Merchant Area.

3.1 Creating 2 payment methods

First of all, please create 2 payment methods as instructed below.

  1. In your Volusion backend, navigate to Settings > Payment.


  2. Go to tab More Payment Types. Enter "Shopgate" into the field Custom Type and click ADD. Repeat the step - enter "Mobile Payment" into the field and click ADD.


  3. Uncheck the boxes in front of the two newly created payment types. Click Save.

 

3.2 Finding the payment IDs

Now find out the IDs of both payment methods.

  1. On the top right click View List.


  2. Note down the ID values in front of the two newly created payment types.

 

3.3 Entering the IDs at Shopgate

  1. Log in to your Shopgate Admin page, and navigate to Integration > Install Interface. On your connection to Volusion, click on Actions, then Edit. The settings page for your Volusion connection will open.


  2. At the bottom of the settings page, enter the IDs you noted down for the two newly created payment types. Click Save.

 

4. Frequently Asked Questions (FAQ)

4.1 Where can I find my Volusion settings at Shopgate?

If you have updated your Volusion API keys or other configurations, you need to update the same info for your mobile shop.

To do so, log into your Shopgate Admin page, and navigate to Integration > Install Interface. On your connection to Volusion, click on Actions, then Edit.

Configure your connection in the settings page below. Detailed explanations for options listed can be found below.

When should the order be transmitted?

Orders can be transmitted right after they were placed or after they were paid. Since Volusion does not support updating orders it’s highly recommended importing them after they were paid.

Debug

This enables advanced debugging for your connection and is usually used by our developers only in case you’ve got a problem.

Advanced error logging

This will break all operations over your connection even on minor errors, making it easier to find the source of a problem if you have one for our developers.

Export "zero amount" products

When enabled, free products (price is $0) will be exported to your mobile shop.

URL to your shop

The plain URL to your shop. This is usually automatically generated when connecting and doesn’t need to be changed.

The API login email address

The email address of the account you created for API access. This is usually automatically generated when connecting and doesn’t need to be changed.

The encrypted API login password

The encrypted API password from the link you get from your Volusion help. This is usually automatically generated when connecting and doesn’t need to be changed.

Volusion export of product names

Choose which field to export as your product’s names from the Volusion API.

Discount level for products at Shopgate

Choose which discount level in your Volusion store should be used to export pricing.

Weight unit for products

Configure the weight unit you’re using in your Volusion store.

ID of the payment method "Shopgate" in your Volusion store

The ID of the payment method that’s assigned on incoming orders paid via payment methods managed by Shopgate.

ID of the payment method "Mobile Payment" in your Volusion store

The ID of the payment method that’s assigned on incoming orders paid via payment methods managed by you.

 

4.2 Why do I need to create an API admin for my mobile shop?

Please make sure to create a separate API admin user for your Shopgate mobile shop.

The reason for this is that Volusion forces a password reset every few months. When this happens, your mobile shop will not be able to communicate to your Volusion backend via the API unless you update the password in the Shopgate Admin. In other words, your mobile shop will not be updated automatically.

 

4.3 Why do products with children sometimes show as inactive in my mobile shop?

Because of a limitation in the Volusion API, the child product names MUST match the parent product's name. Otherwise, the child products cannot be mapped to the parent product.

For example:

Parent: A nice sundress
Children: A pretty sundress - <Color> - <Size>

The part before " - <Color> - <Size>" must be exactly the same for parent and child products.

If you experience this problem, please edit the product names in Volusion so they match.

 

4.4 Do I need to update my mobile shop in the future?

You do not need to manually update your mobile shop. Whenever there is an update in the Shopgate software, we will update your shop via API method automatically.

 

4.5 I am receiving emails about orders not getting imported into my Volusion store. What should I do?

If you have set up your mobile shop following this document but the orders are not imported to your Volusion store, please try the following steps:

  1. In your Volusion system navigate to "Inventory" > "Import / Export" > "Volusion API", and click the "Run" button on "Generic\Orders".

  2. On the next screen, click the orange "Run" button".

 

If you still receive emails about orders not getting imported after these steps, please contact your support team at support@shopgate.com.

 

 

Comments