Support Center

Connecting to plentyMarkets

Follow

 

Shopgate supports plentyMarkets as a shopping cart system.

By setting up the Shopgate plugin for your plentyMarkets shop, you will get these wonderful features straight into your mobile shop and apps:

 

Supported Version Import to PrestaShop

All versions of plentyMarkets

  Orders
Sync Export to Shopgate Mobile Shop

Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page
Product Tax Classes, Rates & Rules





Products
Categories
Reviews
Related Products, Upsell & Cross-sell



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

N/A

Product variations and properties can now be exported.

If you use plentyMarkets as an ERP system for Shopware, please refer to instructions for Shopware 4 or Shopware 3.5

 

In this article, you will find everything you need to set up the Shopgate plugin for your plentyMarkets shop.

 

Topics covered in this article:

  1. Installing the Shopgate Plugin
  2. Establishing connections between plugin and Shopgate
  3. Activating your mobile website
  4. Setting up shipping rates

 

1. Locating the Shopgate plugin

The Shopgate plugin is compatible with all plentyMarkets versions and is pre-installed in your plentyMarkets shop backend. To locate the plugin, follow the surprisingly easy steps below:

  1. Log in to your plentyMarkets admin page.
  2. Navigate to the gear icon on the top menu bar, click Markets, and select Shopgate from the list.
  3. Click + Client (store): Standard to expand the configuration page for the Shopgate plugin. Leave this page open - we will explain the options in the next chapters.

 

 

2. Establishing connections between the plugin and Shopgate

A few simple tasks need to be done to connect your Shopgate mobile shop to your shop's backend:

2.1 Getting API credentials

  1. Log in to your Shopgate Admin and navigate to  Integration then  Install Interface
  2. In the drop-down labeled Select system, type plentyMarkets and select it.
  3. A popup opens. Look for Customer number, Shop number, API key, and Alias under 2. Configure. These are the API credentials the plugin needs to authenticate at the Shopgate backend. Leave this page open - we will come back to enter the URL (explained in 2.4 Connecting your shop to Shopgate)


  4. Copy Customer number, Shop number, API key, and Alias, and paste them individually onto the plugin configuration page you left open from chapter 1. Set Operating mode to Live, Stock buffer to 0, Quantity for items that are not limited to the stock to 100, and Maximum for item upload to 100. The rest of the settings can be configured later. Click the Save icon on top.

    Detailed explanations of the settings can be found in plentyMarkets' knowledge base Settings in plentyMarkets

 

 

2.2 Selecting products

Products need to be selected before they can be imported to your mobile shop. In your plentyMarkets backend, select the categories in which your products are located.

For plentyMarkets 6:

  1. Navigate to Item > Batch processing
  2. Click on (but not expand) a category in which your products are located.
  3. Scroll down to locate Shopgate and Web-API in the Markets section. Check both boxes on the left and right.
  4. Click Apply.
  5. Repeat the steps for all categories needed.

For plentyMarkets 5.0:

  1. Navigate to Item > Group functions > Batch processing
  2. Set all applicable filter to ALL (see screenshot)
  3. Scroll down to locate Shopgate and Web-API in the Markets section. Check both boxes on the left and right.
  4. Click Apply.
  5. Your products have now been selected and will be imported into the correct category.

 

 

2.3 Adding product properties as filters

By default, products can be filtered by their variations (colors, sizes, etc.). Starting from plentyMarkets version 5.1, you can also add a product property (materials, brands, etc.) as a filter option in your mobile shop. This will allow your customers to find a product with more flexibility.

To add a product property as a filter option, please follow the steps here:

For plentyMarkets 7:

  1. Activate mobile orders by navigating to the gear icon > Orders > Order referrer and checking the box next to "Shopgate"














  2. Activate mobile prices by navigating to the gear icon > Item > Sales prices and adding "Shopgate" as a referrer on the prices you use for your mobile shop.







  3. Navigate to Settings > Orders > Shipping > Shipping Options into the tab Shipping profiles. Check whether "Shopgate" is listed in the column Order referrer.

plentymarkets_7_order_referrer.png

