Shopping Cart Systems

Connect with your mobile customers using Shopgate.

Volusion

Volusion is a shopping cart system at Shopgate.

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

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.

Get started

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.

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. Follow the steps below to create an API admin user:

Create an API administrator

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



  2. 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 to your Volusion backend.

Edit 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.

Enable product import & export in XML format

  1. Navigate to Inventory → Import/Export.



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

Find 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 Volusion API Integration Help in Generic.

  2. 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 labeled "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.

 

Build your mobile shop

Establish 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 and navigate to Integration → Install Interface.
  2. In the drop-down labeled Select a system, start typing "Volusion" and select it when it appears.
  3. A pop-up will open. Paste the URL you found in Chapter 1.4 in the text field. Click Connect to establish the interface.



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



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

    Volusion1.png

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!

Activate your mobile website

To redirect mobile visitors to your mobile website, a few lines of code 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 your main template file. It’s usually the first one under Shortcuts → Template Files.



  2. Copy the JavaScript code 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.

Map payment methods

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

Create two payment methods

  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. Then, repeat the step by entering "Mobile Payment" into the field and click ADD.



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

Find the IDs for both payment methods

  1. On the top right, click View List.



  2. Write down the ID values in front of the two payment methods you just created.

Enter the IDs at Shopgate

Now enter the IDs in the settings dialog in your Shopgate Admin (Integration → Install Interface → Actions → Edit). Click Save.

Understand the settings

At your Shopgate Admin, you can enter or update your Volusion API credentials and configure a few export settings. To do so, follow these steps:

  1. Log into your Shopgate Admin and navigate to  Integration → Install Interface.
  2. On your connection to Volusion, click Actions, then Edit.



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

    volusion_settings.png

Import mobile orders to desktop shop after

Orders can be transmitted right after they were placed or after they were paid. Since Volusion does not update orders, we highly recommended importing them after shipping has been approved.

Debug

This enables advanced debugging for your connection and is usually used by our developers only if there is a problem.

Advanced error logging

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

Export product custom fields as properties

When this is ON, the custom fields associated with a product in Volusion will be exported as product properties in Shopgate. Note that the custom labels that can be created for product custom fields in Volusion will NOT be imported into your app and mobile website. Properties created from product custom fields will display the generic labels CustomField1, CustomField2, CustomField3, CustomField4, and CustomField5. To change the labels, contact your Shopgate Support at support@shopgate.com.

Export products with the price of $0

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.

Export product from Volusion using

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 to 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 to incoming orders paid via payment methods managed by you.

 

Frequently Asked Questions

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

Due to a limitation in the Volusion API, a child product can be mapped to its parent product only if the name matches that of the parent. If you experience this problem, please edit the product names in Volusion accordingly.

For example, the part before " - <Color> - <Size>" must be exactly the same for parent and child products:

Wrong:

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

Correct:

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

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.

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 into 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.

 

Was this article helpful?
Can't find what you're looking for?
Let us help you—submit a support ticket.
Contact Support