Shopgate

Market integration will be deactivated

The integration of Shopgate will be deactivated on 31 December 2023. This means that PlentyONE will no longer support the market. As such, you will no longer be able to sell your items on the market with PlentyONE. Further information is available in the forum.

The Shopgate interface provides you with the possibility of quickly and inexpensively participating in m-commerce and therefore connecting with new groups of customers. This page explains which steps you have to take in order to set up the mobile version of your plentyShop and which settings have to be made to connect the m-commerce market Shopgate to your PlentyONE system.

1. Registering with Shopgate

First register with Shopgate in order to set up the interface to Shopgate in your PlentyONE system. After registering, you will receive login details from Shopgate.

2. Setting up Shopgate in PlentyONE

In this chapter, you will find information on settings and functions for the market Shopgate. To set up Shopgate in PlentyONE. proceed as described below.

Setting up Shopgate in PlentyONE:

  1. Go to Setup » Markets » Shopgate.

  2. Expand the Client (store) ().

  3. Carry out the settings. Pay attention to the explanations given in Table 1.

  4. Save () the settings.

Table 1. Settings for the market Shopgate
Setting Explanation

Access data

Operating mode

Select an operating mode.

  • Live = Go online with the settings you have made.

  • Shopgate test system = Activate test mode.

Customer number

Enter the customer number that you received from Shopgate.

Store number

Enter the store number that you received from Shopgate.

API key

Enter the API key that you received from Shopgate.

Basic configuration

Active

  • Deactivate = NO = Interface is inactive.

  • Activate = YES = Interface is active.

Export type

Select Client (store) item or All items.

  • All items = Export all items.

  • Client (store) item = Only exports items that are available for a specific client.

Item name

Select the item name that should be used for Shopgate.

Language

Select the language that should be used for Shopgate.

Item discount coupons active

Select if coupon codes for campaigns should be checked and accepted with discount type and item discount.

  • Yes = Coupon codes are checked and the discount is subtracted if the code is valid.

  • No = Coupon codes are not checked. Coupon codes with the discount type item discount are always rejected.
    Note: Coupon codes are automatically checked for campaigns with other discount types and the discount is deducted if the code is valid.

Advanced options

Transfer shipping costs

  • Yes = Transfer shipping costs to Shopgate.

  • No = Do not transfer shipping costs to Shopgate.

Stock buffer

Enter the number of items that should be used as a stock buffer and excluded from the transfer to Shopgate.
This ensures that an item cannot be completely sold out on this market.

Quantity for items that are not limited to the stock

Enter a quantity of items that is not limited to stock. This amount will represent the stock displayed on Shopgate.
Important: Item variations are only transmitted if the limitation in the item’s stock tab is either set to No limitation or the option Limited to net stock.

Maximum for item upload

Enter the maximum amount of items that you want to upload to Shopgate.

Item description

Select a free text field. The saved text in this field is displayed as the item description.

Add technical data to the item description

  • Yes = Transfers the technical data saved in an item’s texts tab to Shopgate.

  • No = Technical data is not transferred.

Transfer stock unit

Select whether the position saved in a variation’s category tab should be transferred to Shopgate. The position number is used to sort items within the item listing in the plentyShop.

CrossSelling

Use the cross-selling function to offer further items that match your items.

  • Yes = If you select Yes, a maximum of 15 cross-selling items with a maximum of 3 variations each is transferred for each item.

  • No = Cross-selling items will not be transferred.

Stock check

Select whether Shopgate should automatically check current stock levels in PlentyONE during the order process.

  • Yes = Stock is automatically checked in real time during the order process.

  • No = Stock is checked during the order process with the last stock level information that was transferred to Shopgate via CSV file.

Framework URL

URL of the interface. The URL is saved automatically. The framework URL is only displayed if Yes has been selected for the option Active.

Mobile forwarding

Alias

Enter the Alias that you have received from Shopgate.

Cname

You can save a personal domain with your provider. In order to use this domain, it also has to be saved on Shopgate.
The target cname.shopgate.com also has to be saved with the provider.

Connecting to this market allows for the following automatic processes to take place:

  • hourly stock synchronisation, as well as a confirmation when an item is shipped

  • daily item export

  • transfer of item categories

  • order import as soon as Shopgate has marked the item as paid

  • creating a new customer record in PlentyONE when a new customer places an order via Shopgate

  • automatic check of coupon codes during the order process

  • automatic check of item stock in real time during the order process (Stock check option, optional)

3. Setting up forwarding for mobile devices

With the help of mobile forwarding, you can select whether customers should be forwarded to Shopgate when opening the store in a mobile browser. If you do not activate this setting, then customers will not be forwarded.

Setting up forwarding:

  1. Go to Setup » Client » [Select client] » Online store » Forwarding.

  2. Carry out the settings. Pay attention to the explanations given in Table 2.

  3. Save () the settings.

Table 2. Forwarding options for mobile devices
Settings Explanation

Forwarding

This function makes it possible to display your plentyShop on mobile devices, e.g. with Shopgate or a similar provider.

  • Active = Customers are forwarded to activated URLs.

  • Inactive = Customers are not forwarded.

Target URL (category)

Enter the URL for the mobile version of your plentyShop, e.g. http://mobile.yourplentystore.co.uk. Customers who access your plentyShop from a mobile device are forwarded to this URL.
Tip: In the URL, the template variable $ReferrerID defines where customers were forwarded from. The URL would then look like this: http://mobile.yourplentystore.co.uk/?referrerId=$referrerId

Target URL (item page)