plentymarkets_price_referrer.png

For plentyMarkets 5 and 6:

  1. Click on the gear icon and navigate to Item > Properties
  2. Find the property you want to add and click "+" to expand it.
  3. Scroll down to find the option Shopgate and check the box.
  4. Click the save icon.
  5. Repeat the steps for all properties needed.
IMPORTANT: Please make sure to assign a Type and a Value to each property.

 

 

2.4 Connecting your shop to Shopgate

You're almost there! Simply enter your shop's URL and your mobile website will soon be up and running. To do so, follow the 2 easy steps below:

  1. Go back to the pop-up window at your Shopgate merchant page (step 4). Enter your shop's URL to the text field under 3. Enter URL. Click connect to establish the interface.
  2. 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.


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 :)

 

 

3. 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. Please follow the instruction for your version of plentyMarkets.

3.1 Above Version 5.1

  1. In your plentyMarkets backend, navigate to CMS > Webdesign. On the page, go to Layout > PageDesign, and open the template file PageDesignContent. Copy and paste a few lines of code (provided below) between <head>..</head> tags. Note that your template file may look different from the example in the screenshot.
  2. Copy and paste the JavaScript code below to the text field. Note that, do NOT delete any existing code from plentyMarkets in the text field. Overwrite the old JavaScript code from Shopgate, if existed, with the code below.
    <!-- BEGIN SHOPGATE MOBILE HEADER CODE -->
    <script type="text/javascript">
    var _shopgate = {};
    _shopgate.shop_number = "XXXXX";
    {% if $IsWelcomePage %}
    _shopgate.redirect = "start";
    {% elseif $CurrentItemId %}
    _shopgate.redirect = "item";
    _shopgate.item_number_public = "$CurrentItemId";
    {% elseif $CurrentCategoryType == 'item' && $CurrentCategoryId %}
    _shopgate.redirect = "category";
    _shopgate.category_number = "$CurrentCategoryId";
    {% endif %}
    if(typeof _shopgate.redirect != 'undefined')
    { _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>
    <!-- END SHOPGATE MOBILE HEADER CODE -->
  3. Replace the XXXXX (line 4) with your shop number at Shopgate. Then click Save. Where can I find my shop number?

 

3.2 Above Version 7 (New!)

  1. In your plentyMarkets backend, navigate to CMS > Webdesign. On the page, go to Layout > ItemView, and open the template file ItemViewSingleItem. Set a global variable like this:
    {% SetGlobal('currentVariationId', $VariationID) %}
  2. Overwrite the old JavaScript code from Shopgate, if existed, with the code below. Otherwise, copy and paste the code between the <head>..</head> tags.
    Please do NOT delete any existing code from plentyMarkets in the text field.
    <!-- BEGIN SHOPGATE MOBILE HEADER CODE -->
    <script type="text/javascript">
    var _shopgate = {};
    _shopgate.shop_number = "XXXXXX";
    {% if $IsWelcomePage %}
    _shopgate.redirect = "start";
    {% elseif $CurrentItemId %}
    _shopgate.redirect = "item";
    _shopgate.item_number_public = "{% GetGlobal('currentVariationId') %}";
    {% elseif $CurrentCategoryType == 'item' && $CurrentCategoryId %}
    _shopgate.redirect = "category";
    _shopgate.category_number = "$CurrentCategoryId";
    {% endif %}
    if(typeof _shopgate.redirect != 'undefined')
    { _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>
    <!-- END SHOPGATE MOBILE HEADER CODE -->
  3. Replace the XXXXX (line 4) with your shop number at Shopgate. Then click SaveWhere can I find my shop number?
    Note that your template file may look different from the example in the screenshot.


Now your mobile website will be successfully forwarded.

 

4. Setting up shipping rates

Setting up shipping rates has just become easier! The Shopgate technology now supports importing shipping methods and rates from your plentyMarkets backend via the Plugin. To do so, please read Getting shipping configurations (via plugin API)

 

 

If you have finished all tasks described above, you have successfully set up everything you need for your plentyMarkets mobile shop with Shopgate. Now simply sit back and watch your business grow!

Comments