plentyMarkets

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

 

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

 

Establish the connections

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

① Get API credentials

  1. Log in to your Shopgate Admin and navigate to Integration → 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 that the plugin needs to authenticate your shop. Leave this page open - we will come back to enter the URL (explained in step ④ Connect 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
    • 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.

② Select 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.

plentyMarkets 7 plentyMarkets 6
  1. Go to Settings → Orders → Order referrer. Activate Shopgate.
  2. Go to Item → Batch processing and click the tab Variants.
  3. Navigate to the category where your products are located.
  4. Scroll to the Markets section. 
  5. Check both boxes next to Shopgate and Web-API.
  6. Click Apply.

Repeat the steps to select all necessary categories.

③ Add 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:

plentyMarkets 7 plentyMarkets 6
  1. Activate mobile orders by navigating to the gear icon → Orders → Order referrer and checking the box next to "Shopgate" plentymarkets_7_order_referrer.png
  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. plentymarkets_price_referrer.png
  3. Navigate to Settings → Orders → Shipping → Shipping Options into the tab Shipping profiles. Check whether "Shopgate" is listed in the column Order referrer.

④ Connect 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 in Shopgate Admin you left open in step ①. 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. Leave all assignments to ON to apply all the available features. 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. Your import is finished when the progress bar disappears.

Welcome to the mobile world 😊

 

Activate 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 instructions below:

plentyMarkets 7 plentyMarkets 6
  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 -->
    {% if $IsWelcomePage %}
    <link rel="alternate" media="only screen and (max-width: 640px)" href="http://MOBILE-URL.de"/>
    {% elseif $CurrentItemId %}
    <link rel="alternate" media="only screen and (max-width: 640px)" href="http://MOBILE-URL.de/itempublic/{% bin2hex(GetGlobal('currentVariationId')) %}"/>
    {% elseif $CurrentCategoryType == 'item' && $CurrentCategoryId %}
    <link rel="alternate" media="only screen and (max-width: 640px)" href="http://MOBILE-URL.de/category/{% bin2hex($CurrentCategoryId) %}"/>
    {% endif %} <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 MOBILE-URL.de (line 3, 5 and 7) with your own mobile URL.
  4. Replace the XXXXX (line 11) with your shop number at Shopgate and click Save.
    Note that your template file may look different from the example in the screenshot.

Now your mobile website will be successfully forwarded.

 

Set 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!

 

Was this article helpful?
0 out of 0 found this helpful