Enter the URL that customers should be forwarded to e.g. when they use a mobile device to access an item in your plentyShop from a price comparison portal. The item URL would then look like this: http://mobile.yourplentystore.co.uk/?itemNumber=$itemId. In the URL, the template variable $ItemID provides access to every item.
Tip: In the URL, the template variable $ReferrerID defines where customers were forwarded from. Then the URL would look like this: http://mobile.yourplentyshop.co.uk/?itemNumber=$itemId&referrerId=$referrerId
Note: If you don’t enter a URL here, then costumers will not be forwarded to items in your plentyShop from price comparison portals and etc.

4. Activating the order referrer

In order to link items, properties etc. with Shopgate, you have to activate the order referrer Shopgate in the Setup » Orders » Order referrer menu.

Activating the order referrer for Shopgate:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the referrer Shopgate.

  3. Save () the settings.

5. Setting the variation availability

You need to activate all variations that you want to sell on Shopgate. This is done in the Availability tab of a variation within the Item » Edit item » [Open item] » [Open variation] menu. In addition, you can select whether all items or only selected items should be transferred. This is done in the Setup » Markets » Shopgate menu.

Selling all variations of an item on Shopgate

If you want to sell all variations of an item on Shopgate, carry out the settings below for the item’s main variation. All other variations of the item then inherit the settings of the main variation.

Activating the variation availability for Shopgate:

  1. Go to Item » Edit item » [Open item] » [Open variation].
    → The tab Settings of the variation is shown.

  2. In the Availability area, activate the option Active.

  3. Click on the Availability tab.

  4. Click in the selection field in the Markets area.
    → A list of all available markets is displayed.

  5. Activate the option Shopgate.

  6. Activate the option Web API.

  7. Click on Add ().
    → The market is added.

  8. Save () the settings.

  9. Go to Setup » Markets » Shopgate.

  10. Select All items as the Export type.

  11. Carry out additional settings as desired. Pay attention to the explanations given in Table 1.

  12. Save () the settings.
    → The item is available on Shopgate.

Transferring selected items of a client

If you work with several clients and you don’t want to transfer all items of all clients to Shopgate, then you can open individual items and specify which clients should be transferred. The following requirements have to be met in order for the export per client (store) to work correctly:

  • Select Client (store) item as the Export type in the Setup » Markets » Shopgate menu.

  • Activate at least one client under Markets in the item’s Availability tab.

  • It is not permitted to select all or none of the clients (store). Both cases will trigger a general export and not an export per client (store).

  • Shopgate has to be set up for each client (store) that items are available for.

6. Optional: Saving SKU

Add SKUs manually for specific referrers in the Item » Edit item » [Open item] » [Open variation] » Tab: Availability menu if needed.

Adding SKU:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.

  2. Click on the Availability tab.

  3. In the SKU area, click on Add ().
    → The New SKU window is displayed.

  4. Select the referrer Shopgate.

  5. Select the corresponding marketplace account.

  6. Enter the SKU.

  7. Click on Add ().
    → The SKU is saved and displayed.

7. Defining a sales price

To sell variations on Shopgate, you need a sales price in which the order referrer Shopgate is activated. The price that you save for this sales price is the price that will be shown on Shopgate.

What is a sales price?

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. For example, you can sell your items at a lower price in your webshop than on Amazon. Or you can sell products cheaper to B2B customers than to B2C customers.

Two default sales prices are already configured in your PlentyONE system. However, you can also create new sales prices and edit them individually. In addition to default sales prices, you can also create RRPs, special offers, and set prices.

Defining a sales price for Shopgate:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a sales price first.

  2. Open the Settings tab.

  3. Activate the referrer Shopgate.

  4. Save () the settings.

8. Linking properties

Link your properties with the Shopgate properties. To do so, proceed as follows.

Linking properties:

  1. Go to Setup » Item » Characteristics.

  2. Expand the property ().

  3. Activate the option Shopgate.

  4. Save () the settings.

9. Permitting payment method in customer classes

The payment method Shopgate Payment is automatically available in your PlentyONE system as soon as an active Shopgate account exists. No separate configurations are needed for this. You just need to permit the payment method in one or more customer classes.

What are customer classes?

Customer classes allow you to divide your customer base according to specific criteria. Examples of use for customer classes are:

  • Create two separate customer classes for end customers (B2C) and business customers (B2B) respectively. Depending on the customer class, customers either see net prices or gross prices in your plentyShop.

  • Give discounts to specific customer classes.

For more information about customer classes, head over to the to the Managing contacts page.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Customer classes.

  2. Open the customer class for which you want to permit the payment method.

  3. For the setting Allowed payment methods, activate the option Shopgate Payment.

  4. Save () the settings.

Amazon Pay payment method

If you want to use the payment method Amazon Pay, then do not create a separate Shopgate account for Amazon Pay. Use the account created in PlentyONE.

Depending on the payment method, Shopgate will generate and send an invoice so that you do not have to send it to the customer. You can check if Shopgate generated and sent an invoice by checking your orders in Shopgate or by setting up an event procedure to automatically generate and send invoices.

10. Automatically sending cancellations

Set up an event procedure to automatically send cancellations to Shopgate. Cancellations are handled as returns at Shopgate. Therefore, use the procedure Send return to Shopgate.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 3.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 3.

  7. Select the setting Active ().

  8. Save () the settings.

Table 3. Event procedure for automatically sending cancellations to Shopgate
Setting Option Selection

Event

Order change: Status change

[8] Cancelled

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

Shopgate

Procedure

Return > Send return to Shopgate

11. Automatically sending returns

Set up an event procedure to automatically send returns to Shopgate.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 4.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 4.

  7. Select the setting Active ().

  8. Save () the settings.

Table 4. Event procedure for automatically sending returns to Shopgate
Setting Option Selection

Event

Order generation: New return

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

Shopgate

Procedure

Return > Send return to Shopgate